Report Builder-functies - verwijzing naar statistische functies in gepagineerde rapporten (Report Builder)

Van toepassing op: Microsoft Report Builder (SSRS) Power BI Report Builder Report Designer in SQL Server Data Tools

Als u geaggregeerde waarden wilt opnemen in uw gepagineerde rapport, kunt u ingebouwde statistische functies gebruiken in expressies. De standaard statistische functie voor numerieke velden is SUM. U kunt de expressie bewerken en een andere ingebouwde statistische functie gebruiken of een ander bereik opgeven. Het bereik bepaalt welke set gegevens moet worden gebruikt voor de berekening.

Terwijl de rapportprocessor rapportgegevens en de rapportindeling combineert, worden de expressies voor elk rapportitem geëvalueerd. Terwijl u elke pagina van het rapport bekijkt, ziet u de resultaten voor elke expressie in de weergegeven rapportitems.

De volgende tabel bevat categorieën van ingebouwde functies die u in een expressie kunt opnemen:

• Ingebouwde aggregatiefuncties

• Beperkingen voor ingebouwde velden, verzamelingen en statistische functies

• Beperkingen voor geneste aggregaties

• Actieve waarden berekenen

• Aantal rijen ophalen

• Waarden uit een andere gegevensset opzoeken

• Sort-Dependent waarden ophalen

• Serveraggregaties ophalen

• Recursief niveau ophalen

• Testen op omvang

Zie het naslagonderwerp van individuele functies om de geldige toepassingsgebieden voor een functie te bepalen. Zie Expressiebereik voor totalen, aggregaties en ingebouwde verzamelingen (Report Builder en SSRS) voor meer informatie en voorbeelden.

Opmerking

U kunt gepagineerde rapportdefinitiebestanden (.rdl) maken en wijzigen in Microsoft Report Builder, Power BI Report Builder en in Report Designer in SQL Server Data Tools.

Ingebouwde aggregatiefuncties

Met de volgende ingebouwde functies worden samenvattingswaarden berekend voor een set niet-null-numerieke gegevens in het standaardbereik of het benoemde bereik.

Function	Beschrijving
Avg	Retourneert het gemiddelde van alle niet-null-numerieke waarden die zijn opgegeven door de expressie, geëvalueerd in het opgegeven bereik.
Aantal	Retourneert een telling van niet-null-waarden die zijn opgegeven door de expressie, geëvalueerd in de context van het opgegeven bereik.
CountDistinct	Retourneert een telling van alle afzonderlijke niet-null-waarden die zijn opgegeven door de expressie, geëvalueerd in de context van het opgegeven bereik.
Max	Retourneert de maximumwaarde van alle niet-null-numerieke waarden die zijn opgegeven door de expressie, in de context van het opgegeven bereik. U kunt dit gebruiken om een maximumwaarde voor de grafiekas op te geven om de schaal te beheren.
Min	Retourneert de minimumwaarde van alle niet-null-numerieke waarden die zijn opgegeven door de expressie, in de context van het opgegeven bereik. U kunt dit gebruiken om een minimumwaarde voor de as van de grafiek op te geven om de schaal te regelen.
StDev	Retourneert de standaarddeviatie van alle niet-null-numerieke waarden die zijn opgegeven door de expressie, geëvalueerd in het opgegeven bereik.
StDevP	Retourneert de standaarddeviatie van de populatie van alle niet-null-numerieke waarden die zijn opgegeven door de expressie, geëvalueerd in de context van het opgegeven bereik.
Sum	Retourneert de som van alle niet-null-numerieke waarden die zijn opgegeven door de expressie, geëvalueerd in het opgegeven bereik.
Unie	Retourneert de samenvoeging van alle niet-null ruimtelijke gegevenswaarden van het type SqlGeometry of SqlGeography die zijn opgegeven door de expressie, geëvalueerd in het opgegeven bereik.
Var	Retourneert de variantie van alle niet-null-numerieke waarden die zijn opgegeven door de expressie, geëvalueerd in het opgegeven bereik.
VarP	Retourneert de populatievariantie van alle niet-nul numerieke waarden die door de expressie zijn opgegeven, geëvalueerd in de context van het gegeven bereik.

Terug naar boven

Beperkingen voor ingebouwde velden, verzamelingen en statistische functies

De volgende tabel bevat een overzicht van beperkingen in rapportlocaties waar u expressies kunt toevoegen die verwijzingen naar globale ingebouwde verzamelingen bevatten.

