Editores para objetos personalizados de PerformancePoint Services
Última modificación: martes, 30 de agosto de 2011
Hace referencia a: SharePoint Server 2010
En este artículo
Disponibilidad de controles de edición para las propiedades de objeto
Interacción con objetos de repositorio
Integración con el Diseñador de paneles
En PerformancePoint Services de Microsoft SharePoint Server 2010, la función principal de un editor personalizado es permitir a los usuarios establecer las propiedades de un objeto personalizado. Un objeto personalizado es un objeto nativo ReportView, Filter o DataSource que tiene valores personalizados definidos para sus propiedades.
Un editor se ejecuta en una instancia de aplicación de PerformancePoint Services en el servidor front-end web, normalmente como una página ASPX . Las aplicaciones web que se ejecutan en una instancia de aplicación de PerformancePoint Services y en un proceso de SharePoint se encuentran en el directorio virtual /_layouts y se instalan de forma predeterminada en la carpeta LAYOUTS en la ruta de acceso %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE.
Se aplica a: PerformancePoint Services para SharePoint Server, versión Enterprise
Nota
Un editor es un componente de una extensión de origen de datos, informe o filtro personalizados y sólo es necesario si la extensión necesita una interfaz de usuario para establecer las propiedades. Para obtener información acerca de otros componentes de la extensión, vea Escenarios de desarrollo con PerformancePoint Services.
Para permitir a los usuarios establecer las propiedades de objetos personalizados, los editores proporcionan controles de edición e interactúan con objetos del repositorio.
Disponibilidad de controles de edición para las propiedades de objeto
Un editor define las propiedades de un objeto personalizado y expone las propiedades en los controles de edición. El editor debe exponer las propiedades que desea que los usuarios puedan ver y modificar. Para obtener un ejemplo de un método que pone a disposición de un editor de informes los controles de ASP.NET, vea el método CreateChildControls en Procedimiento para crear editores de informes de PerformancePoint Services.
Nota
Diseñador de paneles de PerformancePoint proporciona los controles para las propiedades Name, Description y Owner (persona responsable) de un objeto personalizado en su ficha Propiedades.
Se recomienda el uso del ejemplo de objetos personalizados como una plantilla para el editor personalizado. Los editores de ejemplo definen los controles de ASP.NET en el marcado HTML de una página ASPX, siguiendo así la práctica del desarrollo de SharePoint de definir la lógica de negocios en una clase compilada en una DLL, en lugar de hacerlo en la clase de código subyacente usada en el desarrollo de ASP.NET. En el ejemplo también se explica cómo llamar a objetos de la DLL Microsoft.PerformancePoint.Scorecards.Client.
Interacción con objetos de repositorio
Los editores (y otras aplicaciones web personalizadas) se ejecutan en una instancia de aplicación de PerformancePoint Services en el servidor front-end web y usan los objetos BIMonitoringServiceApplicationProxy y SPDataStore en la API de PerformancePoint Services para realizar tareas de creación, lectura, actualización y eliminación, como se muestra a continuación:
Para objetos de origen de datos personalizados, use la clase BIMonitoringServiceApplicationProxy para realizar tareas de creación y actualización. Esto permite que estas tareas se realicen dentro del contexto de la aplicación de servicio de PerformancePoint Services. Las tareas de lectura (obtener) y eliminación pueden llevarse a cabo mediante BIMonitoringServiceApplicationProxy o SPDataStore. (Las aplicaciones personalizadas que se ejecutan en el servidor de aplicaciones pueden llamar a SPDataStore directamente).
Para objetos de informe y filtro personalizados, use la clase SPDataStore.
Se recomienda el uso de los objetos auxiliares incluidos con el ejemplo de objetos personalizados para realizar las operaciones en el repositorio en lugar de llamar a los objetos BIMonitoringServiceApplicationProxy y SPDataStore directamente desde el editor.
Nota
La llamada a servicios web de PerformancePoint de forma remota no es un escenario de desarrollo admitido oficialmente y no se aborda en esta documentación.
No es necesario que el editor proporcione lógica para crear objetos, ya que Diseñador de paneles está configurado para crear objetos personalizados de forma predeterminada. Sin embargo, es posible permitir a los usuarios crear objetos sin usar Diseñador de paneles. Para obtener más información, vea Creación de objetos fuera del Diseñador de paneles. Además, los objetos personalizados pueden eliminarse de Diseñador de paneles y del repositorio, por lo que también es opcional proporcionar lógica para eliminar objetos del editor.
Integración con el Diseñador de paneles
Para integrarse en la experiencia de creación del Diseñador de paneles, el editor debe poder abrirse desde un identificador uniforme de recursos (URI), y éste debe estar registrado para el objeto personalizado en el archivo web.config de PerformancePoint Services.
Para crear un objeto personalizado, Diseñador de paneles recupera los metadatos del objeto del archivo web.config de PerformancePoint Services y, posteriormente, crea el objeto como un tipo de contenido en el repositorio de PerformancePoint Services. Los orígenes de datos se crean en una biblioteca de documentos de SharePoint y los objetos de informe y filtro se crean en una lista de SharePoint. Una vez creado el objeto personalizado, el Diseñador de paneles muestra un vínculo al editor.
PerformancePoint Services usa el siguiente proceso para abrir un editor personalizado:
Cuando un usuario intenta editar un objeto personalizado desde el Diseñador de paneles (o un tipo de contenido en el repositorio), se pasa una cadena de consulta a un control de servidor web. La cadena de consulta proporciona la ubicación del objeto en el repositorio.
El control de servidor web interroga al objeto para identificar su tipo y subtipo. El subtipo del objeto indica si éste es nativo o personalizado.
Si el objeto es personalizado, el control de servidor web busca el URI del editor del objeto en el archivo web.config de PerformancePoint Services.
El control de servidor web anexa los parámetros de cadena de consulta a la ruta de acceso del editor y, a continuación, abre el editor.
Nota
Los usuarios deben actualizar la sesión de Diseñador de paneles para ver los cambios recientes efectuados en los editores personalizados.
Parámetros de cadena de consulta
PerformancePoint Services anexa los parámetros de cadena de consulta al URI de editor cuando abre un editor personalizado. En la siguiente tabla se describen los parámetros.
Tabla 1. Parámetros de cadena de consulta
Parámetro |
Descripción |
|---|---|
Operation= |
Operación que debe llevar a cabo el editor: OpenItem para recuperar un objeto del repositorio o CreateItem para crear un objeto en el repositorio. Ejemplo: ?Operation=OpenItem |
SiteCollection= |
Dirección URL de la colección de sitios. Ejemplo: &SiteCollection=http://ProductionServer |
ItemLocation= |
Ubicación del primer objeto de clase en el repositorio de PerformancePoint Services. Los objetos de origen de datos se almacenan en una biblioteca de documentos, como la Biblioteca de conexiones de datos de PerformancePoint, y todos los objetos restantes se almacenan en una lista, como la Lista de contenido de PerformancePoint. Ejemplo: &ItemLocation=/Lists/PerformancePoint%20Content/39_.000 |
Puede especificar los parámetros estáticos personalizados del editor en el archivo web.config de PerformancePoint Services. Los parámetros estáticos pasan un valor predefinido al editor cada vez que se abre. Para obtener más información acerca de cómo registrar un editor, vea Procedimiento para registrar manualmente las extensiones de PerformancePoint Services.
Como alternativa, puede hacer referencia a estos parámetros por sus constantes correspondientes en el modelo de objetos de PerformancePoint Services en lugar de usar la cadena de consulta. Estas constantes se representan por medio de los campos LaunchOperation, SiteCollectionUrl e ItemLocation de la clase ClickOnceLaunchKeys (en el espacio de nombres Microsoft.PerformancePoint.Scorecards de la DLL Microsoft.PerformancePoint.Scorecards.Client).
Nota
PerformancePoint Services también anexa el parámetro SiteLocation=, pero no es relevante para las extensiones personalizadas.
Creación de objetos fuera del Diseñador de paneles
De forma predeterminada, los usuarios solo pueden crear objetos personalizados desde el Diseñador de paneles. Dado que Diseñador de paneles crea objetos personalizados sin usar editores personalizados, sólo envía solicitudes OpenItem a los editores personalizados.
Para permitir a los usuarios crear objetos fuera del Diseñador de paneles, debe proporcionar la siguiente funcionalidad:
Lógica en el código del editor para crear objetos
Una acción que envíe una solicitud CreateItem al editor
Por ejemplo, para enviar una solicitud de creación desde un elemento del repositorio, puede agregar un elemento de menú y una acción que envíe una solicitud CreateItem desde el elemento hacia el editor. PerformancePoint Services almacena las acciones personalizadas en la siguiente ruta de acceso: %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Template\Features\PPSWorkspaceCtype. Para obtener más información acerca de cómo agregar elementos de menú personalizados, vea Procedimiento para modificar la interfaz de usuario con acciones personalizadas.
Vea también
Otros recursos
Creación de objetos personalizados para PerformancePoint Services
Fundamentos de PerformancePoint Services
Ejemplos de código para PerformancePoint Services en SharePoint Server 2010