The first release of RelevantCodes[1]One is ready, and has been successfully tested on QTP versions 9.2, 9.5 and 10.0. I would like to thank Clive Farrington, Mahesh Upadhyay and Sunitha Reddy for helping me beta-test this framework. I really appreciate your efforts, guys!

Download RelevantCodes[1]One (6171)

Be sure to view the videos at the end of this post, which show RelevantCodes[1]One being initiated through the Excel Table, and full executions on versions 9.2 and 10.0.

January 27, 2010: Added examples. These show how DP statements can be converted to RelevantCodes[1]One keywords.

Features:

• OO Architecture
• Custom DOTNetFactory Form
• Hierarchical Reporting
• Product Version Settings
• Single Block for Loading and Unloading Global Objects
• Advanced Dictionary Object usage
• Generic Structure (Currently supports Web & Standard Windows)
• Simple Validations
• Custom CheckPoints
• Supports execution on multiple windows/browsers (see Test Case 002)
• Simple Reporting
• Data Sheet with Custom Macros (macros will not available for viewing)
• Customized Test Execution
• Supports multiple object descriptions

I have tried to keep everything quite basic in this release, but there will be several enhancements in the next, including a CustomUserActions object which will give ability to create tests from the Table as well as perform custom actions through code simultaneously. Also in the next release will be featured an upgrade to the Implementor Class, that will enable multiple iterations of a group of statements from the Data Table.

Setting Up

1. Download, unzip and copy the RelevantCodes folder to your “C:\”. The folder structure should look exactly like:

C:\RelevantCodes\RelevantCodes[1]One\0.1

2. In the folder C:\RelevantCodes\RelevantCodes[1]One\0.1\Test Resources\Excel Tables: change the name of the relevant table to Data.xls. If you are using QTP 9.2 or below, rename Data92.xls to Data.xls. For versions 9.5 and higher, rename Data95+.xls to Data.xls.

Current Version

0.1 Beta

Found a Bug. What should I do now?

If any issues that you may encounter, please use the comments section to notify me. I will try to have the fix ready, and the fix will be implemented in the next version, giving full credit to you for finding the bug. If the bug requires a small fix, then, the solution will be available for everyone to view/download immediately.

Will it support other technologies other than Web and Standard Windows?

Technically, this design is capable of working with all sorts of technologies, but because I don’t have access to other add-ins, this may not be possible in the near future. However, if someone is willing to utilize their time in this upgrade, you are most welcome to. If you get this framework to work with other technologies successfully, I would be happy to share it with the everyone giving full credit to your extraordinary work.

Does RelevantCodes[1]One come under any warranties?

No, and Relevant Codes, Anshoo Arora or any associated parties cannot be held responsible for any damage caused by the use of RelevantCodes[1]One.

Copyright Notice / License Agreement

RelevantCodes[1]One is being released under Creative Commons 3.0 Attribution License. For more information about this license, please view this topic at Creative Commons website. In other words, you can distribute, remix, tweak, and build upon this framework as long as you give proper credit to the authors, and to RelevantCodes.com. You must also leave the terms in the License Agreement in the source folder unchanged. Click here to view the Creative Commons 3.0 Attribution license legal code.

RelevantCodes[1]One Automation Framework by Anshoo Arora [RelevantCodes.com] is licensed under a Creative Commons Attribution 3.0 United States License.
Based on a work at relevantcodes.com.

Defects

