Using tags

Use tags to group, find, and filter nodes in your project. You can assign multiple tags to a single node.

For example, you can use tags to:

Tagging a node

You can create a tag and tag a node in the Properties of that node.

To tag a node:

  1. In the Node Tree select the node you want to tag.

  2. In the Properties:

    • In the Tags property enter the name of the tag and press Enter.

      Kanzi Studio creates the tag and tags the node with the tag.

      ../../_images/create-tag-tags-property.png

    • Click the Tags button next to the Tags property and select a tag from the list of existing tags.

      Kanzi Studio uses the existing tag to tag the node.

      ../../_images/use-exisiting-tag.png

Creating a tag without tagging a node

You can create a tag without tagging a node at the same time.

To create a tag without tagging a node:

  1. In the Library press Alt and right-click Tags and select Tag.

    ../../_images/create-tag.png

  2. Name the tag and click OK.

    Kanzi Studio creates the tag and lists it in the Library > Tags.

    ../../_images/tags-in-library-tags.png

Finding tagged nodes with quick search in the Node Tree

To find tagged nodes with quick search in the Node Tree:

  1. Create a tag and assign it to nodes. See Tagging a node.

  2. In the Node Tree in the quick search box enter the entire tag name you are looking for and press Enter.

    ../../_images/find-tagged-nodes-project.png

Finding tagged nodes using the Find Project Item tool

To find tagged nodes using the Find Project Item tool:

  1. Create a tag and assign it to nodes. See Tagging a node.

  2. Select Edit > Find.

    The Find Project Item window opens.

    ../../_images/edit-find.png

  3. In the Advanced Search tab in the Criteria section click image0 to add a new criterion and in the criterion:

    1. Select Has Property Value.

    2. Select the Tags property.

    3. Click the Tags button and select the tag you are looking for.

    ../../_images/find-tag-criterion.png

  4. Click Search.

    The Find Project Item shows all nodes with the tag you selected.

    ../../_images/search-tag.png

Using tags in the API

For details, see the Tag class in the Kanzi Engine API reference.