Lietot parametrus atskaitēs

Raksts
03/22/2023

Parametri atskaitēs tiek lietoti, lai kontrolētu izgūtos datus, atskaites palaišanas laikā lūdzot lietotājam norādīt vērtību vai vērtību kopas. Datu kopu vaicājums izgūst tikai tos datus, ko lietotājs pieprasa. Tāpat atskaitēs varat pievienot slēptus un īpašus parametrus, kuri lietotājam neko nelūdz ievadīt, bet kurus var izmantot tādām darbībām kā datu filtrēšana un dinamiskā detalizēšana.

Piezīmes

Maksimālais parametru vērtību garums, kas tiek nodots no Microsoft Dynamics 365 Customer Engagement (on-premises), ir 2000 rakstzīmes. Piemēram, ja palaižat atskaiti un izveidojat datu filtru, izmantojot lietotāja interfeisu Detalizētā atrašana , iegūtā filtra izteiksme, kas tiek nodota filtra parametram, nedrīkst pārsniegt 2 000 rakstzīmes. Norādāmo parametru skaitam nepastāv maksimālais ierobežojums. Taču jums var nākties ierobežot virknes garumu URL rindā un parametru skaitu, lai atbilstu konkrēta pārlūka prasībām.

Parametru pievienošana

Atskaitei var pievienot parametrus, lai definētu pārskata individuālos parametrus, nodotu informāciju vaicājumam vai nodrošinātu piekļuvi lietotāja iestatījumiem, piemēram CRM_CurrencySymbol , un CRM_CurrencyPositivePattern parametriem.

ReportParameter <> ir pārskata definīcija (RDL) faila elements, kas tiek izmantots, lai aprakstītu atsevišķu parametru atskaitē. QueryParameter <> satur informāciju par atsevišķu parametru, kas tiek nodots datu avots kā vaicājuma daļa. Šis XML kods, kas ņemts no konta kopsavilkuma atskaites RDL faila, parāda, ReportParameter kā izmantot parametrus and 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>

Tālāk sniegtajos piemēros ir parādīts, QueryParameter kā izmantot parametrus ReportParameter un Fetch bāzes atskaitē.

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

Slēptie parametri

Atskaišu noformētājā Visual Studio ir iebūvēts slēpto parametru atbalsts. Turklāt jūs varat slēpt parametru, tā nosaukumam atskaitē pievienojot prefiksu CRM_. Pēc noklusējuma parametri ar prefiksu CRM_ pēc noklusējuma tiek slēpti, kad atskaite tiek publicēta. Kad palaižat atskaiti, jums netiek prasīts ievadīt parametru vērtības slēptajiem parametriem.

Īpašie parametri

Nākamajā tabulā ir parādīti īpašie slēptie parametri, kurus varat izmantot savās atskaitēs.

Parametrs	Apraksts
`CRM_FilterText`	Ietver filtra teksta vērtību, ko atskaites lietotājs interaktīvi izveido atskaišu skatītājā, kad lietotājs palaiž atskaiti. Šis parametrs ir filtra kopsavilkuma tekstlodziņā, kas atrodas atskaites virsrakstā. Sākotnējā vērtība ir iestatīta uz noklusējuma filtru.
`CRM_URL`	Iestatiet tīmekļa programmas URL. Lietojiet šo parametru, kad veicat detalizēšanu.
`CRM_FilteredEntity`	Izmantojiet vaicājuma izteiksmē, lai iespējotu datu priekšfiltrēšanu (izmantojot detalizēto atrašanu).

Lai atskaitē varētu atsaukties uz parametriem, visi parametri ir jāizveido. Šo īpašo parametru vērtības Customer Engagement (on-premises) aizpilda, kad palaižat atskaiti.

Papildu formāta parametri

Nākamajā tabulā ir ietverti papildu parametri, kurus varat izmantot atskaitēs. To vidū ir parametri, kas nodrošina piekļuvi lietotāja numuru iestatījumu informācijai. Šīs vērtības varat izmantot, lai formatētu un parādītu skaitliskās vērtības. Šie parametri ir līdzīgi vērtībām, kas norādītas NumberFormatInfo klasē. Izmantojiet šos parametrus pielāgotās atskaitēs, lai formatētu datus saskaņā ar lietotāja iestatījumiem.

