• Artículo

Función Union (Generador de informes 3.0 y SSRS)

Devuelve la unión de todos los valores numéricos no NULL especificados por la expresión, que se evalúa en el ámbito especificado.

Nota

Puede crear y modificar las definiciones de informe (.rdl) en el Generador de informes 3.0 y en el Diseñador de informes en Business Intelligence Development Studio. 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 3.0 y el Administrador de informes (SSRS) en el sitio web microsoft.com.

Sintaxis

Union(expression, scope, recursive)

Parámetros

  • expression
    (SqlGeometry o SqlGeography). Expresión en la que se lleva a cabo la agregación.

  • 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.

  • recursive
    (Tipo enumerado) (opcional). Simple (predeterminado) o RdlRecursive. Especifica si se debe realizar la agregación de forma recursiva.

Tipo devuelto

Devuelve un objeto espacial, SqlGeometry o SqlGeography, basado en el tipo de expresión. Para obtener más información acerca de los tipos de datos espaciales SqlGeometry y SqlGeography, vea Tipos de datos espaciales.

Comentarios

El conjunto de datos especificado en la expresión debe tener el mismo tipo de datos.

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. No se admiten los ámbitos de conjunto de datos. 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, Previous o RunningValue.

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

Para obtener más información, vea Referencia a funciones de agregado (Generador de informes 3.0 y SSRS) y Descripción del ámbito de expresión para totales, agregados y colecciones integradas (Generador de informes 3.0 y SSRS).

Para obtener más información acerca de los agregados recursivos, vea Crear grupos de jerarquía recursiva (Generador de informes 3.0 y SSRS).

Ejemplo

En la tabla siguiente se muestran ejemplos de las expresiones SqlGeometry y la expresión de resultado de Union, mostrados en formato de texto bien conocido (WKT, Well Known Text) para los datos espaciales.

Campo con datos espaciales

Ejemplo

Resultado de UNION

[PointLocation]

POINT(1 2)

POINT(3 4)

MULTIPOINT((1 2), (3 4))

[PathDefinition]

LINESTRING(1 2, 3 4)

LINESTRING(5 6, 7 8)

MULTILINESTRING((7 8, 5 6), (3 4, 1 2))

[PolygonDefinition]

POLYGON((1 2, 3 4, 5 2, 1 2))

POLYGON((-1 2, -3 4, -5 2, -1 2))

MULTIPOLYGON(((1 2, 5 2, 3 4, 1 2)), ((-5 2, -1 2, -3 4, -5 2)))

 
=Union(Fields!PointLocation.Value)
=Union(Fields!PathDefinition.Value)
=Union(Fields!PolygonDefinition.Value, "Group1")