Skip Headers
Oracle® Application Testing Suite Getting Started Guide
Version 9.01 for Microsoft Windows (32-Bit)

Part Number E15487-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

7 Oracle Test Manager for Web Applications Tutorial

This tutorial walks you through the main features of Oracle Test Manager for Web Applications. It consists of the following examples.

The tutorial is designed to be followed sequentially from beginning to end. Many of the examples are interrelated and build upon the steps in previous examples.

Starting Oracle Test Manager for Web Applications

Note:

This section uses the default login credentials from the Oracle Application Testing Suite installation.

To start Oracle Test Manager for Web Applications:

  1. Select Programs from the Start menu and then select Oracle Test Manager for Web Applications - Web from the Oracle Application Testing Suite menu.

  2. Enter Administrator as the user name.

  3. Enter the password specified during the Oracle Application Testing Suite installation process.

  4. Make sure the Database is set to Default OTM.

  5. Make sure the View Type is set to All modules.

  6. Click Login.

Opening the Sample Project

A demonstration project is installed with Oracle Test Manager for Web Applications for testing the sample stock brokerage application Fitch & Mather. This application can be viewed at http://demo.fmstocks.com. To open the sample project:

  1. Start Oracle Test Manager for Web Applications and log in.

    The default installation user names are Administrator and Default unless changed by an administrator. The password is the password specified during the installation procedure unless changed by an administrator.

  2. Click Open from the Project menu to display the Open Project dialog box.

    Figure 7-1 Open Project Dialog Box

    Description of Figure 7-1 follows
    Description of "Figure 7-1 Open Project Dialog Box"

  3. Make sure the otm-install database is selected. This is the database that was created when you installed Oracle Test Manager for Web Applications.

  4. Select the sample database.

  5. Click OK. The main window appears as follows:.

    Figure 7-2 Oracle Test Manager for Web Applications Main Window

    Description of Figure 7-2 follows
    Description of "Figure 7-2 Oracle Test Manager for Web Applications Main Window"

The left pane contains tabs for the three modules that comprise the application. They are requirements, tests, and issues. The detailed information for the selected item is displayed in the right pane. The information displayed may be different from the examples shown in this tutorial if your system administrator has customized the database to add new fields or disable default fields.

Example 1: Adding a Requirement

This example explains how to add a requirement.

  1. Click the Requirements tab.

  2. Expand item 1 and click item 1.4. The new requirement will be added as item 1.5.

    Figure 7-3 Requirements Tab

    Description of Figure 7-3 follows
    Description of "Figure 7-3 Requirements Tab"

  3. Click Add to display the Add Requirement dialog box.

    Figure 7-4 Add Requirement Window

    Description of Figure 7-4 follows
    Description of "Figure 7-4 Add Requirement Window"

  4. Enter "Users should have access to the chart view of their portfolio" in the Name field.

  5. Select a type, owner, and status.

  6. Select Medium from the Priority list.

  7. Enter "All customers should be able to view their portfolio in the chart view" in the Description field.

    Figure 7-5 Add Requirement Window with Sample Data

    Description of Figure 7-5 follows
    Description of "Figure 7-5 Add Requirement Window with Sample Data"

  8. Click Save. The new requirement appears in the tree.

    Figure 7-6 Requirements Tab with New Requirement Added

    Description of Figure 7-6 follows
    Description of "Figure 7-6 Requirements Tab with New Requirement Added"

Example 2: Adding a Test

You can add two types of test cases to Oracle Test Manager for Web Applications:

Manual tests - these are tests that allow you to organize your test cases. For each step in the test, you enter the action, expected result, and pertinent comments. When you run the test, the Oracle Test Manager for Web Applications Manual Test Wizard takes you step by step through the test, allowing you to manually execute each test and enter the result.

Automated tests - these are Oracle OpenScript or Oracle Functional Testing for Web Applications tests that can be run automatically without manual intervention. You can run one test, an entire branch of tests, or all automatic tests in the project.