Locatie in rapport	Fields	Parameterwaarden	ReportItems	PageNumber TotalPages	gegevensbron Dataset	Variables	RenderFormat
Paginakoptekst Paginavoettekst	Yes	Yes	Maximaal één Opmerking 1	Yes	Yes	Yes	Yes
Body	Yes Opmerking 2	Yes	Alleen items in het huidige bereik of een omvattend bereik Opmerking 3	Nee.	Yes	Yes	Yes
Rapportparameter	Nee.	Alleen parameters eerder in de lijst Opmerking 4	Nee.	Nee.	Nee.	Nee.	Nee.
Veld	Yes	Yes	Nee.	Nee.	Nee.	Nee.	Nee.
Queryparameter	Nee.	Yes	Nee.	Nee.	Nee.	Nee.	Nee.
Groepsexpressie	Yes	Yes	Nee.	Nee.	Yes	Nee.	Nee.
Sorteerexpressie	Yes	Yes	Nee.	Nee.	Yes	Yes Opmerking 5	Nee.
Filterexpressie	Yes	Yes	Nee.	Nee.	Yes	Yes Opmerking 6	Nee.
Code	Nee.	Yes Opmerking 7	Nee.	Nee.	Nee.	Nee.	Nee.
Rapport.Taal	Nee.	Yes	Nee.	Nee.	Nee.	Nee.	Nee.
Variables	Yes	Yes	Nee.	Nee.	Yes	Huidig of bestaand bereik	Nee.
Aggregaten	Yes	Yes	Alleen in paginakoptekst/paginavoettekst	Alleen in aggregaties van rapportitems	Yes	Nee.	Nee.
Opzoekfuncties	Yes	Yes	Yes	Nee.	Yes	Nee.	Nee.

• Opmerking 1. ReportItems moeten aanwezig zijn op de weergegeven rapportpagina of de waarde is Null. Als de zichtbaarheid van een rapportitem afhankelijk is van een expressie die evalueert naar Onwaar, verschijnt het rapportitem niet op de pagina.

• Opmerking 2. Als een veldreferentie wordt gebruikt in een groepsbereik en de veldreferentie niet is opgenomen in de groepsexpressie, is de waarde voor het veld niet gedefinieerd, tenzij er slechts één waarde in het bereik is. Als u een waarde wilt opgeven, gebruikt u Eerst of Laatste en het groepsbereik.

• Opmerking 3. Expressies die een verwijzing naar ReportItems bevatten, kunnen waarden opgeven voor andere ReportItems in hetzelfde groepsbereik of in een omvattend groepsbereik.

• Opmerking 4. Eigenschapswaarden voor eerdere parameters kunnen null zijn.

• Opmerking 5. Alleen bij sorteerders voor leden. Kan niet gebruiken in sorteerexpressies voor gegevensregio's.

• Opmerking 6. Alleen in ledenfilters. Kan niet gebruiken in gegevensregio- of gegevenssetfilterexpressies.

• Opmerking 7. De verzameling Parameters wordt pas geïnitialiseerd nadat het codeblok is verwerkt, zodat methoden niet kunnen worden gebruikt om parameters bij initialisatie te beheren.

• Opmerking 8. Het gegevenstype voor alle aggregaties behalve Count en CountDistinct moet hetzelfde gegevenstype of null zijn voor alle waarden.

Terug naar boven

Beperkingen voor geneste aggregaties

De volgende tabel bevat een overzicht van beperkingen voor welke statistische functies andere statistische functies kunnen opgeven als geneste aggregaties.

Context	RunningValue	Rijnummer	Eerst Laatste	Vorige	De Sum- en andere voorsorteringsfuncties	ReportItem-aggregaties	Opzoekfuncties	Aggregatiefunctie
Lopende waarde	Nee.	Nee.	Nee.	Nee.	Yes	Nee.	Yes	Nee.
Eerst Laatste	Nee.	Nee.	Nee.	Nee.	Yes	Nee.	Nee.	Nee.
Vorige	Yes	Yes	Yes	Nee.	Yes	Nee.	Yes	Nee.
Som en andere functies Presort	Nee.	Nee.	Nee.	Nee.	Yes	Nee.	Yes	Nee.
ReportItem-aggregaties	Nee.	Nee.	Nee.	Nee.	Nee.	Nee.	Nee.	Nee.
Opzoekfuncties	Yes	Yes Opmerking 1	Yes Opmerking 1	Yes Opmerking 1	Yes Opmerking 1	Yes Opmerking 1	Nee.	Nee.
Aggregatiefunctie	Nee.	Nee.	Nee.	Nee.	Nee.	Nee.	Nee.	Nee.

