53. Work with triage attributes

A triage attribute is metadata that is applied to a run as a key-value pair. Creating, manipulating, and defining attribute-based rules are key to an effective triage process. Attributes help in determining the active state of runs, organizing the data in a more accurate and efficient way, and ultimately reducing the time it takes to find the most important issues in a test suite result.

Following are some typical use cases for triage attributes. You can:

• Change the triage verdict of specific runs from 'Failed' to 'Passed' once they are considered passed in the context of your team's work.

• Change the triage status to 'Non Issue'. You can create a filtered view that hides these 'Non Issue' runs.

• Create an attribute for a bug tracking system. For clusters that relate to a bug, add the bug ID link.

• Create attributes that refine the issue kind, assign values to them, and use these attributes to further cluster test suite data.

To see a complete list of the predefined triage attributes, see Attributes.

53.1 Manage triage attributes

To manage triage attributes:

1. Click Triage Configuration on the bottom left of the Triage view.

   

   The Triage Configuration page displays.

2. Select the Attributes tab.

   

3. On the Attributes tab, you can do the following:

   • To create a new attribute, click Create Attribute on the top right. See Create a triage attribute for steps.

   • To edit an attribute, select the attribute and click the Edit Attribute icon on the top right. You can edit the name and the comment for the attribute. Click Save.

53.2 Attributes table

The Attributes table shows all available attributes in the system. The attribute columns are as follows:

53.3 Create a triage attribute

When you create a triage attribute, the attribute’s name is displayed in the column chooser, run tables, filters, rule conditions and assignments where the attribute is used.

53.3.1 Attribute data types

Foretify Manager supports the following attribute types: String, Integer, Float, Enum, Link, Date and User. When setting or filtering:

• String attributes: The attribute accepts any string value.

• Integer attributes: The attribute values are restricted to integer values.

• Float attributes: The attribute values are restricted to floating point values.

• Enum attributes: The attribute values are restricted to those specified when the Enum attribute was created. The enumeration values are available in filters, rule conditions and assignments where the attribute is used.

• Link attributes: The attribute values depend on the URL link template specified when the Link attribute was created. When creating a Link attribute, you specify a URL link template that will be used to render links for attribute values. For example, say you have a bug tracking web system that lets users navigate to issues by their ID. Assume the link template is: “https://bug-tracker/issue/{}”. When setting a value to the attribute, the user only needs to enter the issue ID (for example, “BUG-2471”). Once you have created a Link attribute:

  • Triage displays the attribute value with link notation (for example, BUG-2471).

  • When a user clicks on the attribute value, Triage renders a URL based on the URL template created in the attribute definition and replaces {} with the attribute value. It then opens a browser tab that navigates to the new URL (in this example, https://bug-tracker/issue/BUG-2471).

• Date attributes: The values are restricted to only date or time values.

• User attributes: Triage presents all available users of the project for the user to select from.

To create a triage attribute:

1. Create an attribute using one of the following methods:

   • Click Triage Configuration on the bottom left of the main Triage view, then select the Attributes tab and click Create Attribute on the top right.

     

   • Click Create Attribute on the top right of the main Triage view.

2. Enter the attribute Name.

3. Optionally, click + Internal name to enter an internal name for the attribute.

4. Optionally, enter a Description for the attribute.

5. Select the Type for the attribute. See Attribute data types for a discussion of the supported data types.

   • If you select Enum, enter the first enumeration value as Value 1, then click + Add value for each additional enumeration value.

   • If you select Link, define the URL link template as described in the Attribute data types section.

6. Click Create.

   Note

   • For early versions of Triage, the attribute name must be unique within the system. In upcoming phases of development, there will also be workspace- and project-level attributes.

After creating a triage attribute, you can set it as described in the following section.

53.4 Set Triage attributes

You can set Triage attributes from the Triage Runs table or from a cluster.

To set an attribute from the Runs table:

1. Select one or more runs, and then click the Set Attribute Value And Create A Rule icon located at the top right corner of the Runs table.

   

   The Set Attribute dialog box indicates how many runs will be affected by your action.

2. Select an attribute from the Attribute dropdown list or start typing a known attribute name to choose from an auto-completed list of attributes.

   

   Note that you can create your own attribute and then set it.

3. Set a Value.

   The value is applied to all selected runs.

4. Enter a Rule Name.

5. Select Save & Set Rule to save the rule, set the attribute, and re-run the entire rules calculation process.

   You can hover over Preview rule to review the rule before applying.

For a large bulk of runs, it may take some time for the set operation to complete.

To set an attribute for all runs in a cluster:

1. In the Triage view, go to the Clusters pane, click the three dots (⋯) next to a cluster, and select Set Attribute Value and Create a Rule.

   

   The Set Attribute Value dialog box indicates the scope on which the set operation will apply. The scope is determined by the cluster path, for example, "ERROR/other/out_of_odd".

   Note

   The three dots appear only if you have editor or owner permissions for the workspace.

2. Select an attribute from the Attribute list or start typing a known attribute name to choose from an auto-completed list of attributes.

   Note that you can create your own attribute and then set it.

3. Set a Value.

4. Enter a Rule Name

5. Select the attribute's apply method:

   • Select Save Rule to save the rule and set the attribute.
   • Select Save Rule & Apply to save the rule, set the attribute, and re-run the entire rules calculation process.

   You can hover over Preview rule to review the rule before applying.

6. Click Apply.

For a large bulk of runs, it may take some time for the set operation to complete.

53.5 View custom attributes

To view custom attributes in the Runs table:

1. Click the Column Selection icon.

2. Add the custom attribute to the view.

See how to select columns to display in a table.