This example has two parts. The first part explains how to add a manual test. The second part explains how to create the same test using Oracle Functional Testing for Web Applications and add it as an automated test.

Adding a Manual Test

This example explains how to add a manual test.

  1. Click the Tests tab.

  2. Click item 1, Login Tests.

  3. Click Add to display the Add Test dialog box.

    Figure 7-7 Add Test Window

    Description of Figure 7-7 follows
    Description of "Figure 7-7 Add Test Window"

  4. Enter "Verify customer chart view of portfolio" in the Name field.

  5. Select Manual Test in the Type field.

  6. Enter "This test verifies that the chart view of the portfolio is accessible" in the Description field.

  7. Select an owner and priority.

    Figure 7-8 Add Test Window with Sample Data

    Description of Figure 7-8 follows
    Description of "Figure 7-8 Add Test Window with Sample Data"

  8. Click Save. The test is added as item number 2. You are now ready to add test steps.

  9. Click Add/Edit in the Test Steps section of the right-hand pane to display the Test Steps dialog box.

    Figure 7-9 Manual Test Steps Window

    Description of Figure 7-9 follows
    Description of "Figure 7-9 Manual Test Steps Window"

  10. Click Add.

  11. Enter, "Go to http://www.fmstocks.com/fmstocks" in the Action field.

  12. Enter, "The FMStocks Customer Login page should be displayed" in the Expected Results field.

  13. Click Add to update the top of the dialog box and to go to the next step.

    Figure 7-10 Manual Test Steps Window with Sample Data

    Description of Figure 7-10 follows
    Description of "Figure 7-10 Manual Test Steps Window with Sample Data"

  14. Enter the following steps, clicking Add to start each step:

    Step Action Expected Result
    2 Click Login. The Welcome to FMStocks page should be displayed.
    3 Click the Chart Your Portfolio link The Your Portfolio page should be displayed with a spreadsheet and graphs.

    The Manual Test Steps dialog box shows the entries as entered.

  15. Click OK.

Adding an Automated Test

Oracle Test Manager for Web Applications can run Oracle OpenScript scripts or Oracle Functional Testing for Web Applications tests that have been saved in the Oracle Test Manager for Web Applications Package format. Package format files have a .otmPKG extension. This example explains how to create a test in Oracle Functional Testing for Web Applications, add it to the Tests in Oracle Test Manager for Web Applications, and associate it with the requirement just added.

  1. Select Programs from the Start menu and then select Oracle Functional Testing for Web Applications from the Oracle Application Testing Suite menu.

  2. Go to http://www.fmstocks.com/fmstocks.

  3. Select New Script from the File menu.

  4. Select Record from the Run menu and then select Start to begin recording the script.

  5. Click Login.

  6. Click the Chart Your Portfolio link.

  7. Select Record from the Run menu and then select Stop to stop recording the script.

  8. Select Save Script from the File menu.

  9. Navigate to the OracleATS/OFT/Default! workspace.

  10. Select Oracle Test Manager for Web Applications Package (*.otmPKG) as the format to save the file.

  11. Enter ChartPortfolio as the name of the script.

  12. Click Save.

  13. Select Exit from the File menu to exit Oracle Functional Testing for Web Applications and return to Oracle Test Manager for Web Applications.

  14. Click the Tests tab.

  15. Expand Customer Account Tests and click item 3.3.

  16. Click Add to display the Add Test dialog box.

  17. Enter "Verify customer chart view of portfolio" in the Name field.

  18. Select Oracle Functional Testing Script in the Type field.

  19. Click Browse in the Test File field.

  20. Select ChartPortfolio.otmPKG.

  21. Select an owner and priority.

  22. Enter "This test verifies that the chart view of the portfolio is accessible" in the Description field.

    Figure 7-11 Add Test Window with Sample Automated Test

    Description of Figure 7-11 follows
    Description of "Figure 7-11 Add Test Window with Sample Automated Test"

  23. Click Save.

  24. The test is added as item 3.4.

    Figure 7-12 Tests Tab with New Test Added

    Description of Figure 7-12 follows
    Description of "Figure 7-12 Tests Tab with New Test Added"

  25. Click Add/Edit next to Associated Requirements in the right pane, to display the Associate Requirement dialog box.

  26. Click the Tree View tab.

    Figure 7-13 Associate Requirements Window

    Description of Figure 7-13 follows
    Description of "Figure 7-13 Associate Requirements Window"

  27. Expand item 1 and click item 1.5.

  28. Click Select.

  29. Click OK. The test is now linked to the requirement and is listed on the right-hand side of the screen. The test is also listed in the Associated Tests section of the requirement.

    Figure 7-14 Test Associated with Requirement

    Description of Figure 7-14 follows
    Description of "Figure 7-14 Test Associated with Requirement"

