6 Working With Tests

Tests can be manual or automatic. Automatic Oracle OpenScript scripts can be run from Oracle Test Manager. For manual tests, you enter the individual test steps. When you run a manual test, a wizard guides you through each step, allowing you to enter the results.

Tests can be grouped together into branches for easy management. Once entered, they can be associated with the requirements they address or any issues that result from running the test.

When you run a test, you can specify the workstation to run it on. Workstations are configured using the Systems Manager. To run Oracle OpenScript tests on remote systems, you must also install the Oracle Application Testing Suite Remote Agent on the remote system and configure Remote Agent Service login credentials. See the "Installing the Oracle Load Testing Remote Agent" section in the Oracle Application Testing Suite Installation Guide for additional information about installing the agent and configuring the login credentials.

In addition, tests can be scheduled to run once at a specified day and time, daily at a specified time, or weekly at a specified day and time.

6.1 Adding Oracle OpenScript Scripts

Oracle OpenScript scripts can be added from the Web interface. To add an Oracle OpenScript test:

  1. Select the Tests tab.

  2. Click the Add button.

  3. Enter a name for the test.

  4. Select Oracle OpenScript in the Type field.

    This dialog box has the following options:

    Name - displays the test name.

    Type - displays the type of test. The last type selected is displayed first in the list.

    • Manual Test - manual tests are entered, performed, and kept track of manually.

    • Test folder - high level descriptions for grouping tests together.

    • Oracle OpenScript - scripts created using Oracle OpenScript.

    • 3rd Party Test - use this option when you want to run an executable file and capture the results.

    • JUnit Test - use this option when you want to run an Ant file and capture the results.

    Test File - for JUnit and 3rd Party tests, displays the file that will run. Click Browse to display the Choose File dialog box for selecting the file.

    Repository - for OpenScript scripts, specifies the repository where the script is located. Click Find to display the Select Script dialog box for selecting the script file.

    Workspace - for OpenScript scripts, specifies the workspace where the script is located. When you select a script using Find, the workspace will be filled in automatically.

    OpenScript - specifies the OpenScript script file name. When you select a script using Find, the script name will be filled in automatically.

    Command line run setting - specifies the OpenScript command line run settings to use when running OpenScript scripts. This option only appears when Type is set to Oracle OpenScript. You must explicitly specify the OpenScript repository path of the agent machine as a command line setting if the Operating System of the agent machine is different from the Oracle Test Manager controller's Operating System (for example, if the controller is on Windows and the agent is on Linux). The syntax is as follows:

    -repository repository_name=full_path_of_repository 
    

    See the Command line settings in the Oracle Functional Testing OpenScript User's Guide or OpenScript online help for the available settings.

    OpenScript password - specifies the script password to use to access scripts that have the encryption password specified in OpenScript. If you add an OpenScript test and select an OpenScript script with an encryption password, the same password is required here to access and playback the script in Oracle Test Manager.

    Owner - select the user that owns the test. Only users with read permission for this project are listed.

    Functionality - for 3rd party tests, displays the regular expression that you want to match for a result of passed. For all other test types, displays the description of the functionality the test is designed to verify.

    Priority - displays the priority of the test. These options can be changed by your system administrator.

    Description - displays the test description.

    Attachment - lets you add an attachment or link to this test.

    File - lets you add an attachment to the Attachments section.

    • Browse - displays the Choose File dialog box for selecting the file to attach.

    Link - lets you add a link to the Links section.

    • Title - enter a descriptive title for the link. This will be displayed in the Links section.

    • Link - enter the URL. For example, http://www.company.com. If a title is not entered, the URL is displayed in the links section.

    Reset - clears the fields and returns the dialog box options to the starting state.

  5. Click Find to display the Select Script dialog box.

  6. Select the Repository and Workspace.

  7. Select the Oracle OpenScript script that you want to add.

  8. Enter command line settings and OpenScript password if required.

  9. Click OK.

  10. Select the owner and priority and enter any descriptive information in the Functionality and Description fields.

  11. Click Save.

6.2 Adding Manual Tests


Note:

The fields and options available to you may be different than those shown in the following examples if your system has been customized by your system administrator.

