10. Actions and Configuration Menu¶
Per default the menu is enabled on all MQC pages. You can simply
switch it on or off by clicking the
Menu icon within the MES Quality
Commander banner in the top-left.
The MQC Menu is divided into Actions and Configuration.
10.1.1. Refresh Data¶
Once you have configured Data Sources and imported data, you can gradually import your file reports by copying new files / directories into the configured directories. To consider your newly added files/directories, press the “Refresh” Button.
Each time you update Adapters configuration, to consider your changes (e.g. adding custom adapter or disabling base adapter), press the “Refresh” Button.
Alternatively, you can enable the Automatic Refresh checkbox, so that MQC refreshes the specified directories and files automatically when changes are detected.
MQC searches all configured files and subdirectories recursively to load new file reports into the collection of your analysis.
Changes inside the added directories (new files, removal of files or even changes within the files) are automatically detected.
When clicking on the Refresh button the message will show to the “Data is up-to-date” status message, after the data has been refreshed.
10.1.2. Dashboard Customization¶
This action is available on the Dashboard page only. The dialog provides different options to customize your Dashboard (see Dashboard). Clicking on this option makes the Dashboard editable. In other words, the tiles become volatile and the visualizations can be changed.
The different customization options once the dashboard is in edit mode are as follows:
Resize, by hovering over the boundary of the visualization and drag it to obtain the desirable size. There is however a limit to the minimum size a visualization can get.
Remove, by hovering the visualization and clicking the red button at the top right corner.
Rearrange, by dragging and dropping the visualization to another empty space of the same or larger size.
Additionally, a menu of options is present below the Customize Dashboard.
Add Tile button opens a new dialog with different groups of tiles
(Project, Quality, Availability, Action and Tool) that can be added.
Simply select the tile of your choice and click on the
Add button to
include it in the dashboard. If the minimum size of the tile cannot fit to the
available empty spaces then the tile cannot be added. If you would still like
to add another tile then close the “Add Tile” dialog and resize, rearrange or
remove existing tiles and try again.
Remove all tiles button provides an easy way to get an empty dashboard
by removing all tiles so that you can add the tiles of your choice later.
Reset to Default button will undo all the changes made and
reset the dashboard with the default tiles.
All the customizations made to the dashboard are persistent when the dxp is saved.
10.1.3. Show Diff View¶
This navigates to the Diff Page of the current page (see Quality Diff and Availability Diff). It is only available for the Quality pages and for the Data Availability page.
10.1.4. Show Data Details¶
In this dialog you get a drill down from Quality to Data (see Data Details Drill Down). This is only available for Quality pages.
10.1.5. Show Data Origins¶
This dialog allows you to directly access the data reports imported by MQC (see Data Origins).
10.1.6. Manage Pages¶
This section contains all pages that exist in MQC, categorized in five groups (Quality, Data, Tool, Action and Custom pages) and additionally the Dashboard page. You can add or remove them by selecting or deselecting the checkboxes.
The Dashboard checkbox allows you to select or deselect the creation of the dashboard in your project. Currently only one dashboard page can be enabled.
Quality pages include Quality Status, Quality Status(Diff), Quality Sunburst, Quality Sunburst(Diff), Quality HeatMap, Quality HeatMap(Diff), Quality Trend, Quality Trend(Diff), and Quality Model pages.
Data pages include Data Availability, Data Availability(Diff), Data Availability(Treemap), Data Status, Data Trend pages.
Action pages include the Action List and Action Treemap pages.
Custom pages: are defined in Custom Pages.
Sorting: there are two options for sorting pages (see Page order in the Pages dialog). By default the pages are in Fixed order. If Custom is selected for ordering, new pages are added after existing pages.
To apply changes in the Manage Pages dialog you have to click
The bottom of menu contains all configurations of the analysis.
10.2.2. Data Sources¶
Users can import either single files or directories by clicking on the Data Sources section and select files or directories that contain file reports. For more information about data sources, refer to chapter Data Sources.
10.2.3. Project Structures¶
Users can load, export or reload the Project Structures excel configuration (please refer to Project Structures Configuration for more information).
10.2.4. Quality Model and Quality Bin Configuration¶
Users can load, export or reload Quality Model source files. See chapter Quality Model Configuration for more information.
Additionally, it is possible to adapt the Quality Bin Configuration via this dialog (see Figure 10.10). Bins are used to group quality aspects of a project, i.e. a quality property per artifact for a certain point in time (revision), into categories (see Quality Bins). As per default, MQC uses the calculated quality measure value to assign a quality property to a quality bin.
You can define project specific quality bins by assigning a color, name, and an upper quality boundary. After creating/editing a quality bin it will be added to the list of already existing quality bins. There is no limit of quality bins you can configure for your project, but be aware there can be only one quality bin for the same upper quality boundary value.
With the given upper quality boundary values MQC is able to define the value ranges for the configured quality bins. Quality measure values are between 0 % and 100 %. Therefore it is required to define an upper quality boundary of 100 % for the highest quality bin. Then MQC automatically takes the upper quality boundary of the next quality bin as the lower boundary (where the quality bins will be automatically sorted according to the given quality boundary values).
For the default configuration the resulting value ranges are as follows:
Good (green): ]80%, 100%]
Acceptable (yellow): ]20%, 80%]
Bad (red): [0%, 20%]
10.2.5. Target Values¶
Users can load, reload or remove the Target Values excel configurations (please refer to Target Values for more information).
In the Project Structure and Target Values dialogs the Reload button is only visible when a configuration file has already been imported. A tooltip shows the paths to the currently loaded file.
Users can justify the calculated quality to document deviations of expected values. Additionally it is also possible to change a quality bin (i.e. from bad to acceptable) or the quality value directly if necessary (please refer to Annotations for more information).
This section contains a group of settings:
10.2.7.1. Revision granularity¶
Can be used to change the degree of compactions of the revisions for which data exists to better visualize your trend line charts. The revision granularity can be selected depending on your needs (see Figure 10.14).
Apply the defined annotations to the quality of your project. (see Annotations)
10.2.7.9. Artifact Mapping¶
MQC provides a different possibility to map artifacts (for more details please see Artifact Mapping) in case you do not have your project structure ready yet. For that, you need to define regular expression patterns which can map artifact paths to artifact names.
By pressing the Add Pattern button, a new dialog Artifact Mapping Pattern is opened. Here, you can define the Search RegEx and Replace values and the effective result can also be directly seen on the pageable list.
For example in Figure 10.16
, the pattern is defined as:
Search RegEx: ^(.*)_demo_.*$ , Replace: $1, which means the
artifact name is the substring of artifact path before _demo_.
As you can see in Figure 10.15, more than one pattern can be defined. The first matching pattern from the list will be applied to the artifact path. The order of the patterns can be changed in the list. The result of these patterns are also present in the export of artifact structure.
These artifact patterns will be applied until there is no project structure imported otherwise artifact mapping in project structure configuration has more priority.
To apply changes in the Settings dialog you have to click on the