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:
- Stimulsoft laadt het design
- De data uit het pakket wordt ingelezen
- Stimulsoft doorloopt het design sectie voor sectie
- Voor elke verwijzing naar een veld wordt de werkelijke waarde ingevuld
- Databanden worden herhaald voor elke rij in een lijst
- Het eindresultaat wordt weergegeven als PDF, afdruk of schermweergave
Een concreet voorbeeld
Stel: je hebt een pakbon-design met een databand voor orderregels.
| In het design | Na genereren met data |
|---|---|
{Klant.Naam} | Bakkerij de Zon |
{Order.Datum} | 15-03-2024 |
| Databand herhaalt | 3 regels afgedrukt (want 3 orderregels in data) |
{Regel.Omschrijving} | Tarwebloem, Roggebloem, Suiker |
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
Meer in deze rubriek
- 01 - Data vs Informatie
- 02 - Oefening data vs Informatie
- 03 - Rapporten vs Labels
- 04 - Oefening Rapporten vs Labels
- 05 - Wat is de Report Designer?
- 06 - Oefening Wat is de Report Designer?
- 07 - design plus data is resultaat
- 08 - oefening design plus data
- 09 - de interface
- 10 - oefening de interface
- 11 - nieuw rapport aanmaken
- 12 - oefening nieuw rapport
- 13 - componenten
- 14 - oefening componenten
- 15 - pagina instellingen
- 16 - oefening rapport met logo