Bruge parametre i rapporter

 

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

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

Dette emne indeholder

Tilføje parametre

Skjulte parametre

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 Microsoft Visual Studio har indbygget understøttelse af skjulte parametre. Derudover kan du skjule parametre ved at tilføje en CRM_ prefix til parameteren navn i en Microsoft Dynamics 365-rapport. Som standard er parametre med et CRM_ prefix skjult, når rapporten publiceres via Microsoft Dynamics 365. 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 Rapportfremviser, 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 Microsoft Dynamics 365-webprogrammet. Brug denne parameter, når du får vist detaljer i Microsoft Dynamics 365.
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 Microsoft Dynamics 365, 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 i året, der bruges i Microsoft Dynamics CRM 2013.
CRM_WeekStartDayCode	Den første dag i ugen, der bruges i CRM 2013.
CRM_FiscalCalendarStart	Startdatoen for regnskabsåret, der bruges i CRM 2013.
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_DateSeperator	Den streng, der adskiller komponenterne i en dato, f.eks år, måned og dag.
CRM_TimeSeperator	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å

Rapportskrivning med CRM 2015 til det lokale miljø
Arbejde med SQL-baserede rapporter (CRM kun i det lokal miljø)
Udgivelse af rapporter

© 2016 Microsoft Corporation. Alle rettigheder forbeholdes. Ophavsret