Tests are automatically numbered when you enter them. You can reorder them using the Move buttons. To add a manual test:

  1. Select the Tests tab.

  2. Click the Add button.

  3. Enter the name of the test.

  4. Select the Manual Test in the Type field.

    This dialog box has the following options:

    Name - displays the test name.

    Type - displays the type of test.

    • Manual Test - manual tests are entered, performed, and kept track of manually.

    • Test folder - high level descriptions for grouping tests together.

    • Oracle OpenScript - scripts created using Oracle OpenScript.

    • 3rd Party Test - use this option when you want to run an executable file and capture the results.

    • JUnit Test - use this option when you want to run an Ant file and capture the results.

    Owner - select the user that owns the test. Only users with read permission for this project are listed.

    Functionality - for 3rd party tests, displays the regular expression that you want to match for a result of passed. For all other test types, displays the description of the functionality the test is designed to verify.

    Priority - displays the priority of the test. These options can be changed by your system administrator.

    Description - displays the test description.

    Attachment - lets you add an attachment or link to this test.

    File - lets you add an attachment to the Attachments section.

    • Browse - displays the Choose File dialog box for selecting the file to attach.

    Link - lets you add a link to the Links section.

    • Title - enter a descriptive title for the link. This will be displayed in the Links section.

    • Link - enter the URL. For example, http://www.company.com. If a title is not entered, the URL is displayed in the links section.

    Reset - clears the fields and returns the dialog box options to the starting state.

  5. Select the owner of the test.

  6. Enter a description of the functionality to be tested.

  7. Select the test priority.

  8. Enter a description of the test.

  9. Click Save.

  10. Select Add/Edit in the Test Steps section of the right-hand pane.

    This dialog box has the following options:

    Add - adds a new row under the selected row. When you click the tab key the test in the Action, Expected Result, and Comment fields is added to the grid. Clicking Add again also populates the grid.

    Delete - deletes the selected step.

    Move Up - moves the selected step up one position in the list.

    Move Down - moves the selected step down one position in the list.

    First - display the first step.

    Previous - displays the previous step.

    Next - displays the next step.

    Last - displays the last step.

    # - displays the step number.

    Action - displays the action to perform.

    Expected Result - displays a description of what is expected to happen as a result of this step.

    Comment - displays additional information about the step.

    Add/Edit Attachments - displays the Add Attachment dialog box for adding an attachment associated with this test step. Attachments are listed in the Test Steps section of the right-hand pane.

  11. Click Add.

  12. Enter the information in the Action, Expected Result, and Comment fields for the step. The gird is populated when move to the next field or when you click Add.

  13. Click Add/Edit Attachments to add an attachment associated with this step.

  14. Click Add to add another step or OK to exit the dialog box when you are finished adding steps.

6.3 Adding Test Folder

Folders are automatically numbered when you enter them. You can reorder them using the Move buttons. To add a test folder:

  1. Select the Tests tab.

  2. Click the Add button.

  3. Enter a name for the test.

  4. Select Test Folder in the Type field.

    This dialog box has the following options:

    Name - displays the test name.

    Type - displays the type of test. The last type selected is displayed first in the last.

    • Manual Test - manual tests are entered, performed, and kept track of manually.

    • Test folder - high level descriptions for grouping tests together.

    • Oracle OpenScript - scripts created using Oracle OpenScript.

    • 3rd Party Test - use this option when you want to run an executable file and capture the results.

    • JUnit Test - use this option when you want to run an Ant file and capture the results.

    Owner - select the user that owns the test. Only users with read permission for this project are listed.

    Functionality - for 3rd party tests, displays the regular expression that you want to match for a result of passed. For all other test types, displays the description of the functionality the test is designed to verify.

    Priority - displays the priority of the test. These options can be changed by your system administrator.

    Description - displays the test description.

    Attachment - lets you add an attachment or link to this test.

    File - lets you add an attachment to the Attachments section.

    • Browse - displays the Choose File dialog box for selecting the file to attach.

    Link - lets you add a link to the Links section.

    • Title - enter a descriptive title for the link. This will be displayed in the Links section.

    • Link - enter the URL. For example, http://www.company.com. If a title is not entered, the URL is displayed in the links section.

    Reset - clears the fields and returns the dialog box options to the starting state.

  5. Enter a description of the functionality of the folder.

  6. Select the owner and priority and enter any descriptive information in the Functionality and Description fields.

  7. Click Save.

6.4 Adding Third Party Tests


Note:

The fields and options available to you may be different than those shown in the following examples if your system has been customized by your system administrator.

The 3rd party test lets you run an executable file and capture the results. Before creating the 3rd party test, create a batch or command file using a text editor such as Notepad. This file can contain anything that can be run from the command line.

Once you create the test, you can add test steps that use regular expressions to parse the test output to determine if the test was successful. If all test steps pass, the test result is passed. If one step fails, the test result is failed.

