03 - Veldverwijzingen

Je hebt het woordenboek verkend en weet waar de data staat. Maar hoe vertel je de designer welk veld je wilt tonen op het rapport? Dat doe je met een veldverwijzing.

Een veldverwijzing is als een adres: het vertelt Stimulsoft precies waar in het business object de gewenste waarde staat. Op het moment van genereren vervangt Stimulsoft de verwijzing door de werkelijke waarde.

De syntax: accolades en puntnotatie

Een veldverwijzing staat altijd tussen accolades { } en gebruikt puntnotatie om door de boomstructuur te navigeren:

{Object.Veld}

Concreet voorbeeld — het business object voor een order:

Merk op: hoe dieper het veld in de boom zit, hoe langer de verwijzing wordt. Klant.Naam navigeert eerst naar het Klant-object en dan naar het veld Naam.

Verwijzingen in het design vs. het resultaat

In het design zie je de verwijzing:

Geachte {Order.Klant.Naam},

Na genereren met data zie je het resultaat:

Geachte Bakkerij de Zon,

Dit is het kernprincipe design + data = resultaat in actie: de verwijzing in het design wordt bij het genereren vervangen door de werkelijke waarde uit het business object.

Meervoudige velden

Bij meervoudige velden (lijsten) werkt de verwijzing iets anders. Je verwijst naar de velden van het herhalende object:

{Regels.Omschrijving}
{Regels.Aantal}

Deze verwijzingen komen in een databand te staan — de databand herhaalt voor elke regel, en bij elke herhaling vult Stimulsoft de verwijzing met de waarde van die specifieke regel. Hoe je een databand koppelt leer je verderop in deze sessie.

Samenvatting

• Een veldverwijzing staat tussen accolades: {Object.Veld}
• Puntnotatie navigeert door de boomstructuur: {Order.Klant.Naam}
• Bij het genereren vervangt Stimulsoft elke verwijzing door de werkelijke waarde
• Verwijzingen naar meervoudige velden komen in een databand