Partajați prin

Utilizarea parametrilor în rapoarte

  • Articol

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.

Notă

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 de utilizator Advanced Find , expresia de filtru rezultată care este transmisă unui parametru de filtru 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, puteți transmite informații printr-o interogare sau puteți oferi acces la setările utilizatorului, cum ar fi parametrii CRM_CurrencySymbol și CRM_CurrencyPositivePattern .

<ReportParameter> este un element din fișierul de definire a raportului (RDL) care este utilizat pentru a descrie un parametru individual din raport. <QueryParameter> conține informații despre un parametru individual care este transmis către sursă de date ca parte a unei interogări. Următorul cod XML preluat din fișierul RDL al raportului Rezumatul contului demonstrează cum să utilizați 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

Designerul 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 prefiltrarea datelor (prin Găsire avansată).

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 care este utilizată în aplicațiile Dynamics 365 for Customer Engagement.
CRM_WeekStartDayCode Prima zi a săptămânii care este utilizată în Customer Engagement.
CRM_FiscalCalendarStart Data de începere pentru exercițiu financiar care este utilizată î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 de raportare și analiză
Publicați rapoarte