Adding a Bean to a Page

This topic provides step-by-step instructions on adding an instance of a bean class to a MicroStrategy Web page.

1. Launch the New Web Bean Wizard. 

2. Enter a name for the bean in the Name text box. 

3. Click the ... button to select a system bean or to specify a fully qualified bean class. 

4. Select a persist mode for the bean using the Persist Mode drop-down menu. Persist modes include the following options. 

   • None: the bean does not persist beyond the current page.
     
   • Default: the bean does not persist beyond the current page.
     
   • Request: the bean persists throughout the request and ends with the request.
     
   • Preferences: the bean persists as long as the preferences for the user exist.
     
   • Session: the bean persists though the life of the session. 

5. Click Next. 

6. On the next panel of the wizard, use the shopping cart to select web features to be associated with the bean.

   If you highlight only one web feature in either pane, the declaration for that feature is displayed in the pane below, together with a brief explanation of what the feature does. If you highlight multiple features, only the text Multiple Selection is displayed.
   
   When you select a web feature, a check box appears next to it in the list of selected features. Selecting the check box adds the web feature as a position condition. Clearing the check box adds the web feature as a negative ("not") condition. For example, clearing the check box for the administrator web feature adds the condition "not administrator."
    

   On the Bean Properties tab, the feature is displayed in the list of features as !administrator.

7. Click Next. 

8. Click the appropriate radio buttons Yes or No to indicate if there is a custom event handler for the bean. 

9. If you selected Yes to indicate that there is a custom event handler for the bean, click the ... button to select the custom event handler. 

10. Click Next. 

11. Select initialization properties for the bean and click Next. 

12. Select request properties for the bean and click Next.

    The dialog box entitled Results displays a summary of your selections. 

13. Click Finish to confirm your choices.

    The new bean gets added to the list of beans for the page. 

14. Save your changes.

After you have completed this task, you must restart the application server for changes to take effect, unless the reloadConfigurationFiles property in microstrategy.xml is set to true. See Applying Customization Changes for information on changing the value of the reloadConfigurationFiles property.