Använda parametrar i rapporter

Artikel
03/22/2023

Du kan använda parametrar i rapporter för att styra den data som hämtas genom att tillfråga användaren om ett värde eller en uppsättning värden när användaren kör rapporten. Datauppsättningen fråganr endast om data som begärs av användaren. Du kan också lägga till dolda och särskilda parametrar i rapporterna som inte uppmanar användaren att infoga, men kan användas för åtgärder som t.ex. datafiltrering och dynamiska detaljer.

Kommentar

Den maximala längden på parametervärdena som skickas från Microsoft Dynamics 365 Customer Engagement (on-premises) är 2 000 tecken. Anta att du kör en rapport och skapar ett datafilter via användargränssnitt avancerad sökning kan det resulterande filteruttrycket som skickas till en filterparameter får inte överstiga 2 000 tecken. Det finns ingen maxgräns för hur många parametrar som du kan ange. Du kan emellertid behöva begränsa längden på strängen på URL:ens rad och antal parametrar för att uppfylla kraven i en viss webbläsare.

Lägga till parametrar

Du kan lägga till parametrar till en rapport för att definiera enskilda parametrar i en rapport, skicka via en fråga eller ge åtkomst till användarinställningar, till exempel CRM_CurrencySymbol och CRM_CurrencyPositivePattern-parametrar.

<ReportParameter> är ett element i RDL-filen (report definition file) som används för att beskriva en enskild parameter i rapporten. <QueryParameter> innehåller information om en enskild parameter som skickas till datakällan som en del av en fråga. I följande XML-kod från rapporten Kontosammanfattnings RDL-fil visar hur du använder parametrarna ReportParameter och QueryParameter.

<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>

Följande exempel visar hur du använder parametrarna QueryParameter och ReportParameter i en Fetch-baserad rapport.

<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>

Dolda parametrar

Rapportdesignern i Visual Studio innehåller stöd för dolda parametrar. Dessutom kan du dölja parametrar genom att lägga till prefixet CRM_ till parameternamnnet i en rapport. Som standard döljs parametrarna med prefixet CRM_ när rapporten har publicerats. När du kör rapporten ombeds du inte att ange värden för dolda parametrar.

Särskilda parametrar

I följande tabell visas de särskilda dolda parametrarna som du kan använda i dina rapporter.

Parameter	Beskrivning
`CRM_FilterText`	Innehåller ett värde av filtertexten som en rapportanvändare skapar interaktivt i rapportvisningsprogrammet när användaren kör en rapport. Parametern är i en filtersammanfattningstextruta som finns i sidhuvudet för rapporten. Det första värdet till standardfiltret.
`CRM_URL`	Inställt på URL för appen. Använd den här parametern när du går igenom.
`CRM_FilteredEntity`	Använd i ett frågeuttryck för att aktivera förfiltrering av data avancerad sökning.

Du måste skapa alla parametrar i en rapport innan du kan använda dem. Värdena för dessa särskilda parametrar fylls i Customer Engagement (on-premises) när du kör rapporten.

Ytterligare formatparametrar

I följande tabell innehåller ytterligare parametrarna som du kan använda i dina rapporter. Mellan dem är parametrar som ger åtkomst till användarens nummerinställningsinformation. Du kan använda dessa värden för att formatera och visa numeriska värden. Dessa parametrar liknar värdena i klassen NumberFormatInfo. Använd dessa parametrar i anpassade rapporter om du vill formatera data enligt användarinställningar.

Parameter	Beskrivning
`CRM_FullName`	Det fullständiga namnet på användaren som kör rapporten.
`CRM_UserTimeZone`	Användarens tidszonnamn, till exempel Pacific Standard Time.
`CRM_UILanguageId`	Aktuellt språk (LCID) för användaren.
`CRM_YearStartWeekCode`	Den första veckan på året som används i Dynamics 365 för Customer Engagement-appar.
`CRM_WeekStartDayCode`	Första dagen den veckan som används i Customer Engagement.
`CRM_FiscalCalendarStart`	Startdatum för räkenskapsåret som används i Customer Engagement.
`CRM_FiscalPeriodType`	Anger hur räkenskapsåret ska delas upp, kvartalsvis, månadsvis, årligen och så vidare.
`CRM_FiscalYearDisplayCode`	Anger om räkenskapsårets namn visas baserat på dess startdatum eller slutdatum.
`CRM_FiscalYearPeriodConnect`	Anger hur räkenskapsåret och räkenskapsperioden ska vara kopplade när de visas tillsammans.
`CRM_FiscalYearFormat`	Anger hur namnet på räkenskapsåret visas.
`CRM_FiscalPeriodFormat`	Anger hur räkenskapsperioden visas.
`CRM_FiscalYearPrefixFormat`	Anger om ett prefix läggs till räkenskapsåret när det visas.
`CRM_FiscalYearSuffixFormat`	Anger om ett suffix läggs till räkenskapsåret när det visas.
`CRM_CurrencyDecimalPrecision`	Precision för valutadecimal
`CRM_CurrencySymbol`	Organisationens valutasymbol.
`CRM_CurrencyPositivePattern`	Formatfönstret för positiva valutavärden.
`CRM_CurrencyNegativePattern`	Formatfönstret för negativa valutavärden.
`CRM_NumberDecimalDigits`	Antalet decimaler som ska användas i numeriska värden.
`CRM_NumberDecimalSeperator`	Strängen som används som decimaltecken i numeriska värden.
`CRM_NumberNegativePattern`	Formatfönstret för negativa numeriska värden.
`CRM_NumberGroupSizes`	Antal siffror i varje grupp till vänster om decimaltecknet i numeriska värden.
`CRM_NumberGroupSeperator`	Strängen som separerar grupper av siffror till vänster om decimaltecknet i numeriska värden.
`CRM_DateSeparator`	Strängen som avgränsar komponenterna i ett datum som år, månad och dag.
`CRM_TimeSeparator`	Strängen som avgränsar komponenterna i tid som timme, minuter och sekunder.
`CRM_AMDesignator`	Strängen som avgränsar komponenterna i tid som timme, minuter och sekunder.
`CRM_PMDesignator`	Beteckning för timmar som är "post meridiem" (standard).
`CRM_ShortDatePattern`	Formatmönster för ett kort datumvärde som associeras med formatmönster "d"
`CRM_LongDatePattern`	Formatmönster för ett långt datumvärde som associeras med formatmönster "D"
`CRM_ShortTimePattern`	Formatmönster för ett kort tidsvärde som associeras med formatmönster "t"
`CRM_MonthDayPattern`	Formatmönster för månads- och dagsvärden som är associerade med "m" och "M" formatmönster.

Se även

Guiden Rapportering och analyser
Publicera rapporter