Bruge parametre i rapporter

Artikel
12/13/2024

Du bruger parametre i rapporter til at styre de data, som er hentet ved at bede brugeren om at angive en værdi eller et sæt værdier, når brugeren kører rapporten. Datasætforespørgslen henter kun de data, der forespørges af brugeren. Du kan også tilføje skjulte og særlige parametre i de rapporter, som ikke beder brugeren om input, men som kan bruges til handlinger, som f.eks datafiltrering og dynamisk visning af detaljer.

Bemærk

Maksimumlængden af parameterværdier, der overføres fra Microsoft Dynamics 365 Customer Engagement (on-premises), er 2.000 tegn. Hvis du for eksempel kører en rapport og opretter et datafilter via brugergrænsefladen Avanceret søgning, kan det resulterende filterudtryk, der overføres til en filterparameter, ikke være længere end 2.000 tegn. Der er ingen maksimumgrænse for, hvor mange parametre du kan angive. Men du skal muligvis begrænse længden af strengen på URL-linjen og antallet af parametre for at overholde kravene for en bestemt browser.

Tilføje parametre

Du kan tilføje parametre i en rapport for at definere en rapports individuelle parametre, overføre oplysninger via en forespørgsel eller give adgang til brugerindstillinger, f.eks parametrene CRM_CurrencySymbol og CRM_CurrencyPositivePattern.

<ReportParameter> er et element i rapportdefinitionsfilen (RDL), der bruges til at beskrive en individuel parameter i rapporten. <QueryParameter> indeholder oplysninger om en enkelt parameter, der overføres til datakilden som led i en forespørgsel. Følgende XML-kode, som er hentet fra RDL-filen for rapporten Firmaopsummering, viser, hvordan du bruger parametrene ReportParameter og 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ølgende eksempler viser, hvordan du bruger parametrene QueryParameter og ReportParameter i en Fetch-baseret 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>

Skjulte parametre

Rapportdesigner i Visual Studio har indbygget understøttelse af skjulte parametre. Derudover kan du skjule parametre ved at føje et CRM_ prefix til parameternavnet i en rapport. Som standard er parametre med et CRM_ prefix skjult, når rapporten publiceres. Når du kører rapporten, bliver du ikke bedt om at angive parameterværdier for de skjulte parametre.

Særlige parametre

Følgende tabel viser de særlige skjulte parametre, som du kan bruge i rapporter.

Parameter	Beskrivelse
`CRM_FilterText`	Indeholder værdien for filterteksten, som en rapportbruger opretter interaktivt i Report Viewer, når brugeren kører en rapport. Parameteren er i et tekstfelt i en filteroversigt, som findes i rapporten overskrift. Den første værdi er angivet til standardfilteret.
`CRM_URL`	Angivet til URL-adressen for appen. Brug denne parameter, når du får vist detaljer.
`CRM_FilteredEntity`	Bruges i et forespørgselsudtryk for at aktivere forudfiltrering af data (via Avanceret søgning).

Du skal oprette alle parametre i en rapport, før du kan referere til dem. Værdierne af disse særlige parametre udfyldes af Customer Engagement (on-premises), når du kører rapporten.

Yderligere formatparametre

Følgende tabel indeholder flere parametre, som du kan bruge i rapporterne. Bl.a. parametre, der giver adgang til oplysninger om brugerens nummerindstillinger. Du kan bruge disse værdier til at formatere og få vist de numeriske værdier. Disse parametre svarer til de værdier, der er angivet i NumberFormatInfo-klassen. Brug parametrene i brugerdefinerede rapporter til at formatere dataene i henhold til brugerindstillingerne.

Parameter	Beskrivelse
`CRM_FullName`	Det fulde navn for den bruger, på hvis vegne rapporten kører.
`CRM_UserTimeZone`	Brugerens tidszonenavn, f.eks. Pacific normaltid.
`CRM_UILanguageId`	Brugerens aktuelle landestandard (LCID).
`CRM_YearStartWeekCode`	Den første uge af året, der bruges i Dynamics 365 til Customer Engagement-apps.
`CRM_WeekStartDayCode`	Den første dag i ugen, der bruges i Customer Engagement.
`CRM_FiscalCalendarStart`	Startdatoen for regnskabsåret, der bruges i Customer Engagement.
`CRM_FiscalPeriodType`	Angiver, hvordan regnskabsåret er opdelt: kvartalsvist, månedligt, årligt osv.
`CRM_FiscalYearDisplayCode`	Angiver, om navnet på regnskabsåret vises, på basis af hvornår regnskabsåret starter, eller hvornår det slutter.
`CRM_FiscalYearPeriodConnect`	Angiver, hvordan regnskabsåret og regnskabsperioden er tilknyttet, når de vises sammen.
`CRM_FiscalYearFormat`	Angiver, hvordan navnet på regnskabsåret bliver vist.
`CRM_FiscalPeriodFormat`	Angiver, hvordan regnskabsperioden bliver vist.
`CRM_FiscalYearPrefixFormat`	Angiver, om der er vedhæftet et præfiks til regnskabsåret, når det vises.
`CRM_FiscalYearSuffixFormat`	Angiver, om der er vedhæftet et suffiks til regnskabsåret, når det vises.
`CRM_CurrencyDecimalPrecision`	Decimalnøjagtigheden for valuta.
`CRM_CurrencySymbol`	Organisationens valutasymbol.
`CRM_CurrencyPositivePattern`	Formatmønsteret for positive valutaværdier.
`CRM_CurrencyNegativePattern`	Formatmønsteret for negative valutaværdier.
`CRM_NumberDecimalDigits`	Antallet af decimalpladser, der skal bruges i numeriske værdier.
`CRM_NumberDecimalSeperator`	Den streng, der bruges som decimalseparator i numeriske værdier.
`CRM_NumberNegativePattern`	Formatmønsteret for negative numeriske værdier.
`CRM_NumberGroupSizes`	Antallet af decimaler i hver gruppe til venstre for decimalsymbolet i numeriske værdier.
`CRM_NumberGroupSeperator`	Den streng, der adskiller grupper af cifre til venstre for decimalsymbolet i numeriske værdier.
`CRM_DateSeparator`	Den streng, der adskiller komponenterne i en dato, f.eks år, måned og dag.
`CRM_TimeSeparator`	Den streng, der adskiller komponenterne i et klokkeslæt, f.eks timer, minutter og sekunder.
`CRM_AMDesignator`	Den streng, der adskiller komponenterne i et klokkeslæt, f.eks timer, minutter og sekunder
`CRM_PMDesignator`	Betegnelsen for timer, der er "post meridiem" (PM).
`CRM_ShortDatePattern`	Formatmønsteret for en kort datoværdi, der er knyttet til formatmønsteret "d".
`CRM_LongDatePattern`	Formatmønsteret for en lang datoværdi, der er knyttet til formatmønsteret "D".
`CRM_ShortTimePattern`	Formatmønsteret for en kort klokkeslætsværdi, der er knyttet til formatmønsteret "t".
`CRM_MonthDayPattern`	Formatmønsteret for måneds- og ugedagsværdier, der er knyttet til formatmønstrene "m" og "M".

Se også

Vejledning til rapportering og analyser
Udgivelse af rapporter

Del via