Skip to main content

Component Labels

Component labels are metadata assigned to components for use when targeting specific attributes with policies. Rather than manually adding component coordinates when targeting specific components, generic component labels are used and applied to the components that meet the criteria.

For example, when the Application Architect wants to discontinue the use of a specific component, they apply a Discontinue-Use label to the component while making a policy to trigger for any components with that label.

Viewing a Component Label

  1. Select an organization or application in the sidebar. A page of customizable settings is displayed.

  2. Click Component Labels in the menu bar at the top of the page to scroll to the Component Labels section.

The Component Labels section displays two types of labels:

  • Local - Component labels with a scope that’s specific to the selected organization or application.

  • Inherited - Component labels derived from an organization that’s higher in the system hierarchy than the currently selected organization or application.

Creating a Component Label

  1. In the sidebar, select the organization or application in which the component label will be used.

  2. In the Organization & Policies area, click Component Labels.

  3. In the Component Labels section, click the Add a Label button. The New Component Label editor is displayed.

  4. In the New Component Label editor, set the following attributes:

    1. Component Label Name - Enter a name for the component label that is easily identified.

    2. Short Description - Enter a description that provides additional information about the component label.

    3. Color - Select a desired color for the component label.

  5. Click the Create button to add the component label to the selected organization.

A few things to remember:

  • An organization’s component labels can be seen by any of its applications, the reverse is not true.

  • Component labels can only be edited (or deleted) at the level they were created.

Editing a Component Label

To edit a component label:

  1. In the sidebar, select the organization or application in which the component label was created. The component label is displayed in the Component Labels section under the Local heading, and has a chevron in its row to indicate it’s editable.

  2. Click the component label you want to edit. The Edit Component Label dialog is displayed.

  3. In the Edit Component Label dialog, you can change the following attributes:

    1. Component Label Name - Enter a different name for the component label.

    2. Short Description - Enter a description that provides additional information about the component label.

    3. Color - Select a desired color for the component label.

  4. Click the Update button to save the component label to the selected organization or application.

Deleting a Component Label

To delete a component label:

  1. In the sidebar, select the organization or application in which the component label was created. The component label is displayed in the Component Labels section under the Local heading, and has a chevron in its row to indicate it’s editable.

  2. Click the component label you want to delete. The Edit Component Label dialog is displayed.

  3. In the Edit Component Label dialog, click the Delete Component Label button. A Delete Label alert dialog is displayed.

  4. In the Delete Label dialog, click Continue to delete the component label or Cancel to keep the component label.

Using a Component Label in a Policy

  1. In the sidebar, select the organization or application in which to add the new policy.

  2. Click Policies in the menu bar at the top of the page to scroll to the Policies section.

  3. Create a new Policy. For details see Creating Policies.

  4. In the Constraints section, add a Constraint Condition where your newly created Component Label is selected. For example, if you created a new Component Label named "Do Not Use".

Adding a Component Label from a Policy Evaluation Report

To add a component label to a Component in a Policy Evaluation Report:

  1. In a Policy Evaluation Report, click on a Component.

  2. Click on Labels.

  3. Click on the Available Labels to apply to the Component.

4. Select the scope of the label from the dropdown as shown below. The scope of the label can be limited to an application, an organization at any level, or root organization.

Adding a Component Label from a Repository

To add a component label to a Component from a Repository:

  1. Click Repositories under the Root Organization.

  2. Click the desired repository.

  3. Browse or search for the desired component.

  4. Select the desired component.

  5. Click on Labels.

  6. Add Component Labels to the Component.