Compartir a través de


Función de agregado (Generador de informes y SSRS)

Devuelve un agregado personalizado de la expresión especificada, según esté definido en el proveedor de datos.

[!NOTA]

Puede crear y modificar las 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 varias maneras de crear, abrir y guardar informes y elementos relacionados. Para obtener más información, vea la información sobre el diseño de informes en el Generador de informes y el Administrador de informes (SSRS) en el sitio web microsoft.com.

Sintaxis

Aggregate(expression, scope)

Parámetros

  • expression
    Expresión en la que se lleva a cabo la agregación. La expresión debe ser una referencia de campo sencilla.

  • scope
    (String). 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. Scope debe ser una constante de cadena yno puede ser una expresión. Si no se especifica el parámetro scope, se usa el ámbito actual.

Tipo devuelto

El tipo de valor devuelto viene determinado por el proveedor de datos. Devuelve el valor Nothing si el proveedor de datos no admite esta función o no hay datos disponibles.

Comentarios

La función Aggregate proporciona una manera de utilizar los agregados que se calculan en el origen de datos externo. La extensión de datos determina la compatibilidad con esta característica. Por ejemplo, la extensión de procesamiento de datos Analysis Services de SQL Server recupera los conjuntos de filas planas de una consulta MDX. Algunas filas del conjunto de resultados pueden contener valores agregados calculados en el servidor del origen de datos. Estos se conocen como agregados de servidor. Para ver los agregados de servidor en el diseñador gráfico de consultas para Analysis Services, puede usar el botón Mostrar agregaciones de la barra de herramientas. Para obtener más información, vea Interfaz de usuario del Diseñador de consultas MDX de Analysis Services (Generador de informes).

Cuando se muestra la combinación de valores agregados y valores de conjunto de datos de detalle en las filas de detalles de una región de datos Tablix, normalmente no se incluyen los agregados de servidor porque no son datos de detalle. Sin embargo, es probable que desee mostrar todos los valores recuperados para el conjunto de datos y personalizar la forma en que se calculan y se muestran los datos agregados.

Reporting Services detecta el uso de la función Aggregate en las expresiones del informe y con ello determina si debe mostrar los agregados de servidor en las filas de detalles. Si incluye Aggregate en una expresión en una región de datos, los agregados de servidor solo podrán aparecer en las filas de total de grupo o en las filas de total general, no en las filas de detalles. Si desea mostrar los agregados de servidor en las filas de detalles, no use la función Aggregate.

Para cambiar este comportamiento predeterminado, cambie el valor de la opción Interpretar los subtotales como filas de detalles en el cuadro de diálogo Propiedades del conjunto de datos. Si esta opción se establece en True, todos los datos, incluidos los agregados de servidor, aparecen como datos de detalle. Si se establece en False, los agregados de servidor aparecen como totales. El valor de esta propiedad afecta a todas las regiones de datos que están vinculadas a este conjunto de datos.

[!NOTA]

Todos los grupos contenedores del elemento de informe que hacen referencia a Aggregate deben incluir referencias de campo sencillas en sus expresiones de grupo; por ejemplo, [FieldName]. No puede usar Aggregate en una región de datos que usa expresiones de grupo complejas. Para la extensión de procesamiento de datos de SQL ServerAnalysis Services, la consulta debe incluir campos MDX de tipo LevelProperty (no MemberProperty) para admitir la agregación mediante la función Aggregate.

Expression puede contener 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, Previous o RunningValue.

  • Expression no debe contener a los agregados anidados que especifican recursive.

Para obtener más información, vea Referencia a las 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 obtener más información acerca de los agregados recursivos, vea Crear grupos de jerarquía recursiva (Generador de informes y SSRS).

Diferencias entre las funciones Aggregate y Sum

La función Aggregate difiere de las funciones de agregado numéricas como Sum en que Aggregate devuelve un valor calculado por el proveedor de datos o por la extensión de procesamiento de datos. Las funciones de agregado numéricas como Sum devuelven un valor calculado por el procesador de informes en un conjunto de datos perteneciente al conjunto de datos determinado por el parámetro scope. Para obtener más información, vea las funciones de agregado incluidas en Referencia a las funciones de agregado (Generador de informes y SSRS).

Ejemplo

El ejemplo de código siguiente muestra una expresión que recupera un agregado de servidor para el campo LineTotal. La expresión se agrega a una celda de una fila que pertenece al grupo GroupbyOrder.

=Aggregate(Fields!LineTotal.Value, "GroupbyOrder")

Vea también

Referencia

Ejemplos de expresiones (Generador de informes y SSRS)

Conceptos

Usar expresiones en informes (Generador de informes y SSRS)

Tipos de datos en expresiones (Generador de informes y SSRS)

Ámbito de expresión para los totales, agregados y colecciones integradas (Generador de informes y SSRS)