Compartir a través de


Ejemplo de código: transformaciones personalizadas del cuadro de mandos

Última modificación: martes, 31 de mayo de 2011

Hace referencia a: SharePoint Server 2010

Se aplica a: PerformancePoint Services para SharePoint Server, versión Enterprise
El ejemplo de transformaciones de cuadro de mandos de PerformancePoint Services de Microsoft SharePoint Server 2010 se incluye en el ejemplo de referencia SDK de PerformancePoint Services. El ejemplo está diseñado para mostrar cómo crear transformaciones personalizadas del cuadro de mandos que modifiquen la apariencia, el contenido o la funcionalidad de una visualización de cuadro de mandos de PerformancePoint Services.

Se recomienda usar el ejemplo como plantilla para las extensiones personalizadas porque muestra los procedimientos recomendados para la programación con PerformancePoint Services. Para obtener más información sobre los tipos de extensión admitidos, vea Escenarios de desarrollo con PerformancePoint Services.

Transformaciones del cuadro de mandos de ejemplo

El ejemplo contiene las siguientes transformaciones del cuadro de mandos:

  • AddColumnTransform.cs  Define una transformación del cuadro de mandos de PreQuery que agrega una columna de forma dinámica a un cuadro de mandos que contiene indicadores clave de rendimiento (KPI) en el nivel hoja de la columna.

  • FormattingTransform.cs  Define una transformación del cuadro de mandos de PreRender que cambia la combinación de colores y la fuente predeterminada de un cuadro de mandos.

  • NumberScalingTransform.cs  Define una transformación del cuadro de mandos de PostQuery que aplica escalas B, M y K a los números elevados.

  • ShowAnnotationDate.cs  Define una transformación del cuadro de mandos de PreRender que muestra hace cuántos días se modificó por última vez una anotación.

Instalación de las transformaciones del cuadro de mandos de ejemplo

Para instalar las transformaciones del cuadro de mandos de ejemplo, debe crear el ensamblado de ejemplo, registrar el ensamblado en la memoria caché global de ensamblados y registrar las extensiones en el archivo web.config de PerformancePoint Services. Estas tareas necesitan permisos administrativos suficientes en el servidor de aplicaciones, que es el equipo que ejecuta PerformancePoint Services.

Nota

Las instrucciones acerca de cómo instalar el ejemplo completo se incluyen en los archivos de ejemplo.

Para instalar las transformaciones del cuadro de mandos de ejemplo

  1. Descargue el archivo comprimido (.zip) del ejemplo de referencia SDK de PerformancePoint Services, que incluye los componentes de las transformaciones del cuadro de mandos.

  2. Extraiga el contenido en una carpeta del equipo.

  3. Abra el ejemplo en Visual Studio.

  4. En el Explorador de soluciones, expanda la carpeta Referencias y restablezca todas las referencias del proyecto que falten. Los ensamblados de PerformancePoint Services se instalan únicamente en la memoria caché global de ensamblados. Según el entorno de desarrollo, es posible que deba copiarlos a un directorio diferente. Para obtener instrucciones acerca de cómo copiar ensamblados de PerformancePoint Services desde la memoria caché global de ensamblados, vea Archivos DLL de PerformancePoint Services usados en escenarios de desarrollo.

    El ejemplo incluye referencias a los siguientes ensamblados de PerformancePoint Services y SharePoint Server 2010:

    • Microsoft.PerformancePoint.Scorecards.Client

    • Microsoft.PerformancePoint.Scorecards.DataSourceProviders.Standard

    • Microsoft.PerformancePoint.Scorecards.Server

    • Microsoft.PerformancePoint.Scorecards.ServerCommon

    • Microsoft.PerformancePoint.Scorecards.ServerRendering

    • Microsoft.PerformancePoint.Scorecards.Store

    • Microsoft.SharePoint

  5. Cree el ensamblado de ejemplo.

    Nota

    En estas instrucciones se supone que el ensamblado se firma con el archivo SDKSamples.snk incluido en el ejemplo. Si usa un archivo de clave de nombre seguro diferente para generar un token de clave pública para el ensamblado, reemplace el token de clave pública del ejemplo en estas instrucciones (fa525c8383a44a52) por la clave real.

  6. En el servidor de aplicaciones, agregue el ensamblado de ejemplo (Microsoft.PerformancePoint.SDK.Samples.dll) a la memoria caché global de ensamblados. Para obtener instrucciones, vea How to: Install an Assembly into the Global Assembly Cache.

  7. Navegue al 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.

    Nota importanteImportante

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

  8. Abra el archivo web.config de PerformancePoint Services en un editor de texto como el Bloc de notas.

  9. Para registrar las transformaciones del cuadro de mandos de ejemplo, pegue el siguiente código en el elemento CustomViewTransforms.

    <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"/>
    
  10. Guarde y cierre el archivo web.config.

  11. En función de su entorno, es posible que deba reiniciar Internet Information Services (IIS).

Tras instalar las transformaciones del cuadro de mandos de ejemplo, se aplican a las vistas del cuadro de mandos y los informes de mapa de estrategia en paneles que se crean e implementan desde el Diseñador de paneles de PerformancePoint. Para obtener más información sobre cómo usar el Diseñador de paneles, vea el sitio web de Office.

Vea también

Conceptos

Ejemplo de código: Objetos de origen de datos tabular, filtro e informe personalizados

Otros recursos

Cuadros de mandos de PerformancePoint Services