Delen via

Paginakopteksten en voetteksten in een gepagineerd rapport (Power BI Report Builder)

  • Artikel

VAN TOEPASSING OP: Power BI Report Builder Power BI Desktop

Een gepagineerd rapport kan een kop- en voettekst bevatten die respectievelijk boven en onder aan elke pagina wordt uitgevoerd. Kop- en voetteksten kunnen statische tekst, afbeeldingen, lijnen, rechthoeken, randen, achtergrondkleur, achtergrondafbeeldingen en expressies bevatten. Expressies bevatten gegevenssetveldverwijzingen voor rapporten met precies één gegevensset en statistische functie-aanroepen die de gegevensset als bereik bevatten.

Notitie

Elke renderingextensie verwerkt pagina's anders. Zie Paginering in Reporting Services (Power BI Report Builder en service) voor meer informatie over rapportpaginerings- en renderingextensies.

Rapporten hebben standaard paginavoetteksten, maar geen paginakopteksten. Zie Een paginakoptekst of voettekst toevoegen of verwijderen (Power BI Report Builder en service) voor meer informatie over het toevoegen of verwijderen ervan.

Kop- en voetteksten bevatten vaak paginanummers, rapporttitels en andere rapporteigenschappen. Zie Paginanummers of andere rapporteigenschappen weergeven (Report Builder en service) voor meer informatie over het toevoegen van deze items aan de kop- of voettekst van uw rapport.

Nadat u een paginakoptekst of voettekst hebt gemaakt, wordt deze weergegeven op elke rapportpagina. Zie Een paginakoptekst of voettekst verbergen op de eerste of laatste pagina (Report Builder en de Power BI-service) voor meer informatie over het onderdrukken van paginakopteksten en voetteksten op de eerste of laatste pagina.

Rapportkoppen en voetteksten

Paginakopteksten en voetteksten zijn niet hetzelfde als rapportkopteksten en voetteksten. Rapporten hebben geen speciaal gebied voor rapportkoptekst of rapportvoettekst. Een rapportkoptekst bestaat uit de rapportitems die boven aan de hoofdtekst van het rapport worden geplaatst op het ontwerpoppervlak van het rapport. Ze worden slechts eenmaal weergegeven als de eerste inhoud in het rapport. Een rapportvoettekst bestaat uit rapportitems die onder aan de hoofdtekst van het rapport worden geplaatst. Ze worden slechts één keer weergegeven als de laatste inhoud in het rapport.

Variabele gegevens weergeven in een paginakoptekst of voettekst

Paginakopteksten en voetteksten kunnen statische inhoud bevatten, maar ze worden vaker gebruikt om verschillende inhoud weer te geven, zoals paginanummers of informatie over de inhoud van een pagina. Als u variabele gegevens wilt weergeven die op elke pagina verschillen, moet u een expressie gebruiken.

Als er slechts één gegevensset is gedefinieerd in het rapport, kunt u eenvoudige expressies toevoegen, zoals [FieldName] een paginakoptekst of voettekst. Sleep het veld uit het gegevenssetveldverzameling rapportgegevensvenster of de verzameling Ingebouwde velden naar de paginakop- of paginavoettekst. Er wordt automatisch een tekstvak met de juiste expressie toegevoegd.

Als u totalen of andere aggregaties voor waarden op de pagina wilt berekenen, kunt u statistische expressies gebruiken waarmee ReportItems of de naam van een gegevensset worden opgegeven. De verzameling ReportItems is de verzameling tekstvakken op elke pagina nadat de rapportweergave is uitgevoerd. De naam van de gegevensset moet aanwezig zijn in de rapportdefinitie. In de volgende tabel ziet u welke items worden ondersteund in elk type statistische expressie:

Ondersteund in expressie ReportItems-aggregaties Statistische gegevenssets (bereik moet de naam van de gegevensset zijn)
Tekstvakken in de hoofdtekst van het rapport Ja Nr.
&PageNumber Ja Nr.
&TotalPages Ja Nr.
Statistische functie Ja. Bijvoorbeeld:

=First(ReportItems!TXT_LastName.Value)		 Ja. Bijvoorbeeld:

=Max(Quantity.Value,"DataSet1")
Verzameling velden voor items op de pagina Onrechtstreeks. Bijvoorbeeld:

=Sum(ReportItems!Textbox1.Value)		 Ja. Bijvoorbeeld:

=Sum(Fields!Quantity.Value,"DataSet1")
Gegevensgebonden afbeelding Onrechtstreeks. Bijvoorbeeld =ReportItems!TXT_Photo.Value Ja. Bijvoorbeeld:

