Procedimiento para registrar manualmente las extensiones de PerformancePoint Services

Artículo
09/18/2014

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

Hace referencia a: SharePoint Server 2010

El proceso de implementación de una extensión para PerformancePoint Services de Microsoft SharePoint Server 2010 incluye registrar la extensión y los archivos DLL personalizados en el servidor de aplicaciones, que es el equipo que ejecuta PerformancePoint Services y, a continuación, copiar los archivos auxiliares a sus ubicaciones de destino.

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

Debe registrar la extensión en el archivo web.config de PerformancePoint Services (manualmente o mediante un script o trabajo del temporizador personalizado) para cada instancia de PerformancePoint Services en el conjunto o granja de servidores. Sin embargo, puede empaquetar e implementar los componentes de una extensión de PerformancePoint Services como una solución para toda la granja de servidores. Para obtener información acerca de cómo implementar las soluciones de SharePoint, vea Uso de soluciones.

Nota

La edición del archivo web.config requiere que tenga suficientes permisos administrativos en el servidor de aplicaciones.

En este tema se describe cómo registrar manualmente la extensión en el archivo web.config de PerformancePoint Services después de agregar las DLL personalizadas a la memoria caché global de ensamblados. Las modificaciones que realice dependen del tipo de extensión, como se muestra en la tabla 1.

Tabla 1. Modificaciones que pueden realizarse por tipo de extensión

Tipo de extensión	Modificación del archivo web.config
Informe	Adición de metadatos para un objeto personalizado
Filtro	Adición de metadatos para un objeto personalizado Adición de una clave para un proveedor o una transformación
Origen de datos	Adición de metadatos para un objeto personalizado Adición de una clave para un proveedor o una transformación
Transformación del cuadro de mandos	Adición de una clave para un proveedor o una transformación

Adición de metadatos para un objeto personalizado

Debe agregar metadatos para el objeto de informe, filtro u origen de datos personalizado en el archivo web.config. PerformancePoint Services usa estos metadatos para crear y mostrar objetos personalizados y abrir editores personalizados. Los atributos de los metadatos se asignan a propiedades de la clase CustomFCODefinition.

Para agregar metadatos para un objeto de informe, filtro u origen de datos personalizado

Navegue hasta el archivo web.config de PerformancePoint Services en la ruta de acceso predeterminada C:\Program Files\Microsoft Office Servers\14.0\WebServices\PpsMonitoringServer en el servidor de aplicaciones.

Importante

Como procedimiento recomendado, haga una copia del archivo web.config antes de editarlo.
Abra el archivo web.config de PerformancePoint Services en un editor de texto como el Bloc de notas.
Si su extensión es la primera extensión personalizada para PerformancePoint Services que se va a registrar en el servidor, debe registrar los controladores de sección de configuración y luego agregar el elemento CustomFCOGroup, de la forma siguiente:
1. Pegue el código siguiente en el elemento sectionGroup.
```
<section name="CustomFCOGroup" type="Microsoft.PerformancePoint.Scorecards.Common.Extensions.CustomFCOSection,

    Microsoft.PerformancePoint.Scorecards.Common, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"
    allowLocation="true" allowDefinition="Everywhere" />
```
2. Si el token de clave pública para su versión de Microsoft.PerformancePoint.Scorecards.Common.dll es diferente de la versión del ejemplo, reemplace el valor del atributo PublicKeyToken con el token de clave pública real. Puede encontrar esta propiedad en la memoria caché de ensamblados.
3. Pegue el código siguiente en el elemento Bpm en el mismo nivel que los elementos CustomDataSourceProviders, FCODaoProviders, CustomParameterDataProviders y CustomViewTransforms.
```
<CustomFCOGroup></CustomFCOGroup>
```

Importante
Como procedimiento recomendado, haga una copia del archivo web.config antes de editarlo.

Pegue el código siguiente en el elemento CustomFCOGroup.

<CustomFCO type="[The object type: ReportView, Filter, or DataSource.]"
    subType="[The unique identifier for your custom ReportView, Filter, or DataSource object.]" >
    <Resources assemblyName="[The fully qualified name of the resources assembly.]"
        resourcesName="[The fully qualified name of the resources file.]"
        FCOName="[The display name for the custom object.]"
        FCODescription="[The description for the custom object.]"
        FCOTemplateIcon="[The image resource to use as the icon for the custom object.]"/>
    <RendererClass name="[The fully qualified name of the renderer class in the format: 
        Namespace.Class name, DLL name, DLL version number, DLL culture, DLL public key token. 
        Applies to ReportView and Filter objects only.]"/>
    <EditorURI uri="[The URI of the custom editor.]"/>
</CustomFCO>

En los pasos 5 a 13, sustituya los valores de los marcadores de posición con valores reales para el objeto. Asegúrese de quitar los corchetes pero no quite las comillas.

Nota

