Search Engine: Elastic

Article ID: 129094, created on Jul 7, 2016, last review on Sep 19, 2018

  • Applies to:
  • Operations Automation
  • Business Automation 7.0
  • APS 2.x

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 please refer to APS Standard website.

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 Add Instance.
  4. For UI-only applications (like the sample app above) you should define https://127.0.0.1:8081/pa/rest/fake/ in the Application API end-point URI field. If your APS application has a 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.

Limitation

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

5356b422f65bdad1c3e9edca5d74a1ae caea8340e2d186a540518d08602aa065 e12cea1d47a3125d335d68e6d4e15e07 c0f836394088a28cc30dd0e5fe8b600e 198398b282069eaf2d94a6af87dcb3ff b2c3b33425dfc50c7d41a2efaa7f84f3 717db81efe94e616312b74fb03a5d474 70bf700e0cdb9d7211df2595ef7276ab

Email subscription for changes to this article
Save as PDF