=First(Fields!Photo.Value,"DataSet1")

In de volgende secties in dit onderwerp ziet u kant-en-klare expressies waarmee variabele gegevens worden opgehaald die vaak worden gebruikt in kop- en voetteksten. Er is ook een sectie over hoe de Excel-renderingextensie kop- en voetteksten verwerkt. Zie Expressies in Power BI Report Builder voor meer informatie over expressies.

Berekende paginatotalen toevoegen aan een kop- of voettekst

Voor sommige rapporten is het handig om een berekende waarde op te nemen in de kop- of voettekst van elk rapport; Bijvoorbeeld een totaal per pagina als de pagina numerieke waarden bevat. Omdat u niet rechtstreeks naar de velden kunt verwijzen, moet de expressie die u in de kop- of voettekst plaatst, verwijzen naar de naam van het rapportitem (bijvoorbeeld een tekstvak) in plaats van het gegevensveld:

=Sum(ReportItems!Textbox1.Value)

Als het tekstvak zich in een tabel of lijst bevindt die herhaalde rijen met gegevens bevat, is de waarde die tijdens runtime wordt weergegeven in de kop- of voettekst een som van alle waarden van alle TextBox1 exemplaargegevens in de tabel of lijst voor de huidige pagina.

Bij het berekenen van paginatotalen kunt u verschillen in de totalen verwachten wanneer u verschillende renderingextensies gebruikt om het rapport weer te geven. Gepagineerde uitvoer wordt voor elke renderingsextensie anders berekend. Op dezelfde pagina die u in HTML bekijkt, kunnen verschillende totalen worden weergegeven wanneer ze in PDF worden weergegeven als de hoeveelheid gegevens op de PDF-pagina anders is. Zie Rendering Behaviors (Report Builder en service) voor meer informatie.

Rapporten met meerdere gegevenssets

Voor rapporten met meer dan één gegevensset kunt u geen velden of gegevensgebonden afbeeldingen rechtstreeks toevoegen aan een kop- of voettekst. U kunt echter een expressie schrijven die indirect verwijst naar een veld- of gegevensgebonden afbeelding die u wilt gebruiken in een kop- of voettekst.

Variabele gegevens in een kop- of voettekst plaatsen:

  • Voeg een tekstvak toe aan de kop- of voettekst.

  • Schrijf in het tekstvak een expressie die de variabelegegevens produceert die u wilt weergeven.

  • Neem in de expressie verwijzingen op naar rapportitems op de pagina; U kunt bijvoorbeeld verwijzen naar een tekstvak dat gegevens uit een bepaald veld bevat. Neem geen directe verwijzing naar velden in een gegevensset op. U kunt de expressie [LastName]bijvoorbeeld niet gebruiken. U kunt de volgende expressie gebruiken om de inhoud van het eerste exemplaar van een tekstvak met de naam TXT_LastNameweer te geven:

    =First(ReportItems!TXT_LastName.Value)

U kunt geen statistische functies gebruiken voor velden in de kop- of voettekst van de pagina. U kunt alleen een statistische functie gebruiken voor rapportitems in de hoofdtekst van het rapport. Zie Expressievoorbeelden (Report Builder en service) voor algemene expressies in paginakopteksten en voetteksten.

U kunt afbeeldingsgegevens gebruiken die zijn opgeslagen in een database in een kop- of voettekst. U kunt echter niet rechtstreeks verwijzen naar databasevelden uit het rapportitem Afbeelding. In plaats daarvan moet u een tekstvak toevoegen in de hoofdtekst van het rapport en vervolgens het tekstvak instellen op het gegevensveld dat de afbeelding bevat (houd er rekening mee dat de waarde base64 moet worden gecodeerd). U kunt het tekstvak in de hoofdtekst van het rapport verbergen om te voorkomen dat de met Base64 gecodeerde afbeelding wordt weergegeven. Vervolgens kunt u verwijzen naar de waarde van het verborgen tekstvak uit het item Afbeeldingsrapport in de kop- of voettekst van de pagina.

Stel dat u een rapport hebt dat bestaat uit productinformatiepagina's. In de koptekst van elke pagina wilt u een foto van het product weergeven. Als u een opgeslagen afbeelding in de rapportkoptekst wilt afdrukken, definieert u een verborgen tekstvak met de naam TXT_Photo in de hoofdtekst van het rapport waarmee de afbeelding uit de database wordt opgehaald en gebruikt u een expressie om deze een waarde te geven:

