Article ID: 129094, created on Jul 7, 2016, last review on Jul 8, 2016

  • Applies to:
  • Operations Automation

Cause

The existing approach to the menu customization, implemented for the CCP v1, is not suitable for the CCP v2.

Resolution

The CCP v2 is based on APS technology and requires a different approach to the menu customization. You should create an APS application to add an additional item in the menu in the CCP v2. For detailed information how to create an APS application, refer to http://doc.apsstandard.org/2.2/start/.

If you are not planning some complicated customizations, for example, you need to create an additional item in the menu, showing screen with some static or dynamic content, like links to documentation or video, you can use a sample APS application (download sample APS application package).

To install an APS application package in Odin Automation, do the following:

  1. In the PCP, go to Services > Applications.
  2. Click Import Package.
  3. Select the sample APS application package and click Submit.

To create an APS instance, do the following:

  1. In the PCP, go to Services > Applications.
  2. Find the newly installed sample package, named Support, and click on its name.
  3. Switch to the Instances tab and click Install.
  4. For the sample APS application you can define https://localhost in the Application API end-point URI field. If your APS application has backend, specify appropriate Application API end-point URI and follow the wizard steps.

Now your customers will see a new menu item in the CCP v2, named Support. By clicking the Support item, they will see the screen with some sample text.

Customization

To change the label and icon of the menu item, do the following:

  1. Open APP-META.xml file and find the following block:

    <navigation icon="fa-question-circle" id="item-support" label="Support">
        <plugs-to id="http://www.parallels.com/ccp/2"/>
        <view id="view-support" label="Support" src="ui/support.js">
            <var collection="true" name="services" type-id="http://aps-standard.org/types/core/subscription/service/1.0"/>
        </view>
    </navigation>
    
  2. In the navigation tag change icon attribute's value on your own icon file name. Change label attribute's value on your own.
  3. In the view tag specify src attribute's value. It defines script processing the view shown in the CCP.

To create more complicated custom page in the CCP v2, refer to APS documenation portal http://doc.apsstandard.org/2.2/.

Limitation

Your custom menu item will be shown to all the customers. You can't define per customer, per vendor configuration of displaying the new item.

5356b422f65bdad1c3e9edca5d74a1ae caea8340e2d186a540518d08602aa065 e12cea1d47a3125d335d68e6d4e15e07

Email subscription for changes to this article
Save as PDF