Para obtener instrucciones acerca de cómo instalar el ejemplo de PerformancePoint Services, vea Ejemplo de código: Objetos de origen de datos tabular, filtro e informe personalizados y Ejemplo de código: transformaciones personalizadas del cuadro de mandos.

Para el atributo de type, escriba el tipo de objeto personalizado. Los valores válidos son ReportView, Filter o DataSource. PerformancePoint Services usa este valor para clasificar el objeto en el Diseñador de paneles de PerformancePoint, en SharePoint Server 2010 y en el repositorio de PerformancePoint Services.
Para el atributo subType, escriba el identificador único del objeto como una cadena. Por ejemplo, el origen de datos de ejemplo usa la siguiente entrada: subType="WSTabularDataSource".

Cuando un usuario crea un objeto personalizado desde el Diseñador de paneles, el valor subType del archivo web.config se usa como la propiedad SubTypeId del objeto. PerformancePoint Services usa este valor para determinar si un objeto es personalizado.

Nota

Si su editor personalizado también especifica la propiedad SubTypeId del objeto, ésta debe coincidir con el atributo subType en el archivo web.config. Como práctica recomendada, los editores deben especificar la propiedad SubTypeId solo cuando se crea un objeto personalizado fuera del Diseñador de paneles. Para obtener más información, consulte Editores para objetos personalizados de PerformancePoint Services.
Para el atributo assemblyName, escriba el nombre completo del ensamblado que contiene el archivo de recursos con el siguiente formato.

assemblyName="[DLL name], Version=[version number], Culture=[culture type], PublicKeyToken=[public key token]"

Si no va a proporcionar los recursos del proyecto en su extensión, quite los atributos assemblyName y resourcesName. (El atributo resourcesName se describe en el paso siguiente).

Nota

Para obtener instrucciones acerca de cómo agregar recursos a su extensión, vea Procedimiento para agregar recursos en una extensión para PerformancePoint Services.
Para el atributo resourcesName, escriba el nombre completo del archivo de recursos. Debe proporcionar un valor si especifica un valor para el atributo assemblyName. Si no va a proporcionar los recursos del proyecto en su extensión, quite los atributos assemblyName y resourcesName.
Para el atributo FCOName, escriba el nombre del objeto personalizado. Si especifica un ensamblado de recursos, escriba la clave de recurso del nombre; en caso contrario, escriba el nombre como una cadena. Este nombre se muestra en el Diseñador de paneles, en SharePoint Server 2010 y en el repositorio de PerformancePoint Services.
Para el atributo FCODescription, escriba la descripción del objeto personalizado. Si especifica un ensamblado de recursos, escriba la clave de recurso de la descripción; en caso contrario, escriba la descripción como una cadena. Esta descripción se muestra en el cuadro de diálogo de selección de plantilla en el Diseñador de paneles.
Para el atributo FCOTemplateIcon, escriba la clave de recurso para el icono. Si su extensión no proporciona un icono personalizado, quite el atributo FCOTemplateIcon. El icono se muestra en el cuadro de diálogo de selección de plantilla en el Diseñador de paneles.

Nota

Para usar un icono personalizado, la extensión debe incluir un recurso de imagen de mapa de bits de 32 x 32 píxeles para el icono. Para obtener más información, consulte Procedimiento para agregar recursos en una extensión para PerformancePoint Services.
Para el atributo name del elemento RendererClass, escriba el nombre completo de la clase de representador, que es el control de servidor web predeterminado que representa el control de selección de informe o filtro personalizado. Use el formato Namespace.Class name, DLL name, DLL version number, DLL culture, DLL public key token. Por ejemplo, la clase de representador para el informe de ejemplo se registra de la siguiente manera.
```
<RendererClass name="Microsoft.PerformancePoint.SDK.Samples.SampleReport.SampleReportRenderer,
    Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral,
    PublicKeyToken=fa525c8383a44a52" />
```
Este valor es necesario para los tipos ReportView y Filter. Si va a registrar un objeto de origen de datos personalizados, quite el elemento RendererClass y el atributo name.

Nota

Para permitir que los usuarios puedan invalidar este valor, exponga la propiedad RendererClassName en la interfaz de usuario del editor personalizado.
Para el atributo EditorURI, escriba el URI del editor personalizado. PerformancePoint Services anexa el type y el subType del objeto a esta ruta de acceso y, a continuación, la usa para abrir el editor desde Diseñador de paneles o desde SharePoint Server 2010.

