Skip to main content

Edit Mode in Diagram/Table View

Overview

Diagram and table views feature an “edit mode” that allows adding, modifying and deleting assets, relations as well as their properties. The edit mode can be enabled by clicking on the Edit toggle button in the toolbar on the top. After activation, a + button is shown next to the edit mode button. Clicking on it shows the specific buttons for adding a new asset (Add Asset) and a new relation (Add Relation).
9 – General View Actions: Overview
Adding options when “Edit Mode” is activated in a diagram view Furthermore, an + Add Property button appears in the Details tab of the right sidebar after activating the edit mode (and clicking on a specific asset or relation). Now, all modifiable properties are shown with a dotted rectangle surrounding them. There is also a delete icon (bin) shown next to each (non-mandatory) property.
9 – General View Actions: Overview
Asset Details sidebar showing a + Add Property action when “edit mode” is activated.
9 – General View Actions: Overview
A table view with activated edit mode

Adding Properties

It is possible to manually add properties by clicking on the + Add Properties button in the Properties headline bar. Hint: This can only be done, if not all of the properties of a specific asset/relation have not been defined yet, i.e. there is still an unused property available. If the message No unused properties available. is shown, then the user has to create a new property type for this asset/relation type first (see Data Schema section). After that, the first step is to choose a property type to define. Then, the value of this property can be entered. The input value has to match the property’s content type (number, text, Boolean or DateTime). By clicking on the checkmark icon, the property can be saved.

Modifying & Deleting Properties

Properties can easily be modified by just clicking on their value (the input field surrounded by a dotted line). After modifying the value, changes are automatically saved as soon as the input field is left, i.e., the input field loses focus. Deleting a property can be done via the “garbage can” icon on the right side of the row.

Manually Creating Assets

New assets can be created by clicking + and Add Asset in the top toolbar. Afterwards, the following information can be defined:
  1. Type: The “category” of the new asset
  2. Name Property (mandatory): the name value that is later used as “primary tag”
  3. Via + Add Property, further properties (and their values) can be set for this new asset. Therefore, the dropdown menu lists all available properties defined for the according asset type.
  4. Finally, clicking on Save creates a new asset while Cancel discards any changes made.
9 – General View Actions: Manually Creating Assets
Manually adding an asset

Manually Deleting Assets

There are two ways to delete an asset:
  • Via the hover menu: clicking on the specific asset opens the hover menu on the bottom that provides the Delete Asset function.
  • Via the Details tab: Clicking on an asset opens the asset details on the right sidebar, which provides an Delete Asset function on the bottom.
9 – General View Actions: Manually Deleting Assets
Manually deleting an asset instance via hover menu (left arrow) or Details panel (right arrow)

Manually Creating Relations

New relations can be created by clicking + and Add Relation in the top toolbar. Afterwards, the following information can be defined:
  1. Type: The “category” of the new relation
  2. Source Asset and Target Asset: the “origin” and “destination” assets of the relation
  3. Name Property (mandatory): the name value that is later used as “primary tag”
  4. Via + ADD PROPERTY, further properties (and their values) can be set for this new relation. Therefore, the dropdown menu lists all available properties defined for the according asset type.
  5. Finally, clicking on Save creates a new asset while Cancel discard any changes made.

Manually Deleting Relations

There are two ways to delete a relation:
  1. Via the hover menu: clicking on the specific relation opens the hover menu that provides the Delete Relation function.
  2. Via the Details tab: Clicking on a relation opens the relation details on the right sidebar, which provides an Delete Relation function on the bottom.
9 – General View Actions: Manually Deleting Relations
Manually deleting a relation instance via hover menu (left arrow) or Details panel (right arrow)

Tab “Filters”

Assets and Relations

Individually filtering shown assets and relations in the diagram view is possible via the Filters tab on the right sidebar. Here, selecting and deselecting the checkboxes within the Assets and Relations sections triggers a visualization update in diagram and table views.

Analysis

