Usar parámetros en informes

Artículo
12/13/2024

Los parámetros de los informes se usan para supervisar los datos recuperados solicitando al usuario un valor o un conjunto de valores cuando ejecuta el informe. La consulta del conjunto de datos recupera solo los datos que está solicitando el usuario. También puede agregar parámetros ocultos y especiales en los informes que no soliciten la intervención del usuario, pero se puedan usar para operaciones como el filtrado de datos y los informes dinámicas detallados.

Nota

La longitud máxima de los valores de los parámetros que se pasan de Microsoft Dynamics 365 Customer Engagement (on-premises) es de 2.000 caracteres. Por ejemplo, si ejecuta un informe y crea un filtro de datos mediante la interfaz de usuario de Búsqueda avanzada, expresión resultante de filtro que se pasa a un parámetro de filtro no puede exceder los 2.000 caracteres. No hay límite máximo en el número de parámetros que puede especificar. Sin embargo, es posible que deba limitar la duración de la cadena en la línea de la dirección URL y el número de parámetros para cumplir los requisitos del explorador en particular.

Agregar parámetros

Puede agregar parámetros a un informe para definir los parámetros individuales de un informe, pasar información a través de una consulta o proporcionar acceso a la configuración del usuario, como los parámetros CRM_CurrencySymbol y CRM_CurrencyPositivePattern.

<ReportParameter> es un elemento del archivo de definición de informes (RDL) que se usa para describir un parámetro individual en el informe. <QueryParameter> contiene información sobre un parámetro individual que se transfiere al origen de datos como parte de una consulta. El siguiente código XML tomado del archivo RDL del informe de resumen de cuenta demuestra cómo usar los parámetros ReportParameter y 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>

Los siguientes ejemplos muestran cómo usar los parámetros QueryParameter y ReportParameter en un informe basado 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

El diseñador de informes de Visual Studio tiene soporte integrado para parámetros ocultos. Además, puede ocultar parámetros agregando un CRM_prefix al nombre del parámetro en un informe. De forma predeterminada, los parámetros con un CRM_prefix están ocultos cuando se publica el informe. Al ejecutar el informe, no se le pide especificar los valores de parámetro de los parámetros ocultos.

Parámetros especiales

La siguiente tabla muestra los parámetros especiales ocultos que puede usar en los informes.

Parámetro	Descripción
`CRM_FilterText`	Contiene el valor de texto del filtro que un usuario de informes crea de manera interactiva en el visor de informes al ejecutar un informe. El parámetro está en un cuadro de texto de resumen del filtro que se encuentra en el encabezado del informe. El valor inicial se establece en el filtro predeterminado.
`CRM_URL`	Establezca la dirección URL de la aplicación. Use este parámetro al realizar el informe detallado.
`CRM_FilteredEntity`	Use una expresión de consulta para habilitar el prefiltrado de datos (mediante Búsqueda avanzada).

Debe crear todos los parámetros de un informe para poder consultarlos. Los valores de estos parámetros especiales los rellena Customer Engagement (on-premises) cuando se ejecuta el informe.

Parámetros de formato adicionales

La siguiente tabla contiene parámetros adicionales que puede usar en los informes. Entre ellos están los parámetros que proporcionan acceso a la información de configuración del número de usuarios. Puede usar estos valores para formatear y mostrar los valores numéricos. Estos parámetros son similares a los valores especificados en NumberFormatInfo (Clase). Use estos parámetros en los informes personalizados para dar formato a los datos según la configuración de usuario.

Parámetro	Descripción
`CRM_FullName`	Nombre completo del usuario en nombre del cual se ejecuta el informe.
`CRM_UserTimeZone`	Nombre de zona horaria del usuario como, por ejemplo, hora estándar del Pacífico.
`CRM_UILanguageId`	Configuración regional (LCID) actual del usuario.
`CRM_YearStartWeekCode`	La primera semana del año que se usa en las aplicaciones de Dynamics 365 for Customer Engagement.
`CRM_WeekStartDayCode`	Primer día de la semana que se usa en Customer Engagement.
`CRM_FiscalCalendarStart`	Fecha de inicio del año fiscal que se usa en Customer Engagement.
`CRM_FiscalPeriodType`	Especifica cómo se divide el año fiscal: por trimestres, meses, años, etc.
`CRM_FiscalYearDisplayCode`	Especifica si el nombre del año fiscal se muestra en función de cuando empieza o finaliza el año fiscal.
`CRM_FiscalYearPeriodConnect`	Especifica cómo se conectan el año fiscal y el período fiscal cuando se muestran juntos.
`CRM_FiscalYearFormat`	Especifica cómo se mostrará el nombre del año fiscal.
`CRM_FiscalPeriodFormat`	Especifica cómo se mostrará el período fiscal.
`CRM_FiscalYearPrefixFormat`	Especifica si un prefijo está asociado al año fiscal cuando se muestra.
`CRM_FiscalYearSuffixFormat`	Especifica si un sufijo está asociado al año fiscal cuando se muestra.
`CRM_CurrencyDecimalPrecision`	Precisión decimal de la divisa.
`CRM_CurrencySymbol`	Símbolo de moneda de la organización.
`CRM_CurrencyPositivePattern`	Modelo de formato para los valores positivos de divisa.
`CRM_CurrencyNegativePattern`	Modelo de formato para los valores negativos de divisa.
`CRM_NumberDecimalDigits`	El número de decimales que se usará en los valores numéricos.
`CRM_NumberDecimalSeperator`	Cadena que se usará como separador decimal en valores numéricos.
`CRM_NumberNegativePattern`	Modelo de formato para los valores numéricos negativos.
`CRM_NumberGroupSizes`	Número de dígitos en cada grupo a la izquierda de la coma decimal en valores numéricos.
`CRM_NumberGroupSeperator`	Cadena que separa los grupos de dígitos a la izquierda de la coma decimal en valores numéricos.
`CRM_DateSeparator`	Cadena que separa los componentes de una fecha, como el año, el mes y el día.
`CRM_TimeSeparator`	Cadena que separa los componentes de la hora, como las horas, los minutos y los segundos.
`CRM_AMDesignator`	Cadena que separa los componentes de la hora, como las horas, los minutos y los segundos
`CRM_PMDesignator`	Designador de horas "post merídiem" (p. m.).
`CRM_ShortDatePattern`	Modelo de formato para un valor de fecha corta asociado con el modelo de formato "d".
`CRM_LongDatePattern`	Modelo de formato para un valor de fecha larga asociado con el modelo de formato "D".
`CRM_ShortTimePattern`	Modelo de formato para un valor de hora corta asociado con el modelo de formato "h".
`CRM_MonthDayPattern`	Modelo de formato para los valores de mes y día asociados a los modelos de formato "m" y "M".

Vea también

Informes y guía de análisis
Publicación de informes

Compartir a través de