MicroStrategy ONE

Adding Localized Text to the Browser Title for a Page

In this scenario, add a string of text to localized descriptor files in Messages Bundle such that the text is displayed in the browser title. This is the text displayed within the <TITLE> tag. The Messages Bundle and Localized Descriptor Files are located in WEB-INF/classes/resources directory.

Several MicroStrategy Web pages such as Report Execution page, Document Execution page, and Folder Browsing pages display the text in the browser's title dynamically based on the content being rendered. That is, the Report Execution page displays the name of the report while the Folder Browsing pages displays the name of the folder being browsed. Since the displayed text is dynamic, this customization scenario is not applicable to these MicroStrategy Web pages. This customization scenario works only for those MicroStrategy Web pages which have static text displayed in the browser's title. This list of pages include Login page, Welcome page, Desktop page, History List page, My Subscriptions page and Logout page.

In this scenario, you add localized text to the browser title for the Desktop page. By default, this page displays Home in the browser title. The static text is customized to display My Custom Browser Title.

Before customization:

After customization:

This customization can be accomplished using either of the following methods:

Deploying the plug-in provided with MicroStrategy SDK

MicroStrategy SDK provides a plug-in (ZIP file) that can simply be extracted to thepluginsfolder to view the customization in MicroStrategy Web. The following steps guide you in locating the plug-in and deploying it. 

  1. Access the plug-in: JSP version or ASP .NET version. 

  2. Extract the plug-in to the plugins subfolder inside the MicroStrategy Web installation folder.   

  3. Launch MicroStrategy Web to view the customization.

Using the Web Customization Editor to create a plug-in

MicroStrategy SDK provides a Web Customization Editor that can be used to create a customization plug-in. The following steps guide you in creating the plug-in and deploying it. 

  1. Launch the Web Customization Editor. 

  2. Enable the Property Files setting from the Show Advanced Options in MicroStrategy Preferences. 

  3. Click on MicroStrategy Web Configuration inside the Application Settings view to expand the hierarchical tree. The expanded list comprises the different settings that can be modified to perform customizations. 

  4. Click on Property Files to expand the list of property files used in MicroStrategy Web. 

  5. Navigate to WEB-INF->classes->resources and double-click on MessagesBundle_en_US.properties to launch the Web Properties Editor. 

  6. Enter a new property-value pair in the text field at the bottom confirming to the syntax nameOfProperty=value. For example: scenario1.2=My Custom Browser Title. 

  7. Click Add. 

  8. Save your changes. 

  9. Navigate upwards in the hierarchical tree and click on Pages to expand the list of pages used in MicroStrategy Web. 

  10. Double-click the desktop (Desktop) page to view the Basic Properties editor. 

  11. Update the value in the Descriptor ID text field to scenario1.2. 

  12. Save your changes. 

  13. Launch MicroStrategy Web to view the customization.

See Also