Remote Menu Maintenance
The Remote Menu Maintenance screen allows you maintain access to the screens that make up your system. This screen is identical to the one found in your local install of JDesignerPro under System Maintenance. You can create a hierarchical menu system or a flat, single tier system. Each new menu item under the Main or other menu is called a "menu option". An unlimited number of options can be added to an existing menu. Each menu option will either lead to another set of menus or it will load a screen.
You will only be able to maintain menu options for the System you are currently working in. to maintain the menus and user authorizations for a system, you must login to that system. To login to a newly-created system, duplicate the default.htm page and change the applet tag to load the new system. See Deployment in Chapter 2.
Double-click on a menu name in the list to navigate down that menu and see the list of options for that menu. Double-click on the '...' to step back a level. Single-clicking on an option will load the details for that option and allow you to maintain/modify it.
To create a new option press the New Option button. A blank screen will appear. Enter the details and press Apply. To copy an option do the same as for creating a new option. To update an option select it first in the list and then make the necessary changes and press Apply.
If you did not do a Final Build, only a Build, but added the project to a menu, there will not be a class file with your project name. The Build button only uses preliminary build names based on "PrelimXXXX" where XXXX is a random number. JDesignerPro may be looking for the name of the project instead, which will cause a "Class Failed to Load" error. Go back through the builder and do a Final Build on the Project. Remember to clear your caches first.
Remote Menu Maintenance Properties
Menu. This is the menu on which the current option resides. The default initial Menu is "Main".
Option Number. This signifies the position relative to other options on the same menu. For example, position number 1 will be to the left of option number 2, which will be to the left of option number 8, etc. Menu options need not be sequential.
Type of Option. Choose whether this option is a menu to drop into a new area or will load a screen module. For example, the Screen Wizard tab is Type: Menu because it opens into the next level of tabs instead of loading an application module. The Menu Maintenance tab, which we are on now, is Type: Program Module because it load an application module, or Project.
The Build Test Panel type is reserved for the JDesignerPro Builder. You can use this type to create a screen that loads a module you have completed.
Points to Menu or Module to Load. In this field enter the name of either the menu it will drop into, or the Project name to load.
Module parameter. This is a variable field that will pass this information to the class that is loaded. It is used mainly to pass the name of the HTML file to load into the Browser module. It is blank by default. Enter the servers path to the file, i.e.: Docs/JDesignerPro.htm.
Description on Menu Tab. Enter the text to appear on the menu tab. The Maximum length is 30 characters of any type. JDesignerPro will automatically resize the tab to fit the name.
Color of Menu Text / Tab. The text and background color of the menu tab.
Status. Choose either Active or Inactive to decide whether this option should appear in the application.
Authorization Codes. This is where you determine the user access to the menu or program module. User and group definitions are determined by matching menu authorization codes to user authorization codes. An authorization code is the main grouping. The level numbers determine the secondary grouping.
You may create your own set of codes up to 10 characters long for assigning to menu options. You then assign the same codes to the user profiles of users that require access to the menu option. To illustrate how this works, double-click the Main menu to see a list of the options on it. Single-click the Welcome option in the list and notice that it has authorization code "*ALL". Now single-click on the Screen Wizard option. It has authorization code "ADMIN".
To set up authorized users for these screens you assign *ALL and ADMIN to the authorization code fields under both Menu Maintenance and User Menu Authorization. This matching of codes is how you form groups.
Authorization Levels. You can also set levels within an authorization code. Levels must be numeric, from 0 to 99. Level 0 affords the most complete authorization, 99 the least. Users have access to menu options with the same or higher level number. Users with the same code but a level greater than the menu option level will not have access to that option.
For Example:
In this configuration, any menu with Authorization Code Sales and Level 3-99 will be sent to the Sales Manager. While only menus with Authorization Code Sales and Level 12-99 will be served to the Sales Representative. Therefore, the Group for Sales Managers is Levels 3-11.
If you dont want the same screens that go to Sales Reps to go to Sales Managers, then give the Sales Managers an entirely different Authorization Code. Sales Managers may have Authorization Code, SalesMgr and Sales Reps have an Authorization Code SalesRep.
Apply, Reset, Remove and New buttons. To create a new menu option, press the New button. The fields will go blank. Enter the parameters that define your new menu. The first field is where you enter the name of the menu where your new option will appear, not the name of your new menu option. Press Reset at any time during the New or Copy process to undo changes. Press the Apply button when you are ready to save your menu option changes or new entry. Use the remove button to delete a menu option from a menu. To remove a menu option, single-click it first in the list, the press Remove. This does not delete the project or class file.
Copy button. To create another instance of a menu option or to move one, use the Copy button. This is a handy way to set up more than one HTML modules on a menu. Simply select the Welcome tab or Help tab in the list, then press Copy. Enter the name of the menu where you want the copy to appear, change its option number and enter a new HTML page to load in the Module Parameter field. Press Apply and your copy is complete.
To move a menu option you first make a copy of it, then enter the name of the new menu where you would like it to be located and any new properties. Press Apply, then Select the menu again from the list and press Remove to delete from the current menu. This completes the move. You may leave the menu option on the current menu, removing it is not required. In fact you may have any number of invocations of a module on any number of menus.