Filtros de PerformancePoint Services

Artículo
09/18/2014

Última modificación: martes, 30 de agosto de 2011

Hace referencia a: SharePoint Server 2010

En este artículo
Proceso de filtrado en PerformancePoint Services
Datos del filtro
Conexiones de filtro
Controles de selección de filtro

En PerformancePoint Services de Microsoft SharePoint Server 2010, normalmente aparece un filtro en una página de panel como un control de servidor web. El control de filtro se representa en un elemento web que implementa interfaces de conexión de SharePoint estándar. El control permite a los usuarios seleccionar los valores del parámetro, que posteriormente se envían a informes y cuadros de mandos conectados.

Se aplica a: PerformancePoint Services para SharePoint Server, versión Enterprise

Para obtener más información acerca de los filtros de PerformancePoint Services, vea las siguientes secciones:

Proceso de filtrado en PerformancePoint Services
Datos del filtro
Conexiones de filtro
Controles de selección de filtro

Proceso de filtrado en PerformancePoint Services

El proceso de filtrado en un panel se lleva a cabo de la siguiente manera:

El servidor representa un elemento web de filtro en una página de panel. El elemento web hospeda un control de servidor web, como una lista o un árbol.
El proveedor de datos del filtro se conecta al origen de datos subyacente. Recupera los datos y los almacena en una tabla de datos (a la que se hace referencia como la tabla de datos de visualización).
Los datos recuperados se usan para rellenar el control de filtro.
Un usuario selecciona uno o varios valores del control de filtro y, a continuación, hace clic en Aceptar.
El proveedor de datos almacena las selecciones del usuario en una tabla de datos (a la que se hace referencia como la tabla de datos del mensaje).
El control de filtro envía los datos del mensaje (valores seleccionados por el usuario) al servidor.
El servidor recupera los resultados de la nueva consulta del origen de datos y, posteriormente, envía los datos actualizados a los consumidores de informes y cuadros de mandos.
El servidor representa los consumidores con los datos nuevos.

Nota

Los filtros también pueden enviar información de condiciones de visualización. Una condición de visualización controla la visibilidad de los consumidores conectados. Cuando una selección de filtro es igual a un valor de condición de visualización, se muestra el consumidor conectado.

Datos del filtro

Un filtro usa un proveedor de datos para administrar dos conjuntos de datos:

Los datos de visualización que se usan para definir los puntos de conexión y para rellenar el control de filtro.
Los datos del mensaje que el filtro pasa a los consumidores para representar la selección del usuario del control de filtro.

Ambos conjuntos de datos se almacenan en objetos DataTable en matrices de columnas y filas.

Datos de visualización

Los datos de visualización se usan para definir los puntos de conexión del filtro y para rellenar el control de filtro. La tabla de datos de visualización se almacena en la propiedad DisplayValues del objeto ParameterDefinition que, a su vez, se almacena en la propiedad BeginPoints del filtro. La tabla se inicializa mediante el método GetDisplayDataInternal.

La tabla de datos de visualización contiene datos del origen de datos subyacente del filtro. La propiedad CustomDefinition contiene la información necesaria para obtener los datos. Esta información puede almacenarse en un objeto como una cadena de consulta, una dirección URL o un objeto serializado. El origen de datos de destino se define en la propiedad DataSourceLocation, que puede especificar un origen de datos admitido de forma nativa o un origen de datos personalizado. Para obtener información acerca de la configuración de los datos de visualización, vea Conexiones de filtro.

Datos de mensaje

Los valores que un usuario selecciona del control de filtro se almacenan en la tabla de datos de mensaje. Los datos de mensaje se pasan en un paquete de transmisión de explorador del lado cliente y se usan como los valores del parámetro de las consultas de los consumidores de informes y cuadros de mandos conectados. Posteriormente, el servidor representa los consumidores con los datos nuevos. La tabla de datos de mensaje se devuelve mediante el método GetMessageData.

Conexiones de filtro

Los filtros son proveedores que envían datos a los consumidores de informes y cuadros de mandos conectados. Los autores de paneles definen una conexión entre un filtro y un consumidor mediante la asignación de un punto inicial de filtro a un extremo de consumidor en Diseñador de paneles de PerformancePoint. El extremo representa un parámetro de una consulta de informes o cuadros de mandos y el punto inicial representa el valor del parámetro. Por ejemplo, el filtro muestra las regiones geográficas norte, sur, este y oeste, y el informe devuelve los ingresos brutos de la región seleccionada en el filtro. En este ejemplo, la región es el parámetro de la consulta del informe (su valor no se define específicamente). El informe debe obtener el valor del parámetro que se va a usar en la consulta (norte, sur, este u oeste) del filtro.

Un objeto ParameterDefinition define el punto inicial de una conexión de filtro, incluida la tabla de datos de visualización que contiene los datos de origen del punto inicial, como los valores que rellenan el control de filtro. Se obtiene acceso a la información del punto inicial mediante la propiedad BeginPoints del filtro, que devuelve un objeto ParameterDefinitionCollection que contiene un objeto ParameterDefinition.

Nota