After the test has run, you can view the console output in the results report. To add a 3rd Party test:

  1. Select the Tests tab.

  2. Click the Add button.

  3. Enter a name for the test.

  4. Select 3rd Party Test in the Type field.

    This dialog box has the following options:

    Name - displays the test name.

    Type - displays the type of test. The last type selected is displayed first in the last.

    • Manual Test - manual tests are entered, performed, and kept track of manually.

    • Test Folder - high level descriptions for grouping tests together.

    • Oracle OpenScript - scripts created using Oracle OpenScript.

    • 3rd Party Test - use this option when you want to run an executable file and capture the results.

    • JUnit Test - use this option when you want to run an Ant file and capture the results.

    Test File - for Oracle OpenScript tests, displays the script test file name. For 3rd Party tests, displays the file that will run. Click Browse to display the Select Script or Choose File dialog box for selecting the file.

    Owner - select the user that owns the test. Only users with read permission for this project are listed.

    Functionality - enter a description of the functionality being tested.

    Priority - displays the priority of the test. These options can be changed by your system administrator.

    Description - displays the test description.

    Attachment - lets you add an attachment or link to this test.

    File - lets you add an attachment to the Attachments section.

    • Browse - displays the Choose File dialog box for selecting the file to attach.

    Link - lets you add a link to the Links section.

    • Title - enter a descriptive title for the link. This will be displayed in the Links section.

    • Link - enter the URL. For example, http://www.company.com. If a title is not entered, the URL is displayed in the links section.

  5. Click Browse to display the Choose File dialog box.

  6. Select the file that you want to run.

  7. Select the owner and priority and enter any descriptive information in the Functionality and Description fields.

  8. Click Save.

  9. Select Add/Edit in the Test Steps section of the right-hand pane.

    This dialog box has the following options:

    Add - adds a new row under the selected row. When you click the tab key the test in the Action, Expected Result, and Comment fields is added to the grid. Clicking Add again also populates the grid.

    Delete - deletes the selected step.

    Move Up - moves the selected step up one position in the list.

    Move Down - moves the selected step down one position in the list.

    First - display the first step.

    Previous - displays the previous step.

    Next - displays the next step.

    Last - displays the last step.

    # - displays the step number.

    Action - displays the description of the action.

    Result Pattern - displays the regular expression that will be used to parse the output of the third party test, which will determine if the step passed or failed. See the Regular Expressions topic in the online help (Contents, Working with Tests, Regular Expressions) for more information on regular expressions.

    Comment - displays additional information about the step.

    Add/Edit Attachments - displays the Add Attachment dialog box for adding an attachment associated with this test step. Attachments are listed in the Test Steps section of the right-hand pane.

  10. Click Add.

  11. Enter the information in the Action, Result Pattern, and Comment fields for the step. The gird is populated when move to the next field or when you click Add.

  12. Click Add/Edit Attachments to add an attachment associated with this step.

  13. Click Add to add another step or OK to exit the dialog box when you are finished adding steps.

6.5 Adding JUnit Tests


Note:

The fields and options available to you may be different than those shown in the following examples if your system has been customized by your system administrator.

JUnit is a unit testing framework for the Java programming language. JUnit has been important in the development of test-driven development and is one of a family of unit testing frameworks. Oracle Test Manager uses JUnit 4 and Ant. JUnit tests are run from a command-line using Ant.

Apache Ant is a Java library and command-line tool used to drive processes described in build files as targets and extension points dependent upon each other. The main usage of Ant is building Java applications. Ant supplies a number of built-in tasks allowing to compile, assemble, test and run Java applications. Ant can also be used effectively to build non Java applications, for instance C or C++ applications. More generally, Ant can be used to pilot any type of process which can be described in terms of targets and tasks.

A developer or tester creates unit test cases using JDeveloper (or any other development environment that allows unit tests). Once created, the JUnit test can be added to Oracle Test Manager. Oracle Test Manger executes the unit tests and reports the results.

The following settings are required on the system which runs JUnit test:

  1. Set the Environment variable PATH to include the following:

    • JDK (C:\OracleATS\jdk\jre\bin)

    • JUnit.jar (C:\OracleATS\install\lib\junit-4.5.jar)

    • ANT (C:\OracleATS\wls\modules\org.apache.ant_1.7.1\bin)

  2. Set Environment variable CLASSPATH to include the following:

    • JUnit.jar (C:\OracleATS\install\lib\junit-4.5.jar)

    • File path where class files are placed (C:\JUnit\Test\src)

  3. Validate the Environment:

    • Type "java -version" at the command prompt, you should see the JVM reports

    • Validate JUnit by executing "java org.junit.runner.JUnitCore" from the command line (JUnit Version details will be displayed).

    • Type "ANT" from the command prompt and verify there are no errors. (If you see tools.jar file missing error, place the jar file under JRE/lib directory.)

  4. Edit JUnit-Testfile.xml (Sample file at <OATS_HOME>\otm\junit) to include the correct classes directory path under classes.dir. Note: JUnit-Testfile.xml is the sample ANT file, which is supported by Oracle Test Manager.

  5. Execute the JUnit from command prompt (<OATS_HOME>\otm\junit):

    ant -Doats.junit.reports.dir=<path to store Report> -buildfile <buildfile name>
    

    Example:

    ant -Doats.junit.reports.dir=C:\Temp\Rpt -buildfile junit-testfile.xml 
    
  6. Execute JUnit from Oracle Test Manager application:

    • Login to Oracle Test Manager.

    • Navigate to Test tab.

    • Add Test: JUnit.

    • Browse to the ANT file.

    • Perform a QuickRun of the JUnit test.

