MicroStrategy ONE

Changing Prompt Layout on the Prompt Question Page

By default, when you display all of a report’s prompts on a single page in MicroStrategy Web, they are stacked vertically (that is, each prompt question appears below the previous one). In some cases, you may want to conserve space and reduce the amount of scrolling necessary by displaying prompt questions horizontally, rather than vertically.

In this customization scenario, you display three prompt questions side-by-side instead of placing the next prompt question below.

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. Create a new plug-in and give it a meaningful name. For example: ChangingPromptLayout. 

  3. Exit the Web Customization Editor. 

  4. Create an XML file, PromptQuestionHorizontalViewRoll.xml. The sample, PromptQuestionHorizontalViewRoll.xml,contains the entire code for this layout definition file. 

  1. Save this custom XML file, PromptQuestionHorizontalViewRoll.xml, in the plugins\pluginName\WEB-INF\xml\layoutsCS\mstr\layouts subfolder inside the MicroStrategy Web installation folder. For example: plugins\ChangingPromptLayout\WEB-INF\xml\layoutsCS\mstr\layouts. 

  2. Create layout definition files PromptsContainerLayout_widget.xml (if you wish to view the customization in DHTML mode) and CustomPromptsSampleLayout.xml (if you wish to view the customization in HTML mode). The samples, PromptsContainerLayout_widget.xml and CustomPromptsSampleLayout.xml contain the entire code for the layout definition files. 

  3. Paste the files in your customization plug-in folder.  For example: plugins\ChangingPromptLayout\WEB-INF\xml\layouts. 

  4. Open this copy of PromptsContainerLayout_widget.xml for editing and replace the default plug-in name DefaultPlugin with the name of your customization plug-in.:

    Before customization:

    <mstrlayout:bSetProperty path="layoutClass" value="@DefaultPlugin:mstr.layouts.PromptQuestionHorizontalViewRoll"/>

    After customization:

    <mstrlayout:bSetProperty path="layoutClass" value="@ChangingPromptLayout:mstr.layouts.PromptQuestionHorizontalViewRoll"/>ZYZ

  1. If the Web Customization Editor is closed, launch it again and access your plug-in. 

  2. 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. 

  3. Click on Styles to expand the list of styles used in MicroStrategy Web. 

  4. Double-click PromptsContainerStyle_Widget  to open the Style Properties editor in the right frame. 

  5. Click the Style Layouts tab at the bottom. 

  6. Click ... and navigate to the custom layout definition file, PromptsContainerLayout_widget.xml in the plugins\ChangingPromptLayout\WEB-INF\xml\layouts subfolder inside the MicroStrategy Web installation folder. 

  7. Click Open. 

  8. Save your changes. 

  9. Double-click PromptsTransformClassic to open the Style Properties editor in the right frame. 

  10. Click the Style Layouts tab at the bottom. 

  11. Click ... and navigate to the custom layout definition file, CustomPromptsSampleLayout.xml in the plugins\ChangingPromptLayout\WEB-INF\xml\layouts subfolder inside the MicroStrategy Web installation folder. 

  12. Click Open. 

  13. Save your changes. 

  14. Launch MicroStrategy Web to view the customization.

See Also