Paraméterek használata a jelentésekben

Cikk
10/31/2023

A paraméterek használata a jelentésekben azért szükséges, hogy vezérelni lehessen a beolvasott adatokat, amelyet a felhasználó a figyelmeztetést követően megad, amikor futtatja a jelentést. Az adathalmaz-lekérdezés csak a felhasználó által kért adatokat olvassa be. Rejtett és különleges paramétereket is hozzáadhat a jelentésekhez, amelyek nem figyelmeztetik a felhasználót adatbevitelre, olyan műveletekhez viszont használhatóak, mint az adatszűrés és a dinamikus részletezés.

Feljegyzés

A paraméter értékek maximális hossza, amelyek a Microsoft Dynamics 365 Customer Engagement (on-premises) alkalmazásból lettek átadva, 2000 karakter. Ha például jelentést futtat, és adatszűrőt hoz létre az Irányított keresés felhasználói felületén, a szűrőparaméternek átadott szűrőkifejezés nem lehet hosszabb 2 000 karakternél. A meghatározható paraméterek számában nincsen maximális korlátozás. Azonban előfordulhat, hogy az URL-cím sorban lévő karakterlánc hosszát, és a paraméterek számát korlátoznia kell, hogy az adott böngésző követelményeit teljesítse.

Paraméterek hozzáadása

A jelentésekhez paraméterek hozzáadásával meghatározhatja a jelentés egyes paramétereit, adatokat adhat át lekérdezésen keresztül, vagy hozzáférést biztosíthat a felhasználói beállításokhoz, például CRM_CurrencySymbol a és CRM_CurrencyPositivePattern paraméterekhez.

A <ReportParameter> a jelentésdefiníció (RDL) fájl egyik eleme, amely a jelentés egyes paramétereinek leírására szolgál. A <QueryParameter> egy lekérdezés részeként a adatforrás számára átadott egyedi paraméter adatait tartalmazza. A Fiókösszegzés jelentés RDL-fájljából vett alábbi XML-kód bemutatja a ReportParameter és QueryParameter paraméterek használatát.

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

Az alábbi példák bemutatják, hogyan használhatja az QueryParameter és ReportParameter paramétereket egy Fetch alapú jelentésben.

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

Rejtett paraméterek

A Jelentéstervező Visual Studio beépített támogatást nyújt a rejtett paraméterekhez. Továbbá elrejtheti a paramétereket a CRM_ előtag hozzáadásával a paraméter nevéhez egy jelentésben. Alapértelmezés szerint a CRM_ előtaggal rendelkező paraméterek a jelentés közzétételekor rejtettek. Amikor futtatja a jelentést, nem kap figyelmeztetést, hogy adja meg a paraméter-értékeket a rejtett paraméterekhez.

Speciális paraméterek

Az alábbi táblázat azokat a különleges rejtett paramétereket mutatja be, amelyeket a jelentésekben használhat.

Paraméter	Leírás
`CRM_FilterText`	A szűrő szövegének értékét tartalmazza, amelyet egy jelentés felhasználója interaktívan készít a Jelentésmegjelenítőben, amikor a felhasználó futtat egy jelentést. A paraméter egy szűrő összefoglaló szövegmezőjében van, amely a jelentés fejlécében található. A kezdeti érték beállítása az alapértelmezett szűrő.
`CRM_URL`	Állítsa be az alkalmazás URL-címét. Használja ezt a paramétert, amikor részletezni szeretne valamit.
`CRM_FilteredEntity`	Lekérdezési kifejezésben használva engedélyezheti az adatok előszűrését (az Irányított keresés segítségével).

Minden paramétert létre kell hoznia egy jelentésben, mielőtt hivatkozni tudna rájuk. Ezeknek a különleges paramétereknek az értékeit a Customer Engagement (on-premises) tölti ki jelentés futtatásakor.

További formátumparaméterek

Az alábbi táblázat azokat a további paramétereket tartalmazza, amelyeket a jelentésekben használhat. Ezek között vannak olyan paraméterek, amelyek hozzáférést biztosítanak a felhasználó Szám beállításainak információjához. Ezeknek az értékeknek a segítségével formázhatja, illetve megjelenítheti a numerikus értékeket. Ezek a paraméterek hasonlóak a NumberFormatInfo osztályban megadott értékekhez. Ezen paraméterek használata egyéni jelentésekben a felhasználói beállítások alapján való adatformázáshoz.

