UI Overview

Note

Zephyr Squad does not support the restoring Test Cycle and Execution Details for tests issues moved between projects. This includes test issues that are moved from one project to another using the 'Move Issues' function in Jira.

Main navigation

You can access Zephyr Squad in two ways:

  • Open a Jira project and select Zephyr in the project sidebar.

  • From Jira main menu, select Apps > Zephyr.

When the Zephyr application is open, you will see the following sidebar:

Zephyr menu

What's New - Learn about new features and improvements made in recent releases of Zephyr Squad.

Design

  • Create a Test - Create a brand new test under the current project. The issue type is "Test" and is indicated by this icon: zephyr-icon.png

  • Create a BDD Feature - Create a BDD feature with accompanying steps.

  • Search Tests -This opens the Issue Navigator to allow searching for tests.

  • Import Tests - Import your existing tests from Excel or XML files.

Planning and Execution

  • Cycle Summary - Create and view various test cycles based on version.

  • Search Test Executions - Search for executions in a project using ZQL.

  • Manage Execution Filters - Manage filters saved using the test execution search functionality.

Reporting

  • Test Metrics - Opens the Test Dashboard with testing metrics gadgets displayed.

  • Test Summary - Summary of all testing activity in a project.

  • Traceability Matrix - A report that can generate a trace of testing from a story through tests, cycles, executions, and defects.

Integrations

  • API Keys - Get API keys required to call Zephyr Squad REST API.

  • Test Automation - Imports test results from test automation frameworks directly into Zephyr test execution cycles.

  • BDD/Cucumber - Learn how to create and use behavior-driven development (BDD) testing with Zephyr Squad.

  • REST API - Learn more about Zephyr Squad REST API.

  • Continuous Integration - Learn how to integrate your CI/CD workflows with Zephyr Squad.

Settings

  • Zephyr Custom Fields - Select the custom fields to add to test steps and test executions.

About (this menu appears only when Zephyr is opened from global context)

  • Welcome - This page educates and provides access to a variety of resources such as Support, Buying/Upgrading etc.

  • Documentation - Link to the online documentation.

  • Zephyr Status - Opens the status page where you can see the current status of Zephyr Squad Cloud and subscribe to updates on planned maintenance.

  • Support - Link to Zephyr's support page.

  • Feedback - Give feedback directly to the plugin developers regarding your Zephyr Squad experience.

  • About Zephyr - Version and license information.

Create and view a test

A test can be created in any one of the ways that any issue type can be created in Jira. For example, clicking on the Create Issue link or Create Test link will bring up the following screen:

Create issue

A test can be viewed in its entirety in the following View Issue page:

View issue

On this screen, you'll find a toolbar that will allow you to access various features associated with editing and executing a test:

  • Comment: This allows users to add comments to the test.

  • Add to Test Cycle(s): Allows this test to be added to a specific test cycle of a version for test execution.

  • Attach Files: Allows files to be attached to this test.

  • More Actions:

    • Link: This brings up the Link Issue dialog that allows this test to be linked to any other issue (Task, Improvement, Story, Epic etc.)

    • Clone: A test can be very easily and quickly cloned.

    • Attach Screenshot: Allows screenshots to be attached to this test.

  • Execute: This allows for this test to be executed - either in an ad hoc manner (i.e. not associated with any particular test cycle and/or version) or as part of a test cycle.

Note

If you use the new Jira issue view, you must have the Edit Issues permission in the project in order to see Zephyr test information in the issue detail view. See User Permissions for more information.

Test Summary

The Test Summary page provides a comprehensive view of all the tests that belong to a particular project, summarized based on overall totals, Versions, Components and Labels. Clicking on any of these links will take you to the Issue Navigator and display a list of those tests.

Test summary

Cycle Summary

The Cycle Summary page allows you to view test cycles that have been created for a particular version of a project, create new ones, and drill-down into the list of tests for execution. Selecting a different version will change the view and display the test cycles for that selected version. A summary of the execution status is also displayed on the right and hovering over it provides additional stats.

Cycle summary

Execute tests

This screen allows you to execute a test by changing its status, filing a new bug or associating an existing one, adding attachments and comments. You can then save and return to the test or the test cycle from where you had come.

Execute a test
Publication date: