Parameters in rapporten gebruiken

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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.

In dit onderwerp

Parameters toevoegen

Verborgen parameters

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 Microsoft 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 Microsoft Dynamics 365-rapport. Gewoonlijk worden de parameters met een CRM_ prefix verborgen wanneer het rapport door Microsoft Dynamics 365 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.

U moet alle parameters in een rapport maken voordat u ernaar kunt verwijzen. De waarden van deze speciale parameters worden ingevuld door Microsoft Dynamics 365 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.

Zie ook

Rapportage en analyse met Dynamics 365
Werken met op SQL gebaseerde rapporten (alleen Dynamics 365 on-premises)
Rapporten publiceren

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht