07 - Databand Koppelen
Je weet nu welke secties een rapport heeft en dat de databand de sectie is die herhaalt. Maar hoe weet de databand welke data hij moet herhalen? Daarvoor moet je de databand koppelen aan een business object.
Vergelijk het met een printer en een adressenlijst: de printer (databand) drukt steeds hetzelfde sjabloon af, maar de adressenlijst (business object) bepaalt welke gegevens er per exemplaar worden ingevuld.
Stap voor stap: een databand toevoegen en koppelen
Stap 1 — Databand toevoegen
- Ga naar het tabblad Invoegen in het lint
- Klik op DataBand (onder de groep Banden)
- Klik op het canvas om de databand te plaatsen
Er verschijnt een horizontale sectie op het canvas met de naam “DataBand1”.
Stap 2 — Databron kiezen
Direct na het plaatsen — of via dubbelklik op de databand — verschijnt het venster Databron selecteren. Hier kies je welk business object de databand aanstuurt.
Je ziet de beschikbare business objects uit het woordenboek. Kies het object dat de herhalende data bevat, bijvoorbeeld Order.Regels.
Stap 3 — Koppeling controleren
Na het koppelen zie je de naam van de databron in de databand op het canvas (bijvoorbeeld “Regels”). Dit bevestigt dat de databand is gekoppeld.
In het Eigenschappen-paneel kun je de koppeling ook zien bij de eigenschap DataSource.
Wat gebeurt er bij het genereren?
Na koppeling werkt de databand als volgt:
| Stap | Wat er gebeurt |
|---|---|
| 1 | Stimulsoft leest de gekoppelde databron (bijv. Order.Regels) |
| 2 | Voor elke rij in de databron herhaalt de databand |
| 3 | Bij elke herhaling worden de veldverwijzingen in de databand gevuld met de waarden van die rij |
Heeft de order 5 regels, dan herhaalt de databand 5 keer. Heeft de volgende order 20 regels, dan herhaalt hij 20 keer — het design verandert niet.
Veelgemaakte fout: databand zonder koppeling
Als je een databand plaatst maar vergeet een databron te kiezen, blijft de databand leeg bij het genereren. Je ziet dan geen foutmelding, maar ook geen data. Controleer altijd of de databand een databron heeft.
Samenvatting
- Een databand moet gekoppeld worden aan een business object om te weten welke data hij herhaalt
- Je koppelt via het venster Databron selecteren dat verschijnt bij het plaatsen
- Na koppeling herhaalt de databand automatisch voor elke rij in het gekoppelde object
- Controleer de koppeling in het Eigenschappen-paneel bij DataSource