Menus
Define permissions for the Menu Item object
The Menu Item object contains data for the menu items in your tenant. The Access Control List allows you to define permissions for the Menu Item object. Modifying permissions for an object allows you to grant access to actions that affect the object, which can be executed from API calls or portal pages. You can grant a role full access, custom access, or no access to the object. You can also customize the level of access users have to the actions and fields within the object. The TenantAdministrator role has full access to all objects.
Important:The Authenticated User role has read access to the Menu Item object by default. DSI highly recommends that you do not revoke this access.
To define permissions for the Menu Item object, complete the following steps in the portal.-
Go to the ACL page.Step InformationNote:The default location for the ACL page is Configuration > ACL. If the menu items for your tenant have been customized, it may be located elsewhere. For more information, contact your tenant administrator.
-
In the list, expand Object (System), and then select Menu Item Object.Step InformationResult: The list of roles displays, along with each role's access to the object.
-
Select a role from the list, and then select Modify.
-
In the context menu, select one of the following options.
-
To allow the role full access to the object, select Full Access.Note:This allows all users within the role to use API calls to add, read, modify, search, and update the object itself, and all fields within the object.
-
To prevent the role from being able to view the object, select No Access.
-
To customize the level of access the role will have to the object, select Custom Access.
Expected ResultResult: If you selected Full Access or No Access, a "Permissions Applied" message displays, indicating that the object permissions were successfully updated. If the role has access to any portal pages that use data from the object, the pages inherit the new permissions. -
-
If you selected Custom Access, under Action Level Permissions, turn the Execute switch on to allow, or off to disallow, each of the following actions.
-
Add: Allows the role to add menu items.
-
Read: Allows the role to view menu items.
-
Modify: Allows the role to change the object definition for the Menu Item object.
-
Search: Allows the role to search for specific menu items.
-
Update: Allows the role to edit menu items.
-
-
If you selected Custom Access, under Field Level Permissions, turn the Read switch on to allow read access, or off to disallow read access, for each of the fields.Step InformationNote: Some fields are required for specific actions. For more information about the available fields, refer to Field level permissions for the Menu Item object.
-
If you selected Custom Access, under Field Level Permissions, turn the Update switch on to allow the role to update, or off to disallow update access, for each of the fields.Step InformationNote: Some fields are required for specific actions. For more information about the available fields, refer to Field level permissions for the Menu Item object.
-
If you selected Custom Access, select Apply Permissions.Expected ResultResult: A "Permissions Applied" message displays, indicating that the object permissions were successfully updated. If the role has access to any portal pages that use data from the object, the pages inherit the new permissions.
-
Optional. To allow a role to access the Menus page, Define permissions for the Menu Management page securable.
Field level permissions for the Menu Item object
The Access Control List (ACL) allows you to customize the level of access users have to the fields within the Menu Item object.
The list of fields is populated from the list of attributes in the Menu Item object. The following permissions can be modified for each field.
-
Read: allows or disallows read access.
-
Update: allows or disallows editing.
When modifying field level permissions, keep in mind that some fields are required for specific actions.
The following fields are available for the Menu Item object.
Url
The url to which the menu item links.
Full access to this field is required when adding or editing a menu item.
Icon
The icon that displays next to the menu item.
Full access to this field is required when adding or editing a menu item.
Text
The text that displays for the menu item.
Full access to this field is required when adding or editing a menu item.
Sequence
The order in which the menu item displays.
Full access to this field is required when adding or editing a menu item.
Createdby
The userid of the user who created the menu item.
Full access to this field is required when adding or editing a menu item.
Updatedby
The userid of the user who last updated the menu item.
Full access to this field is required when adding or editing a menu item.
Menuitemid
The ID assigned to a menu item.
Full access to this field is required when adding or editing a menu item.
Description
The description assigned to a menu item.
Full access to this field is required when adding or editing a menu item.
Whencreated
The date and time a menu item was created.
Full access to this field is required when adding a menu item.
Whenupdated
The date and time a menu item was updated.
Full access to this field is required when adding or editing a menu item.
Portalpageid
The ID of the portal page linked from the menu item.
Full access to this field is required when adding or editing a menu item.
Hidefrommainnav
Specifies whether a menu item is hidden from the top menu.
Full access to this field is required when adding or editing a menu item.
Parentmenuitemid
The ID of the parent menu item.
Full access to this field is required when adding or editing a menu item.
Define permissions for the Menu Management page securable
The Access Control List allows you to modify a role's permissions to the Menu Management page securable. This defines the role's level of access to the Menu Management page on the portal. This only controls access to the page itself. Access to the data within the page is inherited from the Menu Item object. You can grant a role full access, custom access, or no access to the Menu Management page securable. The TenantAdministrator role has full access to all objects.
Prerequisites:
-
If you want to allow users to view or edit the Menu Management page, you must also grant permissions for any parent pages in the menu structure. For example, if the Menu Management page is nested under Configuration, you must Define permissions for the Configuration page securable.
To define permissions for the Menu Management page securable, complete the following steps in the portal.
-
Go to the ACL page.Step InformationNote:The default location for the ACL page is Configuration > ACL. If the menu items for your tenant have been customized, it may be located elsewhere. For more information, contact your tenant administrator.
-
In the list, expand Page (System), and then select Menu Management Page Securable.Step InformationResult: The list of roles displays, along with each role's access to the page.
-
Select a role from the list, and then select Modify.
-
In the context menu, select one of the following options.
-
To allow the role full access to the page, select Full Access.
-
To prevent the role from being able to view the page, select No Access.
-
To customize the level of access the role will have to the page, select Custom Access.
Expected ResultResult: If you selected Full Access or No Access, a "Permissions Applied" message displays, indicating that the page permissions were successfully updated. -
-
If you selected Custom Access, under Top Level Permissions, for Page, turn the View switch on to allow read access to the page, or off to disallow read access.
-
If you selected Custom Access, select Apply Permissions.Expected ResultResult: A "Permissions Applied" message displays, indicating that the page permissions were successfully updated.
Loading...
There was a problem loading this topic