Paraméter	Leírás
`CRM_FullName`	A felhasználó teljes neve, akinek a nevében a jelentés fut.
`CRM_UserTimeZone`	A felhasználó időzónájának neve, például Csendes-óceáni téli idő.
`CRM_UILanguageId`	A felhasználó aktuális területe (LCID).
`CRM_YearStartWeekCode`	A Dynamics 365 for Customer Engagement alkalmazásokban használt év első hete.
`CRM_WeekStartDayCode`	A Customer Engagement rendszerben használt hét első napja.
`CRM_FiscalCalendarStart`	A Customer Engagement rendszerben használt pénzügyi év kezdő dátuma.
`CRM_FiscalPeriodType`	A pénzügyi év felosztását adja meg – Negyedévi, Havi, Éves és így tovább.
`CRM_FiscalYearDisplayCode`	Meghatározza, hogy a pénzügyi év neve a pénzügyi év kezdete vagy vége alapján jelenjen-e meg.
`CRM_FiscalYearPeriodConnect`	Meghatározza, hogy hogyan kell a pénzügyi év és a pénzügyi időszak nevét összekapcsolni, ha együtt jelennek meg.
`CRM_FiscalYearFormat`	Megadja, hogy a pénzügyi év neve hogyan jelenjen meg.
`CRM_FiscalPeriodFormat`	Megadja, hogy a pénzügyi időszak hogyan jelenjen meg.
`CRM_FiscalYearPrefixFormat`	Megadja, hogy legyen-e előtag csatolva a pénzügyi évhez, amikor megjelenik.
`CRM_FiscalYearSuffixFormat`	Megadja, hogy legyen-e utótag csatolva a pénzügyi évhez, amikor megjelenik.
`CRM_CurrencyDecimalPrecision`	A pénznem tizedes jegyeinek száma.
`CRM_CurrencySymbol`	A szervezet pénznem jele.
`CRM_CurrencyPositivePattern`	A formátum-minta a pozitív pénznem értékek esetén.
`CRM_CurrencyNegativePattern`	A formátum-minta a negatív pénznem értékek esetén.
`CRM_NumberDecimalDigits`	Numerikus értékekben használható tizedesjegyek száma.
`CRM_NumberDecimalSeperator`	Tizedesjegy-elválasztóként használt karakterlánc a numerikus értékekben.
`CRM_NumberNegativePattern`	A formátum-minta a negatív numerikus értékek esetén.
`CRM_NumberGroupSizes`	Az egyes csoportokban található számjegyek a tizedesjegyek bal oldalán a numerikus értékekben.
`CRM_NumberGroupSeperator`	A számjegy-csoportokat elválasztó karakterlánc a tizedesjegyek bal oldalán, a numerikus értékekben.
`CRM_DateSeparator`	A dátum összetevőit, úgy mint év, hónap és nap, elválasztó karakterlánc.
`CRM_TimeSeparator`	Az idő összetevőit, úgy mint óra, perc és másodperc, elválasztó karakterlánc.
`CRM_AMDesignator`	Az idő összetevőit, úgy mint óra, perc és másodperc, elválasztó karakterlánc
`CRM_PMDesignator`	Az óra-jelző, amely „post meridiem” (délután) (PM).
`CRM_ShortDatePattern`	A rövid dátum érték formátum-mintája, amely a „d” formátum-mintához kapcsolódik.
`CRM_LongDatePattern`	A hosszú dátum érték formátum-mintája, amely a „D” formátum-mintához kapcsolódik.
`CRM_ShortTimePattern`	A rövid idő érték formátum-mintája, amely a „t” formátum-mintához kapcsolódik.
`CRM_MonthDayPattern`	A hónap és nap értékekhez kapcsolódó formátum-minta, amely a „m” és a „M” formátum-mintához kapcsolódik.

Lásd még

Jelentéskészítési és elemzési útmutató
Jelentések közzététele

Megosztás a következőn keresztül: