Creating manual test scripts from the test case design

You can define test script steps in the Test Case Design section of a test case and use the design to automatically generate a test script.

Before you begin

Before you write test script steps, check the terms that are used to identify reporting steps by clicking the Administration icon (Administration) at the upper, right part of the banner, selecting Manage Project Properties, and then clicking Manual script dictionary. Statements that contain these terms are converted to reporting steps when manual test scripts are automatically created.
Note: By default, an approved test case is no longer open for editing. If a user modifies and attempts to save an approved test artifact, the following message is displayed: Do not allow saving of an "Approved" or "Retired" artifact. To change this behavior, see Allowing users to edit approved artifacts.


  1. Open the test case to add a test script to.
  2. Click the Test Case Design section.
  3. To begin typing statements, click Add Content.

    Enter each step on a new line. You can add a new line using the Enter key or the Shift+Enter keys. When you use the Enter key, paragraphs are added for the preceding line and next line. When you use the Shift+Enter keys, a single line break is added.

    The text that you include in the test case design is only converted into step descriptions, not expected results. If you have more information about expected results, you can add it to the steps after the script is generated.
    Tip: For releases before, enter each step on a new line, which is separated by a line break. When you press the Enter key, a single line break is added. Groups of steps that are not separated by line breaks are included in the same step.
    Note: To identify reporting steps, use the terms in the Manual script dictionary. For example, if the term report is listed as a term that identifies reporting steps, the statement Report whether the credit card information was processed becomes a reporting step after automatically creating the manual test script.
  4. Use the toolbar to format steps, attach and resize images, and attach documents. If you are pasting text from another word-processing application, click the Validate (Rich Text Editor cleanup) icon to clean up the text.
    Tip: Click Preview to view your test script before you create it.
  5. When you finish typing the statements, click the Create manual test script from test case design icon (Generate new test script) to automatically create a test script from the statements in the text editor.
    Tip: You can also complete this step from the Test Scripts section or when you are browsing through a list of test cases. In the latter case, click Construction > Browse Test Cases, select a test case, and click Create manual test script from test case design.
  6. In the window that opens, optionally edit the title or click Work item: Create to assign the test creation to another team member, and then click OK.
  7. Click the Test Scripts section to see the generated test script, and then click Save to save the test case.
    Tip: You can also generate the test script from the Test Scripts section.
  8. To open the test script in the Manual Test editor, click the test script name.
  9. If needed, you can continue to edit and format the statements with the Manual Test editor.


The manual test script is automatically generated and associated with the test case.

video icon Watch videos

CLM playlist channel
User Education channel

learn icon Learn more

CLM learning circle
Agile learning circle
Learning circles

ask icon Ask questions forum
developerWorks forums

support icon Get support

Support Portal
Deployment wiki
Support blog