Sun Java System Portal Server 7.1 Developer Sample Guide

Creating a New Help File

You can create a new help file by creating a new HTML file. This method of customizing the online help is useful if, for example, you add a new provider to the Desktop. When you create a new help file, you must modify the display profile to contain the new helpURL value.

ProcedureTo Create a New Online Help File and to Define the helpURL Value

  1. Create an HTML file for the provider you want to document.

  2. Place your file in the appropriate directory.

    You can place your custom help files under the web server document root, in the directory specified as root by the display profile:


    PortalServer-base/web-src/docs/locale/desktop

    Or, you can deploy them in a custom web application archive. See the web server documentation for information on how to deploy a web application archive.

  3. Run the PortalServer-base/bin/psadmin deploy subcommand to deploy the file.

  4. Define the helpURL value for that file in the display profile.

    To define the helpURL value for a new online help file, use the format described in the section Overview of the Desktop End-User Online Help.

  5. Use the psadmin subcommand to load the display profile into LDAP.

  6. Verify that the new help file is displayed correctly.