Skip to main content

Hierarchy Reporting with Ragged Hierarchies

KB300417: New feature in MicroStrategy 10.4 Secure Enterprise Platform: Hierarchy Reporting



Hierarchy Reporting is a new feature introduced in MicroStrategy 10.4 Secure Enterprise Platform. This technical note explains the supported configurations, required changes in MicroStrategy Web preferences, a Hierarchical Attribute and its creation steps, and general features of Hierarchy Reporting.
Mar 30, 2017KB Article
Content
SUMMARY:
Hierarchy Reporting is a new feature introduced in MicroStrategy 10.4 Secure Enterprise Platform. This technical note explains the supported configurations, required changes in MicroStrategy Web preferences, a Hierarchical Attribute and its creation steps, and general features of Hierarchy Reporting.

WHAT IS HIERARCHY REPORTING?
Unbalanced hierarchies(also known as ragged hierarchies) are hierarchies with branches that descend to inconsistent levels. For example, in an Employee hierarchy, different parts of the organizational structure will have more management levels than others. 
Many organizations have aspects of their business that are organized in unbalanced hierarchies. Besides the Employee hierarchy, other typical examples include a chart of accounts, complex product portfolios, and multinational geographic groupings. 
Hierarchy Reports are a class of reports in which the data is naturally organized and presented in a hierarchical structure. Hierarchy Reporting features treat hierarchies as a first-class citizen, and make interacting with entire hierarchies intuitive and efficient. Both balanced and unbalanced hierarchies may be represented in a hierarchy report, although unbalanced hierarchies benefit the most from Hierarchy Reporting features.

SUPPORTED DATA SOURCE AND INTERFACES
In MicroStrategy 10.4 Secure Enterprise Platform, the following data sources are supported for Hierarchy Reporting. See the Readme for the exact database versions supported.
  • Microsoft Analysis Services
  • Oracle Essbase
Hierarchy Reporting features are currently supported only in Dashboard (Visual Insight). Normal reports, Report Services documents, and Mobile are not supported in version 10.4.

WEB PREFERENCE
Hierarchy Reporting is released as a Preview feature in MicroStrategy 10.4 Secure Enterprise Platform. When MicroStrategy is installed, Hierarchy Reporting will be disabled by default. To enable Hierarchy Reporting, implement the following steps:
  1. Log into MicroStrategy Web as an administrator.
  2. On the upper right of any page, click on the user name, and then select Preferences from the drop-down list.
  3. By default, the General preferences at the User Preferences level page is displayed. On this page, go to the Features for Customer Feedbacksection. For the Financial Reporting feature, change the feature status to “On” as shown below.
    1.jpg
    1.jpg
  4. At the bottom of the page, click on Apply

HIERARCHICAL ATTRIBUTE
In order to facilitate the building of hierarchy reports, 1MicroStrategy Secure Enterprise Platform 10.4 introduces a new type of attribute: the hierarchical attribute. The hierarchical attribute represents an entire hierarchy and all its levels. For example, you may have a Time hierarchical attribute that represents the Time hierarchy, including its levels Year, Quarter, Month, and Day. In contrast, a normal attribute usually represents a single level of a hierarchy (e.g., Year). The hierarchical attribute can be placed on a grid, filtered, and sorted, much like a normal attribute.

CREATING HIERARCHICAL ATTRIBUTES WITH DATA IMPORT
To create a hierarchy report, the first step is to perform a Data Import and connect to an OLAP data source. There are two ways to initiate the Data Import:
1) Create a standalone Intelligent Cube
The Intelligent Cube can be used to create dashboards at a later time. To import data into an Intelligent Cube, click on the Create button in the upper left of any page, and select Add External Data.
2) In Visual Insight Dashboard, import data
Data can be imported from within a dashboard. Create a new dashboard by clicking on the Create button in the upper left of any page, and select New Dashboard. In the dashboard toolbar, click the arrow next to the Add Dataset icon
2.jpg
2.jpg
, then select External Data

Once Data Import is initiated, take the following steps to create hierarchical attributes:
  1. In the 'Connect to Your Data' page, click OLAP. The 'Import From Cubes' page opens.
  2. From the MDX Connections panel on the left, select the name of the data source connection that contains the data to import. The cube catalog is displayed in the Browse Catalog panel.
  3. Click on the arrow to the left of the cube catalog to see a list of the cubes in the selected data source.
  4. To add a cube to import, click and drag the name of the cube from the Browse Catalog panel to the Editor panel on the right of the page. The cube name is displayed in the Editor panel.
  5. Below the Editor panel, select the option to Import hierarchy as hierarchical attribute.
  6. Click Finish.

