| Oracle® Test Manager Test Manager User's Guide Version 9.10 for Microsoft Windows (32-Bit) Part Number E15486-03 |
|
|
View PDF |
| Oracle® Test Manager Test Manager User's Guide Version 9.10 for Microsoft Windows (32-Bit) Part Number E15486-03 |
|
|
View PDF |
This chapter explains how to use the Windows interface version of Oracle Test Manager. The Windows interface version includes many of the same features as the Web interface version.
You can add an existing database to Oracle Test Manager or you can create a new one. In addition, you can create tables in an empty SQL database. When you add a database, Oracle Test Manager creates a user account for the default user and the administrator. Use Oracle Application Testing Suite Administrator to add more users and to customize projects.
Select Oracle Application Testing Suite Database Configuration from the Oracle Application Testing Suite - Tools menu to open the Configure Databases dialog box.
Refer to Chapter 9, "Configuring Databases" for instructions on adding, deleting, and updating databases.
To start the Windows version of Oracle Test Manager:
Select Oracle Test Manager - Windows from the Oracle Application Testing Suite start menu to start Oracle Test Manager.
Enter your username.
Enter your password.
Select the database to which you want to log in.
Select the license type.
Click OK.
The Oracle Test Manager Main window is where you perform Oracle Test Manager activities. The main window consists of the menu options, toolbar, and once a project is opened, the left pane and right pane. The left pane is a tree view that lists scripts, requirements, or issues, depending on the tab that is selected. The right pane displays the detailed information related to the item selected in the left pane.
The left pane has the following tabs:
Requirements - lists the requirements that must be tested for this project. From here, you can add, edit, or delete requirements. Once added, you can associate tests with them so you know which tests address the requirement.
Tests - lists the test cases that pertain to this project. From here you can insert, edit, and delete test cases. Once added, you can associate requirements and issues with them so you know which requirements the test addresses and whether there are any issues pertaining to the test. You can run individual tests, an entire branch, or all tests in the project.
Issues - lists the issues created as a result of running the tests in the project. From here you can insert, edit, and delete issues. Once added, you can associate tests and other issues with them so you to know which test the issue effects and any related issues. You can group issues in several ways using the right-click menu.
In addition to the default information displayed in the right pane, there may be optional custom fields. These fields are created by your system administrator.
The Requirements tab lets you work with requirements.
You can:
Expand and collapse the tree view by clicking on the plus and minus signs.
Move requirements by dragging and dropping them into their new locations.
Search requirements by selecting Find from the Edit menu.
Group requirements using the View menu or right-click menu.
Filter the requirement list using the View menu or right-click menu.
The color of the icon in front of the requirement indicates its priority. The color is determined by the display order of the priority field as set up in Oracle Application Testing Suite Administrator. The default colors are as follows:
Red, high priority
Yellow, medium priority
Green, low priority
If you add additional priorities in Oracle Application Testing Suite Administrator, the colors will be blue, silver, purple, dark orange, light blue, and gray.
The right pane lists the selected requirement's details. In the upper right corner, associated tests and issues are listed as well as attachments. You can:
Click Edit this requirement to open the Edit Requirement dialog box.
Click on an associated test or issue to view its details.
Click on an attachment to open it in the appropriate application.
Select Add/Edit to add or edit attachments or associated items.
The Tests tab lets you work with tests.
You can:
Expand and collapse the tree view using the plus and minus signs.
Move tests by dragging and dropping them into their new locations.
Search tests by selecting Find from the Edit menu.
Group tests using the View menu or right-click menu.
Filter the test list using the View menu or right-click menu.
The icon in front of the test indicates the type of test as follows:
Functional test script - green with a scroll.
Manual test - blue with a pencil.
Test folder - blue with a spiral.
Functional Test group - blue with a plus sign.
3rd Party test - blue with two stars
The color of the icon in front of the test indicates the last result from running the test, as follows:
Green, passed
Red, failed
Yellow, warning
Blue, not run
Silver, currently running
The right pane lists the selected test's details. Test steps and run history are displayed. You can:
Click Edit this test to open the Edit Test dialog box.
Click Run this test to execute the test.
Click Delete Results to display the Delete Results dialog box for deleting results from particular test runs.
Click Download Test Script to save Visual Scripts that have been saved in the database to your hard drive.
Click the date in the Run History section to display result details for a particular run.
In the upper right corner or the right pane, associated requirements and issues are listed as well as attachments. You can:
Click on an associated requirement or issue to view its details.
Click on an attachment to open it in the appropriate application.
Select Add/Edit to add or edit attachments or associated items.
The Issues tab lets you work with issues.
You can:
Group issues using the View menu or right-click menu.
Filter the issue list using the View menu or right-click menu.
Search issues by selecting Find from the Edit men u.
The color of the icon in front of the issue indicates its priority. The default colors are as follows and can be changed by changing the order of the Issue Priorities in Oracle Application Testing Suite Administrator:
Red, high priority
Yellow, medium priority
Green, low priority
The number inside the icon corresponds to the status number.
The right pane lists information about the selected issue including the issue's details, solution, priority, and status. You can:
Click Edit this issue to open the Edit Issue dialog box.
In the upper right corner of the right pane, associated requirements, tests, and issues are listed as well as attachments. You can:
Click on an associated test, requirement, or issue to view its details.
Click on an attachment to open it in the appropriate application.
Select Add/Edit to add or edit attachments or associated items.
The Toolbar has the following buttons:
Open- displays the Select Project dialog box.
Cut - copies the selected component to the clipboard and deletes it when it is pasted.
Copy - copies the selected component to the clipboard.
Paste - pastes the contents of the clipboard into the left pane at the current location.
Find - displays the Find dialog box for searching requirements, tests, and issues.
History - displays the History dialog box for viewing the selected item's history.
Add Requirement - displays the Add Requirement dialog box.
Add Test - displays the Add New Test dialog box.
Add Issue - displays the Add Issue dialog box.
Delete - deletes the selected item.
Edit - displays the Edit Requirement, Edit Test, or Edit Issue dialog box, based on the selected item.
Move Up - moves the selected item up one spot at its current level.
Move Down - moves the selected item down one spot at its current level.
Outdent - moves the selected item to the same level as its parent.
Indent - moves the selected item to a sub menu of the previous item.
Run - runs the selected test.
Abort Test - stops the running test.
View Schedule - displays the Schedule dialog box.
Activate Schedule - starts the schedule.
Deactivate Schedule - stops the schedule.
Help - displays the help system contents.
Select Toolbar from the View menu to show or hide the toolbar.
The menus provide options for accessing the various Oracle Test Manager features. Many of these menu options have corresponding links in the right detail pane.
The Project menu options let you work with Oracle Test Manager projects.
Open - displays the Select Project dialog box for opening an existing project. More than one project can be open at one time.
Close - closes the project.
Properties - displays the name of the project and the database in which it is located.
Exit- closes Oracle Test Manager.
The Edit menu options let you add, edit, and delete components as well as and associate them with one another. The options on this menu vary depending on which tab is selected in the left pane.
Cut - deletes the selected component and places it on the clipboard.
Copy - copies the selected component to the clipboard.
Paste - pastes the contents of the clipboard into the left pane.
Find - displays the Find dialog box for searching requirements, tests, and issues.
The View menu lets you show or hide the toolbar and status bar, refresh the display, group issues, and view test history and reports.
Toolbar - when checked, the toolbar is displayed.
Status Bar - when checked, the status bar is displayed.
Refresh - refreshes the display and reloads the tree from the database.
Filter - lets you select which items to display in the left pane based on field values.
No filter - shows all items.
Customize Filters - shows only the requested items.
Group by - lets you select how to sort items in the left pane. It has the following options.
No Grouping - lists items sequentially.
Group by <field> -sorts items into folders by the indicated field. The options available differ for requirements, tests, and issues.
Customize Groupings - displays the Customize Groupings dialog box for multi-level sorting. For example, you could sort by assigned to and then priority within assigned to.
Requirement/Test/Issue History - displays the History dialog box for viewing changes, by date, that have been made to the selected item.
Schedule - displays the Schedule dialog box for creating or editing the schedule.
Activate Schedule - starts the schedule.
Deactivate Schedule - stops the schedule.
Display Unique IDs - displays unique IDs for requirements and tests.
The Actions menu lets you add, edit, and move requirements, tests, and issues. It also lets you attach files, associate items, and run tests.
Add - displays the options for adding requirements, tests, or issues based on the selected tab.
Add Requirement/Test/Issue - displays the Add Requirement, Add Test, or Add Issue dialog box for adding a new component. The component is added after the selected component at the same level.
Insert Requirement/Test- displays the Insert Requirement or Insert Test dialog box for inserting a component directly above the selected component. This option is not available for issues.
Add Sub Requirement/Sub Test - displays the Add Child Requirement or Add Child Test dialog box for adding a component at the level below the selected component. This option is not available for issues.
Edit Requirement/Test/Issue - displays the Edit Requirement, Edit Test, or Edit Issue dialog box for editing the selected component.
Delete Requirement/Test/Issue - deletes the selected component and its sub components.
Move - displays the following options for moving the selected item in the tree view.
Move Up - moves the selected item up one spot at its current level.
Move Down - moves the selected item down one spot at its current level.
Outdent - moves the selected item to the same level as its parent.
Indent - moves the selected item to a submenu of the previous item.
Associate - displays the options for associating requirements, tests, and issues based on the selected tab.
Attach File - displays the Attach File dialog box.
Run Test - displays the following options for running tests. These options are only available when the Test tab is selected.
Run Test - executes the selected test.
Run Test Branch - executes all tests in the selected branch.
Run All Tests - executes all tests in the project.
Abort Test - stops the running test.
Edit Test Steps - displays the Test Steps dialog box for editing test steps. This option is only available when the Test tab is selected.
Delete Test Results - displays the Delete Results dialog box for selecting the results to delete. This option is only available when the Test tab is selected.
Schedule Test- displays the Schedule Test dialog box for adding the selected test to the schedule.
The Tools menu lets you start Oracle Functional Testing or Oracle Load Testing.
Oracle Functional Testing - starts Oracle Functional Testing.
Options - displays the Options dialog box for setting Oracle Test Manager options.
User Properties - displays the User Properties dialog box for changing your password, name, or email address.
Configure Databases - displays the Configure Databases dialog box for adding, removing, and updating databases.
Import - lets you import data from an external XML or CSV file.
Export - lets you export data to an XML file. It has the following options.
Export Requirement/Test/Issue - exports the selected item.
Export Requirement/Test/Issue Branch - exports the selected branch.
Export All Requirements/Tests/Issues - exports all items.
Export Project - exports the project to an XML file.
You can set options that determine:
how Oracle Test Manager runs Oracle Functional Testing when running tests,
whether Oracle Test Manager automatically creates issues for failed tests,
the number of test results to display.
To set options:
Select Options from the Tools menu.
This dialog box has the following options:
Run Oracle Functional Testing hidden - runs Oracle Functional Testing in hidden mode when running tests.
Close Oracle Functional Testing between test runs - closes Oracle Functional Testing after each test run, then reopens it to run the next test.
Automatically create issues for failed tests - Oracle Test Manager automatically creates issues for tests that fail.
Copy results with tests - copies both the test and its results.
Limit number of displayed test results - when selected, you can enter the maximum number of test results you want to show, otherwise all test results are shown.
Select the options you want to enable.
Click OK.
You can change your user name, email address, password, and enable or disable email notification for each database to which you have access. To change your user information:
Select User Properties from the Tools menu.
This dialog box has the following options:
Database - select the database for which you want to change your user information.
First Name - displays your first name.
Last Name - displays your last name.
E-mail - displays the e-mail address to which e-mail notification will be sent if the Enable E-mail notification option is selected.
Enable E-mail notification - enables and disables e-mail notification. Notification is sent when a new requirement, test, or issue is created and when an issue's owner or assigned to field is changed.
Password - lets you change your password.
Old - enter the current password.
New - enter the new password.
Confirm - enter the new password again.
Select the database for which you want to change your information.
Make any changes.
Click OK.
You can change the order in which requirements, tests, and issues are displayed by changing the way they are grouped. The default view is not grouped. Items are listed in order. Oracle Test Manager provides some standard grouping selections or you can customize the grouping according to the information that is most important to you.
To group items:
Select the tab corresponding to the category you want to group, requirements, tests, or issues.
Select Group by from the View menu.
Select the way you want to sort the items. Items are redisplayed grouped into folders and subfolders.
Click the folder level to display a list of items in the folder. Click the item for which you want to view details.
To customize groups:
Select the tab corresponding to the category you want to group, requirements, tests, or issues.
Select Group by from the View menu then select Customize Groupings. You can group items up to four levels.
Select how you want to group issues. You can group by both default and custom fields.
Click OK. Items are redisplayed grouped into folders and subfolders.
Click the folder level to display a list of items in the folder. Click the item for which you want to view details.
You can filter requirements, tests, and issues to display only those items in which you are interested. You can filter by both default and custom fields. Requirements and tests must be grouped before they can be filtered. Issues can be filtered whether or not they are grouped.
To filter items:
Select the tab corresponding to the items you want to filter, Requirements, Tests, or Issues.
If you are filtering requirements or tests, group them first as described above.
Select Filter from the View menu then select Customize Filters to display the Filter dialog box.
This dialog box has the following options:
Field - select the field that you want to use to select the items to display.
Value - enter or select the value of the field that you want to use to select the items to display.
Equals - causes only items that match the value for the selected field to be displayed.
Not Equal - causes only items that do not match the value for the selected field to be displayed.
Select the field by which you want to filter.
Select or enter the value by which you want to filter.
Select Equals if you want to display items that match the value. Select Not Equal if you want to display items that do not match the value.
Repeat these steps to filter to three levels, if required.
Click OK. The left pane is redisplayed according to your selections.
Note:
Items that are not displayed are still in the database. To display the default view select Filter from the View menu then select No Filters.The following sections explain the project options.
To open a project:
Select Open from the Project menu.
Select the database that contains the project you want to open. The projects displayed are only those in the selected database.
Select the project you want to open.
Click OK.
You can copy requirements and tests from one project to another.
Open both projects by selecting Open from the Project menu.
Select Tile from the Window menu so that both projects can be viewed.
Make sure the same tab is selected in both projects. For example, if you are copying requirements, select the Requirements tab in both windows. If you do not do this, nothing will be copied.
Select the item you want to copy and select Copy from the Edit menu.
Select the destination project and select Paste from the Edit menu. Note that associations are not copied.
You can view the project name and its location. To view project properties, select Properties from the Project menu.
This dialog box has the following options:
Name - displays the project name.
Database - displays the name of the database in which the project is located.
Version - displays the database version.
You can attach files containing additional or related information to requirements, tests, or issues. The attachment will open in a separate window in the appropriate program.
To attach a file:
Select the Requirement, Test, or Issue to which you want to add an attachment.
Select Attach File from the Actions menu.
This dialog box has the following options:
File - displays the full path and name of the attachment.
Location - displays Database if the attachment was stored in the database; otherwise displays the path.
Close - closes the dialog box.
Add - displays the Open dialog box.
Remove - either removes the reference to the attachment or deletes the attachment from the database. Attachments are not deleted from the local machine.
Copy to DB/Update DB - for attachments stored in the database, updates the selected attachment, otherwise stores the attachment in the database.
Save Local - for attachments stored in the database, displays the Save As dialog box for saving the attachment to the local machine.
Click Add to display the Open dialog box.
Navigate to the file you want to attach and select it.
Select Store in Database to save the attachment in the database. This allows the attachment to be opened on other machines.
Click Open.
Click Close.
Attachments are opened in a separate window in their associated application. You can open attachments that are stored in the database or located on the machine you are using. You can also edit attachments stored in the database. If you do, Oracle Test Manager asks you if you want to save the changes to the database when you close the window.
To open an attachment:
Select the Requirement, Test, or Issue containing the attachment.
Click the attachment that you want to open in the Attachment section of the right pane.
You can view, by date, the history of changes for an individual requirement, test, or issue.
To view history:
Select the requirement, test, or issue that you want to view.
Select Requirement, Test, or Issue History from the View menu.
This dialog box has the following options:
Date - lists the dates on which changes were made to the selected item.
<Detail> - displays the details of the selected item as of the selected date.
Select the date you want to view.
Click OK when you are done.
You can search requirements, tests, and issues based on the value of individual fields. To search:
Select Find from the Edit menu.
This dialog box has the following options:
Project - lets you select whether to search the current project only or all projects in the current database.
Current Project - searches only the current project.
Current Database - searches all projects in the current database.
Component - specifies the component to search:
Requirements - searches through requirements.
Tests - searches through tests.
Issues - searches through issues.
Criteria - specifies the search criteria:
Field - select the field to search through. The fields listed are determined by the selected component.
Value - select or enter the value to search for. The values listed are determined by the selected field. Not all fields let you enter a value.
Equals - returns only exact matches.
Contains - returns matches if the field contains the value.
Results - lists the matches. Double-click on an item to display it in Oracle Test Manager.
Select whether to search only the current project or all projects in the database.
Select the component through which you want to search.
Select the search criteria.
Note:
You can use SQL characters for searching. For example, if you wanted to find all issues that contained Joe Smith and Mary Jones in the description field, you could enter %Joe Smith%Mary Jones% in the value field.Click Search. Double-click on an item in the Results list to display it in Oracle Test Manager.
You can import and export data to and from Oracle Test Manager. Data is exported as an .XML file. Data can be imported from either an .XML file or a Comma Separated Value (.CSV) file. This is useful for example, if you have created your test cases using a third party tool.
If you are importing an .xml file that was previously exported from Oracle Test Manager, you will need any .bin files that were also created during the export. Data being imported is put in the current project. Only one project can be imported from any one .xml file. If an .xml file has more than one project, import it using Oracle Application Testing Suite Administrator.
To import an .xml file:
Select Import from the Tools menu to display the Open dialog box.
Select the file type .xml.
Select the file you want to import.
Click Open to display the Import dialog box.
This dialog box lists the requirements, tests, and issues that will be imported. It lets you review the data before importing it.
Click OK to import the data.
To import data from a .csv file, Oracle Test Manager must match the columns in the .csv file with the fields in the database. It assumes that the first row in the .csv file contains labels indicating the type of data in the columns. Oracle Test Manager lets you either manually map the columns to the database fields or lets you choose to let Oracle Test Manager automatically map the columns to the database fields.
To import a .csv file:
Select Import from the Tools menu to display the Open dialog box.
Select the file type .csv.
Select the file you want to import.
Click Open to display the Import CSV File dialog box.
This dialog box has the following options:
Type - indicates the type of data you are importing. Select Issues, Requirements, or Tests. The list of fields changes based on your selection.
# - lists the column number in the .csv file.
CSV Column - displays the column label in the .csv file found in the header row.
Field - lists the Oracle Test Manager database fields for the type of data you are importing, Requirements, Tests, or Issues.
CSV Column - displays the column label in the .csv file that matches the Oracle Test Manager database field. This column is blank until you either click Auto Match or manually associate the labels.
Row - when a column is selected, displays the data in the column. This is useful when you want to verify the data in the .csv file.
<Up arrow> - scrolls up the rows in the .csv file displaying the data for the selected column.
<Down arrow> - scrolls down the rows in the .csv file displaying the data for the selected column.
<Left arrow> - when a field is selected, removes the association between the .csv file label and the Oracle Test Manager database field.
<Right arrow> - when both a field and a column label are selected, moves the selected column label into the column field on the left, indicating that the data in this column corresponds to the expected data for the database field.
Auto Match - Oracle Test Manager tries to match the .csv file column labels with the database fields. If it finds matches, they are listed to the right of the Field column.
Select the type of data you are importing. Only one type of data can be imported from any one .csv file because the column labels and data are different for requirements, tests, and issues.
Match the column labels with the database field names. You can do this in two ways:
automatically by clicking Auto Match.
manually by selecting a field and a column label and clicking the left arrow. To view the data in the .csv file, select the column label and use the up and down arrow keys.
Click OK when you are finished matching columns.
This dialog box lists the requirements, tests, and issues that will be imported. It lets you review the data before importing it.
Click OK.
You can export an entire project, an individual requirement, test, or issue, a branch of requirements, tests, or issues, or all requirements, tests, or issues to an .xml file. In addition to the .xml file, several .bin files are created that contain associated data such as attachment files. If you are copying or emailing the exported data to another location for later import, you will need the .xml file and all of the associated .bin files. To export data:
Select the data you want to export:
Select Export Project from the Tools menu to export the entire project.
Select the tab of the type of data you want to export, select an individual item or branch if you are exporting a subset of an item, then select Export from the Tools menu and whether you want to export the selected item, the selected branch, or all items in this category.
If you are exporting the entire project, you will be asked if you want to export attachments.
If you have selected an item that has associated items, you are asked if you want to export them as well. Click Yes to export associated items.
The Save As dialog box is displayed. Enter a file name and select a location to save the file.
Click Save.
Requirements reflect the test plan for the project. Similar requirements can be grouped together into branches for easy management. Once entered, they can be associated with the tests that address them. Requirements are automatically numbered when you add them. You can reorder them using the move buttons.
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.Requirements are automatically numbered when you add them. You can reorder them by dragging them to the new location. To add a requirement:
Select the Requirements tab.
Select Add from the Actions menu then select one of the following options:
Add Requirement - to add a requirement after the selected requirement at the same level.
Insert Requirement - to add the requirement above the selected requirement at the same level.
Add Sub Requirement - to add a requirement one level below the selected requirement.
The Add Requirement dialog box is displayed. This dialog box has the following options:
Name - enter the name of the requirement.
Type - enter the type of requirement. These options can be changed by your system administrator.
Owner - select the user that owns the requirement. These options can be changed by your system administrator.
Status - select the status of the requirement. These options can be changed by your system administrator.
Priority - select the priority of the requirement. These options can be changed by your system administrator.
Description - enter additional details about the requirement.
Attachment - lets you add an attachment to this requirement. Click Browse to display the Open dialog box for selecting the file to attach.
Enter the requirement details.
Click OK.
To associate tests with a requirement:
Select the requirement with which you want to associate a test.
Select Associate from the Actions menu then select Associate Test.
This dialog box lists all of the tests in the project in an expanded tree view. Associated tests have an "x" in the checkbox in front of them. It has the following options:
<test list> - click tests to add and delete them from the list of associated tests.
OK - closes the dialog box and saves changes.
Cancel - closes the dialog box without saving changes.
Select All - selects all tests.
Clear All - deselects all tests.
Next - moves to the next associated test.
Previous - moves to the previous associated test.
Select the tests you want associated with this requirement. The number of selected items is displayed at the bottom of the window.
Click OK. The tests will be listed in the right pane under associated tests.
Tests can be manual or automatic. Automatic Oracle Functional Testing 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.
Scripts are saved in the database so that the tests can be run from other machines.
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 by dragging them to the new location. To add a test:
Select the Tests tab.
Select Add from the Actions menu, then select one of the following options:
Add Test - to add a test after the selected test at the same level.
Insert Test - to add the test above the selected test at the same level.
Add Sub Test - to add a test one level below the selected test.
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.
Oracle Functional Test Script - Visual Scripts created using Oracle Functional Testing.
Manual Test - manual tests are entered, performed, and kept track of manually.
Test folder - high level descriptions for grouping tests together.
Test Group - a list of Oracle Functional Testing tests that are sequentially run together that can also be scheduled. In addition, the overall results are tracked and displayed.
Owner - displays the user that owns the test.
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.
Attachment - lets you add an attachment to this test. Click Browse to display the Open dialog box for selecting the file to attach.
Workspace - for Oracle Functional Testing tests, displays the Workspace where the test is located.
Test File - for Oracle Functional Testing tests, displays the Visual Script test file name.
Store in Database - when selected, the test is stored in the database which allows it to be run from another machine.
Use All Rows of Databank - when selected, the test will use all values in the databank. When not selected, the test runs once using the first row if there is a databank.
Enter the name of the test. If you are adding more than one test script at the same time, you do not need to enter a name.
Select the type of test. To create a top level header that does not have a script associated with it, use the Description type.
Select the owner of the test.
Select the test priority.
Select the workspace in which the script is located.
Enter the file name or click Browse to locate the file or files.
Select the files you want to add and click Open.
Select Store in Database if you want to run the test from a machine other than the machine where the test resides.
Select Use All Rows of Databank if you want to iterate through the databank. Otherwise, the test runs once using the first row of the databank, if there is one.
Click Ok.
Note:
If you are adding a manual test, select Edit Test Steps from the Actions menu to add details about the test. If you are adding an Oracle Functional Testing Group, click Add/Edit in the right pane in the Test List area to add Oracle Functional Testing tests to the group.To add multiple tests:
Click the Tests tab.
Select Add from the Actions menu then select Add Test.
Click Browse.
Select the tests you want to add.
Click Open. The tests are displayed in the Test File field.
Click OK. Each script is added as a separate test using the file name as its label in the tree.
Use the arrow keys to move the tests to their desired locations.
To change test names, select the test, then select Edit Test from the Actions menu.
Click OK.
Once you have created a Test Group, you can add tests to it. The tests in the group are run sequentially, and the group can also be scheduled. To add tests:
Click the Tests tab.
Select the Oracle Functional Testing Group to which you want to add tests.
In the right pane, click Add/Edit in the Test List area to display the Tests dialog box.
This dialog box has the following options:
All Tests - displays the project's tree view for selecting the tests that you want to add to the group.
<right and left arrows> - let you add and remove tests from the group.
Tests in Group - displays the tests that are in the group. To remove a test, select it and click the left arrow.
Select the Oracle Functional Testing tests that you want to add.
Click the right arrow to move them into the group.
Click OK.
For manual tests, you can add, delete, or edit the test steps.
For Oracle Functional Testing tests, you can edit test steps for the purposes of describing the test in Oracle Test Manager. Changing these steps has no effect on how the script is executed.
To edit test steps:
Select the manual test you want to edit.
Select Edit Test Steps from the Actions menu.
This dialog box lets you edit and keep track of test steps for manual tests. It also lets you add comments to Oracle Functional Testing scripts for the purpose of documentation in Oracle Test Manager only.
This dialog box has the following options for Oracle Functional Testing scripts:
Step - displays the step number.
Page - displays the page being tested by the step.
Comment - displays additional information about the step.
This dialog box has the following options for manual tests:
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.
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.
This dialog box has the following options for all tests:
OK - exits the dialog box and accepts changes.
Cancel - exits the dialog box without accepting changes.
Select the step you want to edit or click New to add a step.
Repeat for all steps you want to edit or add.
Click OK.
When looping scripts or running a series of scripts in succession over an extended time period, Oracle Functional Testing and it's embedded IE browser may consume increasing amounts of memory. To manage memory, you can create a blank script that will stop and then start Oracle Functional Testing. This script can be used as many times as necessary, allowing you to define where the restart occurs. This lets you maintain the session state between consecutive scripts where you may not want to restart to occur.
To use the restart feature:
Select Options from the Tools menu.
Make sure that Close Oracle Functional Testing between test runs is deselected.
In Oracle Functional Testing, create a blank Oracle Functional Testing script with the following name: RESTART_ETESTER.mom. Case is important.
In Oracle Test Manager, insert this script as a node anywhere in your Tests tree where you want an Oracle Functional Testing restart to occur.
To delete a test from the project:
Select the test you want to delete. If the test has sub tests these are also deleted.
Select Delete Test from the Actions menu.
Click Yes when asked to confirm the deletion.
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:
Select the test you want to change.
Select Edit Test from the Actions menu.
This dialog box has the following options:
Name - displays the test name.
Type - displays the type of test. This field cannot be changed.
Owner - displays the owner of the test.
Functionality - displays the description of the functionality the test is designed to verify.
Priority - displays the test's priority. These options can be changed by your system administrator.
Description - displays the test description.
Attachment - lets you add an attachment to this test. Click Browse to display the Open dialog box for selecting the file to attach.
Workspace - for Oracle Functional Testing tests, displays the Workspace where the test is located.
Test File - for Oracle Functional Testing tests, displays the Visual Script test file name.
Store in Database/Update Database - the test is either stored in the database or if it is already in the database, updated in the database, allowing it to be run from another machine.
Use All Rows of Databank - when selected, the test will use all values in the databank. When not selected, the test runs once using the first row if there is a databank.
Replace Test Steps - the test steps are deleted and reset to what is in the Oracle Functional Testing script.
Make any necessary changes.
Click OK.
You can run all of the tests in the project, all tests in a branch of the project, or individual tests. Manual tests are not run when you run all tests or a test branch. They can only be run individually or as part of en Oracle Functional Testing Group. When you run a manual test, the Manual Test wizard runs to guide you through the steps and to allow you enter results.
You can set up Oracle Test Manager to automatically create an issue and associates it with the test if the test fails. Refer to Setting Oracle Test Manager Options in Chapter 2.
Note:
You cannot run tests that are not stored in the database and are located on a different machine.To run automated tests:
Select one of the following:
To run an individual test, select the test and select Run Test from the Actions menu then select Run Test.
To run all tests in a branch, select the top level of the branch, and select Run Test from the Actions menu then select Run Test Branch.
To run all tests in the project, select Run Test from the Actions menu then select Run All Tests.
The Run All Tests dialog box has the following default options. It may have additional fields if your administrator has added custom fields.
Version - enter the version of the software you are testing. This lets you to match test results with the version of the software that was tested.
Enter the version number of the software you are testing.
Enter custom field information, if any.
Click OK.
To run a manual test:
Select the test you want to run.
Select Run Test from the Actions menu then select Run Test to start the manual test wizard.
The Run Test dialog box has the following options. It may have additional fields if your administrator has added custom fields.
Build Version - enter the version of the software you are testing.
Enter the version number of the software you are testing and custom fields, if any, and click Next.
The step dialog box appears for each step in the test. It has the following options:
Action - displays the action to perform.
Expected Result - displays the expected result.
Comment - displays additional information about the step.
Result - select the outcome of the step after performing it.
Summary - enter additional information about the step.
Create an issue - automatically adds an issue stating that the test had a status of failed or warning. This option is only available when Failed or Warning is selected.
The Run Manual Test - Step dialog box is displayed for each step in the test. When you have completed the step, select the result and enter a comment.
Click Next to go to the next step.
The summary dialog box appears after all of the steps in the test have been completed. It has the following options:
Result - enter the overall outcome of the test.
Summary - enter additional information about the test.
After the last step, the Run Manual Test - Summary dialog box is displayed. Enter the overall test result and any summary comments and click Finish.
When you run a Test Group, Oracle Test Manager runs the tests in the group in sequence. If there are any manual tests in the group you will be informed that human intervention may be required and asked if you want to continue. If you choose to continue, the Run Manual Test wizard prompts you through any manual tests in the group.
To run a test group:
Select the test group and select Run Test from the Actions menu then select Run Test.
Enter the version number of the software you are testing and any custom field information, if any, and click OK.
If there are manual tests in the group, you will be asked if you want to continue. Click Yes.
Oracle Test Manager runs the tests in sequence. The Run Manual Test wizard prompts you through any manual tests. The results are displayed when all tests have been run.
You can delete test results based on the date and time the test was run.
To delete test results:
Select Delete Test Results from the Actions menu.
Select the results that you want to delete. You can select more than one test result by clicking on each test result that you want to delete.
Click OK.
To associate requirements with a test:
Select the test with which you want to associate a requirement.
Select Associate from the Actions menu then select Associate Requirement.
The Associate Requirements dialog box lists all of the requirements in the project in an expanded tree view. Associated requirements have an "x" in the checkbox in front of them. It has the following options:
<requirements list> - click requirements to add and delete them from the list of associated requirements.
OK - closes the dialog box and saves changes.
Cancel - closes the dialog box without saving changes.
Select All - selects all requirements.
Clear All - deselects all requirements.
Next - moves to the next associated requirement.
Previous - moves to the previous associated requirement.
Select the requirements you want associated with this test. The number of selected requirements is displayed at the bottom of the window.
Click OK. The requirements will be listed in the right pane under associated requirements.
To associate issues with a test:
Select the test with which you want to associate an issue.
Select Associate from the Actions menu then select Associate Issues.
The Associate Issues dialog box lists all of the issues in the project in an expanded tree view using the same grouping as the Issues tab. Associated issues have an "x" in the checkbox in front of them. It has the following options:
<issues list> - click issues to add and delete them from the list of associated issues.
OK - closes the dialog box and saves changes.
Cancel - closes the dialog box without saving changes.
Select All - selects all issues.
Clear All - deselects all issues.
Next - moves to the next associated issue.
Previous - moves to the previous associated issue.
Select the issues you want associated with this test. The number of selected issues is displayed at the bottom of the window.
Click OK. The issues will be listed in the right pane under associated issues.
You can view the result details for each test run. To view test details:
Select the test for which you want to view details.
In the Run History section of the right pane, click the date of the test for which you want to view details.
The Results report is displayed in a browser window and gives detailed information about the test run. To view the Results report:
Select the test for which you want to view the report.
In the Run History section of the right pane, click the date of the test for which you want to view the report.
Click View Report in the Result Detail Summary section of the right pane.
You can download Visual Script files that have been saved in the Oracle Test Manager database to your local hard drive. They are saved either in the OTM! workspace of your Oracle Functional Testing installation directory or a shared directory if one is set up. To save a script:
Select the test whose script you want to save.
Click Download Test Script in the Run History section of the right pane.
Click OK to close the message box.
Shared directories provide the capability to place workspaces and other components of the repository on a network location that lets multiple installs of Oracle Functional Testing access Visual Scripts and other common files.
Required files - the following files must be installed in the shared directory:
Authman.dat
Dialogs.dat
Favorites.dat
Required Sub Directories - the following subdirectories and associated files of the Repository must be below the shared directory:
\Databank
\Spider
\Monitor
\Reporter
Other Sub Directories - the following other subdirectories must be below the shared directory:
UserWorkspace(s)!
Locking - Oracle Functional Testing has locking in use for Visual Scripts and .dat files. If an instance-B of Oracle Functional Testing tries to open a Visual Script that is use by instance-A of Oracle Functional Testing, instance-B receives a message that the Visual Script is in use. Authentication, Dialog Manager, and preferences also are locked.
The user cannot Save As the same name as a Visual Script that is in use.
Once the shared directory is set up, use the SharedDir setting in the rsw.ini file to indicate the directory's location. This setting is located in the [Install] section of the rsw.ini file. The syntax is:
[Install]
...
SharedDir=networkdrive:sharedDir
You can create a schedule to automatically run Oracle Functional Testing tests at a specified time. Once you have created a schedule, you can enable it. Oracle Test Manager must be running to enable a schedule, although you do not have to be logged in to a database. The schedule is automatically disabled when you exit Oracle Test Manager.
To schedule a test:
Select the test that you want to schedule.
Select Schedule Test from the Actions menu to display the Schedule Test dialog box.
The Schedule Tests dialog box has the following options:
Database - indicates the database in which the test is located.
Project - indicates the project to which this test belongs.
Test - indicates the name of the test.
Type - select the frequency with which you want to run the test. The options are:
Once - runs the test one time.
Daily - runs the test daily at the selected time.
Weekly - runs the test weekly at the selected date and time.
Monthly - runs the test once a month on the selected date and time.
Date - click on the day, month, or year to edit the date or click the down arrow to display a calendar to select the date.
Time - enter the time at which you want to run the test or click the arrows to change the time.
Version - enter or select the version.
Enable - enables the test so that it executes when the schedule is enabled. Disabled tests will not execute.
Select the frequency with which you want to run the test.
Select the date and time at which you want to run the test.
Click OK.
To edit the schedule:
Select Schedule from the View menu to display the Schedule dialog box.
The Schedule dialog box has the following options:
Test List - lists the tests in the schedule. You can sort the schedule by any of the following columns by clicking the column title:
Test - displays the name of the test.
Type - displays the type of test.
Date - displays the date that the test is scheduled to run.
Time - displays the time that the test is scheduled to run.
Enabled - indicates whether the test is enabled or disabled.
Close - exits the dialog box.
Edit - displays the Edit Schedule dialog box for the selected test.
Delete - deletes the selected test from the schedule.
Select the test that you want to edit.
Click Edit to display the Edit Schedule dialog box.
Make any changes and click OK.
Click Enable All to enable all tests or click Disable All to disable all tests.
Click Close.
Oracle Test Manager must be running for the schedule to execute. You do not have to be logged in to a database to enable or disable the schedule.
To enable the schedule, select Activate Schedule from the View menu. A check in front of this option indicates that the schedule is enabled.
To disable the schedule, select Deactivate Schedule from the View menu. A blank in front of this option indicates that the schedule is disabled.
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.When you add an issue, it is automatically assigned the next available number in the database and is added at the bottom of the list. This number cannot be changed. You can group issues using the right-click menu or by selecting Group by from the View menu. To add an issue:
Select Add from the Actions menu then select Add Issue.
The Add Issue dialog box has the following options:
Summary - enter the title of the issue.
Component - select the component associated with the issue. Components are entered by your system administrator using the Oracle Application Testing Suite Administrator.
Assigned To - select the person responsible for the issue. These options can be changed by your system administrator.
Status - select the issue's status. These options can be changed by your system administrator.
Priority - select the issue's priority. These options can be changed by your system administrator.
Severity - select the severity of the issue. These options can be changed by your system administrator.
Version - select or enter the version of the software that was being tested.
Platform - select or enter the platform on which the issue occurred. These options can be changed by your system administrator.
Description - enter details about the issue.
Solution - enter details about the issue's resolution.
Attachment - lets you add an attachment to this issue. Click Browse to display the Open dialog box for selecting the file to attach.
Enter the issue details.
Click OK.
To delete issues:
Select the issue you want to delete.
Select Delete Issue from the Actions menu.
Click Yes when asked to confirm the deletion.
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 an issue:
Select the issue you want to edit.
Select Edit Issue from the Actions menu.
The Edit Issue dialog box has the following options:
Summary - enter the title of the issue.
Component - select the component associated with the issue. Components are entered by your system administrator using the Oracle Application Testing Suite Administrator.
Assigned To - select the person responsible for the issue. These options can be changed by your system administrator.
Status - select the issue's status. These options can be changed by your system administrator.
Priority - select the issue's priority. These options can be changed by your system administrator.
Severity - select the severity of the issue. These options can be changed by your system administrator.
Version - select or enter the version of the software that was being tested.
Platform - select or enter the platform on which the issue occurred.
Add Description - enter a new description. This text is appended to previous description text.
Edit Text - Select this option to display and edit previously entered description text. The text is displayed when the box is checked.
Add Solution - enter a new resolution. The text is appended to previous solution text.
Edit Text - Select this option to display and edit previously entered solution text. The text is displayed when the box is checked.
Attachment - lets you add an attachment to this issue. Click Browse to display the Open dialog box for selecting the file to attach.
Make any changes.
Click OK.
To associate issues with an issue:
Select the issue with which you want to associate another issue.
Select Associate from the Actions menu then select Associate Issues.
This dialog box lists all of the issues in the project in an expanded tree view in the same grouping as the Issues tab. Associated issues have an "x" in the checkbox in front of them. It has the following options:
<issues list> - click issues to add and delete them from the list of associated issues.
OK - closes the dialog box and saves changes.
Cancel - closes the dialog box without saving changes.
Select All - selects all issues.
Clear All - deselects all issues.
Next - moves to the next associated issue.
Previous - moves to the previous associated issue.
Select the issues you want associated with this issue. The number of issues selected is displayed at the bottom of the window.
Click OK. The issues will be listed in the right pane under associated issues.
To associate tests with an issue:
Select the issue with which you want to associate a test.
Select Associate from the Actions menu then select Associate Test.
This dialog box lists all of the tests in the project in an expanded tree view. Associated tests have an "x" in the checkbox in front of them. It has the following options:
<test list> - click tests to add and delete them from the list of associated tests.
OK - closes the dialog box and saves changes.
Cancel - closes the dialog box without saving changes.
Select All - selects all tests.
Clear All - deselects all tests.
Next- moves to the next associated test.
Previous - moves to the previous associated test.
Select the tests you want associated with this issue. The number of tests selected is displayed at the bottom of the window.
Click OK. The tests will be listed in the right pane under associated tests.
|
 Copyright © 1997, 2010, Oracle and/or its affiliates. All rights reserved. Legal Notices |
|
