Asset Tagging (Versions: 9.0+)

Versions: 8.0+

Asset Tags are user-created descriptors that can be attached to a number of project entities, including QueryPairs, Reusable Query Snippets, Staging Queries, Test Suites, and Scenarios. Tagging enhances data testers' overall abilities to organize, search for, and report on artifacts and results in their projects.

Creating and Assigning Asset Tags

Users can create and assign one or more Asset Tags in the Properties panels of a QueryPair, Reusable Query Snippet, Staging Query, or Test Suite, while scheduling a Scenario for execution, or after a Scenario has finished executing.

Tagging a QueryPair

After creating or opening a QueryPair, navigate to the Properties panel. Asset Tags are created and assigned by entering or selecting tag values from the Asset Tags dropdown menu.

Type one or more desired values into the dropdown menu. As you do so, you'll be presented with suggested values based on existing Asset Tags. Press the Enter key to select either your input, or one of the suggestions.

As with any property change, be sure to press the Save button when you're done.

Tagging a Reusable Query Snippet

Open a Reusable Query Snippet and navigate to the Properties panel. All entities in QuerySurge share the same set of available Asset Tags. Expand the dropdown menu, and you'll see you have access to all tags, regardless of their creator or the original asset type to which they were assigned.

All of your Asset Tag suggestions are based on this set of values. If you start to type the letter M, for example, the dropdown menu will update accordingly.

Again, the Save button assigns the Asset Tags you've added to the asset, in this case a Reusable Query Snippet.

Tagging a Staging Query

You can add tags to a Staging Query in much the same way. Navigate to the Properties panel, and enter or select any number of desired tags. There are a few restrictions; namely, that Asset Tag values are limited to 64 characters or fewer.

Most special characters are also restricted from use in Asset Tag names. Common special characters, such as commas, periods, hyphens, and underscores, are permitted.

Tagging a Test Suite

Test Suites, too, support tagging. Much like the Design entities we've already covered, Asset Tags can be added to a Test Suite in the Properties panel.

These tag values are associated with the Test Suite, and can be optionally attached to Scenario executions that include this Test Suite.

Tagging a Scenario

There are a few different ways in which users can assign an Asset Tag to a Scenario execution.

• Prior to execution in the Run Scenario modal.
• Prior to execution in the Schedule Scenario modal.
• After execution in the Scenario Tags modal.

When associating Asset Tags to a Scenario prior to execution, users have the option of inheriting all underlying Test Suite tags, assigning tags specific to that Scenario execution, or a combination of the two.

Assigning Tags when Running a Scenario

Right-click a Test Suite and select Run Now. By default, the modal will show an editable Scenario name, along with an Asset Tags dropdown menu where you can enter or select tags to specifically associate with this execution.

If you select the Include Inherited Suite Tags checkbox, the underlying tags associated with this Test Suite will be attached to the execution, too.

You can remove some of the inherited Test Suite tags if you don't want to include them all. And don't worry if you've got duplicates across the Asset Tags and Inherited Suite Tags dropdown menus. It'll only make a single association.

Assigning Tags when Scheduling a Scenario

If you choose to schedule a Scenario, you'll have the same options in terms of execution-specific and inherited Asset Tags. From either the Scheduling or Execution view, click the Schedule button. In addition to the scheduling options you have in this modal, you'll also have the ability to make one or more Asset Tag associations with this execution.

And much like the Run Scenario modal, you can select the Include Inherited Suite Tags in the Schedule Scenario modal to attach the underlying tags for each of the Test Suites in the grid.

If you remove a Test Suite from the grid, its inherited tags will be disassociated with this Scenario execution, as well.

Viewing and Editing Tags after a Scenario Finishes its Execution

Navigate to the Run Dashboard and select a Scenario execution. The Scenario Status panel provides execution metadata, such as start times, owner, and various QueryPair metrics. At the bottom of this panel, you'll see the Asset Tags you attached to this execution.

If you wish to modify these tag assignments, right-click the Scenario in the Scenario Queue and click Edit Asset Tags. This modal shows all current tag assignments (including inherited tags), and gives users the ability to make post-hoc modifications as needed.

Note: Tag inheritance is determined at the moment a Scenario execution is scheduled. Subsequent changes to underlying Test Suite tag associations will not be reflected by Scenarios already scheduled for execution.

Tag Management

To open the Tag Management panel, navigate to the Design menu in the application header and click the View All Tags menu option.

This panel gives users a bird's eye view of their project-wide Asset Tag usage, including IDs, names, and the number of occurrences. The number of occurrences refers to the number of entities that are associated with a particular tag.

Tag Occurrences

If you double-click an Asset Tag (alternatively, you can right-click or use the action menu to select View Occurrences), you can browse each of the entities that are tagged with this value. 

Double-click (or, again, right-click or use the action menu and select Open <Asset Type>) any of these entries to navigate directly to that asset.

Renaming a Tag

To rename an Asset Tag, you'll need to open the Occurrences panel. At the top of the panel, edit the value in the Tag Name field and press the Save button.

This will impact all instances of this Asset Tag, meaning any entities with this tag association will be updated to reflect the new value.

Deleting a Tag

You can delete an Asset Tag entirely from the Tag Management panel. Right-click a tag (or, alternatively, use the action menu) and click Delete.

Note: When you delete an Asset Tag, it removes it entirely from your QuerySurge project. This includes severing any of its existing associations with your QueryPairs, Reusable Query Snippets, Staging Queries, Test Suites, and Scenarios.

Filtering on Reports by Asset Tags

Asset Tags have been integrated, where applicable, with a number of QuerySurge Data Intelligence Reports. Using the Contains Tags filter, users have the ability to select one or more tags by which to filter their report data.

Only assets with at least one of the selected Asset Tags will be displayed in the resulting report. If no Asset Tags are selected, then all data will be included (regardless of tag association).

Asset Tag filtering is available on the following QuerySurge Data Intelligence Reports.

• Reusable Query Snippet Usage
• Reusable Query Snippet History
• QueryPair Property
• QueryPair Overview
• QueryPair to Test Suite Mapping
• QueryPair Mappings Coverage
• QueryPair History
• QueryPair Detail
• Test Suite Detail
• Test Suite History
• Test Suite Last Run Results
• Scenario Comparison
• QueryPair Last Run Results
• Cross Scenario Run Results