=Convert.ToBase64String(Fields!Photo.Value)

Voeg in de koptekst een afbeeldingsrapportitem toe dat gebruikmaakt van het TXT_Photo tekstvak, gedecodeerd om de afbeelding weer te geven:

=Convert.FromBase64String(ReportItems!TXT_Photo.Value)

Kop- en voetteksten gebruiken om tekst te plaatsen

U kunt kop- en voetteksten gebruiken om tekst op een pagina te plaatsen. Stel dat u een rapport maakt dat u wilt mailen naar klanten. U kunt een kop- of voettekst gebruiken om het adres van de klant te plaatsen, zodat het in een envelopvenster wordt weergegeven wanneer deze wordt gevouwen.

Als u alleen het tekstvak gebruikt om een kop- of voettekst te vullen, kunt u het tekstvak verbergen in de hoofdtekst van het rapport. De plaatsing van het tekstvak in de hoofdtekst van het rapport kan van invloed zijn op het feit of de waarde wordt weergegeven in de kop- of voettekst van de eerste of laatste pagina van een rapport. Als u bijvoorbeeld tabellen, matrices of lijsten hebt die ervoor zorgen dat het rapport meerdere pagina's omvat, wordt de waarde van het verborgen tekstvak weergegeven op de laatste pagina. Als u wilt dat het op de eerste pagina wordt weergegeven, plaatst u het verborgen tekstvak boven aan de hoofdtekst van het rapport.

Rapporten ontwerpen met paginakoppen en voetteksten voor specifieke renderers

Wanneer een rapport wordt verwerkt, worden gegevens en indelingsgegevens gecombineerd. Wanneer u een rapport bekijkt, wordt de gecombineerde informatie doorgegeven aan een renderer die bepaalt hoeveel rapportgegevens op elke rapportpagina passen.

Als u een rapport op de rapportserver bekijkt met behulp van een browser, bepaalt de HTML-renderer de inhoud op de rapportpagina's die u ziet. Als u van plan bent rapporten in een andere indeling te leveren dan u gebruikt voor weergave, of als u van plan bent om rapporten in een specifieke indeling af te drukken, kunt u de rapportindeling optimaliseren voor de renderer die u wilt gebruiken voor de uiteindelijke rapportindeling. Zie Paginering in Reporting Services (Report Builder en service) voor meer informatie over rapportpaginering.

Werken met paginakoppen en voetteksten in Excel

Wanneer u paginakopteksten en voetteksten definieert voor rapporten die zijn gericht op de Excel-renderingextensie, volgt u deze richtlijnen om de beste resultaten te bereiken:

  • Gebruik paginavoetteksten om paginanummers weer te geven.
  • Gebruik paginakoppen om afbeeldingen, titels of andere tekst weer te geven. Plaats geen paginanummers in de koptekst.

In Excel hebben paginavoetteksten een beperkte indeling. Als u een rapport definieert dat complexe rapportitems in de paginavoettekst bevat, wordt de paginavoettekst niet verwerkt zoals verwacht wanneer het rapport wordt weergegeven in Excel.

De Excel-renderingsextensie kan geschikt zijn voor afbeeldingen en absolute plaatsing van eenvoudige of complexe rapportitems in de paginakoptekst. Een neveneffect van het ondersteunen van een uitgebreidere paginakopindeling is beperkte ondersteuning voor het berekenen van paginanummers in de koptekst. In de Excel-renderingsextensie worden standaardinstellingen paginanummers berekend op basis van het aantal werkbladen. Afhankelijk van hoe u het rapport definieert, kan dit onjuiste paginanummers opleveren. Stel dat u een rapport hebt dat wordt weergegeven als één groot werkblad dat op vier pagina's wordt afgedrukt. Als u informatie over paginanummers in de koptekst opneemt, wordt op elke afgedrukte pagina pagina 1 van 1 weergegeven in de koptekst.

Een nauwkeuriger aantal pagina's is gebaseerd op logische pagina's die correleren met de afmetingen van een afgedrukte pagina. In Excel gebruikt de paginavoettekst automatisch logische paginanummers. Als u het aantal logische pagina's in de paginakoptekst wilt plaatsen, moet u de instellingen voor apparaatgegevens configureren om eenvoudige headers te gebruiken. Houd er rekening mee dat wanneer u eenvoudige kopteksten gebruikt, u de mogelijkheid verwijdert om complexe rapportindelingen in de koptekstregio te verwerken.

Zie Exporteren naar Microsoft Excel (Power BI Report Builder en service) voor meer informatie.

Gerelateerde inhoud