Tags

Tags are flexible model object properties that help organize and draw attention to different objects in your system. They're fully customizable, and with IcePanel's tag visualization tools, you can show different perspectives on your system to have more focused discussions.

With tags, you can highlight specific parts of your system like:

• Risk

• Cost

• Security

• Regions

• Release versions

• Deployment information

Creating a Tag group

A Tag group is a collection or category for your tags. Tag groups and their respective tags are shared across a landscape and can be edited by users with Editor or Admin permissions.

There 2 ways to create a Tag group:

In the bottom Tag bar (faster)

1. Navigate to the bottom Tag bar in a diagram

2. Click on the New group button

3. Name the Tag group

4. To edit the Tag group icon, click on the overflow menu and Set icon (optional)

5. To re-arrange Tag groups, click and drag on the area to the left of the Tag group (optional)

In the object details view

1. Click on an object in a diagram or the model objects tab

2. On the right-hand menu, click the Add tag button (if the object already has tags, click on the tag area)

3. Click on New group

4. Name the Tag group

5. Click on the Tag group icon to edit it (optional)

Creating a tag

There are no restrictions on the number of tags you can create on all plans, but they must be nested in a Tag group.

There are 2 ways to create a tag:

In the bottom Tag bar (faster)

1. Navigate to the bottom tag bar in a diagram

2. Click on the Tag group you want to add a tag to

3. Click on the New tag button

4. Name the tag

5. Hover on the tag and click on Color to edit the tag's colour (optional)

In the object details view

1. Click on an object in a diagram or the model objects tab

2. On the right-hand menu, click on the Add tag button (if the object already has tags, click on the tag area)

3. Click on the + button at the top right of the Tag group or on the New tag button if the Tag group is empty

4. Name the tag

5. Click on the palette icon (🎨) to edit the colour of the tag (optional)

Adding a tag to an object

To add a tag to an object:

1. Click on an object in a diagram or the Model objects tab

2. On the right-hand menu, click on the Add tag button (if the object already has tags, click on the tag area)

3. Click on the tag(s) you want to add. You can add as many tags to an object

Deleting a Tag group

There are 2 ways to delete a Tag group.

In the bottom tag bar (faster)

1. Navigate to the bottom tag bar in a diagram

2. Click on the Tag group you want to delete

3. Click on the overflow menu beside the Tag group

4. Click on the Delete button

5. Click on the Delete button again to confirm

In the object details view

1. Click on an object in a diagram or the model objects tab

2. On the right-hand menu, click on the tag area

3. Hover over the Tag group and click on the trash icon (🗑️)

4. Click on the Delete button to confirm

Deleting a tag

There are 2 ways to delete a Tag group:

In the bottom tag bar (faster)

1. Navigate to the bottom tag bar in a diagram

2. Click on the Tag group where the tag is located

3. Hover over the tag you want to delete

4. Click on the Delete button

5. Click on the Delete button again to confirm

In the object details view

1. Click on an object in a diagram or the model objects tab

2. On the right-hand menu, click on the tag area

3. Hover over a tag and click on the pencil icon (✏️) to the right

4. Click on the trash icon (🗑️)

5. Click on the Delete button to confirm

Seeing tags in a diagram

You can view your tags in a diagram by opening the Tags bar at the bottom of the navigation. Click on the Tags label or a Tag group to open it. Tags are only visible in a diagram when the Tags bar is open.

The Tags bar is a controller for:

• Showing tags by Tag group in a diagram

• Highlighting objects by tag by hovering over it

• Pinning objects by clicking on the tag

• Focusing on objects by tag

• Hiding objects by tag

Showing tags by Tag group

When the Tag bar opens, you can switch between Tag groups to view your diagram objects with their respective tags. Each object will display the tag's colour as a coloured bar on the bottom.

If an object has 2 or more tags applied, it will add a bar for each tag colour horizontally responsive. Connections only use the colour of the first tag applied unless hovering, pinning, or focusing on other tags.

Highlighting objects by tag

Hovering on a tag will highlight all objects in that tag's colour in the diagram.

Pinning a tag

Pinning tags is a quick way to give extra visual attention to specific objects in the diagram.

To pin a tag:

1. Open the Tag bar

2. Click on the tag you want to pin

3. Click on the tag again to unpin it

Pinned tags apply a dotted line in the colour of the tag around the object. The tag name is also added to the bottom left of the object.

Focusing on a tag

Focusing on a tag allows you to reduce the complexity of a diagram by only showing the objects with the tag, their connections (any direction), and the objects they're connected to.

To focus on a tag:

1. Open the Tag bar

2. Hover on the tag you want to focus on and click the Focus button

3. To unfocus the tag, click on the tag again

Only objects with that tag, their connections, and connected objects will appear in the diagram. Connected objects will be slightly greyed out. An indicator will appear in the bottom navigation to show tags in focus. You can also use this to unfocus the tag.

Hiding a tag

Hiding a tag removes all objects with the tag and their connections (any direction) in the diagram. It's a great way to show the difference when model objects are being deprecated or exist in a future release without removing them permanently from the diagram or model.

To hide a tag:

1. Open the Tag bar

2. Hover on the tag you want to hide and click the Hide button

3. To unhide the tag, click on the tag again

Objects with that tag and their connections will disappear from the diagram unless you hover over the tag (they'll appear slightly greyed out). An indicator will appear in the bottom navigation to show hidden tags.

Tags with flows

Using tags in combination with Flows is a great way to visualize use cases with an added layer of perspective. This can help your team identify anything from risky areas in a flow to expensive systems or apps that should be investigated for cost reduction.

Filtering tags in the Model objects tab

If you prefer to view objects by tag in a list view, you can use filters in the Model objects tab.

Here's how to do this:

1. From your landscape, go to the Model objects tab

2. Click on the Filter button

3. Click on Tags

4. Select which tags you want to filter