07 - Design plus data is resultaat

Je kent nu de designer en je weet dat data via business objects uit ReflexBlue komt. Maar hoe komen die twee samen? Dat is het kernprincipe van Stimulsoft en de rode draad door deze hele training.

Een rapport bestaat uit twee onafhankelijke onderdelen die op het moment van genereren samenkomen.

  Rapport design          Data (business object)
  (layout, opmaak)    +   (waarden uit ReflexBlue)
         │                         │
         └────────────┬────────────┘
                      ▼
             Gegenereerd rapport
             (PDF / afdruk / scherm)

Het design bepaalt hoe het rapport eruitziet. De data bepaalt wat erin staat.

Het rapport design

Het design is een sjabloon dat de structuur van het rapport beschrijft:

• Welke secties er zijn (koptekst, regels, voettekst)
• Waar velden staan en hoe ze zijn opgemaakt
• Welke velden uit het business object worden gebruikt
• Regels voor herhaling, groepering en conditionele opmaak

Het design bevat geen echte data — alleen verwijzingen naar velden. Zo kun je hetzelfde design gebruiken voor duizenden verschillende orders.

De data

De data wordt aangeleverd door ReflexBlue als een business object op het moment dat het rapport wordt aangevraagd. Het business object bevat de actuele waarden die in het rapport moeten verschijnen.

Elke keer dat je een rapport genereert, kan de data anders zijn — maar het design blijft hetzelfde.

Het printproces: wat er werkelijk gebeurt

Als je in ReflexBlue op de printknop klikt, wordt het rapport niet onmiddellijk gegenereerd. Het proces werkt in twee stappen:

Stap 1 — Pakket samenstellen (op het moment van klikken)

De applicatieserver stelt een pakketje samen dat bevat:

• Een kopie van de layout (het design)
• Een bestand met de data (het business object)
• Instructies voor het printen (formaat, printer, aantal)

Dit pakket wordt gezipt en in de database opgeslagen.

Stap 2 — Rapport genereren (later)

Het rapport wordt pas daadwerkelijk gegenereerd als het pakket wordt opgepakt. Dit kan op verschillende plaatsen:

Tussen stap 1 en stap 2 kan tijd zitten — van milliseconden tot minuten, afhankelijk van de wachtrij.

Het genereren (samenvatting)

Wanneer het pakket wordt opgepakt, combineert Stimulsoft het design met de data:

1. Stimulsoft laadt het design
2. De data uit het pakket wordt ingelezen
3. Stimulsoft doorloopt het design sectie voor sectie
4. Voor elke verwijzing naar een veld wordt de werkelijke waarde ingevuld
5. Databanden worden herhaald voor elke rij in een lijst
6. Het eindresultaat wordt weergegeven als PDF, afdruk of schermweergave

Een concreet voorbeeld

Stel: je hebt een pakbon-design met een databand voor orderregels.

Hetzelfde design gegenereerd met een andere order levert een volledig ander document op.

Waarom is dit belangrijk?

• Je bouwt een design een keer en gebruikt het voor alle vergelijkbare documenten
• Een aanpassing in het design geldt direct voor alle toekomstige generaties
• De data en de opmaak zijn strikt gescheiden — je kunt ze onafhankelijk van elkaar aanpassen

Samenvatting

• Design + data = resultaat — dit is het kernprincipe van Stimulsoft
• Het design is een herbruikbaar sjabloon met veldverwijzingen, geen echte data
• De data komt als business object op het moment van genereren
• Dezelfde opmaak, andere data → ander document