To add a JUnit test:

  1. Select the Tests tab.

  2. Click the Add button.

  3. Enter a name for the test.

  4. Select JUnit test in the Type field.

    This dialog box has the following options:

    Name - displays the test name.

    Type - displays the type of test. The last type selected is displayed first in the last.

    • Manual Test - manual tests are entered, performed, and kept track of manually.

    • Test Folder - high level descriptions for grouping tests together.

    • Oracle OpenScript - scripts created using Oracle OpenScript.

    • 3rd Party Test - use this option when you want to run an executable file and capture the results.

    • JUnit Test - use this option when you want to run an Ant file and capture the results.

    Ant File - for Oracle OpenScript tests, displays the script test file name. For 3rd Party tests, displays the file that will run. For JUnit tests, displays the Ant file that will used for the test. Click Browse to display the Select Script or Choose File dialog box for selecting the file.

    Owner - select the user that owns the test. Only users with read permission for this project are listed.

    Functionality - enter a description of the functionality being tested.

    Priority - displays the priority of the test. These options can be changed by your system administrator.

    Description - displays the test description.

    Attachment - lets you add an attachment or link to this test.

    File - lets you add an attachment to the Attachments section.

    • Browse - displays the Choose File dialog box for selecting the file to attach.

    Link - lets you add a link to the Links section.

    • Title - enter a descriptive title for the link. This will be displayed in the Links section.

    • Link - enter the URL. For example, http://www.company.com. If a title is not entered, the URL is displayed in the links section.

  5. Click Browse to display the Choose File dialog box.

  6. Select the file that you want to run.

  7. Select the owner and priority and enter any descriptive information in the Functionality and Description fields.

  8. Click Save.

  9. Select Add/Edit in the Test Steps section of the right-hand pane.

    This dialog box has the following options:

    Add - adds a new row under the selected row. When you click the tab key the test in the Action, Expected Result, and Comment fields is added to the grid. Clicking Add again also populates the grid.

    Delete - deletes the selected step.

    Move Up - moves the selected step up one position in the list.

    Move Down - moves the selected step down one position in the list.

    First - display the first step.

    Previous - displays the previous step.

    Next - displays the next step.

    Last - displays the last step.

    # - displays the step number.

    Action - displays the description of the action.

    Result Pattern - displays the regular expression that will be used to parse the output of the third party test, which will determine if the step passed or failed. See the Regular Expressions topic in the online help (Contents, Working with Tests, Regular Expressions) for more information on regular expressions.

    Comment - displays additional information about the step.

    Add/Edit Attachments - displays the Add Attachment dialog box for adding an attachment associated with this test step. Attachments are listed in the Test Steps section of the right-hand pane.

  10. Click Add.

  11. Enter the information in the Action, Result Pattern, and Comment fields for the step. The gird is populated when move to the next field or when you click Add.

  12. Click Add/Edit Attachments to add an attachment associated with this step.

  13. Click Add to add another step or OK to exit the dialog box when you are finished adding steps.

6.6 Deleting Tests

You can delete tests from the project. To delete a test or branch:

  1. Select the test or branch that you want to delete.

  2. Click the Delete button.

  3. Click Yes when asked to confirm the deletion.

To delete multiple tests:

  1. Select the tests you want to delete using SHIFT-click and CTRL-click.

  2. Click Delete. The Delete Tests dialog box is displayed showing the selected tests.

    Selected nodes - lists the nodes that you selected. Uncheck any nodes that you do not want to delete.

    OK - deletes the selected nodes.

    Reset - checks all of the nodes.

  3. Deselect any nodes that you do not want to delete.

  4. Click OK.

6.7 Editing Tests


Note:

The fields and options available to you may be different than those shown in the following examples if your system has been customized by your system administrator.

