Del via


Bruge parametre i rapporter

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