Parameters in rapporten gebruiken

Artikel
12/13/2024

U gebruikt parameters in rapporten om de gegevens te controleren die door een rapport zijn opgehaald door de gebruiker te vragen om een waarde of een reeks waarden wanneer de gebruiker het rapport uitvoert. De gegevenssetquery haalt alleen de gegevens op die door de gebruiker worden aangevraagd. U kunt ook verborgen en speciale parameters in de rapporten toevoegen die niet de gebruiker vragen om invoer, maar voor bewerkingen zoals gegevensfiltering en dynamische detailanalyse worden gebruikt.

Notitie

De maximale lengte van de parameterwaarden die vanuit Microsoft Dynamics 365 Customer Engagement (on-premises) worden doorgegeven, is 2.000 tekens. Als u bijvoorbeeld een rapport uitvoert en een gegevensfilter maakt door de gebruikersinterface Geavanceerd zoeken, dan zal de resulterende filterexpressie die wordt doorgegeven aan een filterparameter niet groter dan 2.000 tekens zijn. Er is geen maximumlimiet op het aantal parameters dat u kunt specificeren. U moet echter de lengte van de tekenreeks in de URL-regel en het aantal parameters mogelijkerwijs eerst beperken om aan de vereisten van een afzonderlijke browser te voldoen.

Parameters toevoegen

U kunt parameters toevoegen aan een rapport om de afzonderlijke parameters van een rapport te bepalen, gegevens door te voeren naar een query, of toegang te verschaffen tot gebruikersinstellingen zoals CRM_CurrencySymbol en CRM_CurrencyPositivePattern-parameters.

De <ReportParameter> is een element in het rapportdefinitiebestand dat wordt gebruikt om een afzonderlijke parameter in het rapport te beschrijven. De <QueryParameter> bevat informatie over een afzonderlijke parameter die wordt doorgegeven aan de gegevensbron als onderdeel van een query. De volgende XML-code die uit het RDL-bestand van het accountoverzichtsrapport wordt gehaald RDL toont hoe u de ReportParameter en QueryParameter parameters kunt gebruiken.

<ReportParameter Name="CRM_FilteredAccount">  
  <DataType>String</DataType>  
    <Nullable>true</Nullable>  
    <DefaultValue>  
      <Values>  
         <Value>select * from FilteredAccount</Value>  
      </Values>  
    </DefaultValue>  
    <AllowBlank>true</AllowBlank>  
    <Prompt>CRM_FilteredAccount</Prompt>  
</ReportParameter>