To edit tests:

  1. Select the test you want to change.

  2. Click Edit.

    This dialog box has the following options:

    Name - displays the test name.

    Type - displays the type of test. The last type selected is displayed first in the last.

    • Manual Test - manual tests are entered, performed, and kept track of manually.

    • Test folder - high level descriptions for grouping tests together.

    • Oracle OpenScript - scripts created using Oracle OpenScript.

    • 3rd Party Test - use this option when you want to run an executable file and capture the results.

    • JUnit Test - use this option when you want to run an Ant file and capture the results.

    Repository - for OpenScript scripts, specifies the repository where the script is located. Click Find to display the Select Script dialog box for selecting the script file.

    Workspace - for OpenScript scripts, specifies the workspace where the script is located. When you select a script using Find, the workspace will be filled in automatically.

    Test File - for 3rd Party tests, displays the script test file name. Click Browse to display the Choose File dialog box for selecting the test file.

    Owner - select the user that owns the test. Only users with read permission for this project are listed.

    Functionality - displays the description of the functionality the test is designed to verify.

    Priority - displays the priority of the test. These options can be changed by your system administrator.

    Description - displays the test description.

  3. Make any changes.

  4. Click Save.

  5. To edit test step page titles or comments, or to add an attachment to a test step click Add/Edit in the Test Steps section of the right-pane.

  6. Make any changes.

  7. Click OK.

6.8 Editing Multiple Tests

You can edit several tests at the same time if you want to make the same change to them all. To edit multiple tests:

  1. Select the tests you want to edit.

  2. Select Edit Test from the right-click menu.

    Selected nodes - lists the selected nodes. Deselect nodes that you do not want to edit.

    Fields - the fields listed are determined by the type of node and whether there are any custom fields.

    Check Box - select the check box to change the field's value. The change will be applied to all of the selected nodes.

  3. Deselect any nodes that you do not want to change.

  4. Select a field that you want to change.

  5. Select or enter the new value. The change will be made to all of the selected nodes.

  6. Repeat for all fields that you want to change.

  7. Click Save.

6.9 Editing Manual Test Steps

To edit test steps for a manual test:

  1. Select the test for which you want to edit test steps.

  2. Select Add/Edit in the Test Steps section of the right-hand pane.

    This dialog box has the following options:

    Add - adds a new row under the selected row. When you click the tab key the test in the Action, Expected Result, and Comment fields is added to the grid. Clicking Add again also populates the grid.

    Delete - deletes the selected step.

    Move Up - moves the selected step up one position in the list.

    Move Down - moves the selected step down one position in the list.

    First - display the first step.

    Previous - displays the previous step.

    Next - displays the next step.

    Last - displays the last step.

    # - displays the step number.

    Action - displays the action to perform.

    Expected Result - displays a description of what is expected to happen as a result of this step.

    Comment - displays additional information about the step.

    Add/Edit Attachments - displays the Add Attachment dialog box for adding an attachment associated with this test step. Attachments are listed in the Test Steps section of the right-hand pane.

  3. Make any changes.

  4. Click OK.

6.10 Converting Tests

You can convert manual test case nodes to Oracle OpenScript test case nodes. Oracle Test Manager maintains the test case definition and results and allows you to replace the manual test steps with Oracle OpenScript scripts. To convert a manual test:

  1. Select the test you want to convert and click Edit. The Edit Test dialog box is displayed.

  2. Select Oracle OpenScript in the Type field.

  3. Select the test file that you want to use.

  4. Click OK when asked if you are sure that you want to convert the test type. The Convert test type dialog box is displayed.

    Save a copy of the selected Manual Test Case - saves both the converted test case and the original test case.

    Save the prior results history with the new Oracle Functional Testing Test Case - saves the prior results history with the new test.

  5. Select the options and click OK.

  6. Click Save.

6.11 Viewing Test Details

You can view the result details for each test run. To view test details:

  1. Click the Tests tab.

  2. Select the test for which you want to view details.

  3. In the Run History section of the right pane, click the date of the test for which you want to view details. The Test Set Run History is only included if the Include Test Set Runs in Tests Tab option is selected in the Right Hand Pane Display section of the user options (select Options from the Tools menu).

    The details of the test run expand and appear under the Run History section.

6.12 Associating Requirements With Tests

There are two ways to associate tests with requirements. You can search for tests that contain designated values in one or more fields or you can select tests from a tree view.