Los cuadros de mandos son proveedores y consumidores que pueden recibir datos de filtros y enviar datos a informes. Los puntos iniciales de filtro solo pueden contener un objeto ParameterDefinition, pero los puntos iniciales de cuadro de mandos normalmente contienen varios objetos ParameterDefinition.

Designación de los campos clave y de visualización

El proveedor de datos del filtro define cómo usar las columnas de la tabla de datos de visualización. Como mínimo, debe designar las columnas que se van a usar como campo clave y campo de visualización. (Una columna puede usarse como ambos campos.)

El campo clave contiene los valores que se van a usar como claves (localizadores de filas).
El campo de visualización contiene los valores que rellenan el control de filtro.

Además, el proveedor de datos puede definir cómo usar otras columnas de la tabla. Por ejemplo, puede definir la primera columna de la tabla como el campo clave, la segunda como el campo de visualización y omitir las otras columnas, o bien definir funcionalidades adicionales en otras columnas. Estas designaciones se definen durante el desarrollo y los autores de paneles no pueden volver a configurarlas.

Designación de los posibles puntos de conexión

Los valores que un filtro puede enviar a un consumidor se originan en una columna de la tabla de datos de visualización. El autor de paneles selecciona esta columna de origen (o columna dependiente), la cual representará el punto de conexión del filtro.

En el Diseñador de paneles, las columnas de la tabla de datos de visualización que tienen la propiedad extendida ShowColumn establecida en true se muestran a los autores de paneles como posibles puntos de conexión para el filtro. Aparecen en el cuadro Valores de origen del cuadro de diálogo Conexión o en la sección Campos disponibles del filtro en una zona de panel.

Nota

Vea el método SetColumnVisibility del tema Procedimiento para crear proveedores de datos para filtros de PerformancePoint Services para ver cómo el proveedor de datos de ejemplo establece ShowColumn en true para todas las columnas de la tabla.

Ejemplo de una conexión de filtro

En el ejemplo general se muestra cómo se usa la información del punto inicial en una conexión de filtro.

La tabla de datos de visualización define el punto inicial. Contiene tres columnas configuradas de la siguiente manera:

IdentificadorDelCliente está designado como campo clave. ShowColumn está establecida en false.
NombreParaMostrar está designado como campo de visualización. ShowColumn está establecida en true.
NombreDeCuenta no tiene designación de campo. ShowColumn está establecida en true.

Tabla 1. Tabla de datos de visualización de ejemplo

IdentificadorDelCliente (Clave)	NombreParaMostrar (Visualización)	NombreDeCuenta
19-001	Tailspin Toys	TailspinToys_R19
19-002	Wide World Importers	WideWorldImporters_R19
19-003	Wingtip Toys	WingtipToys_R19

En el Diseñador de paneles, el autor crear una conexión para un filtro y un informe en una página de panel. El filtro muestra NombreParaMostrar y NombreDeCuenta como posibles puntos de conexión debido a que la propiedad ShowColumn está establecida en true para estas dos columnas de la tabla de datos de visualización.
El autor selecciona NombreDeCuenta como el punto de conexión (o columna dependiente). Esto identifica a NombreDeCuenta como la columna de la tabla de datos de visualización que contiene los valores que el filtro puede enviar a los consumidores.
En la página de panel publicada, el control de filtro se rellena con los valores Tailspin Toys, Wide World Importers y Wingtip Toys. Estos valores se originan en la columna NombreParaMostrar porque está designada como el campo de visualización en la tabla de datos de visualización.
El usuario selecciona Wingtip Toys en el control. El proveedor de datos del filtro usa la clave correspondiente (19-003) para buscar el valor de la columna dependiente para enviar a los consumidores (WingtipToys_R19).

Controles de selección de filtro

En una página de panel de PerformancePoint Services, un elemento web de filtro hospeda un control de servidor web. El control de filtro normalmente muestra los valores de datos enumerados y permite a los usuarios de paneles seleccionar uno o varios valores. El control se rellena con datos durante el proceso de representación.

El control que un filtro usa se identifica por su clase de representador. El atributo RendererClass del archivo web.config de PerformancePoint Services especifica el control predeterminado para un tipo de filtro. Sin embargo, la propiedad RendererClassName invalida el control predeterminado para una instancia de filtro. Por lo tanto, los creadores pueden especificar un representador de tiempo de ejecución diferente en el editor de filtros.

Los filtros personalizados pueden usar un control personalizado, de terceros o uno de los siguientes controles de PerformancePoint Services:

Nota

Los controles de filtro personalizados pueden usar las clases base ParameterizableControl o ParameterSelectionControl. Se recomienda usar ParameterSelectionControl debido a que se deriva de ParameterizableControl y, asimismo, proporciona un marco de trabajo para implementar un control de selección. Esta documentación no incluye información sobre cómo crear un control personalizado, pero el proceso es similar al de creación de un representador de informes.

Al usar un control de PerformancePoint Services o un control personalizado para el filtro, debe especificar una clase de representador predeterminada en el atributo RendererClass del archivo web.config de PerformancePoint Services. Para obtener más información, vea Procedimiento para registrar manualmente las extensiones de PerformancePoint Services.