Parametrs	Apraksts
`CRM_FullName`	Pilnais nosaukums tam lietotājam, kura vārdā atskaite darbojas.
`CRM_UserTimeZone`	Lietotāja laika joslas nosaukums, piemēram, Klusā okeāna standarta laiks.
`CRM_UILanguageId`	Lietotāja pašreizējā lokalizācija (LCID).
`CRM_YearStartWeekCode`	Gada pirmā nedēļa, kas tiek izmantota Dynamics 365 for Customer Engagement programmās.
`CRM_WeekStartDayCode`	Nedēļas pirmā diena, kas tiek izmantota programmā Customer Engagement.
`CRM_FiscalCalendarStart`	Programmā Customer Engagement izmantotā finanšu gads sākuma datums.
`CRM_FiscalPeriodType`	Norāda, kā tiek sadalīts finanšu gads — Reizi ceturksnī, Reizi mēnesī, Reizi gadā un tā tālāk.
`CRM_FiscalYearDisplayCode`	Norāda, vai finanšu gada nosaukums tiek parādīts, balstoties uz finanšu gada sākumu vai uz tā beigām.
`CRM_FiscalYearPeriodConnect`	Norāda, kā finanšu gads tiek saistīts ar finanšu periodu, ja tie tiek rādīti kopā.
`CRM_FiscalYearFormat`	Norāda, kā tiek rādīts finanšu gada nosaukums.
`CRM_FiscalPeriodFormat`	Norāda, ka tiek rādīts finanšu periods.
`CRM_FiscalYearPrefixFormat`	Norāda, vai finanšu gadam tiek pievienots prefikss, ja tiek rādīts finanšu gads.
`CRM_FiscalYearSuffixFormat`	Norāda, vai finanšu gadam tiek pievienots sufikss, ja tiek rādīts finanšu gads.
`CRM_CurrencyDecimalPrecision`	Valūtas decimālā precizitāte.
`CRM_CurrencySymbol`	Organizācijas valūtas simbols.
`CRM_CurrencyPositivePattern`	Pozitīvo valūtas vērtību formāta modelis.
`CRM_CurrencyNegativePattern`	Negatīvo valūtas vērtību formāta modelis.
`CRM_NumberDecimalDigits`	Ciparu skaits aiz komata, ko lietot skaitliskajās vērtībās.
`CRM_NumberDecimalSeperator`	Virkne, kas skaitliskajās vērtības tiek lietota kā decimāldaļu atdalītājs.
`CRM_NumberNegativePattern`	Negatīvo skaitlisko vērtību formāta modelis.
`CRM_NumberGroupSizes`	Skaitliskajās vērtībās izmantotais ciparu skaits katrā grupā pa kreisi no komata.
`CRM_NumberGroupSeperator`	Virkne, kas skaitliskajās vērtībās atdala ciparu grupas pa kreisi no komata.
`CRM_DateSeparator`	Virkne, kas atdala datuma komponentus, piemēram, gadu, mēnesi un dienu.
`CRM_TimeSeparator`	Virkne, kas atdala laika komponentus, piemēram, stundas, minūtes un sekundes.
`CRM_AMDesignator`	Virkne, kas atdala laika komponentus, piemēram, stundas, minūtes un sekundes
`CRM_PMDesignator`	Apzīmētājs stundām, kas ir “post meridiem” (PM).
`CRM_ShortDatePattern`	Formāta modelis saīsinātajai datuma vērtībai, kas ir saistīta ar “d” formāta modeli.
`CRM_LongDatePattern`	Formāta modelis garajai datuma vērtībai, kas ir saistīta ar “D” formāta modeli.
`CRM_ShortTimePattern`	Formāta modelis saīsinātajai laika vērtībai, kas ir saistīta ar “t” formāta modeli.
`CRM_MonthDayPattern`	Formāta modelis mēneša un dienas vērtībām, kas ir saistītas ar “m” un “M” formāta modeli.

Skatīt arī

Pārskatu un analīzes ceļvedis
Atskaišu publicēšana

Kopīgot, izmantojot