How to: Add Resources to a PerformancePoint Services Extension

  • Article

To display a custom icon for your custom object, you can add an image-type, bitmap resource to your project in Visual Studio. The custom icon appears in the Select a Template dialog box that is used to create an object in PerformancePoint Dashboard Designer.

If you add a resource for a custom icon to your project, you must also add resources to define the name and description for your custom object. The following instructions describe how to create and register resources that are embedded in your extension assembly.

Applies to: SharePoint Server 2010

To add resources to an extension

  1. Open your extension's project in Microsoft Visual Studio.

  2. Create a resources file for your project, as follows:

    1. On the Project menu, click Add New Item.

    2. In the Add New Item dialog box, click the Resources File template, type a name for the resources (.resx) file, and then click Add.

  3. Add a resource for your custom icon, as follows:

    1. In Solution Explorer, double-click the .resx file.

    2. In the Add Resource menu, point to New Image, and then click BMP Image. PerformancePoint Services does not support icon-type resources.

    3. Type a name for the image resource, and then click Add.

    4. Create your 32 x 32 pixel image. PerformancePoint Services enforces this size requirement.

  4. Add resources for the name and description of your custom object, as follows:

    1. On the <Resources>.resx tab, click the Add Resource menu, and then click Add New String.

    2. Type name/value pairs to use for the display name and description of your custom object.

      Note

      You can also provide string resources to localize the strings and labels that appear in your custom applications. For more information about resources, see Adding and Editing Resources (Visual C#).

  5. Save and then build your project.

  6. Register your extension by following the procedure described in How to: Manually Register PerformancePoint Services Extensions. Be sure to specify the attributes for your resources in the Resources element, as shown in the following example.

    <Resources
  assemblyName="Microsoft.PerformancePoint.SDK.Samples, Version=14.0.0.0,
    Culture=neutral, PublicKeyToken=fa525c8383a44a52"
  resourcesName="Microsoft.PerformancePoint.SDK.Samples.Properties.Resources"
  FCOName="Name_of_Name_Resource"
  FCODescription="Name_of_Description_Resource"
  FCOTemplateIcon="Name_of_Image_Resource"/>

Security

Whether your resources information is built into your extension assembly or you provide a separate resources assembly, all assemblies in your extension must have strong names and be placed in the global assembly cache. For information about how to sign an assembly with a strong name and how to create a public/private key pair, see How to: Create a Public/Private Key Pair. For information about registering an assembly in the global assembly cache, see How to: Install an Assembly into the Global Assembly Cache.