Utilizzare i parametri nei report

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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.

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.

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

Vedere anche

Report e analisi con Dynamics 365
Utilizzare i report basati su SQL (solo Dynamics 365 locale)
Pubblicare report

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright