Tags
In Lobster Data Platform / Orchestration, entities of different categories (business objects, configuration objects, etc.) can be assigned to Tags (label).
In terms of content, Tags are little more than freely definable 'text marks', which are only 'attached' to an entity without changing its immediate data structure.
For administration – as far as the Role of session allows it – the Tags overview can be opened, which lists all Tags already created.
►NOTE◄ The access to tags is not bound by ownership or Company authorizations. For formal reasons, an owner (ownerId) is nevertheless specified in the tag object.
Data model
The object 'tag' (core:Tag) is itself an entity, whose data model stores only two 'useful contents' besides the generic entity attributes (ID, owner, creation and modification details):
The text field Name (name) stores the 'bookmark', i.e. the display text of the tag.
The selection field Category (category) assigns a value from the dynamic enumeration Tag category to the tag.
The assigned Tag category determines in which context an entity can use a tag (see Tag category).
The relationship between Tags and entities is represented by another entity, the 'tag association' (core:TagAssociation), with which normally the user is rarely confronted directly. Nevertheless, they represent the most important information, namely 'which Tags are attached to what':
<core:TagAssociation id="4711" ... tagOwner="core:ProfileSecurity" tagOwnerId="801"> <tag id="51" ... name="test" category="CONFIGURATION"/></core:TagAssociation>In the example, the 'tag association' with the ID (id) "4711" links the tag with the name (name) "test" to one of the Profile securities with the ID "801" (tagOwnerId).
►NOTE◄ Each 'tag association' defines exactly one tag with exactly one entity. Multiple tag associations can be related to the same tag and entity. There is a (m:n)-relation.
Usage
Export job
By default, the system sees the category "Configuration" (CONFIGURATION) offered (see Tag category), since the tags have special meaning in relation to configuration objects:
If a single tag of the category "Configuration" is selected in the Tags overview, the Export tagged with button appears in the ribbon (see screenshot above).
With this function, all entities to which the selected tag is assigned can be added to an Export job (see Meta exchange). In this way, configuration objects of different types can be bundled and transferred together at the click of a mouse, which were assigned to a functional complex ('process') via a common tag.
General example
The following example shows an overview of Profile securities that should be systematically checked for effectiveness after each change. Tags are used to document this check. Newly created or modified elements are assigned the tag 'test' to indicate that the current configuration is complete and ready for testing. After a successful test, the 'tested' tags should also be assigned.
The element in the first line of the filtered list already has the 'test' and 'tested' Tags assigned.
Starting from the multiple selection, the same tags should be assigned to the two following lines, since these have just been created and already tested with perfect results.
A click on the Manage tags button in the Tags subcategory of the Common ribbon opens a modal dialog where you can select multiple Tags to be assigned:
►NOTE◄ This dialog appears with the default settings ('test' and 'tested') and the Save button, because this corresponds to the current assignment of Tags for all selected elements. The appearance of the dialog for a non-uniform selection is described below.
After clicking the Save button, the new Tags appear in the list:
The last entry of this list should now only be assigned the 'test' tag, since the test must still be executed for this tag.
A simple mouse click in the Tags (Configuration) column of the corresponding row simultaneously changes the selection and reopens the dialog:
Since the tag 'test' has already been used, it appears in the dropdown for selection and is taken into account when typing by auto-complete.
At the same time, completely new Tags (here: for the category 'Configuration') can be created by ending the text input with the [+] symbol (right) or by pressing Enter.
To add the 'test' tag selected in the dropdown menu, click the
symbol in the grey menu bar in the dropdown or close it using the Tab key and then close the dialog with the Save button.
The overview then shows the following status:
After the last profile security of the group has been tested without objections, the tag 'tested' should be assigned to the group and then the tag 'test' should be removed from all groups.
For demonstration purposes, the selection is extended to all elements of the filtered list and then the ribbon button Manage tags needs to be clicked.
The Tags dialog shows only Tags selected that are assigned in all lines of the selection. Specifically, this is only the 'test' tag.
Due to the heterogeneous position of the assigned Tags within the selection, a group of buttons appears for selection instead of the Save button:
Add inserts the Tags selected in the multiselect combobox Tags to all lines in the selection if they are not already assigned.
Remove deletes the Tags selected in the multiselect combobox Tags from all lines of the selection if they are currently assigned.
Set transfers the selection of Tags in the multiselect combobox Tags to all lines of the selection and removes all deviating assignments if available.
In a specific case, clicking on the Set button after selecting the 'tested' tag results in the desired overall image: