Tags Overview
Easily organize and manage your Nodinite environment with Tags. One Tag can label every kind of item: Repository Model items such as Systems and Services, Resources, Log Views, Monitor Views, Articles, C4 Diagrams, and Diagram Set entries. This page is where administrators keep that vocabulary clean: a change here reaches every item that carries the Tag.
On this page, you will learn how to:
- ✅ Rename a Tag once, and every item that carries it follows
- ✅ Clear, delete, restore, and permanently remove Tags
- ✅ See where each Tag is used, and draw it in Mapify
Animated walkthrough: one rename in the Tags list, and every item that carries the Tag follows.
- Open Administration > Customize > Tags and click the pen of the Tag, here Contoso: Fianance.
- Correct the name and click Save.
- Open an item that carries the Tag, here the System Contoso Warehouse: its Tags field shows the new name.
This Overview shows all user-defined Tags, and in the Used In column, where each one is used. Enter text in the filter text box to narrow down many records in the list.
Each Tag lists the items that use it, with an icon per item type, and an Action button per row. The page title carries the hashtag, the icon for Tags everywhere in the Web Client.
Understanding the Tag Lifecycle
of any taggable item"] --> Active["fa:fa-hashtag Active Tag"] Active -->|"Edit Name"| Active Active -->|"Clear"| Unused["fa:fa-empty-set Active, no associations"] Active -->|"Delete"| Deleted["fa:fa-trash-can Deleted
associations kept"] Deleted -->|"Restore"| Active Deleted -->|"Permanently Delete"| Gone["fa:fa-trash-xmark Permanently deleted"] style Add fill:#2678BD,color:#fff style Active fill:#93d16d,color:#000 style Unused fill:#FFD525,color:#000 style Deleted fill:#E47528,color:#fff style Gone fill:#c33d34,color:#fff
A Tag is created where it is used (blue) and stays active (green). Clear removes its associations (yellow), Delete is reversible (orange), and only a deleted Tag can be permanently deleted (red), which cannot be undone.
Operations
- Add a Tag in the Tags field of any taggable item; see below.
- On this page, Administration > Customize > Tags, which only Administrators can open, you can: New 6.1.0.66
A Tag has a unique name. To create one, open the edit page of any taggable item, such as a Log View, a System, or an Article, and type the new name in its Tags field (placeholder Add Tags). A name that doesn't exist yet is offered as Id: New; pick it, and the Tag is created when you Save the item. An existing Tag is offered by its name. Manage Tags only offers existing Tags; it never creates one. Business users who apply Tags follow Add or manage Tags (Getting Started).
A new name is offered as Id: New; the Tag is created when you save the item.
Show in Mapify or Mermaid
New 7.12 Open a Tag's Action menu and choose Show in Mapify or Show in Mermaid to draw the Tag and the items that carry it as a map in Mapify or as a Mermaid diagram, and from there the Roles and Users behind them. For the complete list of items that carry a Tag, read its Used In column.
Each Tag row lists the items that carry it in Used In.
Animated walkthrough: from the Tags list to a map of the Tag and the views and Articles that carry it.
- Find the Tag, here Contoso: Critical, and read Used In.
- Open its Action menu and choose Show in Mapify.
- Mapify draws the Tag with the items it reaches, and their Roles and Users.
To put a Tag on, or take it off, many items at once, use With Selected > Manage Tags in the item's own list; see Manage Tags.
Edit Name
Click the pen button on a row in the Overview to change the name of the Tag. The walkthrough at the top of this page shows the whole rename.
The new name applies to every item that carries the Tag.
Then, click the Save button to persist changes or Cancel to discard.
The confirmation appears on top of the screen.
Clear
Clear takes the Tag off every item that carries it, of every type. The Tag itself stays in the list, used by nothing.
Animated walkthrough: the Tag stays, and nothing carries it any more.
- Find the Tag, here Contoso: Night Shift, on two Systems.
- Open its Action menu and choose Clear.
- Confirm with Yes. The Tag stays in the list, and Used In is empty.
The Clear menu item within the Action button for a Tag.
Clear keeps the Tag but unlinks it from every item that carries it.
The Tag remains in the list without any usages.
Delete Tag
You can Delete a Tag by clicking the Delete menu item from within the Action button. A deleted Tag drops out of the list until you tick Include deleted.
Animated walkthrough: a delete you can take back; the restored Tag is still on its System.
- Open the Action menu of the Tag, here Contoso: Pilot Customer, choose Delete, and confirm with Yes.
- Tick Include deleted to list deleted Tags.
- Open the deleted Tag's Action menu, choose Restore, and confirm with Yes. The Tag is back, still on the System that carried it.
The Delete menu item within the Action button for a Tag.
Remember, you can always bring back a deleted Tag using the Restore function; a restored Tag keeps its previous associations. This safety net ensures you can confidently manage your Tags without fear of irreversible actions.
Next, confirm your intent to Delete the Tag by clicking Yes.
Click Yes to delete the Tag, or No to keep it.
The result is displayed on top of the screen.
A deleted Tag can be listed again with Include deleted.
Restore Tag
You can Restore a deleted Tag by clicking the Restore menu item from within the Action button. Tick Include deleted first to list deleted Tags.
A deleted Tag offers Restore and Permanently Delete.
Next, you must confirm your intent to Restore the deleted Tag.
Restoring brings the Tag back, still on the items it was on.
Click Yes to start the Restore operation. The result is displayed on top of the screen.
The Tag is active again.
Permanently Delete Tag
When you're absolutely sure you want to remove a Tag from the system, use Permanently Delete. It removes the Tag and its links to every item that carries it. This action cannot be undone.
As for every other entity in Nodinite, a Tag is deleted first and permanently deleted after that, and only by an Administrator: Delete the Tag, tick Include deleted, and then click the Permanently Delete menu item from within the deleted Tag's Action button.
Animated walkthrough: the Tag is gone, even with Include deleted ticked, and from the System that carried it.
- Open the Tag's Action menu, choose Delete, and confirm with Yes.
- Tick Include deleted, open the deleted Tag's Action menu, and choose Permanently Delete.
- Confirm with Yes. The Tag is gone from the list and from every item that carried it.
The Permanently Delete menu item, shown on a deleted Tag.
Next, you must confirm your intent to Permanently Delete the Tag.
The dialog warns that this operation can not be undone.
Click Yes to start the Permanently Delete operation. The result is displayed on top of the screen.
The Tag is gone from the list, including the deleted Tags.