Using GeneXus Access Manager (GAM), your WEB application menu can be defined (dynamically) at runtime, based on the GAM Permissions and GAM Roles of the user logged-in.
The purpose is to filter the menu options according to the end user's permissions. Here, GAM returns the menu structure depending on the permissions of the user so that this structure may be loaded at runtime with any User Control.
The menu has to be defined for a particular GAM Application (multiple menus can be defined within a GAM Application).
A menu option will have a permission and a resource associated with it.
How to define the menu
The menu may be set using the GAM Web Backoffice or the GAM API for this purpose (see Update GAM Menu options).
1. Select the GAM application where you will define the Menu, and click on the Menus option at the right-hand side:
2. Click to add a Menu
3. Define the Menu name and its description
4. Add the Menu options
5. When you add a Menu option, you will get a dialog like this:
A menu option is associated with a GAM Permission and a resource.
The permission can be selected from a combo box which includes all the GAM permissions defined for that GAM Application, including the Automatic Permissions generated by GeneXus and the Permissions Created by the User.
Note that if it's a Permission created by the user, the permission is used only to decide whether to show the menu option to the user or not. The permission isn't checked at the execution of the resource itself.
A Resource is any GeneXus object that may be executed from the URL or an URL itself.
If the GeneXus object is inside a module, include the module in the Resource field, e.g.: module1.webpanel1.
By default, the resource of a menu option which is associated with an Automatic Permissions generated by GeneXus is any Object that has that permission as Permission Prefix property.
The option type can be
- Menu (a submenu may be defined here)
Environment settings of the Application
The Environment settings of the Application influence in the behavior of this feature.
For the time being (GeneXus 15 upgrade 4) only the package and extension properties are used to setup the complete URL of the menu options resources.
Afterward, the menu is defined automatically, based on the permissions of the resources and the user's GAM Roles. The end user will view only the Menu options linked to resources associated with the permissions that the user may access.
The menu may be displayed using any User Control. See Howto: Display a GAM Menu using Jscookmenu UC.
The Menu of the GAM Web Backoffice is automatically defined in the GAM Backend Application. It is created when Creating the GAM repository for the first time from GeneXus.