Using Hierarchical Attributes in a Visual Insight Dashboard
When a Visual Insight dashboard is linked to a dataset, the hierarchical attributes are listed in the Datasets Panel. Hierarchical attributes will be denoted with the
3.jpg
3.jpg
icon. To use a hierarchical attribute in a visualization, simply drag-and-drop the desired hierarchical attribute into the main panel.
To search for the desired hierarchical attribute, use the Search box at the top of the Datasets Panel.
When the hierarchical attribute is first placed on a grid, the hierarchy will be displayed with its element tree collapsed. Elements can be expanded and collapsed by clicking on the + (expand) or  (collapse) button next to the element.
4.jpg
4.jpg



NAVIGATION SHORTCUTS
Every level of the entire hierarchy can be expanded or collapsed by using the Expand/Collapse All Levels shortcut.
  1. Hover over the row or column header to reveal an arrow on the right side of the header. Click on the arrow.
  2. Select Expand All Levels or Collapse All Levels.

A similar shortcut is available for each element as well, in order to expand every level of a branch.
  1. Right click on an element of a hierarchy.
  2. Select Expand All Lower Levels.

SORTING
When a report with a hierarchical attribute is sorted, the structure of the hierarchy will remain intact, so every element will retain its parent in the hierarchy tree. Each level of the hierarchy will be sorted separately from the other levels.
To sort on a hierarchy or a metric, hover over the row or column header to reveal an arrow on the right side of the header. Click on the arrow. The sorting options available are:
  • Sort Ascending
  • Sort Descending
  • Advanced Sort

The Advanced Sort dialog will allow users to:
  • sort on multiple hierarchical attributes or metrics
  • sort on alternative attribute forms, such as ID or Description

FILTERING
To filter the data in a dashboard sheet, drag a hierarchical attribute into the Filter Panel. The Filter Panel will display the elements of the hierarchy in a tree. Select or deselect elements to filter the data.

FILTER SELECTION SHORTCUTS
Groups of elements can be selected or deselected with the use of shortcut buttons. There are two types of shortcuts: branch selection, and level selection.
Users may want to see all elements of a hierarchy branch. For example, if users want to see the Year 2015 along with all Quarters and Months of 2015. To select or deselect all elements of a branch in the Filter Panel, hover over an element to reveal the branch selection shortcut
6.jpg
6.jpg
to the right of the element. Click on the branch selection shortcut.
Users may also want to see only the elements of a particular level of the hierarchy. For example, a user may want to see data at the Year level for every Year, but not data at the Quarter or Month levels. The level selection shortcut is a row of buttons above the hierarchy. 
5.jpg
5.jpg

To select or deselect all elements of a level, click on the button corresponding to the hierarchy level. Clicking on the All button will select or deselect all elements.

APPLYING MULTIPLE FILTER CHANGES ALL AT ONCE
By default, each time a change to the filter is made, the data in the sheet will be immediately refreshed. If the sheet contains large amounts of data, it may be helpful to apply a number of filter changes all at once. In order to be able to make a number of changes to the filter before applying it, click on the arrow at the top right of the Filter Panel, and de-select the Auto-apply Filters option. An Apply button will appear at the top of the Filter Panel.
For more information on the Visual Insight Dashboard Filter Panel, see Creating filters for a sheet of data.

VISUAL INSIGHT DASHBOARD FEATURES NOT SUPPORTED BY HIERARCHY REPORTING IN MicroStrategy Secure Enterprise Platform 10.4
The hierarchical attribute is not supported by some features in Visual Insight Dashboard. When a hierarchical attribute is in the dashboard’s dataset, the unsupported features will be disabled in the interface.
The following features are not supported by the hierarchical attribute. (For each feature, the location of the feature in the interface is listed. When there are multiple ways to perform the action, only one of the ways is documented below.)
  • Convert to Document (File > Convert to Document)
  • Download dashboard (File > Download Dashboard)
  • Adding multiple datasets (File > Add Data)
  • Replace dataset (Dataset menu > Replace Dataset With)
  • Create Group (Right click on grid element > Group)
  • Create Calculation (Right click on grid element > Calculation)
  • Alternative display styles for the Filter Panel (Filter menu > Display Style)
  • Exclude option for filtering (Filter menu > Exclude)

