Skip Navigation
Online help
HTML Documents

HTML documents
The difference between documents and HTML documents
Run and view an HTML document
Error within a report included in an HTML document
XSL files
Drill from an HTML document
Report link in an HTML document
Export HTML documents
Refresh HTML documents
Viewing HTML document details
Prompted HTML documents
Print HTML documents

HTML documents
HTML documents are used to display multiple reports on the same page, along with customized HTML formatting. Using MicroStrategy Desktop, a report designer can create or select an HTML file and insert multiple grid or graph reports in this HTML document for display on MicroStrategy Web.

Reports can be displayed in grid mode, graph mode, or both. Each report can have its own custom XSL file associated with it, allowing the report designer to have each grid report in the HTML document displayed in its own style. HTML elements, such as hyperlinks, images, and scripting languages, can also be added to the HTML document.

The difference between documents and HTML documents
HTML documents in the MicroStrategy platform were formerly called documents. They are HTML shells into which you can place MicroStrategy reports and other graphics, and control the formatting and appearance with stylesheets.

A MicroStrategy Report Services document contains objects representing data coming from one or more reports, as well as positioning and formatting information. It is used to format data from multiple reports in a single display of presentation quality.

Note: You can use Web to create a Report Services document from scratch. See Documents - Basics for more information.


Run and view an HTML document
When you run an HTML document using MicroStrategy Web, you are required to answer any prompts contained in any of the reports in the HTML document. (Identical prompts are only displayed once.) After all the required prompts have been answered, the MicroStrategy Intelligence Server executes each of the reports in the HTML document, formats them as specified in each report's XSL, and inserts the result into the appropriate location in the HTML document's HTML file. This completed HTML page is then displayed in MicroStrategy Web.

Error within a report included in an HTML document
an HTML document can run even if one of its reports results in an error. An error message is displayed where the report would normally appear in the HTML document; the rest of the HTML document is displayed as specified.

XSL files
Custom XSL files can be used to format reports. After a report is selected for inclusion within an HTML document, the designer has the option to change the XSL file associated with that report. MicroStrategy includes a library of XSL files from which the designer can choose, providing a number of options for the look and feel of the HTML document. However, if the designer chooses to use the default XSL formatting file provided with MicroStrategy Desktop, the report displays in the HTML document with the same formatting as saved in the report definition.

Note: A report in an HTML document must use the default stylesheet (default.xsl) for thresholds to work.

Drill from an HTML document
If there are hyperlinks in a report, these hyperlinks also appear in the HTML document that includes this report. You can click the hyperlinks to drill down from the HTML document to a new drilled-on report in MicroStrategy Web.

Report link in an HTML document
If the report designer uses a standard MicroStrategy XSL for a report in an HTML document, a link appears under that report within the HTML document. Clicking that link brings you from the HTML document to the report in MicroStrategy Web. You can then manipulate the report as you would normally.

Export HTML documents
See Exporting HTML documents.


Refresh HTML documents
See Report and HTML document execution.

Viewing HTML document details
While in View mode, you can view the details of any HTML document. From the File menu, select Document Details. The HTML Document Details page opens and provides information about each individual report that makes up the document, as well as additional information about the document itself.

Prompted HTML documents
When you run a prompted HTML document using MicroStrategy Web, you must first answer the prompts that appear in any of the reports in the HTML document. This process is similar to answering the prompts in a single report, with the advantage that if the same prompt appears in multiple reports on the same HTML document, you only have to answer that prompt once. After all the prompts have been answered, the MicroStrategy Intelligence Server executes each of the reports in the HTML document, formats them as specified in each report's XSL, and inserts the result into the appropriate location in the HTML document's HTML file. This completed HTML page is then displayed in MicroStrategy Web.

Also see Prompts.


Print HTML documents
See Printing.