Parameetrite kasutamine aruannetes
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 täpsema otsingu kasutajaliidese 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ääs kasutajasätetele (nt CRM_CurrencySymbol
ja CRM_CurrencyPositivePattern
parameetritele).
ReportParameter <> on aruande määratlus (RDL) faili element, mida kasutatakse aruande üksiku parameetri kirjeldamiseks. QueryParameter <> sisaldab teavet üksiku parameetri kohta, mis edastatakse andmeallikas päringu osana. 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 |
Rakendusekomplektis Dynamics 365 for Customer Engagement kasutatava aasta esimene nädal. |
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
Tagasiside
https://aka.ms/ContentUserFeedback.
Varsti tulekul: 2024. aasta jooksul tühistame GitHubi probleemide funktsiooni sisutagasiside mehhanismina ja asendame selle uue tagasisidesüsteemiga. Lisateabe saamiseks vtEsita ja vaata tagasisidet