Adding a New Button to a Toolbar

This topic provides step-by-step instructions on creating a new button and adding it to an existing toolbar on a MicroStrategy Web page. Changes to a toolbar affect every instance of the toolbar.

Launch the New Toolbar Element Wizard.
Select the toolbar to which you wish to add a new toolbar button.
Click Next.
Click Browse under the Basic section to select an icon for the toolbar button.
Enter a description for the tool tip in the Tooltip Description text field.
Select the action that should be triggered as a result of clicking the new toolbar button.
- Command for this toolbar item: 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 toolbar 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
- None causes the button to execute no action.
Under the Advanced section, click Modify to select the web feature for enabling or disabling the toolbar button.

Web features should be separated by semicolons. If all conditions determined by the selected web features are true, the toolbar element 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.
Click Modify to select the web feature that determines when the toolbar button is to be displayed.

Web features should be separated by semicolons. If all conditions determined by the selected web features are true, the toolbar element 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 field for Target path.
Enter any necessary JavaScript code for the toolbar button. This JavaScript code is executed when the button is selected and can include a call to a function in the page.
Enter the extra URL in the text field for Extra URL. This content of this text box is appended verbatim to the end of the URL generated by the toolbar 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.
Check Create Text Shortcut, if required, and enter the text in the text box.
Click Next.
If you did not select the radio button for an event to be triggered on clicking the toolbar button, click Finish and save 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 toolbar button 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.
3. Enter a value for the argument in the Argument Value text field.
4. Enter the name of the base bean in the Base Bean text field.
5. Enter the name of the system bean in the System Bean text field.
Click Next. The wizard displays a summary of the changes made.
Click Finish to confirm changes.