09 - Velden plaatsen

Je hebt een databand gekoppeld aan een business object. Nu ga je de velden uit het woordenboek op het canvas plaatsen — het moment waarop design en data letterlijk samenkomen.

De snelste manier: slepen vanuit het woordenboek

1. Open het tabblad Woordenboek in het linkerpaneel
2. Klap het business object open tot je het gewenste veld ziet
3. Sleep het veld naar de juiste sectie op het canvas
4. De designer maakt automatisch een tekstvak aan met de juiste veldverwijzing

Sleep je Order.Klant.Naam naar de ReportTitle, dan verschijnt er een tekstvak met {Order.Klant.Naam}. Zo simpel is het.

Waar sleep je welk veld?

Niet elk veld hoort in elke sectie. De vuistregel uit de vorige module helpt:

Sleep een meervoudig veld naar de databand die aan dat business object is gekoppeld. Sleep een enkelvoudig veld naar de ReportTitle of een andere niet-herhalende sectie.

De tweede manier: handmatig typen

Je kunt ook handmatig een tekstvak aanmaken en de veldverwijzing zelf typen:

1. Voeg een tekstvak toe via de toolbox of het tabblad Invoegen
2. Dubbelklik op het tekstvak om het te bewerken
3. Typ de veldverwijzing, bijvoorbeeld {Order.Klant.Naam}

Dit is handig als je een veldverwijzing wilt combineren met statische tekst:

Factuurdatum: {Order.Datum}

Veelgemaakte fout: de verkeerde verwijzing op de verkeerde plek

Veldverwijzingen zijn precies — een kleine afwijking kan ervoor zorgen dat je rapport er goed uitziet maar verkeerde data toont. Dit zijn de drie meest voorkomende fouten:

1. Meervoudig veld buiten de databand

Je plaatst {Order.Regels.Omschrijving} in de ReportTitle in plaats van in de DataBand. Resultaat: alleen de eerste waarde verschijnt, de rest ontbreekt.

2. Te diep verwijzen binnen de verkeerde databand

Je hebt een DataBand gekoppeld aan Orders en plaatst daarin {Orders.Regels.Artikel.Naam}. Maar Regels is een meervoudig veld binnen Orders — die verwijzing hoort in een geneste DataBand die gekoppeld is aan Regels, niet in de bovenliggende Orders-databand.

3. Lijsten die op elkaar lijken maar anders zijn

In een business object kunnen vergelijkbare lijsten bestaan, bijvoorbeeld:

• Factuur.Regels — de directe factuurregels
• Factuur.Regelgroepen.Regels — regels gegroepeerd via een tussenlaag

Beide bevatten regels met vergelijkbare velden, maar de verwijzingen zijn niet uitwisselbaar. Gebruik je de verkeerde, dan toont het rapport data uit de verkeerde bron.

Hoe herken je het probleem?

Controleer altijd in het Afdrukvoorbeeld of je verschillende waarden ziet in de rijen van de databand. Zie je steeds dezelfde waarde herhalen, dan verwijst het veld waarschijnlijk naar het verkeerde niveau of de verkeerde lijst. Ga terug naar het design en controleer:

• In welke databand staat het tekstvak?
• Aan welk business object is die databand gekoppeld?
• Past de veldverwijzing bij die koppeling?

Samenvatting

• De snelste manier om een veld te plaatsen is slepen vanuit het woordenboek naar het canvas
• De designer maakt automatisch een tekstvak met de juiste veldverwijzing
• Enkelvoudige velden horen in de ReportTitle of PageHeader, meervoudige in de DataBand
• Je kunt veldverwijzingen ook handmatig typen en combineren met statische tekst