Comments

Popular posts from this blog

MicroStrategy URL API Parameters

MicroStrategy URL Structure The following table summarizes the root URL structure used for every request to MicroStrategy Web. Environment Main Application URL Administration URL J2EE http://webserver/MicroStrategy/servlet/mstrWeb http://webserver/MicroStrategy/servlet/mstrWebAdmin .NET http://webserver/MicroStrategy/asp/Main.aspx http://webserver/MicroStrategy/asp/Admin.aspx Every request sent to MicroStrategy Web calls a central controller. Parameters are appended to  Main.aspx  or  mstrWeb  (in a .NET and J2EE environment, respectively) to indicate to the controller how the request should be internally forwarded and handled. The following examples show a URL for accessing a MicroStrategy folder when the user does not have an existing session. The URL contains not only the parameters needed to connect to MicroStrategy Web, but also the parameters needed to log on and create a session. J2EE environment: <a href="http:...
MicroStrategy Developer Preferences options are expanded so big that some options are being cutoff. Show the hidden objects in the  Microstrategy  developer MicroStrategy Developer Preferences options are expanded so big that some options are being cut off. The steps below given in the MSTR article may not work. This can be simple handled by using the steps below:  In the Microstrategy Developer go to Tools -> Preferences (Not my prefernces :) ) Under Developer category -> select Browsing on the browsing tab you see all the options like below: 3. Now using the mouse place the cursor on text box of 10000 which is next to 'Maximum number of monitoring objects displayed per page. 4. Then Hit Tab on Keyboard and hit another Tab on keyboard 5. Then press the space or down arrow on keyboard and click on OK or Enter. That will show the hidden objects in the Microstrategy developer   Normal Version ...

Microstrategy Dossiers explained

Microstrategy  Dossiers With the release of MicroStrategy 10.9, we’ve taken a leap forward in our dashboarding capabilities by simplifying the user experience, adding storytelling, and collaboration.MSTR has  evolved dashboards to the point that they are more than dashboards - they are  interactive, collaborative analytic stories . Ultimately, it was time to go beyond dashboards, both in concept and in name, and so  the've  renamed VI dashboards to  ‘ dossiers ’.  Dossiers can be created by using the new Desktop product or Workstation or simply from the Web interface which replaces Visual Insights. All the existing visual Insights dashboards will be converted to Dossiers   With MicroStrategy 10.9, there was an active focus on making it easier to build dashboards for the widest audience of end users. To achieve this, some key new capabilities were added that make it easier to author, read, interact and collaborate on dashboards ...

Creates a report delivery schedule in Microstrategy

Creates a Report Delivery Schedule  in Microstrategy  Syntax: CREATE SCHEDULE  schedule_name  [DESCRIPTION  description ]  [LONGDESCRIPTION long_desc ription ]  STARTDATEstart_dateENDDATE (end_date| NEVER) TYPE (EVENTTRIGGERED EVENTNAMEevent_name| TIMETRIGGERED (DAILY EVERY (numberDAYS | WEEKDAY) | WEEKLY EVERYnumberWEEKS ONday_of_week1[,day_of_week2[,...day_of_week7]] | MONTHLY (DAYnumberOF EVERYnumberMONTHS | (FIRST | SECOND | THIRD | FOURTH | LAST) (day_of_week1|day_of_week2| ... |day_of_week7) OF EVERYnumberMONTHS) | YEARLY ((month_of_year1|month_of_year2| ... |month_of_year12)number| (FIRST | SECOND | THIRD | FOURTH | LAST) (day_of_week1|day_of_week2| ... |day_of_week7) OF (month_of_year1|month_of_year2| ... |month_of_year12))) EXECUTE (time_of_day| ALL DAY EVERY (numberHOURS |numberMINUTES |numberHOURSnumberMINUTES) [STARTTIMEtime_of_day] [ENDTIMEendtime_of_day])); where: schedule_name  is the name of the schedule to be creat...

mstrio – Python and R wrappers for the MicroStrategy

mstrio – Python and R wrappers for the MicroStrategy REST APIs Connecting to MicroStrategy  Create a connection to the Intelligence Server using   Connection()   and    connect()  in Python and R, respectively. Required arguments for the   Connection()  function are the URL for the MicroStrategy REST API server, MicroStrategy Intelligence Server username and password, as well as the MicroStrategy project name. By default, the   connect()  function anticipates your MicroStrategy Intelligence Server username and password. LDAP authentication is also supported. Use the optional argument    login_mode=16    in the    connect()  function for LDAP authentication.  Extract data from cubes and reports  To extract data from MicroStrategy cubes and reports, use the   get_cube()  and   get_report()  functions. Use...

