Compartir a través de

Referencias globales y de usuarios integradas (Generador de informes y SSRS)

La colección de campos integrados, que incluye las colecciones Globals y User, representa los valores globales proporcionados por Reporting Services cuando se procesa un informe. La Globals colección proporciona valores como el nombre del informe, la hora en que se inició el procesamiento de informes y los números de página actuales para el encabezado o pie de página del informe. La User colección proporciona el identificador de usuario y la configuración de idioma. Estos valores se pueden usar en expresiones para filtrar los resultados de un informe.

Nota:

Puede crear y modificar definiciones de informe (.rdl) en el Generador de informes y en el Diseñador de informes en SQL Server Data Tools. Cada entorno de creación proporciona diferentes formas de crear, abrir y guardar informes y elementos relacionados. Para obtener más información, vea Diseñar informes en el Diseñador de informes y el Generador de informes (SSRS) en la Web en microsoft.com.

Uso de la colección Globals

La Globals colección contiene las variables globales del informe. En la superficie de diseño, estas variables aparecen con el prefijo & (y comercial); por ejemplo, [&ReportName]. En la tabla siguiente se describen los miembros de la Globals colección.

Miembro Tipo Descripción
Tiempo de ejecución DateTime Fecha y hora en que se empezó a ejecutar el informe.
Número de página Integer Número de página actual relativo a los saltos de página que restablecieron el número de página. Al principio del procesamiento del informe, el valor inicial se establece en 1. El número de página aumenta en cada página representada.

Para numerar páginas dentro de saltos de página para un rectángulo, una región de datos, un grupo de regiones de datos o un mapa, en la propiedad PageBreak, establezca la propiedad TrueResetPageNumber en . No se admite en grupos de jerarquías de columnas de Tablix.

PageNumber solo se puede usar en una expresión en un encabezado de página o pie de página.
CarpetaDeInformes String Ruta de acceso completa a la carpeta en la que se halla el informe. Esto no incluye la dirección URL del servidor de informes.
NombreDelInforme String Nombre del informe tal como se almacena en la base de datos del servidor de informes.
ReportServerUrl String Dirección URL del servidor de informes en el que se ejecuta el informe.
TotalPages Integer Número total de páginas relativas a saltos de página que restablecen PageNumber. Si no se establecen saltos de página, este valor es el mismo que OverallTotalPages.

TotalPages solo se puede usar en una expresión en un encabezado de página o pie de página.
PageName String Nombre de la página. Al principio del procesamiento del informe, el valor inicial se establece desde InitialPageName, una propiedad de informe. A medida que se procesa cada elemento de informe, este valor se reemplaza por el valor correspondiente de PageName de un rectángulo, una región de datos, un grupo de regiones de datos o un mapa. No se admite en grupos de jerarquías de columnas de Tablix.

PageName solo se puede usar en una expresión en un encabezado de página o pie de página.
OverallPageNumber Integer Número de página de la página actual para el informe completo. Este valor no se ve afectado por ResetPageNumber.

OverallPageNumber solo se puede usar en una expresión en un encabezado de página o pie de página.
OverallTotalPages Integer Número total de páginas de todo el informe. Este valor no se ve afectado por ResetPageNumber.

OverallTotalPages solo se puede usar en una expresión en un encabezado de página o pie de página.
RenderFormat RenderFormat Información sobre la solicitud de representación actual.

Para obtener más información, vea "RenderFormat" en la sección siguiente.

Los miembros de la Globals colección devuelven una variante. Si desea usar un miembro de esta colección en una expresión que requiere un tipo de datos específico, primero deberá convertir la variable. Por ejemplo, para convertir los datos de tipo variant de la fecha y hora de ejecución a formato de fecha, utilice =CDate(Globals!ExecutionTime). Para obtener más información, vea Tipos de datos en expresiones (Generador de informes y SSRS).

RenderFormat

En la tabla siguiente se describen los miembros de RenderFormat.

Miembro Tipo Descripción
Nombre String Nombre del representador como registrado en el archivo de configuración RSReportServer.

