Compartir por

Utilizar parámetros en informes

  • Artigo

Os parámetros dos informes utilízanse para controlar os datos recuperados solicitando ao usuario un valor ou un conxunto de valores cando executa o informe. A consulta do conxunto de datos recupera só os datos que está a solicitar o usuario. Tamén pode engadir parámetros ocultos e especiais nos informes que non soliciten a intervención do usuario, pero se poidan usar para operacións como a filtraxe de datos e os informes dinámicos detallados.

Nota

A lonxitude máxima dos valores dos parámetros que se pasan de Microsoft Dynamics 365 Customer Engagement (on-premises) é de 2000 caracteres. Por exemplo, se executa un informe e crea un filtro de datos a través da interface de usuario Busca avanzada , a expresión de filtro resultante que se pasa a un parámetro de filtro non pode superar os 2.000 caracteres. Non hai límite máximo no número de parámetros que pode especificar. No entanto, é posible que deba limitar a duración da cadea na liña do URL e o número de parámetros para cumprir os requisitos dun explorador determinado.

Engadir parámetros

Podes engadir parámetros a un informe para definir os parámetros individuais dun informe, pasar información a través dunha consulta ou proporcionar acceso á configuración do usuario, como os parámetros CRM_CurrencySymbol e CRM_CurrencyPositivePattern .

O <ReportParameter> é un elemento do ficheiro de definición de informe (RDL) que se usa para describir un parámetro individual do informe. O <QueryParameter> contén información sobre un parámetro individual que se pasa ao orixe de datos como parte dunha consulta. O seguinte código XML extraído do ficheiro RDL do informe de resumo da conta mostra 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 seguintes exemplos mostran como usar os parámetros QueryParameter e ReportParameter nun informe baseado en 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 Deseñador de informes en Visual Studio ten soporte integrado para parámetros ocultos. Ademais, pode ocultar parámetros engadindo un CRM_prefix ao nome do parámetro nun informe. Por defecto, os parámetros cun CRM_prefix están ocultos cando se publica o informe. Ao executar o informe, non se lle pide que introduza os valores de parámetro dos parámetros ocultos.

Parámetros especiais

A seguinte táboa mostra os parámetros especiais ocultos que pode usar nos informes.

Parámetro Descripción
CRM_FilterText Contén o valor de texto do filtro que un usuario de informes crea de maneira interactiva no Visualizador de informes ao executar un informe. O parámetro está nunha caixa de texto de resumo do filtro que se atopa na cabeceira do informe. O valor inicial defínese segundo o filtro predefinido.
CRM_URL Defina o enderezo URL da aplicación. Utilice este parámetro ao realizar o informe detallado.
CRM_FilteredEntity Utilízase nunha expresión de consulta para activar o filtrado previo de datos (a través de Busca avanzada).

Debe crear todos os parámetros dun informe para poder consultalos. Os valores destes parámetros especiais os éncheos Customer Engagement (on-premises) cando se executa o informe.

Parámetros de formato adicionais

A seguinte táboa contén parámetros adicionais que pode usar nos informes. Entre eles están os parámetros que permiten o acceso á información de configuración do número de usuarios. Pode usar estes valores para formatar e mostrar os valores numéricos. Estes parámetros son similares aos valores especificados na Clase NumberFormatInfo. Utilice estes parámetros nos informes personalizados para dar formato aos datos segundo a configuración de usuario.

Parámetro Descripción
CRM_FullName Nome completo do usuario en nome do cal se execute o informe.
CRM_UserTimeZone Nome de zona horaria do usuario como, por exemplo, hora estándar do Pacífico.
CRM_UILanguageId Configuración rexional (LCID) actual do usuario.
CRM_YearStartWeekCode A primeira semana do ano que se usa nas aplicacións Dynamics 365 for Customer Engagement.
CRM_WeekStartDayCode O primeiro día da semana que se usa en Customer Engagement.
CRM_FiscalCalendarStart A data de inicio do ano fiscal que se usa en Customer Engagement.
CRM_FiscalPeriodType Especifica como se divide o ano fiscal: por trimestres, meses, anos, etc.
CRM_FiscalYearDisplayCode Especifica se o nome do ano fiscal se mostra en función de cando comeza ou finaliza o ano fiscal.
CRM_FiscalYearPeriodConnect Especifica como se conectan o ano fiscal e o período fiscal cando se mostran xuntos.
CRM_FiscalYearFormat Especifica como se mostrará o nome do ano fiscal.
CRM_FiscalPeriodFormat Especifica como se mostrará o período fiscal.
CRM_FiscalYearPrefixFormat Especifica se un prefixo está asociado ao año fiscal cando se mostra.
CRM_FiscalYearSuffixFormat Especifica se un sufixo está asociado ao ano fiscal cando se mostra.
CRM_CurrencyDecimalPrecision Precisión decimal da moeda.
CRM_CurrencySymbol Símbolo de moeda da organización.
CRM_CurrencyPositivePattern Modelo de formato para os valores de moeda positivos.
CRM_CurrencyNegativePattern Modelo de formato para los valores de moeda negativos.
CRM_NumberDecimalDigits O número de decimais que se usará nos valores numéricos.
CRM_NumberDecimalSeperator Cadea que se usará como separador decimal en valores numéricos.
CRM_NumberNegativePattern Modelo de formato para os valores numéricos negativos.
CRM_NumberGroupSizes Número de díxitos en cada grupo á esquerda da coma decimal en valores numéricos.
CRM_NumberGroupSeperator Cadea que separa os grupos de díxitos á esquerda da coma decimal en valores numéricos.
CRM_DateSeparator Cadea que separa os compoñentes dunha data, como o ano, o mes e o día.
CRM_TimeSeparator Cadea que separa os compoñentes da hora, como as horas, os minutos e os segundos.
CRM_AMDesignator Cadea que separa os compoñentes da hora, como las horas, los minutos y los segundos
CRM_PMDesignator Designador das horas que son "post merídiem" (p. m.).
CRM_ShortDatePattern Modelo de formato para un valor de data corta asociado ao modelo de formato "d".
CRM_LongDatePattern Modelo de formato para un valor de data longa asociado ao modelo de formato "D".
CRM_ShortTimePattern Modelo de formato para un valor de hora corto asociado ao modelo de formato "h".
CRM_MonthDayPattern Modelo de formato para os valores de mes e día asociados aos modelos de formato "m" e "M".

Consulte tamén

Guía de informes e análises
Publicar informes