Microstrategy "Error type: Odbc error. Odbc operation attempted

 "Error type: Odbc error. Odbc operation attempted: SQLExecDirect. [HYT00:0: on SQLHANDLE] [MicroStrategy][ODBC Oracle Wire Protocol driver]Timeout expired" is shown when executing reports from Web When users are trying to execute some reports in MicroStrategy web in particular, they may receive the Error “SQL Generation Complete Index out of range” and “Timeout expired” error as shown below: Possible Causes: One possible cause is that the MicroStrategy Intelligence Server using a cached database connection that was already dropped by the RDBMS. To resolve this: Admin should delete the database connection caches and create a new DSNs in case they are sharing DSNs to connect to different databases. In addition, change the settings for the ‘Connection lifetime’ and the ‘Connection idle time out’.  Follow the steps below to perform the mentioned changes and verify the report after each step and some of the settings require i-server r...
Star schemas and aggregate (or summary) fact tables Aggregate tables can further improve query performance by reducing the number of rows over which higher-level metrics must be aggregated.  However, the use of aggregate tables with dimension tables is not a valid physical modeling strategy. Whenever aggregation is performed over fact data, it is a general requirement that tables joined to the fact table must be at the same attribute level or at a higher level. If the auxiliary table is at a lower level, fact rows will be replicated prior to aggregation and this will result in inflated metric values (also known as "multiple counting"). With the above Time dimension table, a fact table at the level of Day functions correctly because there is exactly one row in DIM_TIME for each day. To aggregate the facts to the level of Quarter, it is valid to join the fact table to the dimension table and group by the quarter ID from the dimension table. Sql select DT...

Best practices for scheduling jobs and administrative tasks in Microstrategy

Best practices for scheduling jobs and administrative tasks Below are the recommended best practices when scheduling jobs and administrative tasks in MSTR: Executing simultaneous reports can strain system resources. If you have many reports or tasks that need to be executed on the same time-based schedule, consider creating several similar schedules that trigger 15 minutes apart. For example, one schedule triggers at 8 AM every Monday, and another triggers at 8:15 AM. To prevent users from scheduling many simultaneous reports, you can prevent users from scheduling jobs using a schedule by editing the schedule’s Access Control List (ACL). To do this, in the Schedule Manager, right-click the schedule and select  Properties , then select the Security tab in the Properties dialog box, and make sure that only users who can use the schedule have Modify or Full Control access to the schedule.  Establish reasonable limits on how many scheduled jobs are allowed. For details on ...

Create an alert-based subscription in MicroStrategy Distribution Services

Create an alert-based subscription in MicroStrategy Distribution Services on Web Subscription to a report or Report Services document which will be executed when a certain conditional threshold is met based on another executing report. For example, a scheduled report executes which shows the Revenue by day for the past week. If the Revenue on any one day falls below a certain value, a subscription to another report or Report Services document can be triggered and delivered to a recipient. An alert based subscription can only be created directly on a report; however, another report or Report Services document can be delivered when the alert based subscription is triggered. Note: you need a grid report to create an alert and you cannot create if you want to create on a document with text boxes. The following example will walk through the basic steps on how to setup a subscription based on an alert like this: Follow the brief  steps bel...

Case functions Microstrategy

Ca se functions Microstrategy Case functions return specified data in a SQL query based on the evaluation of user-defined conditions. In general, a user specifies a list of conditions and corresponding return values. Case This function evaluates multiple expressions until a condition is determined to be true, then returns a corresponding value. If all conditions are false, a default value is returned.  Case  can be used for categorizing data based on multiple conditions. This is a single-value function. Syntax Case ( Condition1 ,  ReturnValue1 ,  Condition2 , ReturnValue2 ,...,  DefaultValue ) Example Case(([Total Revenue] < 300000), 0, ([Total Revenue] < 600000), 1, 2) sum(Case (Day@DESC in (“Sat”,”Sun”), Sales, 0) {~+} Sum(Case(Category@DESC In("Books","Electronics"),Revenue,0)){~+} CaseV (case vector) CaseV  evaluates a single metric and returns different values according to the results. It can be used to perfo...