About MicroStrategy objects

Your MicroStrategy project consists of several different types of objects, including reports, documents, filters, prompts, and more. The information below explains what purpose each object serves, and describes how you can use the object to better analyze your organization's data.

Providing business context to a report: Attributes Attribute icon

Attributes are the business concepts reflected in your stored business data in your data source. Attributes provide a context in which to report on and analyze business facts or calculations. While knowing your company’s total sales is useful, knowing where and when the sales took place provides the kind of analytical depth users require on a daily basis.

For example, you have a report containing the Month, Year, and Region attributes, as well as a Revenue metric. When executed, the report displays your company’s revenue for each region, during each month and year for which data is available. Because of the attributes on the report, a substantial amount of information is available, including which regions produced the least revenue and which years saw the highest growth in revenue. If you remove the attributes from the report, you can only find out how much revenue the company made in total.

Calculating data on a report: Metrics Metric icon

Metrics are MicroStrategy objects that represent business measures and key performance indicators. From a practical perspective, metrics are the calculations performed on data stored in your database, the results of which are displayed on a report. Metrics are similar to formulas in spreadsheet software. It is not an overstatement to say that the focus of almost any report is its metrics. Most of the decisions you make about the other objects to include on a report depend on the metrics you use on the report. Questions such as ”What were the sales for the eastern region during the fourth quarter?” or ”Are inventory counts being consistently replenished at the beginning of each week?” can easily be answered by metrics.

Filtering data on a report: Filters Filter icon

A filter is the part of a MicroStrategy report that screens data in your data source to determine whether the data should be included in or excluded from the calculations of the report results. Filters are helpful in clarifying large quantities of data and only displaying subsets of that data, so reports show users what they really need to see.

For example, you want to determine the number of injuries to your delivery personnel in 2005 that may have been due to bad winter weather in the northeastern U.S. You also want to know the time of day when most injuries occurred. You place the Delivery Location and Delivery Time attributes on your report. You also place the Number of Reported Injuries metric on the report. But you only want the report to display injuries in your northeast region during the winter of 2005. Without a filter, you would have to sift through a lot of report data on your own. By creating a filter that includes Northeast Region, January 2005, and February 2005, and using that filter on the report, the data displayed when the report is executed is limited to that geographical region and season. For details, see Retrieving specific data from sources: Filters.

Asking for user input: Prompts Prompts icon

A prompt is a question the system presents to a user during report execution. How the user answers the question determines what data is displayed on the report when it is returned from your data source.

For example, an analyst in an accounting company needs a report designed to show actual revenue and forecasted revenue for his company’s clients. However, the analyst does not want to see data for every corporation with whom his company does business; he is only interested in seeing revenue and forecasts for certain corporations and only for the current year. The report designer can create one prompt that asks users to select which corporations they want to see data for, and another prompt that asks users what year they want to see data for. The report designer places the prompts on a report. When the analyst executes the report, he is prompted to answer these questions before the report’s SQL query is sent to the data source, and as a result the report displays revenue and forecast numbers for only those corporations and year that this analyst is interested in seeing. For details, see Asking for user input: Prompts.

Designing a report’s structure: Templates

A template is the structure that underlies any report. A template specifies the set of information that the report should retrieve from your data source, and it also determines the structure in which the information is displayed in the report’s results. A template’s structure is the location of objects on the template, such as showing that metrics have been placed in the report’s columns, and attributes have been placed in the rows; the Revenue metric has been placed to the left of the Revenue Forecast metric so that a user reading left to right can see current revenue before seeing forecasted revenue; and so on.

Reports Grid icon Graph icon Grid Graph icon   

A report is a MicroStrategy object that represents a request for a specific set of formatted data from your data source. In its most basic form it consists of two parts:

For details, see About reports.

Documents Documents icon

A MicroStrategy Report Services document contains objects representing data coming from one or more reports, as well as positioning and formatting information. A document is used to format data from multiple reports in a single display of presentation quality. Most data on a document is from an underlying dataset, which is a standard MicroStrategy report. Other document items that do not originate from the dataset are stored in the document's definition. Examples of these other items are static text fields, document page numbers, and images. For details, see Running, analyzing, and saving documents.