APEX Test Automation

Introduction

This tutorial is designed to introduce you to the basic concept and operation of ATAF.  You will require a basic understanding of the anatomy of an Oracle APEX application and the principles of software testing.  This environment is for demonstration purposes only and not for use with production environments.  If you would like to take it further and use the system on one of your own applications, then download and install the source code from Github, or talk to us about our cloud hosting options.

1. Sign up for a free ATAF demo account

• • Click on the Log In link in the navigation bar above
• • Click Register for Account
• • You will receive an email once the account is approved

5. Create Specification

• • From the ATAF Home page, select the project you created in step 3
• • Click Create Specification
• • In the Name field type Smoke Test
• • In the Module Select list choose — Add New Module —
• • In the New Module field type General
• • Click Create

6. Create Test Cases

• • Select the Smoke Test Specification
• • Click Add Case
• • In the Test Case field type Log In
• • In the Data Set Select List choose Test Users
• • Click Create
• • Repeat for Log Out (no Data Row is required)

7. Create Log In Test Conditions

• • Select the Log In Test Case
• • Click Add Condition
• • In the Page From field type 0
• • In the Action Select List choose Open Page (click Notes for more info)
• • In the Outcome Select List choose Branch to Page Without Page Check
• • In the Page To field type 101
• • Click Create & Create Another

• • In the Page From field type 101
• • In the Action Select List choose Type into Text Field (or click Text in the hotlinks)
• • In the APEX Item Select List choose Username
• • In the Data Options Radio list choose Use an Attribute from the current test case data-set
• • In the Data Attributes Select List choose User Name
• • Click Create & Create Another

• • Repeat the process for Password (hint: use Type into Password Field)

• • In the Page From field type 101
• • In the Action Select List choose Click Button (or click Button in the hotlinks)
• • In the APEX Item select Sign In
• • In the Outcome Select List choose Branch to Page Without Page Check
• • In the Page To field type 1
• • Click Create

8. Create Log Out Test Conditions

• • Click Test Cases in the Sidebar Menu
• • Select the Log Out Test Case
• • Click Add Condition
• • In the Page From field type 1
• • In the Action Select List choose Click Nav Bar Parent Item
• • In the APEX Item Select List choose (Nav Bar)  &NICE_USERNAME.
• • In the Outcome Select List choose Child Menu Opens
• • Click Create & Create Another

• • In the Page From field type 1
• • In the Action Select List choose Click Nav Bar Child Item
• • In the APEX Item Select List choose (Nav Bar) Sign Out
• • In the Outcome Select List choose Branch to Page Without Page Check
• • In the Page To field type 101
• • Click Create

9. Run the Test Specification

• • Click Test Specifications in the Side Bar menu
• • In the Interactive Report Click Selenium in the Download column
• • In the FireFox File Menu select Save Page As
• • In the Format field, select Web Page, HTML Only
• • In the FireFox Tools Menu select Selenium IDE
• • In the FireFox File Menu select Open and choose the file you just saved
• • Click Run

Notes

• ⁃ Ideally we’d use Branch to Page, however this action includes a page check to ensure the branch is to the correct page.  Unfortunately, P-Track uses the &ITEM. notation to add the project name to the page title, which ATAF is currently unable to resolve.  To overcome this, I created a copy of the Branch to Page action called Branch to Page Without Page Check, which doesn’t include the page check. 
• ⁃ The Log In and Log Out Test Cases will be used with every Test Specification, so these are the best ones to start with.
• ⁃ The first time you use an action, it may need a little adjustment to get it to work with your application.  This is normal, but once you have your own custom library of Actions, you’ll become very productive.