[Index]
Note
To work on an existing menu layout, we recommend that you clone the menu layout and work on the clone.
Log in as hcsadmin, provider or reseller administrator.
Choose the hierarchy for the menu layout.
Choose Role Management > Menu Layouts.
Click Add to open the Menu Layouts input form.
Enter a Name and a Description for the menu layout.
Add (by clicking + next to Menu Items), and optionally nest Menu Items for each required menu item:
Choose an Icon name from the dropdown to be displayed on the GUI menu. To see the icons, refer to Business Admin Portal Interface Custom Icon Names Reference.
Enter a Title.
For a list view of a model, select from the Type drop-down list and choose List as the Display as value. For the selected model type, choose a default Field Display Policy and Configuration Template. If a User Role is associated with the menu layout, then users with this role see the model type according to these.
If List is chosen as the Display As type, then the resulting list can also be filtered. See Configurable Filters in Menus and Landing Pages.
Href is generally used for external links. It can however be used for links within the application to link directly to a form. For example, the Add Phone form would have the HREF value of api/relation/SubscriberPhone/add. In such cases, any associated Field Display Policies and Configuration Templates for the menu item can only be added by using a menu import in JSON format or on a bulk load sheet.
Note that view/ type models should not be referenced as Href - only from the Type drop down. The view/ model types always open the "Add" form - without having to use the href with /add/.
If Href is used, choose the Display as format of the item as follows:
Form - Show an input form. The Href value points to a model instance with the pkid, for example data/Countries/5331a739d0278d7893e26d2e, or ends with "/add/".
IFrame - A URL specified as the Href value opens as an IFrame for cross-launching.
External Link - A URL specified as the Href value opens as a new browser tab.
Note: pop-up blocking should be disabled on user browsers for the external link to resolve.
Tree - If available, a tree view of resource to display. Href provides the tree path.
List - List view of a resource referenced by Type or Href. A tool (tool/[toolname]) can also be presented as a list, for example
/api/tool/Transaction/?entity=data/Event&operation=execute
Wizard - Execute a wizard referenced by Href (wizard resource ends with "/0/"). For example:
/api/wizard/AddressWizard/0/
Arrange the desired order of the menu items by clicking the up or down arrow to move the menu items up or down respectively.
Click Save on the button bar when complete to create the menu layout.
To modify an existing menu layout, click the relevant menu layout name from the Menu Layouts list view and edit the appropriate fields as described above. Click Save when complete.
Updates in the menu layout are available for the user only when logging in again.
When complete, assign the menu layout to the appropriate roles.
While default menu layouts are available for a user and an administrator user, a menu layout can be created from the GUI and can then be associated with a User Role. Users that have been assigned to this role will be able to use the created menu layout.
Title | Description | Details | |||||||||||||||||||||||||||||||||||||||||||||||
Name * | The name that is given to the Menu Layout. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Description | A description of the Menu Layout. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Menu Items | The list of menu items and -sub items that belong to the Menu Layout. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Icon | The icon to be used for this menu entry. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Title | The menu item title as it will show on the menu. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Type | The selected model type from the Type drop-down list to associate with the Title. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Href | If a direct reference to a model type is used for the menu item, the specified path. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Field Display Policy | The selected Field Display Policy that is associated with the Menu Item. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Configuration Template | The selected Configuration Template that is associated with the Menu Item. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Display As | Select the display format of the model types of the menu item. The format can be a Form for a single instance, or a List for more than one instance. Default: list |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Fixed Filters | Filters that can't be removed by end user. Applicable to display as = 'list' |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Filter By |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Filter Type |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Filter String |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Ignore Case |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Configurable Filters | Filters suggested to end users and my be cleared. Applicable to display as = 'list' |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Filter By |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Filter Type |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Filter String |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Ignore Case |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Menu Items | The list of nested menu items that belong to the Menu Layout. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Title | The nested menu item title as it will show on the menu. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Type | The selected model type from the Type drop-down list to associate with the Title. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Href | If a direct reference to a model type is used for the menu item, the specified path. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Field Display Policy | The selected Field Display Policy that is associated with the Menu Item. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Configuration Template | The selected Configuration Template that is associated with the Menu Item. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Display As | Select the display format of the model types of the menu item. The format can be a Form for a single instance, or a List for more than one instance. Default: list |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Fixed Filters | Filters that can't be removed by end user. Applicable to display as = 'list' |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Filter By |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Filter Type |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Filter String |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Ignore Case |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Configurable Filters | Filters suggested to end users and my be cleared. Applicable to display as = 'list' |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Filter By |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Filter Type |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Filter String |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Ignore Case |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Menu Items | The list of nested menu items that belong to the Menu Layout. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Title | The nested menu item title as it will show on the menu. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Type | The selected model type from the Type drop-down list to associate with the Title. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Href | If a direct reference to a model type is used for the menu item, the specified path. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Field Display Policy | The selected Field Display Policy that is associated with the Menu Item. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Configuration Template | The selected Configuration Template that is associated with the Menu Item. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Display As | Select the display format of the model types of the menu item. The format can be a Form for a single instance, or a List for more than one instance. Default: list |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Fixed Filters | Filters that can't be removed by end user. Applicable to display as = 'list' |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Filter By |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Filter Type |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Filter String |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Ignore Case |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Configurable Filters | Filters suggested to end users and my be cleared. Applicable to display as = 'list' |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Filter By |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Filter Type |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Filter String |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Ignore Case |
|