To associate requirements with a test using search:

  1. Select the test with which you want to associate requirements.

  2. Select Add/Edit from the Associated Requirements section of the right pane.

    Saved filters - lists the saved filter configurations. Select a saved filter to edit or delete it.

    Save - displays the Save Criteria dialog box for saving the settings. Filters do not have to be saved.

    Delete - deletes the selected saved filter.

    Search for - displays whether you are searching requirements, tests, or issues.

    that match - select how to apply the filtering criteria.

    • all - match all of the configured criteria. This setting places an AND between the criteria. For example, if you wanted to view all issues with a high-priority that are assigned to you, use this option.

    • any - match any of the configured criteria. This setting places and OR between the criteria. For example, if you wanted to view all issues with either a high priority or a high severity, use this option.

    • a combination - this setting lets you combine AND and OR. For example, if you wanted to view all issues assigned to Mary or Caren with a high priority, use this option. This option lets you select how to group the criteria, using parenthesis as required. For example:

      (((Assigned to = Mary OR Assigned to = Caren) AND Priority = High) OR Severity = High)
      

    <left parenthesis> - select the left parenthesis up to three.

    Field - select the field that you want to use to select the items to display.

    Operator

    • Equals - causes only items that match the value for the selected field to be displayed.

    • Not Equal to - causes only items that do not match the value for the selected field to be displayed.

    Value - enter or select the value of the field that you want to use to select the items to display.

    <right parenthesis> - select the right parenthesis up to three.

    <operator> - select the operator to use, AND or OR.

    <delete> - deletes the corresponding criteria.

    <expression> - shows the filtering expression you are creating as you select criteria.

    Results - displays the nodes that match the search criteria.

    • Select - places the selected nodes in the Associated Nodes field.

    • Select All - places all nodes in the Results field in the Associated Nodes field.

    Associated Nodes - displays the selected nodes.

    • Remove - removes the selected nodes from the Associated Nodes field.

    • Remove All - removes all nodes from the Associated Nodes field.

    OK - closes the dialog box and saves changes.

    Cancel - closes the dialog box without saving changes.

  3. Enter the search criteria or select a saved filter and click Search.

  4. Select the requirements you want associated with this test or click Select All to associate all requirements that matched the search criteria.

  5. Click OK. The requirements will be listed in the right pane under associated requirements.

To associate requirements with a test using the tree view:

  1. Select the test with which you want to associate requirements.

  2. Select Add/Edit from the Associated Requirements section of the right pane.

    <test list> - double click tests to add and delete them from the list of associated tests or select the tests you want to add and click Select.

    • Select - places the selected test in the Associated Nodes field.

    • Select All - places all tests in the Results field in the Associated Nodes field.

    Associated Nodes - displays the selected nodes.

    • Remove - removes the selected nodes from the Associated Nodes field.

    • Remove All - removes all nodes from the Associated Nodes field.

    OK - closes the dialog box and saves changes.

    Cancel - closes the dialog box without saving changes.

  3. Select the requirements you want associated with this test or click Select All to associate all requirements that matched the search criteria.

  4. To remove nodes from the Associated Nodes field, select the nodes and click Remove or click Remove All to remove all nodes.

  5. Click OK. The requirements will be listed in the right pane under associated requirements.

6.13 Associating Issues With Tests

There are two ways to associate issues with tests. You can search for issues that contain designated values in one or more fields or you can select issues from a tree view.

To associate issues with a test using search:

  1. Select the test with which you want to associate issues.

  2. Select Add/Edit from the Associated Issues section of the right pane.

    Saved filters - lists the saved filter configurations. Select a saved filter to edit or delete it.

    Save - displays the Save Criteria dialog box for saving the settings. Filters do not have to be saved.

    Delete - deletes the selected saved filter.

    Search for - displays whether you are searching requirements, tests, or issues.

    that match - select how to apply the filtering criteria.

    • all - match all of the configured criteria. This setting places an AND between the criteria. For example, if you wanted to view all issues with a high-priority that are assigned to you, use this option.

    • any - match any of the configured criteria. This setting places and OR between the criteria. For example, if you wanted to view all issues with either a high priority or a high severity, use this option.

    • a combination - this setting lets you combine AND and OR. For example, if you wanted to view all issues assigned to Mary or Caren with a high priority, use this option. This option lets you select how to group the criteria, using parenthesis as required. For example:

      (((Assigned to = Mary OR Assigned to = Caren) AND Priority = High) OR Severity = High)
      

    <left parenthesis> - select the left parenthesis up to three.

    Field - select the field that you want to use to select the items to display.

    Operator

    • Equals - causes only items that match the value for the selected field to be displayed.

    • Not Equal to - causes only items that do not match the value for the selected field to be displayed.

    Value - enter or select the value of the field that you want to use to select the items to display.

    <right parenthesis> - select the right parenthesis up to three.

    <operator> - select the operator to use, AND or OR.

    <delete> - deletes the corresponding criteria.

    <expression> - shows the filtering expression you are creating as you select criteria.

    Results - displays the nodes that match the search criteria.

    • Select - places the selected nodes in the Associated Nodes field.

    • Select All - places all nodes in the Results field in the Associated Nodes field.

    Associated Nodes - displays the selected nodes.

    • Remove - removes the selected nodes from the Associated Nodes field.

    • Remove All - removes all nodes from the Associated Nodes field.

    OK - closes the dialog box and saves changes.

    Cancel - closes the dialog box without saving changes.

  3. Enter the search criteria or select a saved filter and click Search.

  4. Select the issues you want associated with the test and click Select or click Select All to associate all issues that matched the search criteria.

  5. Click OK. The issues will be listed in the right pane under associated issues.

