Adding a Test Case

Owned by Kevin Pham (Deactivated)
Last updated: Oct 10, 2024 by Dominik Trygar
2 min read

Starting October 11, 2024 (Zephyr Enterprise 8.2), the Zephyr Enterprise documentation moved from its current location on Atlassian to a dedicated, standalone Zephyr Enterprise documentation page. Please see: https://support.smartbear.com/zephyr-enterprise/docs/en/zephyr-enterprise/zephyr-user-guide/test-repository/adding-a-test-case.html


Adding Test Cases

1. Click on the "Add" button at the top of the table.

2. You can change any of the fields once you create the new test case.

  • Name - The name given to distinguish a test case in the system.
    • By default, the title of the test case will be labeled as "Untitled" until changed.
  • Alt ID - ID given if the test case is linked/imported from JIRA.
  • Priority - The urgency used to define a test case.
  • Tags - A label attached to a test case.
  • Description - A written representation to help provide an explanation for the test case.
  • Comment - Any additional information provided to help clearly understand the test case.
  • Mapping Requirement - Linking a requirement to the test case to build traceability between a requirement and test case.
  • Test Steps - Informative steps used to define the executed steps involved, the data required to replicate the steps, the expected results involved for each step, and comments to provide additional context for the test step.
  • Automation - A file that can be attached to a test case to help define/describe the requirement. (images, docs, etc.)
  • Test Details - Any additional fields that can be filled out if previous test detail fields were customized in the administration page.
  • Attachments - Any file(s) used to assist in defining the test case. Click Attachments to know more about the supported file formats.

Warning for Editing Test Case Fields with Mandatory Custom Fields

Zephyr has improved handling of mandatory custom fields for test cases, adding a message to warn user to fill out mandatory custom fields. 

Users will receive a pop-up to warn users when they try to navigate away from editing in all places except for the following:

  • Breadcrumbs
  • Project/release links
  • Test repo tree
  • Pagination
  • Top navigation
  • Execution redirection

Quick Tip

  • Once you edit or change a field, Zephyr will automatically save your change.
  • When editing test steps:
    • You can press the "esc" shortcut on your keyboard to delete anything that is typed in the current field.
    • You have the ability to reorder the test steps to your liking as well.

3. Click on the  icon to view the list of test cases.

  • You can also click the up arrow to view the previous test case in the list
  • You can also click the down arrow to view the next test case in the list