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.

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.

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.

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