Usar parâmetros em relatórios

Use os parâmetros nos relatórios para controlar os dados recuperados, solicitando ao usuário um valor ou um conjunto de valores quando ele executar o relatório. A consulta do conjunto de dados recupera apenas os dados que são pedidos pelo usuário. Você também pode adicionar parâmetros especiais e ocultos nos relatórios que não solicitam o usuário pela entrada, mas pode ser usado para operações como filtragem de dados e detalhamento dinâmico.

Adicionando parâmetros

Você pode adicionar parâmetros a um relatório para definir os parâmetros individuais do relatório, transmitir informações através de uma consulta ou fornecer acesso às configurações do usuário, como parâmetros CRM_CurrencySymbol e CRM_CurrencyPositivePattern.

O <ReportParameter> é um elemento no arquivo de definição de relatório (RDL) que é usado para descrever um parâmetro individual no relatório. O <QueryParameter> contém informações sobre um parâmetro individual que é passado à fonte de dados como parte de uma consulta. O seguinte código XML levado do arquivo RDL do relatório Resumo da Conta demonstra como usar os parâmetros ReportParameter e 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>  

Os exemplos a seguir mostram como usar os parâmetros QueryParameter e ReportParameter em um relatório baseado em 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>  

Parâmetros ocultos

O Designer de Relatórios no Visual Studio tem suporte integrado para parâmetros ocultos. Você também pode ocultar parâmetros, adicionando um prefixo CRM_ ao nome do parâmetro em um relatório. Por padrão, os parâmetros com um prefixo CRM_ são ocultos quando o relatório é publicado. Ao executar o relatório, você não será solicitado a inserir valores de parâmetro para os parâmetros ocultos.

Parâmetros especiais

A tabela a seguir mostra os parâmetros ocultos especiais que podem ser usados nos relatórios.

Você precisa criar todos os parâmetros em um relatório antes de poder consultá-los. Os valores destes parâmetros especiais são preenchidos pelo Customer Engagement (on-premises) ao executar o relatório.

Parâmetros de formato adicionais

A tabela a seguir contém parâmetros adicionais que podem ser usados nos relatórios. Entre eles são os parâmetros que oferecem acesso às informações de configurações do Número do usuário. Você pode usar esses valores para formatar e exibir os valores numéricos. Esses parâmetros são semelhantes aos valores especificados na Classe NumberFormatInfo. Use esses parâmetros nos relatórios personalizados para formatar os dados de acordo com as configurações do usuário.

Veja também

Guia de Relatório e Análise
Publicar relatórios