Funciones del Generador de informes: función First en 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
Devuelve el primer valor de la expresión especificada en el ámbito especificado en un informe paginado.
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.
Sintaxis
First(expression, scope)
Parámetros
expression
(Variant o Binario) Expresión en la que se lleva a cabo la agregación, por ejemplo, =Fields!FieldName.Value
.
scope
(String) Opcional. Nombre de un conjunto de datos, un grupo o una región de datos que contiene los elementos de informe a los que se va a aplicar la función de agregado. Si no se especifica el parámetro scope , se usa el ámbito actual.
Tipo de valor devuelto
Varía según el tipo de expresión.
Observaciones
La función First devuelve el primer valor de un conjunto de datos después de aplicar todos los filtros y la configuración de ordenación al ámbito especificado.
La función First solo se puede usar en expresiones de filtro de grupo con el ámbito actual (predeterminado).
También puede usar First en un encabezado de página para devolver el primer valor de la colección ReportItems de una página; esto permite generar encabezados de estilo diccionario que muestren la primera y la última entrada de cada página.
El valor de scope debe ser una constante de cadena y no puede ser una expresión. Para los agregados exteriores o los que no especifican a otros agregados, scope debe hacer referencia al ámbito actual o a un ámbito de contenido. Para los agregados de agregados, los agregados anidados pueden especificar un ámbito secundario.
Expression puede contener las llamadas a las funciones de agregados anidados con las siguientes excepciones y condiciones:
Scope , para los agregados anidados, debe ser igual que el ámbito del agregado exterior, o ser contenido por él. Para todos los ámbitos distintos de la expresión, un ámbito debe estar en una relación secundaria con respecto a todos los otros ámbitos.
Scope , para los agregados anidados, no puede ser el nombre de un conjunto de datos.
Expression no debe contener las funciones First, Last, Previouso RunningValue .
Expression no debe contener a los agregados anidados que especifican recursive.
Para más información, consulte Funciones del generador de informes - referencia de funciones de agregado (Generador de informes y SSRS) y Ámbito de expresión para los totales, agregados y colecciones integradas (Generador de informes y SSRS).
Para más información sobre los agregados recursivos, consulte Creación de un grupo de jerarquía recursiva (Generador de informes y SSRS).
Ejemplo
El siguiente ejemplo de código devuelve el primer número de producto del grupo Category
de una región de datos:
=First(Fields!ProductNumber.Value, "Category")