Colecciones integradas en expresiones de un informe paginado (Generador de informes)
Se aplica a: Generador de informes de Microsoft (SSRS) Power BI Report Builder Diseñador de informes en SQL Server Data Tools
En una expresión de un informe paginado, puede incluir referencias a las colecciones integradas siguientes: ReportItems, Parameters, Fields, DataSets, DataSources, Variables y a campos integrados para información global, como el nombre del informe. No todas las colecciones aparecen en el cuadro de diálogo Expresión. Las colecciones DataSets y DataSources solo están disponibles en tiempo de ejecución para los informes publicados en un servidor de informes. ReportItems es una colección de cuadros de texto situados en una región del informe; por ejemplo, los cuadros de texto de una página o de un encabezado de página.
Para más información, vea Expresiones (Generador de informes).
Nota:
Puede crear y modificar los archivos de definición de informes paginados (.rdl) en el Generador de informes de Microsoft, en Power BI Report Builder y en el Diseñador de informes de SQL Server Data Tools.
Descripción de las colecciones integradas
En la tabla siguiente se enumeran las colecciones integradas disponibles cuando se escribe una expresión. Cada fila incluye el nombre de programación que distingue mayúsculas de minúsculas para la colección. El nombre figurará si puede usar el cuadro de diálogo Expresión para agregar una referencia a la colección de forma interactiva, un ejemplo y una descripción que incluye el momento en que se inicializan y se ponen a disposición de los usuarios los valores de la colección.
Colección integrada | Categoría en el cuadro de diálogo Expresión | Ejemplo | Descripción |
---|---|---|---|
Globales | Campos integrados | =Globals.ReportName - or - =Globals.PageNumber |
Representa variables globales útiles para los informes, como el nombre del informe o el número de página. Siempre está disponible. Para obtener más información, consulte Referencias a campos globales y de usuario integrados (Generador de informes). |
User | Campos integrados | =User.UserID O bien =User.Language |
Representa una recopilación de datos acerca del usuario que ejecuta el informe, como la configuración de idioma o el identificador de usuario. Siempre está disponible. Para obtener más información, consulte Referencias a campos globales y de usuario integrados (Generador de informes). |
Parámetros | Parámetros | =Parameters("ReportMonth").Value O bien =Parameters!ReportYear.Value |
Representa la colección de parámetros de informe (pueden tener uno o varios valores). No está disponible hasta que la inicialización se ha completado. Para más información, consulte Referencias a la colección de parámetros (Generador de informes). |
Campos( <Conjunto de datos> ) | Fields | =Fields!Sales.Value |
Representa la colección de campos del conjunto de datos que están disponibles para el informe. Está disponible una vez que los datos se han recuperado desde un origen de datos en un conjunto de datos. Para obtener más información, vea Referencias a la colección de campos de conjunto de datos (Generador de informes). |
DataSets | No se muestra | =DataSets("TopEmployees").CommandText |
Representa la colección de conjuntos de datos a los que se hace referencia desde el cuerpo de una definición de informe. No incluye los orígenes de datos que solo se utilizan en encabezados o pies de página. No está disponible en el modo de vista previa local. Para obtener más información, vea Usar referencias a las colecciones DataSources y DataSets (Geerador de informes). |
DataSources | No se muestra | =DataSources("AdventureWorks2022").Type |
Representa la colección de orígenes de datos a los que se hace referencia en el cuerpo de un informe. No incluye los orígenes de datos que solo se utilizan en encabezados o pies de página. No está disponible en el modo de vista previa local. Para obtener más información, vea Usar referencias a las colecciones DataSources y DataSets (Geerador de informes). |
Variables | Variables |
=Variables!CustomTimeStamp.Value |
Representa la colección de variables de informe y de variables de grupo. Para obtener más información, consulte Referencias a las colecciones de variables de informe y de grupo (Generador de informes). |
ReportItems | No se muestra | =ReportItems("Textbox1").Value |
Representa la colección de cuadros de texto para un elemento de informe. Esta colección se puede usar para resumir los elementos de la página a fin de incluirlos en un encabezado de página o en un pie de página. Para más información, vea Usar referencias a la colección ReportItems (Generador de informes). |
Uso de la sintaxis de colección en una expresión
Si desea hacer referencia a una colección desde una expresión, puede usar la sintaxis estándar de Microsoft Visual Basic para los elementos de una colección. En la tabla siguiente se muestran ejemplos de sintaxis de colección.
Sintaxis | Ejemplo |
---|---|
Collection!ObjectName.Property | =Fields!Sales.Value |
Collection!ObjectName("Property") | =Fields!Sales("Value") |
Collection("ObjectName").Property | =Fields("Sales").Value |
Collection("Member") | =User("Language") |
Collection.Member | =User.Language |