Utilizzare i parametri nei report
Data di pubblicazione: novembre 2016
Si applica a: Dynamics CRM 2015
Vengono utilizzati i parametri nei report per controllare i dati recuperati tramite la richiesta da parte dell'utente di un valore o di un set di valori quando l'utente esegue il report. La query del set di dati recupera solo i dati necessari all'utente. È inoltre possibile aggiungere i parametri nascosti e speciali nei report che non richiedano l'input da parte dell'utente, ma possono essere utilizzati per operazioni come il filtro dei dati e il drill-through dinamico.
Nota
La lunghezza massima dei valori dei parametri passato da Microsoft Dynamics 365 è 2.000 caratteri. Ad esempio, se si esegue un report e si creare un filtro di dati tramite l'interfaccia utente della Ricerca avanzata, l'espressione del filtro risultante passata a un parametro per il filtro non può superare i 2.000 caratteri. Non esiste un limite massimo nel numero dei parametri che è possibile specificare. Tuttavia, è possibile limitare la lunghezza della stringa nella riga dell'URL e il numero di parametri per soddisfare i requisiti di un browser specifico.
In questo argomento
Aggiunta parametri
Parametri nascosti
Aggiunta parametri
È possibile aggiungere parametri a un report per definire i singoli parametri di un report, passare le informazioni tramite una query, o fornire l'accesso alle impostazioni utente, ad esempio i parametri CRM_CurrencySymbol e CRM_CurrencyPositivePattern.
<ReportParameter> è un elemento nel file RDL utilizzato per descrivere un parametro singolo nel report. In <QueryParameter> sono contenute informazioni su un singolo parametro passato all'origine dati come parte di una query. Il codice XML seguente viene estratto dal file RDL del report Riepilogo account illustra come utilizzare i parametri QueryParameter e ReportParameter.
<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>
In questo esempio viene illustrato come utilizzare i parametri QueryParameter e ReportParameter nel report basato su Fetch:
<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>
Parametri nascosti
La progettazione report in Microsoft Visual Studio dispone di un supporto incorporato per i parametri nascosti. È inoltre possibile nascondere i parametri aggiungendo un CRM_ prefix al nome dei parametri in un report di Microsoft Dynamics 365. Per impostazione predefinita, i parametri con un CRM_ prefix sono nascosti quando il report viene pubblicato tramite Microsoft Dynamics 365. Quando si esegue il report, non viene richiesto di immettere i valori dei parametri per i parametri nascosti.
Parametri speciali
Nella tabella seguente sono indicati i parametri nascosti speciali che è possibile utilizzare nei report.
Parametro |
Descrizione |
---|---|
CRM_FilterText |
Contiene il valore del testo di filtro che un utente del report crea in modo interattivo nel Visualizzatore report quando l'utente esegue un report. Il parametro si trova in una casella di testo riepilogativa dei filtri disponibile nell'intestazione dl report. Il valore iniziale è impostato sul filtro predefinito. |
CRM_URL |
Impostare l'URL dell'applicazione Web Microsoft Dynamics 365. Utilizzare questo parametro quando si esegue il drill-through in Microsoft Dynamics 365. |
CRM_FilteredEntity |
Utilizzare in un'espressione query per abilitare il filtro preliminare dei dati (in Ricerca avanzata). |
È necessario creare i parametri in un report prima di poter fare riferimento a questo. I valori di questi parametri speciali sono inseriti da Microsoft Dynamics 365 quando si esegue il report.
Parametri del formato aggiuntivi
Nella tabella seguente sono contenuti altri parametri che è possibile utilizzare nei report. Tra loro sono presenti i parametri che consentono di accedere alle informazioni relative alle impostazioni del numero utente. È possibile utilizzare questi valori per formattare e visualizzare i valori numerici. Questi parametri sono simili ai valori specificati in Classe NumberFormatInfo. Utilizzare questi parametri nei report personalizzati per formattare i dati in base alle impostazioni utente.
Parametro |
Descrizione |
---|---|
CRM_FullName |
Il nome completo dell'utente al nome del quale si sta eseguendo il report. |
CRM_UserTimeZone |
Nome del fuso orario dell'utente, ad esempio, ora solare Pacifico. |
CRM_UILanguageId |
Impostazioni locali correnti (LCID) dell'utente. |
CRM_YearStartWeekCode |
La prima settimana dell'anno utilizzata in Microsoft Dynamics CRM 2013. |
CRM_WeekStartDayCode |
Il primo giorno della settimana utilizzato in CRM 2013. |
CRM_FiscalCalendarStart |
La data di inizio dell'anno fiscale utilizzata in CRM 2013. |
CRM_FiscalPeriodType |
Specifica come viene diviso l'anno fiscale, in trimestri, mesi, anni e così via. |
CRM_FiscalYearDisplayCode |
Specifica la modalità di denominazione dell'anno fiscale, ovvero in base alla data di inizio o alla data di fine. |
CRM_FiscalYearPeriodConnect |
Specifica come sono connessi l'anno fiscale e il periodo fiscale quando vengono visualizzati insieme. |
CRM_FiscalYearFormat |
Specifica come verrà visualizzato il nome dell'anno fiscale. |
CRM_FiscalPeriodFormat |
Specifica come verrà visualizzato il nome del periodo fiscale. |
CRM_FiscalYearPrefixFormat |
Specifica se il prefisso è collegato all'anno fiscale quando viene visualizzato. |
CRM_FiscalYearSuffixFormat |
Specifica se il suffisso è collegato all'anno fiscale quando viene visualizzato. |
CRM_CurrencyDecimalPrecision |
La precisione decimale della valuta. |
CRM_CurrencySymbol |
Il simbolo di valuta dell'organizzazione. |
CRM_CurrencyPositivePattern |
Il modello del formato per i valori di valuta positivi. |
CRM_CurrencyNegativePattern |
Il modello del formato per i valori di valuta negativi. |
CRM_NumberDecimalDigits |
Il numero di posizioni decimali da utilizzare nei valori numerici. |
CRM_NumberDecimalSeperator |
La stringa utilizzata come separatore decimale nei valori numerici. |
CRM_NumberNegativePattern |
Il modello del formato per i valori numerici negativi. |
CRM_NumberGroupSizes |
Il numero di cifre in ogni gruppo a sinistra dei decimali in valori numerici. |
CRM_NumberGroupSeperator |
La stringa che separa i gruppi di cifre a sinistra dei decimali in valori numerici. |
CRM_DateSeperator |
La stringa che separa i componenti di una data, ad esempio, anno, mese e giorno. |
CRM_TimeSeperator |
La stringa che separa i componenti dell'ora, ad esempio, ora, minuti e secondi. |
CRM_AMDesignator |
La stringa che separa i componenti dell'ora, ad esempio, ora, minuti e secondi |
CRM_PMDesignator |
L'identificatore delle ore pomeridiane. |
CRM_ShortDatePattern |
Il modello del formato per un valore di data breve associato al modello del formato "d". |
CRM_LongDatePattern |
Il modello del formato per un valore di data lungo associato al modello del formato "D". |
CRM_ShortTimePattern |
Il modello del formato per un valore di ora breve associato al modello del formato "t". |
CRM_MonthDayPattern |
Il modello del formato per i valori di giorno e di mese associati ai modelli del formato "m" e "M". |
Vedere anche
Scrittura dei report di CRM 2015 locale
Utilizzare i report basati su SQL (solo CRM locale)
Pubblicare report
© 2016 Microsoft Corporation. Tutti i diritti sono riservati. Copyright