Example 3: Running a Test

This example has two parts. The first part explains how to run the manual test created in the previous example. The second part explains how to run the automated test created in the previous example, then how to view the detailed Results Report.

Running a Manual Test

This example explains how to run the manual test entered in the previous example.

  1. Click the Tests tab and select number 2, Verify customer chart view of portfolio.

  2. Click Run this test in the Run History section of the right-hand pane.

    Figure 7-15 Run Test Info Window

    Description of Figure 7-15 follows
    Description of "Figure 7-15 Run Test Info Window"

  3. Select 1.0 in the Build field. This is the version number of the application you are testing.

  4. Click Save.

    Figure 7-16 Run Manual Test Window

    Description of Figure 7-16 follows
    Description of "Figure 7-16 Run Manual Test Window"

  5. This dialog box tells you the action to take and the expected result. Open your browser and perform the first action. Select the result Passed. Enter comments, when needed, in the Summary field.

  6. Repeat for steps 2 and 3.

  7. Click OK to display the Run Manual Test - Summary window.

    Figure 7-17 Run Manual Test Summary Window

    Description of Figure 7-17 follows
    Description of "Figure 7-17 Run Manual Test Summary Window"

  8. Select Passed.

  9. Enter, "No problems encountered with this test." in the Summary field.

  10. Click OK.

The Run History and Result Detail are displayed.

Running an Automated Test

This example explains how to run an the automated test created in the previous example and how to view the results detail and the detailed Oracle Functional Testing for Web Applications Results Report.

  1. Click the Tests tab.

  2. Expand item number 3 and click item 3.4.

  3. Click Run this Test in the Run History section of the right-hand pane to display the Test run Info dialog box.

  4. Select OTM Server in the System field. This is the machine on which the test will be run.

  5. Select 1.0 in the Version field. This is the version number of the application you are testing.

  6. Click Save. Oracle Functional Testing for Web Applications executes the script. Oracle Test Manager for Web Applications displays the Result Detail Summary when the test is finished.

  7. Click the date of the test in the Run History section of the right pane.

  8. Click View Report in the Result Summary to display the detailed Oracle Functional Testing for Web Applications Results Report in a separate browser window.

    Figure 7-18 Results Report Window

    Description of Figure 7-18 follows
    Description of "Figure 7-18 Results Report Window"

Example 4: Adding an Issue

This example explains how to search through issues, add an issue, associate it with a test, and add an attachment with additional information. For the purposes of this example, we will assume that the script run in example 4 failed.

To search through issues to see if an issue already exists for this topic, or to find related issues:

  1. Click the Issues tab.

  2. Click Find to display the Find dialog box.

  3. Select Description for the field to search.

  4. Enter the value, "chart."

  5. Make sure that Issues is selected in the Search for field and that all is selected in the match field. This will search all of the issue descriptions for the word, "chart."

  6. Click Search. If there are any matches they are displayed in the Results portion of the window.

    Figure 7-20 Find Window with Search Results

    Description of Figure 7-20 follows
    Description of "Figure 7-20 Find Window with Search Results"

    One match was found. You can click Navigate the Results list to display it in Oracle Test Manager for Web Applications or click Preview to view the issue in a separate preview window. We will assume that our failure is different enough to warrant creating a new issue.