• Opmerking 1. Statistische functies zijn alleen toegestaan in de bronexpressie van een opzoekfunctie als de functie Opzoeken niet is opgenomen in een aggregatie. Statistische functies zijn niet toegestaan in de doel - of resultaatexpressies van een opzoekfunctie.

Terug naar boven

Lopende waarden berekenen

Met de volgende ingebouwde functies worden actieve waarden voor een set gegevens berekend. RowNumber is net als RunningValue omdat het de voortschrijdende waarde retourneert van een telling die voor elke rij binnen de omvattende scope wordt verhoogd. De bereikparameter voor deze functies moet een omvattend bereik specificeren, dat bepaalt wanneer de telling opnieuw begint.

Function	Beschrijving
Rijnummer	Retourneert een lopend aantal rijen voor het opgegeven bereik. De functie RowNumber start opnieuw op 1, niet op 0.
RunningValue	Retourneert een actieve aggregatie van alle niet-null-numerieke waarden die zijn opgegeven door de expressie, geëvalueerd voor het opgegeven bereik.

** Terug naar boven

Aantal rijen ophalen

Met de volgende ingebouwde functie wordt het aantal rijen in het opgegeven bereik berekend. Gebruik deze functie om alle rijen te tellen, inclusief rijen met null-waarden.

Function	Beschrijving
CountRows	Retourneert het aantal rijen in het opgegeven bereik, inclusief rijen met null-waarden.

Terug naar boven

Waarden uit een andere gegevensset opzoeken

Met de volgende opzoekfuncties worden waarden opgehaald uit een opgegeven gegevensset.

Function	Beschrijving
Opzoekfunctie	Retourneert een waarde uit een gegevensset voor een opgegeven expressie.
LookupSet Functie	Retourneert een set waarden uit een gegevensset voor een opgegeven expressie.
Multilookup functie	Retourneert de set first-match-waarden voor een set namen uit een gegevensset die naam-/waardeparen bevat.

Terug naar boven

Sort-afhankelijke waarden ophalen

De volgende ingebouwde functies retourneren de eerste, laatste of vorige waarde binnen een bepaald bereik. Deze functies zijn afhankelijk van de sorteervolgorde van de gegevenswaarden. Gebruik deze functies bijvoorbeeld om de eerste en laatste waarden op een pagina te vinden en zo een koptekst in woordenlijststijl te maken. Gebruik Vorige om een waarde in één rij te vergelijken met de waarde van de vorige rij binnen een specifiek bereik, bijvoorbeeld om percentagewaarden van jaar tot jaar in een tabel te zoeken.

Function	Beschrijving
Eerste	Retourneert de eerste waarde in het opgegeven bereik van de opgegeven expressie.
laatste	Retourneert de laatste waarde in het opgegeven bereik van de opgegeven expressie.
Previous	Retourneert de waarde of de opgegeven samengestelde waarde voor het vorige exemplaar van een item binnen de gespecificeerde reikwijdte.

Terug naar boven

Serveraggregaties ophalen

Met de volgende ingebouwde functie worden aangepaste aggregaties opgehaald van de gegevensprovider. Met behulp van een Analysis Services-gegevensbrontype kunt u bijvoorbeeld aggregaties ophalen die worden berekend op de gegevensbronserver voor gebruik in een groepskoptekst.

Function	Beschrijving
Aggregaat	Retourneert een aangepaste statistische functie van de opgegeven expressie, zoals gedefinieerd door de gegevensprovider.

Terug naar boven

Testen voor reikwijdte

De volgende ingebouwde functie test of de huidige context van een rapportitem een onderdeel is van een specifieke scope.

Functie	Description
InScope	Hiermee wordt aangegeven of het huidige exemplaar van een item binnen het opgegeven bereik valt.

Terug naar boven

Recursief niveau ophalen

Met de volgende ingebouwde functie wordt het huidige niveau opgehaald wanneer een recursieve hiërarchie wordt verwerkt. Gebruik het resultaat van deze functie met de eigenschap Opvulling in een tekstvak om het inspringniveau van een visuele hiërarchie voor een recursieve groep te bepalen. Zie Recursieve hiërarchiegroepen maken (Report Builder en SSRS) voor meer informatie.

Functie	Description
Niveau	Retourneert het huidige diepteniveau in een recursieve hiërarchie.

Terug naar boven

Verwante inhoud

• Gebruik van expressies in rapporten (Report Builder en SSRS)
• Voorbeelden van expressies (Report Builder en SSRS)
• Expressiebereik voor totalen, aggregaties en ingebouwde verzamelingen (Report Builder en SSRS)