<Query>  
   <rd:UseGenericDesigner>true</rd:UseGenericDesigner>  
   <CommandText>declare @sql as nVarchar(max)  
      set @sql = '  
      SELECT top 10 CAST(accountid as nvarchar(100)) as AccountID,  
      name, '''' as None  
      FROM (' + @FilteredAccount + ') as fa'  
      exec(@sql)  
   </CommandText>  
   <QueryParameters>  
      <QueryParameter Name="@FilteredAccount">  
         <Value>=Parameters!FilteredAccount.Value</Value>  
      </QueryParameter>  
   </QueryParameters>  
   <DataSourceName>CRM</DataSourceName>  
</Query>

De volgende voorbeelden tonen hoe u de parameters van QueryParameter en ReportParameter in een op Fetch gebaseerd rapport kunt gebruiken.

<ReportParameter Name="FilteredAccount">  
      <DataType>String</DataType>  
      <Prompt>Filtered Account</Prompt>  
            <DefaultValue>  
                  <Values>  
                        <Value>  
                              <fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">  
                              <entity name="account">  
                              <all-attributes/>  
                              </entity>  
                              </fetch>  
                        </Value>  
                  </Values>  
            </DefaultValue>  
    </ReportParameter>

<Query>  
        <DataSourceName>DataSource1</DataSourceName>  
        <CommandText>  
                  <fetch>   
                  <entity name="account" enableprefiltering="true" prefilterparametername="FilteredAccount">  
                  <attribute name="accountid" />  
                  <attribute name="name" />  
                  </entity>  
                  </fetch>  
            </CommandText>  
        <QueryParameters>  
          <QueryParameter Name="FilteredAccount">  
            <Value>=Parameters!FilteredAccount.Value</Value>  
          </QueryParameter>  
        </QueryParameters>  
        <rd:UseGenericDesigner>true</rd:UseGenericDesigner>  
      </Query>

Verborgen parameters

De rapportontwerper in Visual Studio heeft ingebouwde ondersteuning voor verborgen parameters. U kunt ook parameters verbergen door een CRM_-prefix toe te voegen aan de parameternaam in een rapport. Gewoonlijk worden de parameters met een CRM_-prefix verborgen wanneer het rapport wordt gepubliceerd. Wanneer u het rapport uitvoert, wordt u niet gevraagd om parameterwaarden voor de verborgen parameters in te voeren.

Speciale parameters

De volgende tabel toont de speciale verborgen parameters die u in uw rapporten kunt gebruiken.

Parameter	Beschrijving
`CRM_FilterText`	Bevat de waarde van de filtertekst die een rapportgebruiker interactief maakt in de Report Viewer wanneer de gebruiker een rapport uitvoert. De parameter is een tekstvak voor een filteroverzicht dat zich in de rapportkoptekst bevindt. De initiële waarde wordt ingesteld in het standaardfilter.
`CRM_URL`	Stel deze in op de URL van de app. Gebruik deze parameter bij het in detail analyseren.
`CRM_FilteredEntity`	Gebruik in een query-expressie om gegevens in te schakelen voor voorfilteren (met Geavanceerd zoeken).

U moet alle parameters in een rapport maken voordat u ernaar kunt verwijzen. De waarden van deze speciale parameters worden ingevuld door Customer Engagement (on-premises) wanneer u het rapport uitvoert.

Extra indelingparameters

De volgende tabel bevat aanvullende verborgen parameters die u in de rapporten kunt gebruiken. Onder deze parameters zijn er die toegang hebben tot de informatie over gebruikersaantalinstellingen. U kunt deze waarden gebruiken om de indeling en de opmaak van de numerieke waarden te bepalen. Deze parameters zijn vergelijkbaar met waarden die zijn opgegeven in Numberformatinfoklasse. Gebruik deze parameters in aangepaste rapporten om de gegevens volgens de gebruikersinstellingen in te delen.

Parameter	Beschrijving
`CRM_FullName`	De volledige naam van de gebruiker voor wie het rapport wordt uitgevoerd.
`CRM_UserTimeZone`	De tijdzonenaam van de gebruiker, bijvoorbeeld, Pacific Standard Time.
`CRM_UILanguageId`	Huidige landinstellingen (LCID) van de gebruiker.
`CRM_YearStartWeekCode`	De eerste week van het jaar die wordt gebruikt in Dynamics 365 for Customer Engagement-apps.
`CRM_WeekStartDayCode`	De eerste dag van de week die in Customer Engagement wordt gebruikt.
`CRM_FiscalCalendarStart`	De begindatum voor het fiscale jaar dat in Customer Engagement wordt gebruikt.
`CRM_FiscalPeriodType`	Geeft aan hoe het fiscale jaar is verdeeld, driemaandelijks, maandelijks, jaarlijks enzovoort.
`CRM_FiscalYearDisplayCode`	Geeft aan of de naam van het fiscale jaar wordt weergegeven op basis van de datum waarop het fiscale jaar begint, respectievelijk eindigt.
`CRM_FiscalYearPeriodConnect`	Geeft aan hoe het fiscale jaar en de boekingsperiode zijn verbonden wanneer ze samen zijn weergegeven.
`CRM_FiscalYearFormat`	Geeft aan hoe de naam van het fiscale jaar wordt weergegeven.
`CRM_FiscalPeriodFormat`	Geeft aan hoe de naam van de boekingsperiode wordt weergegeven.
`CRM_FiscalYearPrefixFormat`	Geeft aan of een voorvoegsel aan het fiscale jaar wordt gekoppeld wanneer deze wordt weergegeven.
`CRM_FiscalYearSuffixFormat`	Geeft aan of een achtervoegsel aan het fiscale jaar wordt gekoppeld wanneer deze wordt weergegeven.
`CRM_CurrencyDecimalPrecision`	Precisie van decimalen voor valuta
`CRM_CurrencySymbol`	Het valutasymbool van de organisatie.
`CRM_CurrencyPositivePattern`	Het indelingpatroon voor positieve valutawaarden.
`CRM_CurrencyNegativePattern`	Het indelingpatroon voor negatieve valutawaarden.
`CRM_NumberDecimalDigits`	Het aantal decimale plekken die numerieke waarden kunnen worden gebruikt.
`CRM_NumberDecimalSeperator`	De tekenreeks die als scheidingsbalk voor decimalen in numerieke waarden wordt gebruikt.
`CRM_NumberNegativePattern`	Het indelingpatroon voor negatieve numerieke waarden.
`CRM_NumberGroupSizes`	Het aantal cijfers in elke groep links van de decimale in numerieke waarden.
`CRM_NumberGroupSeperator`	De tekenreeks die groepen getallen links van de decimale in numerieke waarden scheidt.
`CRM_DateSeparator`	De tekenreeks die de onderdelen van een datum, zoals jaar, maand en dag worden scheidt.
`CRM_TimeSeparator`	De tekenreeks die de onderdelen van tijd, zoals uren, minuten en seconden scheidt.
`CRM_AMDesignator`	De tekenreeks die de onderdelen van tijd, zoals uren, minuten en seconden scheidt
`CRM_PMDesignator`	De aanduiding voor uren die 'post meridiem' (PM) zijn.
`CRM_ShortDatePattern`	Het indelingpatroon voor een korte datumwaarde die met het indelingpatroon 'd' is gekoppeld.
`CRM_LongDatePattern`	Het indelingpatroon voor een lange datumwaarde die met het indelingpatroon 'D' is gekoppeld.
`CRM_ShortTimePattern`	Het indelingpatroon voor een korte tijdwaarde die met het indelingpatroon 't' is gekoppeld.
`CRM_MonthDayPattern`	Het indelingpatroon voor maand- en dagwaarden die aan de indelingpatronen 'm' en 'M' zijn gekoppeld.

Zie ook

Handleiding voor rapporten en analyses
Rapporten publiceren

Delen via