Gunakan parameter dalam laporan
Anda menggunakan parameter dalam laporan untuk mengawal data yang didapatkan semula dengan menggesa pengguna nilai atau set nilai apabila pengguna menjalankan laporan. Pertanyaan set data mendapatkan semula hanya data yang diminta oleh pengguna. Anda juga boleh menambah parameter khas dan tersembunyi dalam laporan yang tidak menggesa pengguna input tetapi boleh digunakan untuk operasi seperti penapisan data dan gerudi lalu dinamik.
Nota
Panjang maksimum nilai parameter yang dimasukkan daripada Microsoft Dynamics 365 Customer Engagement (on-premises) ialah 2,000 aksara. Contohnya, jika anda menjalankan laporan dan mencipta penapis data melalui antara muka pengguna Advanced Find , ungkapan penapis yang terhasil yang dihantar ke parameter penapis tidak boleh melebihi 2,000 aksara. Tiada had maksimum pada bilangan parameter yang boleh anda tentukan. Bagaimanapun, anda mungkin perlu mengehadkan panjang rentetan pada baris URL dan bilangan parameter untuk memenuhi keperluan pelayar tertentu.
Menambah parameter
Anda boleh menambah parameter pada laporan untuk mentakrifkan parameter individu laporan, menghantar maklumat melalui pertanyaan atau menyediakan capaian kepada seting pengguna, seperti CRM_CurrencySymbol
dan CRM_CurrencyPositivePattern
parameter.
ReportParameter <> ialah unsur dalam fail definisi laporan (RDL) yang digunakan untuk menerangkan parameter individu dalam laporan. QueryParameter <> mengandungi maklumat tentang parameter individu yang dihantar ke sumber data sebagai sebahagian daripada pertanyaan. Kod XML berikut yang diambil daripada fail RDL laporan Ringkasan Akaun menunjukkan cara menggunakan parameter dan ReportParameter
parameter 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>
Contoh berikut menunjukkan cara menggunakan QueryParameter
parameter dan parameter ReportParameter
dalam Fetch
laporan berasaskan.
<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>
Parameter tersembunyi
Pereka Laporan mempunyai Visual Studio sokongan terbina dalam untuk parameter tersembunyi. Selain itu, anda boleh menyembunyikan parameter dengan menambah awalan CRM_ pada nama parameter dalam laporan. Secara lalai, parameter dengan awalan CRM_ disembunyikan apabila laporan diterbitkan. Apabila anda menjalankan laporan, anda tidak digesa untuk memasukkan nilai parameter untuk parameter tersembunyi.
Parameter khas
Jadual berikut menunjukkan parameter tersembunyi khas yang boleh anda gunakan dalam laporan anda.
Parameter | Perihalan |
---|---|
CRM_FilterText |
Mengandungi nilai teks penapis yang pengguna laporan secara interaktif cipta dalam Pemapar Laporan apabila pengguna menjalankan laporan. Parameter dalam kotak teks ringkasan penapis yang terletak di pengepala laporan. Nilai awal ditetapkan kepada penapis lalai. |
CRM_URL |
Tetapkan kepada URL aplikasi. Gunakan parameter ini apabila menggerudi lalu. |
CRM_FilteredEntity |
Digunakan dalam ungkapan pertanyaan untuk mendayakan pra-penapisan data (melalui Advanced Find). |
Anda mesti mencipta semua parameter dalam laporan sebelum anda boleh merujuknya. Nilai parameter khas ini diisikan dengan Customer Engagement (on-premises) apabila anda menjalankan laporan.
Parameter format tambahan
Jadual berikut mengandungi parameter tambahan yang boleh anda gunakan dalam laporan anda. Di kalangannya adalah parameter yang memberi akses kepada maklumat tetapan Nombor pengguna. Anda boleh menggunakan nilai ini untuk memformat dan memaparkan nilai angka. Parameter ini serupa dengan nilai yang ditentukan dalam Kelas NumberFormatInfo. Gunakan parameter ini dalam laporan tersuai untuk memformat mengikut tetapan pengguna.
Parameter | Perihalan |
---|---|
CRM_FullName |
Nama penuh pengguna yang menjalankan laporan bagi pihaknya. |
CRM_UserTimeZone |
Nama zon masa pengguna, contohnya, Waktu Standard Pasifik. |
CRM_UILanguageId |
Tempatan semasa (LCID) pengguna. |
CRM_YearStartWeekCode |
Minggu pertama tahun yang digunakan dalam aplikasi Dynamics 365 for Customer Engagement. |
CRM_WeekStartDayCode |
Hari pertama dalam seminggu yang digunakan dalam Customer Engagement. |
CRM_FiscalCalendarStart |
Tarikh mula untuk tahun fiskal yang digunakan dalam Customer Engagement. |
CRM_FiscalPeriodType |
Menentukan cara tahun fiskal dibahagikan—Setiap Suku Tahunan, Bulanan, Tahunan dan sebagainya. |
CRM_FiscalYearDisplayCode |
Menentukan sama ada nama tahun fiskal dipaparkan berdasarkan masa tahun fiskal bermuka atau masa ia berakhir. |
CRM_FiscalYearPeriodConnect |
Menentukan cara tahun fiskal dan tempoh fiskal disambungkan apabila dipaparkan bersama. |
CRM_FiscalYearFormat |
Menentukan cara nama tahun fiskal akan dipaparkan. |
CRM_FiscalPeriodFormat |
Menentukan cara tempoh fiskal akan dipaparkan. |
CRM_FiscalYearPrefixFormat |
Menentukan sama ada awalan dilampirkan pada tahun fiskal apabila ia dipaparkan. |
CRM_FiscalYearSuffixFormat |
Menentukan sama ada akhiran dilampirkan pada tahun fiskal apabila ia dipaparkan. |
CRM_CurrencyDecimalPrecision |
Kejituan perpuluhan mata wang. |
CRM_CurrencySymbol |
Simbol mata wang organisasi. |
CRM_CurrencyPositivePattern |
Corak format untuk nilai mata wang positif. |
CRM_CurrencyNegativePattern |
Corak format untuk nilai mata wang negatif. |
CRM_NumberDecimalDigits |
Bilangan tempat perpuluhan untuk digunakan dalam nilai angka. |
CRM_NumberDecimalSeperator |
Rentetan yang digunakan sebagai pemisah perpuluhan: dalam nilai angka. |
CRM_NumberNegativePattern |
Corak format untuk nilai angka negatif. |
CRM_NumberGroupSizes |
Bilangan digit dalam setiap kumpulan ke kiri perpuluhan dalam nilai angka. |
CRM_NumberGroupSeperator |
Rentetan yang mengasingkan kumpulan digit ke kiri perpuluhan dalam nilai angka. |
CRM_DateSeparator |
Rentetan yang mengasingkan komponen tarikh, seperti tahun, bulan dan hari. |
CRM_TimeSeparator |
Rentetan yang mengasingkan komponen masa, seperti jam, minit dan saat. |
CRM_AMDesignator |
Rentetan yang mengasingkan komponen masa, seperti jam, minit dan saat |
CRM_PMDesignator |
Penanda untuk jam iaitu “post meridiem” (PM). |
CRM_ShortDatePattern |
Corak format untuk nilai tarikh pendek yang dikaitkan dengan corak format "d". |
CRM_LongDatePattern |
Corak format untuk nilai tarikh panjang dikaitkan dengan corak format "D". |
CRM_ShortTimePattern |
Corak format untuk nilai masa pendek yang dikaitkan dengan corak format "t". |
CRM_MonthDayPattern |
Corak format untuk nilai bulan dan hari yang dikaitkan dengan corak format "m" dan "M". |