One of placeholders predefined in the APS specification allows embedding a navigation tree into the Odin Service Automation customer CP as a tab in the top level menu. In the following example, metadata declaration in APP-META.xml makes the tree with the “VPS Management” label embedded into the customer CP, as required by element <plugs-to id=”http://www.aps-standard.org/ui/service”/>.
<navigation id="ccp" label="VPS Management"> <var name="context" type-id="http://event-mgmt.demo.apsdemo.org/vpsclouds/contexts/1.0"/> <plugs-to id="http://www.aps-standard.org/ui/service"/> <item id="servers" label="Servers"> <view id="servers" label="Servers"> ... <view id="server.edit" label="Edit"> <var name="vps" type-id="http://event-mgmt.demo.apsdemo.org/vpsclouds/vpses/1.0"/> <controls> <cancel/> <finish/> </controls> </view> </view> </item> <item id="counters" label="Resource Usage"> <view id="counters" label="Resource Usage"/> </item> <item id="events" label="Event Notifications"> <view id="events" label="Event Notification Log"> <var name="events" type-id="http://event-mgmt.demo.apsdemo.org/vpsclouds/events/1.0"/> </view> </item> </navigation>
Navigation hierarchy must look as item-item-view. The top level item defines an embedded custom menu, and the items below it are menu items.
In the customer CP, it looks as presented below.
APS UI in this case allows the customer to create and manage purchased resources of the application, such as VPSes in our example. Odin Service Automation customer CP supports breadcrumbs when navigating in the APS UI tree.
In the Odin Service Automation customer control panel, each APS application that is provisioned in a subscription and has entry-points defined in APP-META.xml is represented by its auto-generated widget on the Home page, when this subscription is selected.
The widget contains the following components defined in the <presentation> section of the package:
Entry-points of the application services are placed on the bottom of the widget. They are presented in the form of clickable direct links to various views of the custom UI navigation panel.
If the package does not have any entry points defined, the widget will not be shown on the Home page.
<presentation> <summary>Simplest counter management multi-tenant application</summary> <description>This is a demo application to demonstrate how to develop APS application step by step. </description> <icon path="images/icon.png"/> ... </presentation>
A service entry-point is configured in the service presentation section and consists of the following elements and attributes:
For example, the following entry-point will be displayed as VPS Management link to the servers view of the application whose ID is http://counter-mgmt.demo.apsdemo.org/vpsclouds.
<service id="vpses"> ... <presentation> ... <entry-points> <entry dst="http://counter-mgmt.demo.apsdemo.org/vpsclouds#servers" class="aps2-view"> <label>VPS Management</label> </entry> </entry-points> </presentation> </service>