1. Implementor.cls.vbs => Function CheckProperty: The value parsed after using Mid(), the property value stored in sExpected the result is stored in a variable cast as string, however, when using Execute() to set the value of sValue the value is being stored in a variable cast as boolean when performing the compare on these two variable types the checkpoint is failing when it should be passing. [Snapshot] [Credits go to Brock Vietor for reporting this defect; this defect is reported as-is from Brock's e-mail. Brock: Many thanks for your great reporting style and wonderful feedback!]

2. Engine.vbs.cls: Remove/Comment line #15 (Private TestData). Instead, insert Public TestData on line 2. This should fix the bug as reported in this comment. [Credits go to Daim Phillips for finding and reporting this defect. Daim: Thanks for all your time and efforts that went into finding and reporting this defect!]

Converting DP Into RelevantCodes[1]One Keywords

Example 1: Click Image

Browser("title:=Test").Page("title:=Test").Image("name:=ThisImage").Click

Parent       | Child | Description     | Event | Value
--------------------------------------------------------------------------
Browser Page | Image | name:=ThisImage | Click | ""

Example 2: Click Image (Multiple Properties)

Browser("title:=Test").Page("title:=Test").Image("name:=ThisImage", "index:=0").Click

Parent       | Child | Description                 | Event | Value
--------------------------------------------------------------------------
Browser Page | Image | [name:=ThisImage][index:=0] | Click |

Example 3: Enter Value in a Text Box

Browser("title:=Test").Page("title:=Test").WebEdit("name:=ThisText").Set "RelevantCodes[1]One"

Parent       | Child   | Description    | Event | Value
--------------------------------------------------------------------------
Browser Page | WebEdit | name:=ThisText | Set   | RelevantCodes[1]One

Example 4: Launching a Browser and Clicking “Links”

SystemUtil.Run "iexplore.exe", "http://relevantcodes.com"
Browser("title:=.*Relevant Codes.*").Link("innertext:=Links").Click

Parent       | Child | Description      | Event  | Value
--------------------------------------------------------------------------
Browser      |       | Relevant Codes   | Launch | http://relevantcodes.com
Browser      | Link  | innertext:=Links | Click  |

Example 5: Launching a Browser, Clicking “Links” and closing the Browser

SystemUtil.Run "iexplore.exe", "http://relevantcodes.com"
Browser("title:=.*Relevant Codes.*").Link("innertext:=Links").Click
Browser("title:=.*Relevant Codes.*").Close

Parent       | Child | Description      | Event  | Value
--------------------------------------------------------------------------
Browser      |       | Relevant Codes   | Launch | http://relevantcodes.com
Browser      | Link  | innertext:=Links | Click  |
Browser      |       | Relevant Codes   | Close  |

Example 6: Launching a Browser, Clicking “Links”, Synchronizing and closing the Browser

SystemUtil.Run "iexplore.exe", "http://relevantcodes.com"
Browser("title:=.*Relevant Codes.*").Link("innertext:=Links").Click
Browser("title:=.*Relevant Codes.*").Sync
Browser("title:=.*Relevant Codes.*").Close

Parent       | Child | Description      | Event  | Value
--------------------------------------------------------------------------
Browser      |       | Relevant Codes   | Launch | http://relevantcodes.com
Browser      | Link  | innertext:=Links | Click  |
Browser      |       | Relevant Codes   | Sync   |
Browser      |       | Relevant Codes   | Close  |

Example 7: Adding a new Browser to the Object Class

Note: The Activate method can be used to Activate a Browser, as well as add it to the clsImplementor Object Collection. This example shows how a resulting (new) browser TestDomain2 is added to the collection by specifying its properties.

'Open New Browser
SystemUtil.Run "iexplore.exe", "http://Domain.com"
'Clicking the link opens another Browser
Browser("title:=testDomain_1").Link("innertext:=OpenNewBrowser").Click
'Synchronize with new browser
Browser("title:=testDomain_2").Sync
Browser("title:=testDomain_2").Close
Browser("title:=testDomain_1").Close

Parent       | Child | Description      | Event  | Value
--------------------------------------------------------------------------
Browser      |       | TestDomain1               | Launch   | http://Domain.com
Browser      | Link  | innertext:=OpenNewBrowser | Click    |
Browser      |       | TestDomain2               | Activate | title:=testDomain_2
Browser      |       | TestDomain2               | Sync     |
Browser      |       | TestDomain2               | Close    |
Browser      |       | TestDomain1               | Activate |
Browser      |       | TestDomain1               | Close    |

Demos

I have created 3 simple runs. The first demonstrates RelevantCodes[1]One usage with a single browser, the second run demonstrates its usage with multiple browsers simultaneously and the last one demonstrates a simple execution with a standard windows application. The 4th test case is blank, and you can create more such blank test cases to experiment with this framework. The “Execute Y” determines which test case in the Excel Spreadsheet are going to be executed. Any test case with “Execute N” flag will not execute.

Executing Selected Tests through Excel Spreadsheet

Version 9.2

Version 10.0

Download RelevantCodes[1]One (6171)

Update: RelevantCodes[1]One is now available for download.

As some of you may be aware that a few ideas regarding an Automation Framework were shared in this post. Even though I was expecting feedback from more people, I think what we have is a great starting point. Below are a few suggestions that I have think will be excellent to include in the first version:

• 1 Excel Master Spreadsheet
• Use of XML Files (may be available in the subsequent release)
• Recovery Scenario (may be available in the subsequent release)
• HTML Reporting
• Generic structure
• First release will run solely on a Web platform. Subsequent release will include a Windows application as well to be run simultaneously.

A few of my ideas that I wanted to share as well:

• It may be a pure OO-structure.
• VBA (Macros) in the Master Spreadsheet
• Custom User Form
• A simple test driver engine
• Hierarchical Reporting
• Check(s) for Product Versions
• Simple structure for Loading and Unloading Global objects
• Provision to capture screenshots (may be available in the next release)

Of course, what you see above is me thinking out loud, and some new ideas may be included while the ones above may be dropped for the first release. If you have any suggestions that you would like to share, please use the comments section to do so (you’ll really help me out a lot by doing so). Please remember, this is going to be for purely conceptual purposes and I will try to introduce as many of your ideas as possible. If I am not able to include them in the first release, I’m sure we will find room for them in the second (or the third if there is enough support).

The first release will be available sometime in January, and the framework will be code-named RelevantCodes[1]One. I will try to expedite it, but holidays are coming up which make thinking about work quite tough. :)

This post will be frequently updated as the framework creation starts and as I continue to receive your valuable feedback.

RelevantCodes[1]One is now available for download.

I have been planning for a while now to release a framework for our community. I even started on a few ideas, but I felt it would be best if I received some feedback from you guys. Please use the comment section of this post to share your ideas of what you would like to see included in the framework. Also, it will also help me if you could suggest an application that you would like to be automated, because in the end, without your help and your great ideas, this won’t be possible.

PS. You can post as anonymous if you like, but, I would really like to know who suggested what so I can pay credit where its deserved.