Está disponible durante el ciclo de procesamiento o representación de partes concretas del informe.
IsInteractive Boolean Si la solicitud de representación actual usa un formato de representación interactivo.
DeviceInfo Colección nombre/valor de solo lectura Pares clave-valor para los parámetros deviceinfo de la solicitud de representación actual.

Los valores de cadena se pueden especificar utilizando la clave o un índice en la colección.

Ejemplos

En los ejemplos siguientes se muestra cómo usar una referencia a la Globals colección en una expresión:

  • Esta expresión, ubicada en un cuadro de texto en el pie de página de un informe, devuelve el número de página y el número total de páginas del informe:

    =Globals.PageNumber & " of " & Globals.TotalPages

  • Esta expresión devuelve el nombre del informe y la hora a la que se ejecutó. La hora se presenta con la cadena de formato de .NET Framework de Microsoft para fechas cortas:

    =Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")

  • Esta expresión, colocada en el cuadro de diálogo Visibilidad de columna para una columna seleccionada, muestra la columna solo cuando el informe se exporta a Excel. De lo contrario, la columna está oculta.

    EXCELOPENXML hace referencia al formato de Excel que se incluye en Office 2007. EXCEL hace referencia al formato de Excel que se incluye en Office 2003.

    =IIF(Globals!RenderFormat.Name = "EXCELOPENXML" OR Globals!RenderFormat.Name = "EXCEL", false, true)

Uso de la colección de usuarios

La User colección contiene datos sobre el usuario que ejecuta el informe. Puede usar esta colección para filtrar los datos que aparecen en un informe, por ejemplo, mostrando solo los datos del usuario actual o para mostrar el UserID, por ejemplo, en un título de informe. En la superficie de diseño, estas variables aparecen con el prefijo & (y comercial); por ejemplo, [&UserID].

En la tabla siguiente se describen los miembros de la User colección.

Miembro Tipo Descripción
Language String Idioma del usuario que ejecuta el informe. Por ejemplo: en-US.
UserID String Identificador del usuario que ejecuta el informe. Si usa la autenticación de Windows, este valor es la cuenta de dominio del usuario actual. El valor viene determinado por la extensión de seguridad de Reporting Services, que puede usar la autenticación de Windows o la autenticación personalizada.

Para obtener más información sobre cómo admitir varios lenguajes en un informe, vea "Consideraciones de diseño de soluciones para implementaciones multilingües o globales" en la documentación de Reporting Services en los Libros en pantalla de SQL Server.

Uso de la configuración regional

Puede usar expresiones para hacer referencia a la configuración regional de un equipo cliente a través del User.Language valor para determinar cómo aparece un informe al usuario. Por ejemplo, puede crear un informe que utilice una expresión de consulta diferente basada en el valor de configuración regional. La consulta puede cambiar para recuperar información localizada de una columna diferente en función del idioma devuelto. También se puede utilizar una expresión en la configuración de idioma del informe o elementos del informe basados en esta variable.

Nota:

Aunque es posible cambiar la configuración de idioma de un informe, es preciso ser muy consciente de los problemas de visualización que esto puede provocar. Por ejemplo, si se cambia la configuración regional de un informe, puede cambiar no solo el formato de fecha del informe, sino también el formato de moneda. A menos que exista algún proceso de conversión de moneda, este cambio puede provocar que el informe muestre un símbolo de moneda incorrecto. Para evitar esta situación, establezca la información de idioma en cada uno de los elementos que desee cambiar, o establezca el elemento con los datos de moneda en un idioma determinado.

Identificación de ID de usuario para informes de instantáneas o historial

En algunos casos, los informes que incluyen la variable User!UserID no mostrarán los datos específicos del informe para el usuario actual que está viendo el informe.

Véase también

Expresiones (Generador de informes y SSRS)
Expresión (cuadro de diálogo del Generador de informes)
Tipos de datos en expresiones (Generador de informes y SSRS)
Aplicar formato a números y fechas (Generador de informes y SSRS)
Ejemplos de expresiones (Generador de informes y SSRS)

  • Last updated on