03 - Rapporten vs Labels

In de vorige module zag je dat data is opgebouwd in een boomstructuur, en dat sommige velden enkelvoudig zijn terwijl andere meervoudig zijn. Die structuur bepaalt mede welk type ontwerp je nodig hebt.

Stimulsoft ondersteunt twee hoofdtypen ontwerpen: rapporten en labels. Hoewel je beide maakt in dezelfde designer, verschillen ze fundamenteel in opbouw en gebruik.

Rapporten

Een rapport geeft een variabele hoeveelheid data overzichtelijk weer. Denk aan een orderbevestiging, pakbon of factuur. Het aantal pagina’s hangt af van hoeveel data er is.

De kern van een rapport is de databand: een sectie die zich herhaalt voor elke rij in de dataset. Je kent dit concept al — in de vorige module zag je dat Regels meervoudig is. Een databand herhaalt voor elk item in zo’n meervoudige lijst. Heb je 3 orderregels, dan wordt de databand 3 keer afgedrukt. Heb je 300 regels, dan 300 keer.

┌─────────────────────────────┐
│ PageHeader (1x per pagina)  │
├─────────────────────────────┤
│ DataBand -- rij 1           │
│ DataBand -- rij 2           │
│ DataBand -- rij 3           │
│ ...                         │
├─────────────────────────────┤
│ PageFooter (1x per pagina)  │
└─────────────────────────────┘

De pagina-indeling is dynamisch: de designer bepaalt zelf wanneer een nieuwe pagina begint.

Labels

Een label geeft een vaste hoeveelheid informatie weer op een fysiek formaat, zoals een productsticker of verzendlabel. Het formaat staat vast – bijvoorbeeld 100 x 70 mm.

Op een label staan geen databanden. Elk veld staat op een vaste positie. De waarden kunnen wel dynamisch zijn – ze komen uit een business object – maar de structuur verandert niet.

┌──────────────────────┐
│ ProductNaam          │  vaste positie, dynamische waarde
│ THT: 2024-06-01      │  vaste positie, dynamische waarde
│ Partij: P-2041       │  vaste positie, dynamische waarde
│ ▐▌▐▐▌▌▐▌▌▐▐▌▌        │  barcode op vaste positie
└──────────────────────┘

Wil je meerdere labels afdrukken? Dan regelt Stimulsoft de herhaling op paginaniveau, niet via een databand binnen het label.

Het belangrijkste verschil

Denk aan het verschil zo: een rapport is als een accordeon — het kan uitrekken en inkrimpen, afhankelijk van de hoeveelheid data. Een label is als een postzegel — altijd hetzelfde formaat, ongeacht de inhoud.

Wanneer kies je wat?

Kies een rapport als:

• De hoeveelheid data per document varieert
• Je subtotalen, groepen of meerdere secties nodig hebt
• Het document meerdere pagina’s kan beslaan

Kies een label als:

• Het fysieke formaat vaststaat
• Je een object per label weergeeft
• De layout niet afhankelijk is van de hoeveelheid data

Samenvatting

• Een rapport groeit mee met de data via databanden — gebruik het voor documenten met een variabele hoeveelheid data
• Een label heeft een vast formaat zonder databanden — gebruik het voor stickers en etiketten met een vaste indeling
• De keuze hangt af van de vraag: varieert de hoeveelheid data, of staat het formaat vast?