Utilizarea parametrilor în rapoarte

Articol
03/10/2022
5 minute de lectură

Utilizați parametrii în rapoarte pentru a controla datele preluate solicitându-i utilizatorului o valoare sau un set de valori atunci când utilizatorul rulează raportul. Interogarea setului de date preia numai datele solicitate de către utilizator. De asemenea, puteți adăuga parametri ascunși și speciali în rapoartele care nu-i solicită utilizatorului date de intrare, dar pot fi utilizate pentru operațiuni precum filtrarea datelor și drill-through dinamic.

Hinweis

Lungimea maximă a valorilor de parametru transmise de la Microsoft Dynamics 365 Customer Engagement (on-premises) este de 2.000 de caractere. De exemplu, dacă rulați un raport și creați un filtru de date prin interfața utilizator Găsire complexă, expresia de filtrare rezultată care este transmisă unui parametru de filtrare nu poate depăși 2.000 de caractere. Nu există o limită maximă a numărului de parametri pe care-i puteți specifica. Cu toate acestea, poate fi nevoie să limitați lungimea șirului pe linia URL și numărul de parametri, pentru a satisface cerințele unui anumit browser.

Adăugarea de parametri

Puteți adăuga parametri la un raport pentru a defini parametrii individuali ai unui raport, a trece informații printr-o interogare sau a oferi acces la setările de utilizator, cum ar fi parametrii CRM_CurrencySymbol și CRM_CurrencyPositivePattern.

<ReportParameter> este un element din fișierul de definiție raport (RDL) care este folosit pentru a descrie un parametru individual în raport. <QueryParameter> conține informații despre un parametru individual transmis sursei de date ca parte a unei interogări. Următorul cod XML preluat din fișierul RDL al raportului Rezumat cont demonstrează cum se utilizează parametrii ReportParameter și 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>

Următoarele exemple arată cum să utilizați parametrii QueryParameter și ReportParameter într-un raport bazat pe Fetch.

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

Parametri ascunși

Proiectantul de rapoarte din Visual Studio are suport încorporat pentru parametrii ascunși. În plus, puteți ascunde parametrii adăugând un prefix CRM_ la numele parametrului dintr-un raport. În mod implicit, parametrii cu un prefix CRM sunt ascunși atunci când raportul este publicat. Atunci când rulați raportul, nu vi se solicită să introduceți valori de parametru pentru parametrii ascunși.

Parametri speciali

Tabelul următor prezintă parametrii speciali ascunși pe care-i puteți utiliza în rapoarte.

Parametru	Descriere
`CRM_FilterText`	Conține valoarea textului filtru creat în mod interactiv de un utilizator de raport în Vizualizatorul de rapoarte, atunci când utilizatorul rulează un raport. Parametrul este într-o casetă text de rezumat filtru, care se află în antetul raportului. Valoarea inițială este setată la filtrul implicit.
`CRM_URL`	Setați la URL-ul aplicației. Utilizați acest parametru atunci când detaliați.
`CRM_FilteredEntity`	Utilizați într-o expresie de interogare pentru a activa pre-filtrarea datelor (prin Găsire complexă).

Trebuie să creați toți parametrii dintr-un raport înainte de a putea face referire la ei. Valorile acestor parametri speciali sunt completate de către Customer Engagement (on-premises) atunci când rulați raportul.

Parametri de formatare suplimentari

Tabelul următor conține parametrii suplimentari pe care-i puteți utiliza în rapoarte. Printre ei sunt parametrii care oferă acces la informațiile Setări de număr ale utilizatorului. Puteți utiliza aceste valori pentru a formata și a afișa valorile numerice. Acești parametri sunt similari cu valorile specificate în Clasa NumberFormatInfo. Utilizați acești parametri în rapoarte particularizate, pentru a formata datele în funcție de setările utilizatorilor.

Parametru	Descriere
`CRM_FullName`	Numele complet al utilizatorului în numele căruia rulează raportul.
`CRM_UserTimeZone`	Numele fusului orar al utilizatorului, de exemplu, Pacific, oră standard.
`CRM_UILanguageId`	Setările locale (LCID) ale utilizatorului.
`CRM_YearStartWeekCode`	Prima săptămână a anului folosit în aplicațiile Dynamics 365 for Customer Engagement.
`CRM_WeekStartDayCode`	Prima zi a săptămânii folosite în Customer Engagement.
`CRM_FiscalCalendarStart`	Data de început a anului fiscal folosit în Customer Engagement.
`CRM_FiscalPeriodType`	Specifică cum se împarte anul fiscal — Trimestrial, Lunar, Anual și așa mai departe.
`CRM_FiscalYearDisplayCode`	Specifică dacă numele exercițiului financiar este afișat pe baza datei de început sau de sfârșit a exercițiului financiar.
`CRM_FiscalYearPeriodConnect`	Specifică modalitatea de conectare a exercițiului financiar și a perioadei fiscale atunci când se afișează împreună.
`CRM_FiscalYearFormat`	Specifică cum va fi afișat numele anului fiscal.
`CRM_FiscalPeriodFormat`	Specifică cum se va afișa perioada fiscală.
`CRM_FiscalYearPrefixFormat`	Specifică dacă un prefix este atașat la exercițiul financiar când este afișat.
`CRM_FiscalYearSuffixFormat`	Specifică dacă un sufix este atașat la exercițiul financiar când este afișat.
`CRM_CurrencyDecimalPrecision`	Precizia zecimală a monedei.
`CRM_CurrencySymbol`	Simbolul monetar al organizației.
`CRM_CurrencyPositivePattern`	Modelul de format pentru valori monetare pozitive.
`CRM_CurrencyNegativePattern`	Modelul de format pentru valori monetare negative.
`CRM_NumberDecimalDigits`	Numărul de zecimale de utilizat în valorile numerice.
`CRM_NumberDecimalSeperator`	Șirul folosit ca separator zecimal în valorile numerice.
`CRM_NumberNegativePattern`	Modelul de format pentru valori numerice negative.
`CRM_NumberGroupSizes`	Numărul de cifre din fiecare grup din partea stângă a zecimalei în valorile numerice.
`CRM_NumberGroupSeperator`	Șirul care separă grupurile de cifre din partea stângă a zecimalei în valorile numerice.
`CRM_DateSeparator`	Șirul care separă componentele unei date, cum ar fi anul, luna și ziua.
`CRM_TimeSeparator`	Șirul care separă componentele unei ore, cum ar fi ora, minutele și secundele.
`CRM_AMDesignator`	Șirul care separă componentele unei ore, cum ar fi ora, minutele și secundele
`CRM_PMDesignator`	Indicatorul pentru ore care sunt „postmeridiane” (PM).
`CRM_ShortDatePattern`	Modelul de format pentru o valoare de dată scurtă, asociată cu modelul de format „d”.
`CRM_LongDatePattern`	Modelul de format pentru o valoare de dată lungă, asociată cu modelul de format „D”.
`CRM_ShortTimePattern`	Modelul de format pentru o valoare de oră scurtă, asociată cu modelul de format „t”.
`CRM_MonthDayPattern`	Modelul de format pentru valorile lună și zi, care sunt asociate cu modelele de format „m” și „M”.

Consultați și

Ghid raportare și analiză
Publicare rapoarte