Components

Introduction

Components add categorization to your test assets, categorizing them into features, screens, teams, modules and more. Components provide an easier way of grouping your test assets. Using components, you can search Test assets, generate reports, collect statistics, e.t.c.

QMetry allows you to create customized Components at the project level. A user can assign it to a  Test Case, Test Cycle and Test Plan for grouping.

Permissions Required:

Jira Permissions: Browse Project permissions are required.

QMetry Permissions:

  • If Enabled then the below permissions are required.

    • Configuration View

    • Configuration Modify

Searching a Component

You can search for a specific component from the long list.

  1. Navigate to QMetry > Configuration menu > Select Project.

  2. Click on Component.

  3. Click on the search icon to see the text box. Type the keyword in the text box and press ENTER on the keyboard.

It is a good practice to search for a component before creating it. It will help you avoid the creation of duplicate components.

Creating a Component

'Configuration modify' access to the project is needed to create a customized component.

Example: QA manager has to create a component 'login'. Below are the steps for component creation:

1. Go to QMetry menu > Configuration > Select your Project. 

2. Under Project Configuration select Components.

3. Enter a meaningful component name and its relevant description. Click Add.

 

The Components are available for linking them with the Test Case, Test Cycle and Test Plan. 

Add Component Values Inline

The Components field values can be added inline in the test asset detail page. For example, in the test case detail page, a Component value "Admin" is added.

1. In the Components field, type the field value.

2. An option to create the value is prompted. Click on it or press ENTER.

Using a Component

Below are the steps to link components. These are generic steps for all 3 Test assets mentioned above.

Example: Considering the scenario for Test Case 

  1.  Go to QMetry menu > Test Management > Test Case tab.

  2. Create a new Test Case or open detail page of an existing Test Case.

  3. Check the Components drop-down and you will get a list of all components that can be linked to the Test Case.

Import Components from Jira

You can import the components defined in Jira and use them in QMetry. It helps users as they do not have to enter the same data in QMetry which is already created in Jira.

1. Click on the Import button at the top.

 

It opens the Import Components from Jira screen with the list of Jira components created in the Jira project in which QMetry for Jira is enabled.

2. Select the project you want to import Components from. To import Components from other Jira projects, you should have access over it.

3. Select the values you want to import into QMetry Components field.

Select All:

  • Select all records on the current page:

Clicking on the checkbox in the column header selects all the records on the current page only.

An alternate way is to open the checkbox drop-down and select Current Page.

  • Select all records across all pages:

4. Open the checkbox drop-down and select Across All Pages option.

5. Once the Jira Component values are imported into QMetry, these values populate in the Components field on the test asset detail page.

Editing a Component

 User with 'Configuration Modify' access to the project can edit a component that is already created.  Below are the steps to edit a component:

  1. Click on the component name, and a text box appears to enter the new component name as shown in below screenshot.

  2. After typing the new name, click on the tick mark symbol. Also, editing the description field can be done on similar lines.

Copy Components to Other QMetry Projects

Users can copy Components from one project to other projects. The functionality allows users to use similar items in different QMetry projects without having to add these items individually.

Users can save their time as they do not have to create redundant/duplicate items for different QMetry projects.

  1. Select the Components that you want to copy to other QMetry Projects. The Copy button is visible on the screen as soon as you select Components.

  2. Click on the Copy button.

Note: To copy components to other projects, the user must have Configuration “Modify” permission of the targeted project.

 

3. Now select the project wherein you want to copy the selected items. You can select multiple QMetry Projects (maximum 5 projects) at a time to copy the item.

Duplicate entities will be ignored while copying.

Deleting a Component

User with  'Configuration Modify' access to the project can delete a component which is now not in use. 

Note: A deleted component will lose all its linkages with test assets it was previously linked with and it will also affect the reports if they were fetched based on the component filter.

          The Test asset's component field will appear blank once component gets deleted and linkages can't be recovered.

Below are the steps to delete Component:

  1. Go to QMetry menu > Configuration > Select your Project 

  2. Under Project Configuration select Components. The Component list is displayed on the screen.

  3. Hover over the Component that you want to delete and click on the Delete icon.

Deleting components that are linked to any Test Asset will give the warning message like the following:

After deletion, the component value will be removed from the Component field of the test asset.