To associate issues with a test using the tree view:

  1. Select the test with which you want to associate issues.

  2. Select Add/Edit from the Associated Issues section of the right pane.

    <test list> - double click tests to add and delete them from the list of associated tests or select the tests you want to add and click Select.

    • Select - places the selected test in the Associated Nodes field.

    • Select All - places all tests in the Results field in the Associated Nodes field.

    Associated Nodes - displays the selected nodes.

    • Remove - removes the selected nodes from the Associated Nodes field.

    • Remove All - removes all nodes from the Associated Nodes field.

    OK - closes the dialog box and saves changes.

    Cancel - closes the dialog box without saving changes.

  3. Select the issues you want associated with the test and click Select or click Select All to associate all issues that matched the search criteria.

  4. To remove nodes from the Associated Nodes field, select the nodes and click Remove or click Remove All to remove all nodes.

  5. Click OK. The issues will be listed in the right pane under associated issues.

6.14 Emailing Tests

You can email a test to one or more people. For email to work, the SMTP server must be configured using the Oracle Test Manager Administrator. To email a test:

  1. Click the Tests tab.

  2. Select the test that you want to email and click Email.

    Send to - enter the email addresses of the people to whom you want to email this test. Separate email addresses by a comma.

    To - displays the Select Email recipients dialog box for selecting recipients from a list.

    Subject - enter the text that you want to appear in the subject of the email. The default includes the name and id of the test.

    Message - enter the text that you want to appear in the message.

  3. Enter the recipient email addresses separated by a comma or click To to display the Select Email Recipients dialog box.

    <recipient list> - lists users in you database that have email notification enabled.

    Select - adds the selected recipients to the To field.

    To - displays the selected recipients separated by a comma.

  4. Select the recipients that you want to receive the test and click Select. Note that only users in your database that have email notification enabled are listed in the dialog box.

  5. Click Done when you are finished.

  6. Change the subject if necessary.

  7. Enter a message if necessary.

  8. Click OK.

6.15 Scheduling Tests

You can schedule Oracle OpenScript tests to run once on a specified day and time, daily at a specified time, and weekly at a specified day and time.

6.15.1 Adding Tasks to the Schedule

