Managing Attachments

Introduction

Attachments provide additional information which is important to refer to while working with the specific test assets. Attachments are managed under the Attachment tab (like for requirements, test cases, issues and test suites) and can be managed from the detail/edit page.

Attachments are stored at the entity level instead of the entity version level. It is applicable whenever attachments are added while -

  • adding a test asset

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

Notes: 

  • If an attachment is added to one version of the test asset, it is reflected in all versions of the test asset. For example, User is editing a test case version 2 and adding 3 attachments to it. These attachments will be seen in version 1 as well as all the future versions of the test case.

QMetry supports the following attachment types

  1. Attachments: Documents/Videos/Images/Files

  2. References: Links/URL

Note: QMetry does not support these file extensions : (.exe, .dll, .sh, .msi, .deb, .bat)

Adding Attachments

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

1. Go to the Test Cases module.

2. Open the test case details page by clicking on the Test Case Entity Key.

3. Open to the Attachments tab of details page.

3. Click on the Add Attachments button.

The Add Attachment pop-up window opens.

Add Attachments

You can attach different types of attachments: files, images, and URL.

The Add Attachment pop-up allows you to upload multiple files at a time.

Add attachments three ways:

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

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

  • Paste (ctrl + v): 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.

Notes: 

  • Maximum 100 files can be attached. Total size of attached files should not exceed 100 MB.

  • QMetry does not support these file extensions : (.exe; .dll; .sh; .msi; .deb; .bat)

  • All the attachments from the previous version are carried forward to the new version. For example, if the user is editing a test case version 2 which has 3 attachments with it, then these attachments will be carried forward to the latest version of the test case.

You can also remove individual attachments at the uploading stage.

When you upload the attachment, you can view the image thumbnail even before you submit it to attach. This thumbnail is clickable, which allows you to preview the attachment before its submission.

Reference URL

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.

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

View Attachments & Reference 

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

List View

You can preview the attachment by clicking on it.

 

Strip View

You can view the thumbnails of attachments and preview the attachments by clicking on them without downloading them.

Download Attachments

For the attached file, it shows options to Delete and Download. For reference URL, it shows options to Delete and Open Link. You can download the attachment/open link by clicking on the arrow icon.

As QMetry encourages team collaboration, attachments added from a team member can be downloaded, reviewed, modified and attached again by other members of the team.

Download Attachments:

  • To download a single attachment, click on the Download icon for that attachment.

  • To download all attachments at a time, click on the Download All button.

 

List View

A. Click on the Download icon to download a single attachment.

B. To download all the attachments in one go, click on the Download All button.

Strip View

A. Click on the Download icon to download a single attachment.

B. To download all the attachments in one go, click on the Download All button.

After clicking on the Download All button, you can download the zip from the Schedule Task section which can be accessed by clicking on the icon on the application header.

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.

Delete Attachments

Attachments can be deleted in single or in bulk.

Note: If an attachment is deleted from one version of the test asset, it will be deleted from all the versions of the test asset. For example, there are four versions of a test asset which has three attachments. If one attachment is deleted from version 2, then the attachment will be deleted from all 4 versions.

Delete a Single Attachment

List View

Click on the Delete icon for the attachment that you want to delete.

Strip View

Hover over the attachment and click on the Delete icon for the attachment to delete it.

Delete Multiple Attachments

List View

Select the attachments you want to delete and click on the Delete Selected button.

Strip View

Select attachments that you want to delete and click on the Delete Selected button.

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 have attachments with them and they are imported in QMetry, then these issues are imported with associated attachments 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.