Creating tags

Tags are strings without spaces or commas and are project-area specific. Define tags so that team members easily find and organize global configurations and components. Rename tags as needed by your project.

Before you begin

You must have the Configuration Lead role or higher, or be assigned the Create and rename tags privilege for the project area.

About this task

  • Important: Avoid adding classified or sensitive data such as customer names and proprietary information to tags. If you must scrub the GCM data later, tags are removed from the artifacts you scrub, but the tags are not permanently deleted from the repository. See Deleting sensitive data from global configurations and components by scrubbing them.
  • Tags do not organize components or configurations into a physical hierarchy; they simply help you to view them in logical groups.
  • Tags are strings without spaces or commas and are project-area specific. You can nest tags to represent a hierarchy, such as country/state/city. The forward slash (/) separates tag levels: Configuration tag named country, which has a nested tag named state, which in turn has a nested tag named cityComponent tag named country, which has a nested tag named state, which in turn has a nested tag named city
  • Consider creating different tags for configurations and components.Otherwise, if you use the same tags for components and configurations, renaming or deleting a tag on the Browse Components page affects only components; renaming or deleting by querying configurations affects only configurations.
  • Tags do not span project areas. Queries for tags show only the configurations from the same project area as the query. If a configuration lead defines the same tag in multiple project areas and you must rename or delete a tag to suit your project needs, you must query configurations in each project area for the tag.
See Finding and organizing components by using tags.

Procedure

  1. You can define tags in these ways:
    • Components:

      One component: Below the Home menu, click Global Configurations > Browse Components, and click a component name. Then, click the Attributes tab and click Edit.

      Multiple components at a time: Click Browse Components, select the components, and select the tag option from the Actions menu. For details, see the related topic about organizing components.

    • Configurations:

      One configuration: Click a global configuration in a tree; then, click the Attributes tab and click Edit.

      Multiple configurations at a time: Select the global configurations in the tree, right-click one of them, and select Tag Configurations.

  2. Type the tag names and click OK; then, click Save.

Results

Team members can now use the tags to group components or configurations.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki