Skip to content

Managing Tagged Values

To use the THREATGET Analysis in Enterprise Architect, you have to use the THREATGET Toolbox to model the system. This Toolbox provides your defined Elements, Assets, Interfaces, Connectors and Boundaries. It is also possible to define Tagged Values for exclusive diagram components. Exclusive in this case does not mean that they can only be used for this component type but you will be informed about this when assigning the tagged values.

A Tagged Value can be seen as an attribute or property of an element, asset, interface, boundary or connector. A Tagged Value is a key-value relationship and describes a single property. The user can define these Tagged Values within the ThreatGet web interface and then add them to the components to model your system.

An example of this would be defining a Tagged Value that describes which protocol a connector uses.

Tag (Key) = protocol

Values = HTTP, HTTPS, SMTP .....

Create a new Tagged Value

To create a new tagged value, you first have to switch to the correct overview. Please click on ToolBox in the Navigation bar and then select Tagged Values as shown below.

Now we will create a new Tagged Value. To do this, click on the blue New Tagged Value button on the top of the listing to the left.

Enter a name and a description first. We recommend writing a meaningful description to avoid conflicts in meaning with other tagged values.

Tagged Values can also be restricted to certain types of components. If this protocol should only be available for Elements and Assets, then we can simply select these two from the dropdown menu.

As you can see, all tagged values are created with the default namespace (in the standard installation called "USER"), but a different one can be selected if needed. The items created by AIT have the "AIT" namespace. A value with the name undefined has been automatically assigned, and selected as Default Value.

A tagged value must always have at least one value. To assign additional values, like for example HTTP andHTTPS. Please enter the desired value in the New Value field. Then click the ADD button on the right to add it.

All values except the current default and the undefined can be deleted. To delete a value, click on the Trash Can in the Actions column of the table. It is also possible to set a different Default Value for the tagged value. To change the Default Value, click on the Checkbox in the Default column of the table.

On the left upper corner, you can see two buttons ("Circular Arrow", "Trash Can") and a Save button in the middle below the input area.

  • Circular Arrow: to undo any changes.

Undo button

  • Trash Can: to cancel the creation of the new element or delete an element, click on the Trash Can.

Delete button

  • Save Button: to save your newly defined component, click on the Save button.

Save button

Ordering defined Tagged Values

Each defined value of the tagged value has a position and this can be adjusted by using the up and down arrows.

All the tagged values matching the search will then be listed.

Search for a defined Tagged Value

Since the number of tagged values can increase very quickly, you can also search for a particular one. To do this, you can simply enter part of the name or description in the search field.

All the tagged values matching the search will then be listed.