Introduction

Attachments enable you to add additional information relevant to specific test assets. They are managed under the Attachment tab (for requirements, test cases, issues, and test suites) and can be accessed from the detail/edit page.

Attachments are stored at the entity level, rather than the entity version level. This applies when attachments are added under the following circumstances:

• Adding a test asset

• Editing a version of a test asset (Update as well as Save as New Version)

QMetry supports the following attachment types -

1. Attachments: Documents/Videos/Images/Files

2. References: Links/URL

Adding Attachments

Let's see how to add an attachment to test asset.

Attaching Files While Creating an Asset

You can attach inline images and files in all rich text editor fields while creating an asset. Refer to the image below.

Open

To add a new attachment, follow these steps:

• Click the Create Asset button in any module (Requirement, Test Case, Test Suite, Issue).

• On the create page, click the Insert Image button in any rich-text editor field.

• Upload an image or insert an image link.

• Once you are done adding all the other details, click Create.

Attaching Files After Asset Creation

Once the asset is created, you can add attachments by clicking on the asset’s entity key and navigating to the attachment tab as shown below.

Open

To add a new attachment, follow these steps:

1. Navigate to the specific module.

2. Open the module's detail page by clicking on the Entity Key.

3. Go to the Attachments tab on the detail page.

4. Click the Add Attachments button.

5. Click on the Add button once you are done adding attachments.

Adding Attachments to Test Case Steps

You can add attachments to test case steps to provide additional information about that particular test step.

To add attachments:

1. Navigate to the test case detail page.

2. Open the Steps tab.

3. Click the Attachment icon for the relevant test step.

4. The Add Attachment screen will open. Attach the required files.

4 Ways of Adding Attachments

The Add Attachment pop-up window opens, enabling you to attach different types of attachments: files, images, and URL. You can attach multiple files at once in any of the following way:

• Drag and Drop: Drag and drop the attachments into the specific area of drop documents.

• Browse: Browse the file you want to add as attachment and upload it by clicking on the Browse section. 

• Paste: Add attachments to test assets by directly pasting them from the clipboard. This allows you to add screenshots without saving to local machine. Only .png files can be pasted directly into the Add Attachment pop-up.

• Enter URL: You can attach reference URL (with "https" protocol) as an attachment. The field type is Large Text to accommodate URLs that are greater than 255 characters.

Individual attachments can also be removed during the upload stage.

While uploading, a thumbnail of the attachment is displayed. This clickable thumbnail allows you to preview the attachment before submission.

View Attachments & Reference 

Once the files are attached, you can view the attachments in List View or Strip View.

List View

Strip View

Copy Attachment URL

The "Copy Link" option enables you to copy the URL of an image or file added to the attachments section. This URL is intended solely for referencing files or images within the application's rich text editor. Deleting the original image or file from the attachment section will make the link inaccessible.

→ Copy Image Attachment: If the copied link of an image attachment is accessed in a browser directly, then the thumbnail will get displayed as unreadable content.

→ Copy File Attachment: If the copied link of a file (e.g. PDF) is accessed in a browser where you are not logged into QMetry, then you will be redirected to the login page. The file can only be downloaded after logging into QMetry.

Delete Attachments

You can easily delete a single attachment by clicking on the delete icon for that attachment or delete multiple attachments in bulk using the “Delete Selected” button at the top.

Download Attachments

You can easily download, review, update, and reattach attachments with ease.

• To download a single attachment: Click the Download icon corresponding to the specific attachment.

• To download all attachments at once: Click the Download All button.

Download from the Preview screen

You can preview the attachment just by clicking on it.

To download the attachment, click on the Download icon at the top right.

View the Progress and Download Attachments

Click on the Scheduled Task  icon on the application header to view the progress of the download. It shows the current stage of the download process.

Once the process is completed, click on the Download icon for the activity.  The attachments will be downloaded in a zip file.

The download activities on the Scheduled Tasks section appear with the respective module/level from where the download is triggered.

Embed Attachments as In-line Image in Rich Text Fields

In all the modules (Requirements, Test Cases, Test Suites, Issues, and Test Case Executions), you can easily add in-line images to rich text fields from the attachment section.

To do this, use the “Select from Linked Attachments” options under Insert Image while editing. Clicking on this option, displays thumbnails of images, screenshots, or GIFs that are already added in the asset’s attachment section. Selecting a thumbnail, will embed the attachment in the rich text field.

For example, attachments added to a specific requirement or test case can be embedded directly into the rich text fields of that particular requirement or test case.

Adding In-line Image in Test Steps:

1. Navigate to Test Case > Steps.

2. Click Edit.

3. Select the rich text field (step description, input data, expected outcome or any other user-defined field) where you want to embed the image as a thumbnail.

4. Click Select from Linked Attachment.

5. Select ‘test case’ or ‘test steps’ from the drop-down menu.

6. Choose the attachment(s) to add by clicking Select.

7. Update the test case to save the changes.

Adding in-line Images in Test Execution

For rich text fields in test execution, such as actual outcomes or comments, you can insert inline images that are attached to the test case, test step, test execution, or test step execution.

Attachments Syncing between Jira and QMetry

Requirement Module

The attachment works independently for requirements. When requirements (stories in Jira) are imported from Jira, the Attachments tab on the Requirements detail page displays Jira attachments by default. To view attachments added from QMetry, turn the Show QMetry Attachments “On”.

Linking attachments from either side i.e. from QMetry or from Jira does not impact requirements that exist in other applications.

Issue Module

When Jira issues containing attachments are imported into QMetry, the associated attachments are also imported and linked to the issues in the Issue module.

• If an attachment is linked to an issue from QMetry, then that attachment will also reflect in Jira for that issue.

• If an attachment is linked to an issue in Jira, then that attachment will also reflect in QMetry for that issue.