3.3. Interactive Pages¶
The interactive pages of MQC are separated into 3 different types, that share the same functionality but differ in the information they present and how it is shown.
Quality
The Quality Page shows the Quality of your project that is calculated by definition of the quality model out of your data.
It is also possible to view the data related to that quality.
(see Data from Quality)
Data
The Data Page shows the Data of your project in the way it was imported by the Data Source Adapters.
It is also possible to view the data origins and open the relevant report files directly in MQC.
(see Data Origins)
Availability
The Availability Page shows the Availability of the data in your project and also highlights propagated data.
It is easy to see the still missing data, that is not excluded as “not expected” by context categories.
(see Context Categories)
3.3.1. Overview¶
Figure 3.10 Quality page with important features annotated¶
Menu
(see Menu)
UserGuide, Filter panel, Notifications
UserGuide - Link to the UserGuide.
Filter panel - Show or Hide the Filter Panel.
Notifications - Open the Notification menu where warnings and errors are listed. New Notifications pop up as messages temporarily before they disappear. Until the notifications are discarded, they remain in the notification list in the menu. Notifications should be considered with care and only ignored or discarded when the problems behind them are understood.
Page Navigation
All enabled pages for your project are shown in the page navigation and can be opened by clicking on them. It contains Dashboard, Interactive, and Custom Pages. Only an Editor user can remove and/or add pages.
Configuration Menu (only for Editors)
(see Managing Configurations)
Page Layout Switcher
The Page Layout Switcher allows you to select different predefined Page Layout from Template.
(see Templates)
Dashboard Controls (only on Dashboard Page)
(see Dashboards)
Toolbar Menu
The Toolbar menu contains all toolbar items for the current page, so in case some toolbar items are not visible because the screen width is not enough to render all the items, they are still accessible in this menu.
(see Toolbar)
Date Range Selection
(see Date Range Selection)
Revision Selection
(see Revision Selection)
Measure Selection (only on Data Page)
Artifact Structure Selection
(see Structure Selections)
Quality Property Structure Selection (only on Quality Page)
Measure Structure Selection (only on Data Page)
(see Structure Selections)
Active Markings
(see Active Markings)
Quality Assessment Scope (only on Quality Page)
(see Quality Assessment Scope)
View (only on Quality and Availability Page)
(see Views (Diff mode))
Diff Base (for Diff View)
The Diff base is relevant if the current global view mode or the view mode of one or more visualizations is set to Diff mode.
(see Views (Diff mode))
Data Import State
(see Data Import State)
Minimized Visualizations
Minimized Visualizations are collected on the left side of the page. They can be restored to the page by clicking on their tab or by dragging them into the page areas.
(see Visualizations)
Visualization Tabs (Visible and Invisible Visualizations)
Multiple visualizations can be placed together in a group. Only one visualization in a group is active, while the rest of the visualizations are inactive. By clicking on a tab, the clicked on visualization becomes active.
(see Visualizations)
Visualization Controls (Options, Minimize, Maximize)
Visualization Options are different for each visualization and allow specific settings for the visualization and/or the overriding of global toolbar options.
MQC allows you to maximize and minimize visualizations. When maximized, a visualization fills all page layout areas. However, the Page Layout is not modified and can be restored by clicking the restore (unmaximize) button.
(see Visualizations)
3.3.3. Page Layout¶
The page is divided into 3 different areas: Top, Kpi and Main.
While the Top and Kpi Area of the page collapses when all Visualizations inside these areas are minimized, the Main Area expands into the space a collapsed area leaves behind.
The Kpi Area is reserved only for Kpi Visualizations and Kpi Visualizations can only be placed into the Kpi Area.
The Top and Main Area support all Non-Kpi Visualizations.
Visualizations can be placed side by side or stacked to each other in any complex nesting.
Figure 3.11 Quality page with the 3 page layout areas highlighted¶
3.3.3.1. Visualizations¶
Visualizations can be:
Active
The visualization is visible and the tab of the visualization is in the active state.
Inactive
The visualization is part of a visualization group and is currently not the active tab.
Minimized
The visualization is removed from the page and minimized to the left of the page as a vertical tab.
Maximized
The visualization (and it’s group with inactive visualizations) take up the whole space of the page. The page layout is not modified and the visualization can be restored to its initial state.
3.3.3.2. Drag & Drop¶
The Page Layout can be modified through drag & drop.
Active, Inactive and Minimized Visualizations can be dragged from their current position and dropped at valid drop locations.
Figure 3.12 Quality page while dragging a visualization tab¶
Valid drop locations are:
Left or Right of a Visualization
By placing a visualization left or right of another visualization, it is placed side by side to it. Each visualization in a side by side takes up the same width. (e.g. 2 visualizations side by side means 50% of the width for each. 3 visualizations would mean a width of 33.34% for each)
Above or Below a Visualization
By placing a visualization above or below of another visualization, they are placed in a vertical stack. Each visualization in a vertical stack takes up the same height. (e.g. 2 visualizations side by side means 50% of the height for each. 3 visualizations would mean a height of 33.34% for each)
Next to a Visualization (Tab Position)
By placing a visualization next to another visualization it is put into a group with the visualizations already there. Only one visualization of a group can be active, the other visualizations in that group are inactive until their tab is clicked on.
3.3.3.3. Templates¶
The Editor can supply Page Layout Templates that provide predefined Page Layouts (see Pages Layouts). A predefined Layout can be applied by selecting it in the Page Layout Switcher.
MQC ships with 4 Page Layout Templates for the Quality Page for the most common use cases:
Status: Quality Status of one Revision
(with Kpis for Marking)
Trend: Quality Trend over a Date Range
(with Kpis for Marking)
Status with Data: Quality Status of one Revision with related Data Status
(Marking in Heatmap or Sunburst allows viewing of related data)
Trend with Data: Quality Trend over a Date Range with related Data Trend
(Marking in Trends allows viewing of related data)
3.3.4. Toolbar¶
Every page includes a Toolbar on top. Depending on the page type, the Toolbar contains different elements and displays relevant options for the current page. It shows, for instance, the selections of Date Range, Revision, Structures, and View mode that are applied and active. In addition, it allows quick access and fast modifications to these options.
3.3.4.1. Date Range Selection¶
Selecting a Date Range filters all visualizations and the Revision Selection. If the marked or selected revision is not part of the new date range, the latest revision in that time frame is selected automatically.
The date range selections provides different forms of selections:
Everything (Default)
All revisions of the project are shown.
This is the best selection for short projects, to get a full overview of your project.
Weeks or Months or Years
Select one or multiple weeks, months or years.
After selecting this form of selection, a week, month or year can be chosen in a date picker.
If more than one date is needed, additional dates can be added with the [+] button (e.g. 2 weeks for a fortnight).
The arrow buttons move the date range in one interval: week, month or year.
Manual
The manual selection allows for a date range based on a specific start and end date. These date can be chosen with a range date picker.
The arrow buttons move the date range in the duration chosen (e.g. if a start to end range of 3 months is chosen, the arrows switch to a date range of the next/previous 3 months.)
3.3.4.2. Revision Selection¶
One revision is always selected as the active revision for the status visualizations. Trend visualizations show a highlighting of this revision. By default the latest available revision is selected. By marking one or more revisions in a trend visualization, the options in this selection are reduced. Selecting an revision changes the information, that is show in the status visualizations. The Revision Selection can be overridden in visualization options of status visualizations.
3.3.4.3. Measure Selection (Data Page)¶
One measure (incl measurement) is always selected as the active measure for the visualizations. The Measure Kpi visualization shows a highlighting of the selected measure. By default the first available measure is selected. By marking one or more measures in a Measure Kpi visualization, the options in this selection are reduced. Selecting a measure changes the information that is show in the visualizations.
3.3.4.4. Structure Selections¶
Structure selections show the configured structures of the Quality Model, the Project and the Measures. The structure levels are shown in a tree dropdown, while the real structures are only visible in the visualizations (Heatmap, Sunburst and Kpis). When selecting a level in a structure, the Quality Properties or Artifacts that are not assigned to this structure are filtered out. By selecting different levels of a structure the visualizations aggregate the quality or availability in a way that respects the weights of the structures and its elements.
The Structure Selections can be overridden in visualizations that use the related structures.
3.3.4.5. Active Markings¶
There are different types of markings that act as filterings for other visualizations. (see Marking)
The toolbar item shows 5 categories of markings and informs if there is currently a marking in those marking categories:
Revisions
Marking in the Trend visualizations, used as filtering for Quality Properties or Measure Kpi, Artifact Kpi, Trend and Status visualizations.
Bins
Marking in the Bin Trend visualization (Legend), used as filtering for Quality Properties or Measure Kpi, Artifact Kpi, Trend and Status visualizations.
Artifacts
Marking in the Artifacts Kpi visualization, used as filtering for Quality Properties or Measure Kpi, Trend and Status visualizations.
Quality Properties
Marking in the Quality Properties Kpi visualization, used as filtering for Artifacts Kpi, Trend and Status visualizations.
Details
Markings in the Status or Trend visualizations, used as a filtering for the Data visualizations on the Quality Page.
The Marking toolbar item also allows the resetting of marking categories or all active markings by clicking the reset buttons.
3.3.4.6. Views (Diff mode)¶
Switching the view is possible with a click. The Default view shows the quality or availability of the project, while the Diff view shows the differences between Revisions or Revisions to the last Milestone as Increase or Decrease in percentage points.
3.3.4.7. Quality Assessment Scope¶
There a up to 3 different Quality Assessment Scopes:
Absolute
Shows the absolute Quality.
Available
Shows the same as Absolute, but the missing Quality is ignored.
Relative (only available if Target Values have been configured)
Shows the relative Quality related to target values. (e.g. if the quality for a specific artifact for a specific revision is 80% and the related target values is 80% the relative quality is 100%.)
3.3.4.8. Data Import State¶
This icon shows the current state of the imported data.
If the data is up to date, a green check mark is shown. If the monitoring detects a change in the data source a refresh button allows the manual update of the data.
3.3.5. Marking¶
By marking you can select one or more elements in visualizations. Elements can be a tile in Kpi, heatmap and sunburst visualizations, a legend item in trend visualizations or a bar in trend and status visualizations. The marked elements are highlighted and a button on the top right of a visualization is enabled, with which the marking can be reset. Keep the Ctrl or Shift button pressed during clicking on an element adds this element to the existing marking, so that you can mark multiple elements.
The purpose of marking elements in a visualization is to filter or highlight related data in other visualizations.
3.3.5.1. Data Origins¶
The Data Origins visualization is available on the Quality and Data page and shows a list of the imported data reports.
The list of reports in the visualization can be reduced by filtering (see :ref:´filter_panel´) and marking on the Quality and Data pages. Only the reports from one revisions are visible in the visualization at once. By marking a revision in the trend visualization or using the revision dropdown, the reports of another revision can be viewed. Reports that have been propagated from older Revisions are shown with grey text color.
This visualization shows the origin of the quality or data of the page and can be used to find and directly open the reports of data source for a specific artifact and revision. If additional human readable report files (e.g. html) were detected, they can also be accessed directly inside MQC.
Figure 3.13 Data Origins visualization in the Quality page with reports from MXAM.¶
Figure 3.14 Data Origins visualization in the Data page with reports from MXAM.¶
3.3.5.2. Data from Quality¶
The Data Trend and Data Status visualization are available in the Quality page and make it possible to easily deep dive into the underlying data, that was used to calculate marked quality values.
All markings on quality visualizations like artifacts, quality properties, quality bins and revisions, reduce the shown data in these data visualizations by marking.
Figure 3.15 Data Status and Trend visualizations in the Quality page to view the underlying data of quality by marking elements in quality visualizations.¶
As you can see in picture, with the flexibility to change the layout of the page and marking the intended items, MQC gives you a clear picture of transformation of data to quality.