Adding a New Item to a Menu

This topic provides step-by-step instructions on adding a menu item (menu or a submenu item) to an existing menu on a MicroStrategy Web page. Changes to a menu affect every instance of the menu.

Launch the New Menu Element Wizard.
In the wizard, select Add Menu Item and click Next. The New Menu Element Wizard displays a tree menu on the page.
Select the menu to which the new item is to be added and click Next.
Enter a name for the item in the text box for Type in a name for new menu element or click ... to use an existing descriptor.
Select the type of action that should be triggered as a result of clicking the menu item. The options are:
- Command for this menu element: executes a client-side Javascript command
- A hyperlink to a different page:
  
  If you select a hyperlink to a different page, the Target for this menu element drop-down menu is enabled and you must select a target.
  
  If you select Append state, the state of beans represented on the page is appended to the end of the URL request. This option is usually not selected when linking to a new report or document or to an external target.
- An event within MicroStrategy Web: executes a server-side Java event
Under the Advanced section, indicate web features to serve as conditions for enabling or disabling the menu item.

Web features should be separated by semicolons. If all conditions determined by the selected web features are true, the item is enabled.

If you wish to use a shopping cart, click Modifynext to the text box. In the shopping cart, selecting the check box next to a selected feature sets the feature as a positive condition; deselecting the check box sets it as a negative (not) condition.
Under the Advanced section, indicate web features to serve as conditions to determine when the menu item is to be displayed.

Web features should be separated by semicolons. If all conditions determined by the selected web features are true, the item is enabled.

If you wish to use a shopping cart, click Modify next to the text box. In the shopping cart, selecting the check box next to a selected feature sets the feature as a positive condition; deselecting the check box sets it as a negative (not) condition.
Enter the name of the listener method in the text box for Type in the listener method.
Enter the target path in the text box for Target path.
Enter any necessary JavaScript code for the menu item. This JavaScript code is executed when the item is selected and can include a call to a function in the page.
Enter the extra URL in the text box for Extra URL. The content of this text box is appended verbatim to the end of the URL generated by the menu item selection.
Select Trigger IFrame manipulation, if required. This feature causes the server to update only those parts of the screen that need to be updated when the menu item is selected.
Click Next.
If you did not select the radio button for an event to be triggered on clicking the menu item, click Finish to complete your changes. Otherwise, follow the remaining instructions.
Click Browse in the Event section to select the enumeration class for the event.
Select the event from the drop-down menu to specify the event that will be triggered when the menu item is clicked.
Enter the name of the base bean for the event.
If you specified the presence of arguments for the event, click the Add button in the Event Arguments section and select an argument from the dialog that opens. Repeat this step until all required arguments have been added.
Complete the following steps for each event argument.
1. Click the event argument in the Event Arguments list to highlight it.
2. Select the appropriate block from the Block Type drop-down menu: either EventArgument or EventGetterArgument.
3. Enter a value for the argument in the Argument Value text box.
4. Enter the name of the base bean in the Base Bean text box.
5. Enter the name of the system bean in the System Bean text box.
Click Next. The wizard displays a summary of the changes made.
Click Finish to confirm changes.