Använda parametrar i rapporter

2025-05-21

Du använder parametrar i rapporter för att styra vilka data som hämtas genom att be användaren om ett värde eller en uppsättning värden när användaren kör rapporten. Datamängdsfrågan hämtar endast de data som begärs av användaren. Du kan också lägga till dolda och speciella parametrar i rapporterna som inte uppmanar användaren att ange indata, men som kan användas för åtgärder som datafiltrering och dynamisk detaljgranskning.

Anmärkning

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

Lägga till parametrar

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

<ReportParameter> är ett element i rapportdefinitionsfilen (RDL) 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. Följande XML-kod som hämtas från RDL-filen i rapporten Kontosammanfattning 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>

I följande exempel visas 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 har inbyggt stöd för dolda parametrar. Dessutom kan du dölja parametrar genom att lägga till ett CRM_ prefix till parameternamnet i en rapport. Som standard är parametrarna med ett CRM_ prefix dolda när rapporten publiceras. När du kör rapporten uppmanas du inte att ange parametervärden för de dolda parametrarna.

Särskilda parametrar

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

Parameter	Beskrivning
`CRM_FilterText`	Innehåller värdet för den filtertext som en rapportanvändare interaktivt skapar i rapportvisaren när användaren kör en rapport. Parametern finns i en textruta för filtersammanfattning som finns i rapporthuvudet. Det ursprungliga värdet är inställt på standardfiltret.
`CRM_URL`	Inställt på URL för appen. Använd den här parametern när du borrar igenom.
`CRM_FilteredEntity`	Använd i ett frågeuttryck för att aktivera förfiltrering av data (via Avancerad sökning).

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

Ytterligare formatparametrar

Följande tabell innehåller ytterligare parametrar som du kan använda i rapporterna. Bland dem finns parametrar som ger åtkomst till informationen om användarnummerinställningar. Du kan använda dessa värden för att formatera och visa numeriska värden. Dessa parametrar liknar de värden som anges i klassen NumberFormatInfo. Använd dessa parametrar i anpassade rapporter för att formatera data enligt användarinställningarna.

Parameter	Beskrivning
`CRM_FullName`	Det fullständiga namnet på den användare för vars räkning rapporten körs.
`CRM_UserTimeZone`	Användarens tidszonsnamn, 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 for Customer Engagement-appar.
`CRM_WeekStartDayCode`	Den första dagen i veckan som används i Customer Engagement.
`CRM_FiscalCalendarStart`	Startdatumet för räkenskapsåret som används i Customer Engagement.
`CRM_FiscalPeriodType`	Anger hur räkenskapsåret delas upp – kvartalsvis, månadsvis, årligen och så vidare.
`CRM_FiscalYearDisplayCode`	Anger om räkenskapsårets namn ska visas baserat på när räkenskapsåret börjar eller när det slutar.
`CRM_FiscalYearPeriodConnect`	Anger hur räkenskapsåret och räkenskapsperioden är sammankopplade när de visas tillsammans.
`CRM_FiscalYearFormat`	Anger hur namnet på räkenskapsåret ska visas.
`CRM_FiscalPeriodFormat`	Anger hur räkenskapsperioden ska visas.
`CRM_FiscalYearPrefixFormat`	Anger om ett prefix är kopplat till räkenskapsåret när det visas.
`CRM_FiscalYearSuffixFormat`	Anger om ett suffix är kopplat till räkenskapsåret när det visas.
`CRM_CurrencyDecimalPrecision`	Decimalprecisionen för valutan.
`CRM_CurrencySymbol`	Organisationens valutasymbol.
`CRM_CurrencyPositivePattern`	Formatmönstret för positiva valutavärden.
`CRM_CurrencyNegativePattern`	Formatmö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 decimalavgränsare i numeriska värden.
`CRM_NumberNegativePattern`	Formatmönstret för negativa numeriska värden.
`CRM_NumberGroupSizes`	Antalet siffror i varje grupp till vänster om decimaltecknet i numeriska värden.
`CRM_NumberGroupSeperator`	Strängen som avgränsar grupper av siffror till vänster om decimaltecknet i numeriska värden.
`CRM_DateSeparator`	Strängen som avgränsar komponenterna i ett datum, till exempel år, månad och dag.
`CRM_TimeSeparator`	Strängen som separerar komponenterna i tid, till exempel timme, minuter och sekunder.
`CRM_AMDesignator`	Strängen som separerar komponenterna i tid, till exempel timme, minuter och sekunder
`CRM_PMDesignator`	Beteckning för timmar som är ”post meridiem” (standard).
`CRM_ShortDatePattern`	Formatmönstret för ett kort datumvärde som är associerat med formatmönstret "d".
`CRM_LongDatePattern`	Formatmönstret för ett långt datumvärde som är associerat med formatmönstret "D".
`CRM_ShortTimePattern`	Formatmönster för ett kort tidsvärde som associeras med formatmönster ”t”
`CRM_MonthDayPattern`	Formatmönstret för månads- och dagvärden som är associerade med formatmönstren "m" och "M".

Se även

Guide för rapportering och analys
Publicera rapporter