To create an issue.

  1. Click the Issues tab.

  2. Click Add to display the Add Issue dialog box.

    Figure 7-21 Add Issue Window

    Description of Figure 7-21 follows
    Description of "Figure 7-21 Add Issue Window"

  3. Enter "Chart portfolio failed" in the Summary field.

  4. Select the default component.

  5. Select 1.0 for the version.

  6. Assign the issue to Default User.

  7. Set the status to Created.

  8. Change the Priority to High.

  9. Change the Severity to Medium.

  10. Select the Windows platform.

    Figure 7-22 Add Issue Window with Sample Data

    Description of Figure 7-22 follows
    Description of "Figure 7-22 Add Issue Window with Sample Data"

  11. Click Save. The issue is assigned the next available number and added to the bottom of the list.

    Figure 7-23 Issues Tab with New Issue Added

    Description of Figure 7-23 follows
    Description of "Figure 7-23 Issues Tab with New Issue Added"

  12. Click Add/Edit next to Associated Tests in the right pane to display the Associate Test dialog box.

  13. Click the Tree View tab.

  14. Expand item 3 and select item 3.4.

    Figure 7-24 Associate Test Window with Issue Selected

    Description of Figure 7-24 follows
    Description of "Figure 7-24 Associate Test Window with Issue Selected"

  15. Click Select.

  16. Click OK. The test is listed in the Associated Tests list.

  17. Select Add/Edit in the Attachments section to display the Attach Files dialog box.

  18. Click Add.

  19. Click Browse.

  20. Select a file to attach and click Open.

  21. Click Upload.

    Figure 7-25 Attach Files Window with File Selected

    Description of Figure 7-25 follows
    Description of "Figure 7-25 Attach Files Window with File Selected"

  22. Click Close. The attachment is listed in the Attachments list in the right pane. Click on the attachment to open it in the appropriate application.

    Figure 7-26 Issue with File Attachments

    Description of Figure 7-26 follows
    Description of "Figure 7-26 Issue with File Attachments"

Example 5: Creating Reports

Oracle Test Manager for Web Applications comes with a standard set of reports. In addition, you can create and optionally save custom reports. Reports can be either public, that is, available to all users, or private, available only to you. This example explains how to view standard reports and how to create a custom report and save it.

  1. Click the Reports tab.

  2. Expand the Public Reports node, then the Issues node.

  3. Select Issues by Assigned to Bar Graph to display the graph in the right pane.

    Figure 7-27 Reports Tab with Bar Graph Report

    Description of Figure 7-27 follows
    Description of "Figure 7-27 Reports Tab with Bar Graph Report"

  4. Click once on the graph area then mouse over the bars to view the actual values. Click Data View to view just the data.

  5. To create a custom report click Add.

    Figure 7-28 Add Report Window

    Description of Figure 7-28 follows
    Description of "Figure 7-28 Add Report Window"

  6. Enter a name for the report.

  7. Select Vertical bar chart for the report type and 3D for the report template.

  8. Select Priority from the Available fields and click the right arrow to add it to the Selected fields list.

    Figure 7-29 Add Report Window with Selected Fields

    Description of Figure 7-29 follows
    Description of "Figure 7-29 Add Report Window with Selected Fields"

  9. Click Define filters.

    Figure 7-30 Add Report Filters Window

    Description of Figure 7-30 follows
    Description of "Figure 7-30 Add Report Filters Window"

  10. Select Priority as the field, not equal to in the Operator field, and Low for the Value. This means that the report will only display information for Medium and High priority requirements.

  11. Click OK to display the report.

  12. Click Save to save this report.

  13. Enter Requirements Medium and High for the report name. The name will be displayed in the report tree.

  14. Select My Reports as the Report Category.

  15. Click OK. The new report is added under the My Reports folder.

    Figure 7-31 Reports Tab with Custom Reports

    Description of Figure 7-31 follows
    Description of "Figure 7-31 Reports Tab with Custom Reports"

This completes the Oracle Test Manager for Web Applications tutorial. Click Logout to exit the application.