Usar parámetros en informes

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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

En este tema

Agregar parámetros

Parámetros ocultos

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 los 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 Microsoft 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 Microsoft Dynamics 365. De forma predeterminada, los parámetros con un CRM_ prefix están ocultos cuando se publica el informe a través de Microsoft Dynamics 365. 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 web de Microsoft Dynamics 365. Use este parámetro al realizar el informe detallado en Microsoft Dynamics 365.
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 Microsoft Dynamics 365 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	Primera semana del año que se usa en Microsoft Dynamics 365.
CRM_WeekStartDayCode	Primer día de la semana que se usa en Dynamics 365.
CRM_FiscalCalendarStart	Fecha de inicio del año fiscal que se usa en Dynamics 365.
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_DateSeperator	Cadena que separa los componentes de una fecha, como el año, el mes y el día.
CRM_TimeSeperator	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".

Ver también

Informes y análisis con Dynamics 365
Trabajar con informes basados en SQL (solo Dynamics 365 local)
Publicación de informes

© 2017 Microsoft. Todos los derechos reservados. Copyright