Working with the Cameo.xml File

Several software packages are offered by Micro Focus that complement the PPM product. This includes an assortment of Extensions, Migrators, Adapters, Accelerators, and integration suites, plus their documentation. These products typically include documentation is available from the PPM Download Center only (and not installed on the PPM Server). It is often desirable to make these documents available to all PPM users, while having them isolated on a separate Web page, as shown in Figure 4-4. Supplemental product documentation page. Alternatively, these documents can be included on the PPM Documentation Library home page.

Figure 4-4. Supplemental product documentation page

To include or modify supplemental product documentation so that it is accessible from the Additional Project and Portfolio Management Center Products link in the Supplemental Information section of the PPM Documentation Library home page:

  1. Copy the <PPM_Home>/pdf/Cameo.xml file to a working location, so that the <PPM_Home> placeholder represents the path where your PPM instance was installed. For example: xyzserver/E$/PPMServer.

    Remember that you should have a backup copy of this file stored in a safe location.

  2. Edit the temporary version of the XML file as desired, ensuring that it conforms to the DTD as described in Working with the Cameo.xml File.

    You must include the <document> element for each document you want displayed.

    Tip: If the file type is PDF, the <dtype> element does not have to be included.

    If, for example, you were adding documentation for the Deployment Management Extension for Oracle E-Business Suite and Deployment Management Extension for Oracle Technology, the XML file would be similar to the following:

    <?xml version="1.0" ?>
    <!DOCTYPE cameo SYSTEM "Cameo.dtd">
    <cameo>
      <section>
        <document>
    <dtitle>HP Deployment Management Extension for Oracle E-Business Suite Guide</dtitle>
    <dfn>en/ExtOracleEB.pdf</dfn>
    <dtype>pdf</dtype>
    </document>
        <document>
    <dtitle>HP Deployment Management Extension for Oracle Technology Guide</dtitle>
    <dfn>en/ExtOracleT.pdf</dfn>
    </document>
      </section>
    </cameo>
  3. Save and close the file.

  4. Copy the updated XML file to its original location on the PPM Server, overwriting the existing file.

    You should also place a copy of this updated file in a safe location where it does not overwrite the original (or any previously updated) file.

  5. Ensure that each of the files you specified exists in the applicable directory on the PPM Server (typically, <PPM_Home>/pdf/en).

  6. Verify the changes by opening the PPM Documentation Library page and clicking Additional Project and Portfolio Management Center Products in the Supplemental Information group.

    Caution: Test the updated PPM Documentation Library using both Internet Explorer and Mozilla Firefox.

    The resulting supplemental product documentation page would be similar to that shown in Figure 4-4. Supplemental product documentation page.

Tip: If you ever want to discontinue listing supplemental products documents, create an "empty" Cameo.xml file as described in Working with the Cameo.xml File.

Use of this file will remove the Additional Project and Portfolio Management Center Products link in the Supplemental Information group.

If the Cameo.xml file does not include any documents and Custom.xml file does not include any documents, the Supplemental Information group is not displayed.