Adding authorisation to menus

A menu or menu structure (that is, a Menu Page class) may be associated with one or more specific user groups so that members of one user group get a different menu from members of another user group.

Each user group must be associated with exactly one top-level Menu Page. It is not possible to associate partial menus, menu combinations, or specific menu options with a user group. If two user groups have similar but not identical menus, you need to create a separate Menu Page class for each, duplicating any elements they share.

To get menus to work in combination with user groups, you must set the Menu Name property of the menu object to NULL (empty) and specify menu names in USoft Authorizer instead:

1.	In Web Designer, find the name of your application's start page class by viewing the StartPage property of the Publication Configuration that you are using. (By default, the start page class of an application is called "ApplicationPage").

2.	In the Catalog, on the Pages tab, find the page class with this name, right-click on it, and choose Open.

The start page class opens in the preview pane in the center.

3.	Find the MenuControl object in the object tree on the right-hand side, right-click on it, and choose Property Inspector.

The Property Inspector opens for the menu object.

4.	Make sure the value of the Menu Name property is set to NULL (empty).

5.	In USoft Authorizer, open the Application for which you want to set the menus. To do this, choose Define, Applications from the menu, or double-click on the application name in the Authorizer catalog.

6.	For each user group, set the First Menu Page Web to the name of the menu page that you want to display when members of this user group log on to the application.

7.	Save your work. You may have to stop and restart the Rules Service.

IMPORTANT: The values for Menu Page names in the Authorizer and Web Designer are case-sensitive and must match exactly. Authorizer enforces all-uppercase names. This means you will need to use all-uppercase names for Menu Page classes in the Web Designer catalog as well.