Within the Analysis sections in the right sidebar, the + Add Rule button can be used to create analysis rules (coloring). Such rules are used to highlight assets that fulfill certain conditions depending on their properties. Creating new analysis rules (coloring) is similar to creating filters:
  • Asset: the asset type for the analysis rule
  • Color Circle: color used for highlighting assets meeting the analysis rule conditions
  • Property: the asset type’s property used to later colorize the displayed relations
  • Operator (general): independent from the type of the selected property, these “general” operators are always available:
    • is equal to: returns “true” if the property’s value corresponds to the entered/selected value,
    • is not equal to: returns “true” if the property’s value does not correspond to the entered/selected value,
    • exists: returns “true” if an optional property is existing for a specific asset/relation instance
  • Operator (specific): depending on the type of the selected property (Number, Text, …), different “datatype specific” operators are in addition available:
    • for text properties: contains (not), matches (not) and is empty,
    • for number properties: is >/< than and is >=/<= than,
    • for DateTime properties: before, after, within last and not within last.
  • Value: the value to be set for the new property (clicking on the input field shows existing values)
  • Via + Add Condition, additional conditions can be defined for the analysis rule. If more than one condition is defined, the user can choose if …
    • colored assets have to fulfill every defined condition (connecting conditions via AND) or
    • if they only have to meet one of the conditions (connecting conditions via OR).
Clicking on Create adds a “analysis rule” to the Analysis list and automatically activates it. If assets fulfill the conditions of more than one analysis rule, they are colorized according to the topmost activated rule (ascending priority).
9 – General View Actions: Analysis
Analysis Rule Definition
9 – General View Actions: Analysis
Diagram view with analysis rules for “VM” assets (red/blue assets)

Tab “Details”

The Details section within the right sidebar shows all available information for one specifically selected asset or relation. In diagram views, clicking on the “empty space” of the visualization pane deselects the details tab.
9 – General View Actions: Tab "Details"
Details menu example for an asset

General Properties

Within the Details tab in the right sidebar, basic properties for a selected asset/relation are shown in the General section: Table: Basic Properties of Assets and Relations The properties Source Asset and Target Asset are only shown for relations.

Properties

Beneath the General section, all additionally captured properties for a specific asset/relation are shown. If the “edit mode” is activated, then it is possible to modify property values by clicking on the respective property value (input field surrounded by a dotted line) or to add further properties to the asset/relation (+ Add Property button in the Properties title bar). Details are available within the “Edit Mode in Diagram and Table View” section at the beginning of this section.

Relations

For assets, the Relations section on the bottom of the Details tab lists all assets that are directly connected to the selected asset. For each connected “neighbor” asset, an arrow icon indicates whether the respective relation (the dependency between a pair of assets) is “incoming” (Incoming relation icon) or “outgoing” (Outgoing relation icon). Here, every existing relation of an asset is shown and not only those relations displayed within a specific view.
9 – General View Actions: Relations
Relations example for a specific asset instance (an Azure VM)

Tab “Activity”

The Activity Tab on the right panel shows a complete change history for a specific asset or relation. This “audit trail” is important for multiple documentation and compliance standards and is thus immutable.
9 – General View Actions: Tab "Activity"
Example of an asset’s activity tab

Tab “View”

In diagram views, the View tab within the right sidebar shows all asset types and relation types included in the current diagram view. Asset types and relation types are shown with …
  • their particular color (circle on the left),
  • their shape (e.g. the “node style” of assets or if relations are shown as line or container),
  • their type icon and
  • analysis rules associated with this asset/relation type (if they exist).
Hovering over the “analysis rules chip” (color palette icon) triggers a popup dialog that shows the associated analysis rules.
9 – General View Actions: Tab "View"
View Tab example

Importing Existing Views

After navigating to the Views screen via the left navigation menu, previously exported views (.qb files) can be imported again. This can be done by clicking on the Import view button in the top right corner and by selecting one or more files to import. After the import is finished, a short summary shows if it was successful. When closing the dialog (Ok button), the overview list is reloaded including the (successfully) imported views.
9 – General View Actions: Importing Existing Views
Importing Views