Utilizzare i parametri nei report

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.

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 Visual Studio dispone di un supporto incorporato per i parametri nascosti. È inoltre possibile nascondere i parametri aggiungendo un prefisso CRM_ al nome dei parametri in un report. Per impostazione predefinita, i parametri con un prefisso CRM_ sono nascosti quando il report viene pubblicato. 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 Customer Engagement (on-premises) 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.

Vedi anche

Guida alla creazione di report e analisi
Pubblicare report