Develop > Wizards Guide > Calling Wizards > Call a wizard from menus

Call a wizard from menus

To set up a wizard to be called from menus, follow these steps:

  1. Click Tailoring > Tailoring Tools > Menus.
  2. Select a menu record.
  3. Add an option number; a group, if necessary; and a description with the name that you want to display on the menu.
  4. Enter wizard.run for the application.
  5. In the Parameter Name field, specify the name of the parameters to pass to the application. The name of the parameters to pass to the application should be enclosed with quotes "" and curly brackets {}. The available parameters for the wizard.run application are: file, name, text, and prompt.
  6. In the Parameter Value field, specify the value of the parameter being passed, enclosed with quotes "" and curly brackets {}. For example, {"createUser Pre"}.

Example:

In this example, a wizard is set up to be called from the SYSTEM ADMINISTRATION menu through the option Quick Add Utility. Once the wizard is set up, the user clicks the following:

System Administration > Ongoing Maintenance > User Quick Add Utility

When the user clicks User Quick Add Utility on the menu, a wizard opens with a predefined set of steps that assist the user in populating information and completing the task of adding an operator.

To see how this wizard has been set up to be called from menus, follow these steps:

  1. Click Tailoring > Tailoring Tools > Menus.
  2. Open the SYSTEM ADMINISTRATION menu record.
  3. The Description field displays User Quick Add Utility.
  4. The Application field specifies wizard.run, the RAD application called from the menu.
  5. The Parameter Name field specifies the name of a single parameter to pass to the menu item. In this example, {"name"} represents the name of the wizard. The name is enclosed with quotes "" and curly brackets {}.
  6. The Parameter Value field specifies the value of the parameter being passed. In this example, {"createUser Pre"}. The name is enclosed with quotes "" and curly brackets {}.