Alternativamente, puede anexar un parámetro al URI del editor. El parámetro se pasa al editor cada vez que se abre. El valor es estático; no puede generarse dinámicamente. Un ejemplo de un escenario para el que habría que anexar un parámetro es para un editor que admita informes y filtros. Para informar al editor sobre el tipo de objeto con el que está trabajando, puede pasar type en el URI del editor. Para este escenario, anexaría ?type=ReportView a la ruta de acceso del editor de la extensión del informe y ?type=Filter para la extensión del filtro. Estos parámetros no afectan a los parámetros que se anexan mediante PerformancePoint Services. Para obtener más información sobre los parámetros que PerformancePoint Services anexa, vea Editores para objetos personalizados de PerformancePoint Services.
Según el tipo de objeto, cierre el archivo o registre un proveedor.
- Si va a registrar un tipo ReportView, guarde y cierre el archivo web.config.
- Si va a registrar un tipo Filter o DataSource, también debe registrar su proveedor. Vaya al paso 2 en el siguiente procedimiento.

Adición de una clave para un proveedor o una transformación

Debe registrar un proveedor o una transformación del cuadro de mandos si su extensión define un proveedor de origen de datos, un proveedor de datos para un filtro o una transformación del cuadro de mandos.

Para agregar una clave para un proveedor o una transformación

Haga una copia del archivo web.config de PerformancePoint Services. La ruta de acceso predeterminada del archivo web.config en el servidor de aplicaciones es C:\Program Files\Microsoft Office Servers\14.0\WebServices\PpsMonitoringServer.
Abra el archivo web.config de PerformancePoint Services en un editor de texto como el Bloc de notas.
Agregue una clave para el archivo DLL del proveedor o de la transformación, de la forma siguiente:

Nota

Para mejorar la legibilidad, se agregan saltos de línea a los ejemplos siguientes. Puede quitar los saltos de línea después de pegar la entrada en el archivo web.config.
- Para registrar un proveedor de origen de datos, agregue una clave en el elemento CustomDataSourceProviders con el siguiente formato:
  
  <add key="[data source provider ID]" value="[namespace name.class name], [DLL name], Version=[version number], Culture=[culture type], PublicKeyToken=[public key token]" />
  
  Por ejemplo, para registrar el proveedor de origen de datos de la extensión de origen de datos en el ejemplo de PerformancePoint Services, agregue la clave siguiente.
```
<add key="WSTabularDataSource"
    value="Microsoft.PerformancePoint.SDK.Samples.SampleDataSource.WSTabularDataSourceProvider,
    Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral,
    PublicKeyToken=fa525c8383a44a52" />
```
  El identificador del proveedor de origen de datos (WSTabularDataSource) debe coincidir con el atributo subType especificado para el objeto de origen de datos personalizado en el elemento CustomFCOGroup y debe coincidir con el valor devuelto por el método GetId(), que es implementado por la clase TabularDataSourceProvider. Además, si su editor la define, debe coincidir con la propiedad SubTypeId.
- Para registrar un proveedor de origen de datos para un filtro, agregue una clave en el elemento CustomParameterDataProviders con el siguiente formato: <add key="[data provider ID]" value="[namespace name.class name], [DLL name], Version=[version number], Culture=[culture type], PublicKeyToken=[public key token]" />
  
  Nota
  
  El método GetId() debe devolver el valor del atributo key en el proveedor de datos del filtro y también debe hacerlo la propiedad ParameterProviderId, que devuelve la propiedad BeginPoints del filtro.
  
  Por ejemplo, para registrar el proveedor de datos de la extensión del filtro en el ejemplo de PerformancePoint Services, agregue la clave siguiente.
```
<add key="SampleFilterDataProvider"
    value="Microsoft.PerformancePoint.SDK.Samples.SampleFilter.SampleFilterDataProvider,
    Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral,
    PublicKeyToken=fa525c8383a44a52" />
```
- Para registrar una transformación del cuadro de mandos, agregue una clave en el elemento CustomViewTransforms con el siguiente formato:
  
  <add key="[unique transform ID]" value="[namespace name.class name], [DLL name], Version=[version number], Culture=[culture type], PublicKeyToken=[public key token]" />
  
  Por ejemplo, para registrar todas las transformaciones del ejemplo de PerformancePoint Services, agregue las claves siguientes.
```
<add key="AddColumn"
    value="Microsoft.PerformancePoint.SDK.Samples.ScorecardTransforms.PreQuery.AddColumnTransform,
    Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral,
    PublicKeyToken=fa525c8383a44a52"/>
<add key="NumberScaling"
    value="Microsoft.PerformancePoint.SDK.Samples.ScorecardTransforms.PostQuery.NumberScalingTransform,
    Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral,
    PublicKeyToken=fa525c8383a44a52"/>
<add key="ShowAnnotationDate"
    value="Microsoft.PerformancePoint.SDK.Samples.ScorecardTransforms.PreRender.ShowAnnotationDate,
    Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral,
    PublicKeyToken=fa525c8383a44a52"/>
<add key="FormattingTransform"
    value="Microsoft.PerformancePoint.SDK.Samples.ScorecardTransforms.PreRender.FormattingTransform,
    Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0, Culture=neutral,
    PublicKeyToken=fa525c8383a44a52"/>
```
Guarde y cierre el archivo web.config.