To add a task to the schedule:

  1. Click the Schedule button or right-click the test you want to schedule and select Schedule test. If you used the right-click menu, the New Task dialog box is displayed with the selected test in the Tests field, otherwise, the Schedule dialog box is displayed.

    New Task - displays the New Task dialog box for adding a new task to the schedule.

    System - select the system on which you want to run tasks.

    Schedule Area - lists the tasks that are scheduled for the displayed week. The week is displayed from Sunday to Saturday and defaults to the current week.

    • Prev - displays the previous week.

    • Next - displays the next week.

    • Run Time - displays the time that the task is scheduled to run.

    • Task Name - displays the name of the task.

    • Status - displays the task's status.

    Task Detail - click on a task name to display details about this task.

    • Navigate - displays the test in the right pane of the main window.

    • Preview - displays the test in a separate window.

    • Run Now - this button is available for tests that have not been executed. Runs the test immediately.

    • Edit - displays the Edit Task dialog box for changing the task.

    • Clone - displays the Edit Task dialog box with the same configuration as the selected task.

    • Delete - deletes the task from the schedule.

    Calendars - shows the current and next month with the displayed week highlighted. Click on a day in the calendar to display that week.

    • Left arrow - moves the calendars back one month.

    • Right arrow - moves the calendars forward one month.

  2. Select the day for which you want to schedule a task and click New task in the Day column or click New task in the top left of the screen.

    Name - enter a name for this task.

    System - select the system on which you want to run this task.

    Description - enter a description of this task.

    Start Date - select the date and time at which you want to start this task. Tasks can be scheduled on the hour, quarter past the hour, on the half our, and quarter to the hour.

    Recurrence - lets you specify when and how often to run this task.

    • Run once - runs the task once at the specified date and time.

    • Run daily - runs the task every day at the specified time.

    • Run weekly - runs the task every week on the specified day and time.

    • <days> - these options are only displayed when you select Run weekly. Select the day on which you want to run the task.

    End Date - specify the day on which you want this task to stop running.

    Clear Date - blanks out the End Date field.

    OpenScript tests - specifies how the command line settings are use when running OpenScript tests.

    • Command line run settings - specifies the OpenScript command line options to use.

    • Override - when selected, the specified command line options will override the command line run settings specified in for any particular OpenScript test specified in Oracle Test Manger.

    • [commands] - specifies the command line options. See the Appendix A of the OpenScript User Guide for additional information about command line options.

    Tests - displays the tests that are scheduled.

    • Add - displays the Test dialog box for selected tests.

    • Delete - deletes the selected test.

    • Move Up - moves the selected test up one spot in the list.

    • Move Down - moves the selected test down one spot in the list.

    Run Parameters

    • Run Name - specifies a name to associate with the scheduled test run.

    • Version - select the version of software you are testing.

    • Send report to - enter the email addresses of the people you want to send the report to after the schedule is executed or click the To button to display the Select Email Recipients dialog box for selecting email recipients in your database that have email notification enabled. Separate email address with a comma.

  3. Enter a name for the task.

  4. Select the system on which to run the task.

  5. Enter a description of the task.

  6. Select the start date and time, and how often you want to run the task.

  7. Select what to do when a task is scheduled to run when another task is still running.

  8. Click Add to add tests to the task. The same test can be added multiple times.

    There are two ways to select tests. You can search for tests that contain designated values in one or more fields or you can select tests from a tree view.

    Find Tab Fields

    Saved filters - lists the saved filter configurations. Select a saved filter to edit or delete it.

    Save - displays the Save Criteria dialog box for saving the settings. Filters do not have to be saved.

    Delete - deletes the selected saved filter.

    Search for - displays whether you are searching requirements, tests, or issues.

    that match - select how to apply the filtering criteria.

    • all - match all of the configured criteria. This setting places an AND between the criteria. For example, if you wanted to view all issues with a high-priority that are assigned to you, use this option.

    • any - match any of the configured criteria. This setting places and OR between the criteria. For example, if you wanted to view all issues with either a high priority or a high severity, use this option.

    • a combination - this setting lets you combine AND and OR. For example, if you wanted to view all issues assigned to Mary or Caren with a high priority, use this option. This option lets you select how to group the criteria, using parenthesis as required. For example:

      (((Assigned to = Mary OR Assigned to = Caren) AND Priority = High) OR Severity = High)
      

    <left parenthesis> - select the left parenthesis up to three.

    Field - select the field that you want to use to select the items to display.

    Operator

    • Equals - causes only items that match the value for the selected field to be displayed.

    • Not Equal to - causes only items that do not match the value for the selected field to be displayed.

    Value - enter or select the value of the field that you want to use to select the items to display.

    <right parenthesis> -select the right parenthesis up to three.

    <operator> - select the operator to use, AND or OR.

    <delete> - deletes the corresponding criteria.

    <expression> - shows the filtering expression you are creating as you select criteria.

    Results - displays the tests that match the search criteria.

    • Select - places the selected tests in the Selected Test field.

    • Select All - places all tests in the Results field in the Selected Test field.

    Tree View Fields

    <test list> - double click tests to add and delete them from the list of selected tests or select the tests you want to add and click Select.

    • Select - places the selected test in the Selected Test field.

    • Select All - places all tests in the Results field in the Selected Test field.

    Common Fields

    Selected Tests - displays the selected tests.

    • <up arrow> - moves the selected test up one place.

    • <down arrow> - moves the selected test down one place.

    • Remove - removes the selected tests from the Selected Test field.

    • Remove All - removes all tests from the Selected Test field.

  9. Select the tests that you want to schedule.

  10. Click OK.

  11. Use the Move Up and Move Down buttons to put the tests in the order in which you want them to run.

  12. Click Save.

  13. To test the task, click the task that you want to test, then click Run Now.

  14. Click Close to exit the Schedule dialog box.

6.15.2 Editing Tasks

To edit a task:

  1. Click the Schedule button.

  2. Click the task that you want to edit. Details about the task are displayed.

  3. Click the Edit button.

  4. Make any changes.

  5. Click Save.

  6. To test the task, click the task that you want to test, then click Run Now.

  7. Click Close to exit the Schedule dialog box.

6.15.3 Deleting Tasks

To delete a task:

  1. Click the Schedule button.

  2. Click the task you want to delete.

  3. Click Delete.

  4. Click Yes when asked to confirm the deletion.