Auto-Generate Details and Steps in Existing Test Cases

Generate test case details and steps for an existing test case using a requirement or user-provided description, with the option to update the existing test case or create a new version.

Prerequisites
  • Super Admin Configuration: The super admin needs to turn on the Enable users to generate details and steps in an existing test case by either updating the current version or creating a new one feature from AI Configuration under Customization.

  • Permissions: You must have permission to create test cases.

Auto-Generating Details and Steps in Existing Test Cases

Auto-Generate Test Cases (AGT): Generate test case descriptions, preconditions, and test steps within an existing test case. You can either update the current version of the test case or create a new one.

Go to the Test Cases module and click the test case entity key to open the detail view.

Screenshot of an existing test case (e.g., Sports tracking test cases) with the Generate Details and Steps button at the top, allowing users to create or update test case content using QI.

Generating Details and Steps using QI

Use QI to modify an existing test case or create a new version with updated steps. This allows you to refine test cases based on changes in requirements or testing needs. Simply provide the existing test case and specify the modifications required.

Screenshot showing the four generation source tabs: Select Currently Linked Requirement, Select Requirement, Enter Description, and From an Existing Test Case. The requirement list is displayed below.

To auto-generate test steps and details from an existing test case, click Generate Test Cases.

Select one of the following options:

Generating Test Steps and Details from a Requirement

To create test cases from a requirement currently linked to the test case, perform these steps:

  1. Select a tab:

    • Currently Linked Requirement (to use an already linked requirement).

    • Select Requirement (to choose an existing requirement from the current project or another project).

  2. Select a requirement from the list. (You can select only one requirement at a time.)

  3. Click Update Current Version or Create New Version.

Generating Test Steps and Details from a Description

To create test cases for a new description, follow these steps:

  1. Open the Enter Description tab.

  2. Enter a description (between 30 to 1500 words) to define the expected test steps.

  3. Click Update Current Version or Create New Version to apply the changes.

Generating Test Steps and Details from an Existing Test Case

  1. Open the From an Existing Test Case tab.

  2. Select one of the following options:

    • Use Current Test Case: Enter a description explaining the changes expected in test steps.

    • Use Other Test Case:

      • Select the project.

      • Select the test case.

      • Enter a description defining expected updates.

      Note

      • You cannot use the Current Test Case, if it has no steps.

      • You cannot update the Current Version, if it has existing steps.

  3. Click Update Current Version or Create New Version.

Warning

Using QI for test case generation or modification may replace or update the test case description, preconditions, steps, attachments, parameters, or shared steps.

Test Case Processing in QI

QI helps in generating and modifying test cases based on the provided description and structure. If the Generate Test Cases button is disabled, here is how to proceed:

  • Select a relevant test case for QI to refer.

  • Enter a description between 5 and 100 words for accuracy.

  • The selected test case must have sufficient steps to generate a new test case.

Best Practices for Writing User Description:

  • Give clear instructions for enhancing test steps.

  • Write each instruction in a new line for multiline descriptions.

  • Use complete sentences with proper punctuation.

  • Start with action verbs like 'Add', 'Update', 'Change', or 'Remove'.

  • Specify the entity you want QI to modify, such as description, precondition, or steps.

  • For multiple changes, maintain the sequence of test case content:

    • Description: Provide changes first.

    • Precondition: List modifications next.

    • Steps: Detail updates last.

Note

  • Currently, QI processing does not support rich text and tables.

  • Content may lose formatting after the model processes it.

  • AI treats shared steps as steps of a simple test case.

  • AI does not retain metadata of shared steps.

  • Currently, the word limit for a test case (including description, precondition, and step details) is 1500 words.

Test Case Versions

You have the option to either update the current test case version with newly generated test steps based on the linked or newly entered requirements or descriptions, or create a new test case version.

Update Current Test Case Version

The Update Current Test Case Version feature allows you to replace and regenerate the existing test case description, steps, and attachments.

This ensures that the test case reflects the most recent changes. However, this also results in the permanent loss of current details. Hence, back up your data before proceeding.

Clicking Update Test Case Version triggers the auto-generation of test steps and details. You can review, edit, accept, or delete these steps as needed in the Steps tab. The Details tabs allow you to add both system-defined and custom field parameters to the test case.

Screenshot of the “Generate Details and Steps using QI” screen showing generated steps and outcomes, with the Update Current Version button highlighted to update the existing version of the test case.

Clicking Update Current Test Case Version replaces the existing content with QI-generated test case steps and details.

Clicking Update Test Case Version follows the same process as Create New Test Case Version. You can also cancel the operation by clicking Cancel.

Create New Test Case Version

Clicking Create New Test Case Version triggers the automatic generation of test steps and details. You can review, edit, accept, or delete these steps as needed. Add system defined or custom defined field parameters in the Details tab.

Screenshot of generated test case details with the Create New Version button highlighted, indicating the option to create an updated version instead of modifying the current one.

Click Create New Test Case Version to generate a new test case with QI-generated steps while retaining the previous version. Here, the bot symbol signifies that the test case is AI-generated, updated, or versioned, enabling you to track AI-generated test case versions.

Generating Test Steps and Details using QI

Upon clicking Create New Test Case Version or Update Current Test Case Version, the Generate Test Cases and Test Steps using QI screen appears. You can review, edit, approve, and delete the auto-generated steps. This screen is divided into two panels:

  • Top Panel: Displays the requirement description from which the test steps are generated. Expand this section to view the full description.

  • Bottom Panel: Displays the test steps and details associated with the test case.

Full-screen screenshot of the generated test case with the Description at the top, followed by generated steps and outcomes. The bottom action bar includes Cancel and Update Current Version options.

Steps

The Steps tab in the bottom panel presents the test case description at the top, followed by the step description, expected outcome, and input values. Users can edit the test cases, add or delete steps, insert shareable test cases, and reorder or duplicate steps. Additionally, they can refine the content in the test case description, step descriptions, and expected outcomes to better suit their needs.

Screenshot of the Steps tab in a QI-generated test case, showing the steps list, expected outcomes, and action menu options including insert row, remove row, duplicate row, and move.

Users can manually edit AI-generated test cases by performing the following operations:

  • Insert Row: Allows the user to manually insert additional test steps into the AI-generated test case.

  • Insert Shareable Test Case: Lets the user integrate a shareable test case as a test step within the current test case.

  • Remove Step: Provides the option to delete unnecessary or redundant test steps.

  • Duplicate Step: Enables the user to create a copy of a test step for reuse.

  • Reorder Steps: Allows the user to move test steps up or down to organize them logically.

  • Edit Text: Allows users to modify the text of the test case description, step description, and expected outcome as needed.

  • Accept or Decline: Provides the user with the ability to accept or decline a test case based on its relevance and requirements.

You can easily navigate between test cases on this screen using the left and right arrows located near the Accept and Decline buttons.

Details

The Details tab allows users to set values for both system-defined and user-defined fields.

Screenshot showing the Details tab of a generated test case with editable system fields, user-defined fields (including Pre_condition), and the “Generated by QI” badge.
Publication date: