Parameetrite kasutamine aruannetes

Artikkel
10/31/2023

Parameetreid kasutatakse aruannetes hangitavate andmete juhtimiseks, küsides kasutajalt väärtust või väärtuste kogumit, kui kasutaja aruande käivitab. Andmekogumi päring toob ainult kasutaja soovitud andmed. Aruandesse saab lisada ka peidetud ja spetsiaalseid parameetreid, mis kasutaja sisendit ei küsi, kuid mida saab kasutada toimingute puhul nagu andmete filtreerimine ja dünaamiline süvitsiminek.

Märkus.

Microsoft Dynamics 365 Customer Engagement (on-premises)-ist edastatavate parameetriväärtuste maksimaalne pikkus on 2000 märki. Näiteks kui käivitate aruande ja loote kasutajaliidese Täpsem otsing kaudu andmefiltri, ei tohi filtriparameetrile edastatav filtriavaldis ületada 2,000 märki. Määratavate parameetrite arv ei ole piiratud. Kuid URL-i real oleva stringi pikkust ja parameetrite arvu võib olla vaja piirata konkreetse brauseri nõuete täitmiseks.

Parameetrite lisamine

Saate aruandele lisada parameetreid, et määratleda aruande üksikud parameetrid, edastada päringu kaudu teavet või anda juurdepääsu kasutajasätetele, näiteks CRM_CurrencySymbol parameetritele ja CRM_CurrencyPositivePattern parameetritele.

Aruandeparameeter <> on aruande definitsiooni (RDL) faili element, mida kasutatakse aruande üksiku parameetri kirjeldamiseks. QueryParameter <> sisaldab teavet üksiku parameetri kohta, mis edastatakse päringu osana andmeallikas-le. Järgmine XML-kood, mis on võetud konto kokkuvõtte aruande RDL-failist, näitab, kuidas parameetreid ja ReportParameter parameetreid kasutada 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>

Järgmistes näidetes on näidatud, kuidas kasutada parameetrit QueryParameter and ReportParameter põhinevas Fetch aruandes.

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

Peidetud parameetrid

Aruandekujundajal Visual Studio on sisseehitatud varjatud parameetrite tugi. Lisaks saab parameetri peita, lisades aruandes parameetri nimele eesliite CRM_. Parameetrid eesliitega CRM_ on aruande avaldamisel vaikimisi peidetud. Kui käivitate aruande, siis ei paluta teil peidetud parameetrite väärtusi sisestada.

Spetsiaalsed parameetrid

Järgmises tabelis on näidatud spetsiaalsed peidetud parameetrid, mida aruannetes kasutada saab.

Parameeter	Kirjeldus
`CRM_FilterText`	Sisaldab filtri teksti väärtust, mille kasutaja aruande käitamisel interaktiivselt aruandevaaturis loob. Parameeter on aruande päises asuval filtri kokkuvõtte tekstiväljal. Algväärtuseks on määratud vaikefilter.
`CRM_URL`	Määrake parameetriks veebirakenduse URL. Kasutage seda parameetrit süvitsi minekuks.
`CRM_FilteredEntity`	Kasutage päringuavaldises andmete eelfiltreerimise lubamiseks (täpsema otsingu kaudu).

Peate looma aruandes kõik parameetrid, enne kui saate neile viidata. Customer Engagement (on-premises) lisab nende spetsiaalsete parameetrite väärtused aruande käitamisel.

Täiendavad vorminguparameetrid

Järgmises tabelis on lisaparameetrid, mida aruannetes kasutada saab. Nende hulgas on parameetrid, mis annavad juurdepääsu kasutaja numbrisätete teabele. Neid väärtusi saab kasutada arvväärtuste vormindamiseks ja kuvamiseks. Need parameetrid on sarnased klassis NumberFormatInfo määratud väärtustega. Kasutage neid parameetreid kohandatud aruannetes andmete vormindamiseks kasutaja sätete kohaselt.

Parameeter	Kirjeldus
`CRM_FullName`	Kasutaja, kelle nimel aruanne töötab, täisnimi.
`CRM_UserTimeZone`	Kasutaja ajavööndi nimi, näiteks, Vaikse ookeani standardaeg.
`CRM_UILanguageId`	Kasutaja pragune lokaat (LCID).
`CRM_YearStartWeekCode`	Aasta esimene nädal, mida kasutatakse dynamics 365 for Customer Engagementi rakendustes.
`CRM_WeekStartDayCode`	Nädala esimene päev, mida Customer Engagement-is kasutatakse.
`CRM_FiscalCalendarStart`	Customer Engagement-is kasutatava finantsaasta alguskuupäev.
`CRM_FiscalPeriodType`	Määrab, kuidas majandusaasta jagatakse – kvartaliteks, kuudeks, aastateks ja nii edasi.
`CRM_FiscalYearDisplayCode`	Määrab, kas finantsaasta nimi kuvatakse finantsaasta alguse või lõpu alusel.
`CRM_FiscalYearPeriodConnect`	Määrab, kuidas finantsaasta ja -periood koos kuvamisel ühendatakse.
`CRM_FiscalYearFormat`	Määrab, kuidas finantsaasta nimi kuvatakse.
`CRM_FiscalPeriodFormat`	Määrab, kuidas finantsperiood kuvatakse.
`CRM_FiscalYearPrefixFormat`	Määrab, kas finantsaastale lisatakse kuvamisel eesliide.
`CRM_FiscalYearSuffixFormat`	Määrab, kas finantsaastale lisatakse kuvamisel järelliide.
`CRM_CurrencyDecimalPrecision`	Valuuta kümnendkohaline täpsus.
`CRM_CurrencySymbol`	Organisatsiooni valuutatähis.
`CRM_CurrencyPositivePattern`	Positiivsete valuutaväärtuste vormingumuster.
`CRM_CurrencyNegativePattern`	Negatiivsete valuutaväärtuste vormingumuster.
`CRM_NumberDecimalDigits`	Arvväärtustes kasutatav kümnendkohtade arv.
`CRM_NumberDecimalSeperator`	String, mida kasutatakse arvväärtuste kümnendkoha eraldajana.
`CRM_NumberNegativePattern`	Negatiivsete arvväärtuste vormingumuster.
`CRM_NumberGroupSizes`	Numbrikohtade arv igas arvväärtuse kümnendkohtade eraldajast vasakule jäävas rühmas.
`CRM_NumberGroupSeperator`	String, mis eraldab arvväärtuse kümnendkohtade eraldajast vasakul olevad numbrirühmad.
`CRM_DateSeparator`	String, mis eraldab kuupäeva komponendid (nt aasta, kuu ja päeva).
`CRM_TimeSeparator`	String, mis eraldab ajakomponendid (nt tunnid, minutid ja sekundid).
`CRM_AMDesignator`	String, mis eraldab ajakomponendid (nt tunnid, minutid ja sekundid)
`CRM_PMDesignator`	Tähis „post meridiem” (PM) tundide kohta.
`CRM_ShortDatePattern`	Lühikese kuupäevaväärtuse vormingumuster, mis on seotud vormingumustriga „d”.
`CRM_LongDatePattern`	Pika kuupäevaväärtuse vormingumuster, mis on seotud vormingumustriga „D”.
`CRM_ShortTimePattern`	Lühikese kellaajaväärtuse vormingumuster, mis on seotud vormingumustriga „t”.
`CRM_MonthDayPattern`	Kuu- ja päevaväärtuste vormingumuster, mis on seotud vormingumustritega „m” ja „M”.

Vt ka

Aruandluse ja analüüsi juhend
Aruannete avaldamine