Creating manual test scripts

The Manual Test editor is a rich-text editor for constructing test scripts.

About this task

You can create a test script on the Construction page or create a script from within a test case.

Procedure

  1. Use one of these procedures to create a test script.
    • To create a test script from the Construction page:
      1. From the main menu, click Construction > Create > Test Script.
      2. At the top of the new test script window, type a descriptive name that identifies the purpose of the script.
      3. If team areas are enabled for the project area, select a team area from the list.
        Note: You must explicitly enable team areas in Manage Project Properties.
      4. Select an owner for the test script.
      5. For a manual test script, make sure that the script type is Manual.
      6. Optional: Type a description.
      7. Optional: To assign the task of completing the test script to another team member, save the test script, and then click Work Item: Create.
        Note: Creating a work item to complete the test script does not change the owner of the test script.
    • To create a test script from within a test case:
      1. Open a test case.
      2. From the Test Scripts section of the test case, click the Create Test Script icon (Add new test script).
      3. In the New Test Script dialog box, in the Name field, type a descriptive name that identifies the purpose of the script.
      4. Optional: Type a description.
      5. The type is Manual by default.
      6. Click OK.
      7. Save the test case. The test script shell is created.
      8. Click the test script name to open it in the Manual Test editor.
      9. Select an owner for the test script.
      10. Optional: To assign the task of completing the test script to another team member, click Work Item: Create.
        Note: Creating a work item to complete the test script does not change the owner of the test script.
  2. Optional: Add test data.

    You can use test data to supply realistic values for the variables in a manual test script. Test data is a collection of related data records. During execution, the variables in the manual test script are replaced with data from the test data. As a result, you can use a single script to test multiple data records.

    1. Next to the Test Data field, click the Change Associated Test Data icon (Edit).
    2. Select a test data artifact; then, click OK.
    3. Optional: To filter data records so that a subset is used when the test script is executed, complete the following steps:
      1. Next to the Test Data Usage field, click the Select Records from Test Data icon (Edit).
      2. Under Record Selection Criteria, select a column name; then, set a filter value.
      3. To verify the selection, click the Show button.
        The data records are filtered according to the filter settings.
        Tip: To reset the selection criteria, click the Clear icon.
      4. Click OK.
  3. Define categories.

    You can use categories to define a hierarchical organization of test plans, test cases, test scripts, and other test artifacts. You can also define subcategories and other category relationships. You can use the default categories that are provided or create your own. To define categories, click the Manage Test Plan Categories icon (Manage category).

  4. Assign values to the custom attribute fields.

    If an administrator defined any custom attributes for test scripts, they are displayed in the Attributes section of the summary. The field values for custom attributes can be in the format of text, integer, or date. You can sort or filter your test scripts by using custom attributes in the same way that you use categories.

  5. After you finish adding steps, click Save at the top of the page to save the test script.
    Tip: To quickly save a script, press Ctrl+S.
  6. Optional: To make a copy of the test script, in the upper right of the test case, click the Duplicate icon (Copy ).
  7. Optional: To display a printable version of the test script, in the upper right of the test script, click the Print View icon (Print view).
  8. Optional: To lock or unlock the test script, in the upper right of the test script, click the Set to Lock/Unlock icon (Change lock). The ability to lock a test script depends on your role-based permissions. Depending on how your project is configured, you might be required to sign this action electronically by providing your password and a comment. When the test script is locked, the editable fields are disabled for editing. To reverse the locking attribute, click the icon again.
  9. Optional: To export the test script details to a PDF document, click the PDF icon (Export to PDF).

What to do next

If your organization requires a review of the test script, you can use the Formal Review section of the test script to assign reviewers and approvers.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki