HP Unified Functional Testing

Transcription

1 HP Unified Functionl Testing Softwre Version: Enter the operting system(s), e.g. Windows Tutoril for GUI Testing Document Relese Dte: Decemer 2012 Softwre Relese Dte: Decemer 2012

2 Legl Notices Wrrnty The only wrrnties for HP products nd services re set forth in the express wrrnty sttements ccompnying such products nd services. Nothing herein should e construed s constituting n dditionl wrrnty. HP shll not e lile for technicl or editoril errors or omissions contined herein. The informtion contined herein is suject to chnge without notice. Restricted Rights Legend Confidentil computer softwre. Vlid license from HP required for possession, use or copying. Consistent with FAR nd , Commercil Computer Softwre, Computer Softwre Documenttion, nd Technicl Dt for Commercil Items re licensed to the U.S. Government under vendor's stndrd commercil license. Copyright Notices Hewlett-Pckrd Development Compny, L.P. Trdemrk Notices Adoe nd Acrot re trdemrks of Adoe Systems Incorported. Intel, Pentium, nd Intel Xeon re trdemrks of Intel Corportion in the U.S. nd other countries. Jv is registered trdemrk of Orcle nd/or its ffilites. Microsoft, Windows, Windows NT, nd Windows XP re U.S registered trdemrks of Microsoft Corportion. Orcle is registered US trdemrk of Orcle Corportion, Redwood City, Cliforni. Unix is registered trdemrk of The Open Group. SlickEdit is registered trdemrk of SlickEdit Inc. 2

3 Documenttion Updtes The title pge of this document contins the following identifying informtion: Softwre Version numer, which indictes the softwre version. Document Relese Dte, which chnges ech time the document is updted. Softwre Relese Dte, which indictes the relese dte of this version of the softwre. To check for recent updtes, or to verify tht you re using the most recent edition of document, go to: This site requires tht you register for n HP Pssport nd sign-in. To register for n HP Pssport ID, go to: Or click the New users - plese register link on the HP Pssport login pge. You will lso receive updted or new editions if you suscrie to the pproprite product support service. Contct your HP sles representtive for detils. 3

4 Support Visit the HP Softwre Support we site t: This we site provides contct informtion nd detils out the products, services, nd support tht HP Softwre offers. HP Softwre online support provides customer self-solve cpilities. It provides fst nd efficient wy to ccess interctive technicl support tools needed to mnge your usiness. As vlued support customer, you cn enefit y using the support we site to: Serch for knowledge documents of interest Sumit nd trck support cses nd enhncement requests Downlod softwre ptches Mnge support contrcts Look up HP support contcts Review informtion out ville services Enter into discussions with other softwre customers Reserch nd register for softwre trining Most of the support res require tht you register s n HP Pssport user nd sign in. Mny lso require support contrct. To register for n HP Pssport ID, go to: To find more informtion out ccess levels, go to: 4

5 Tle of Contents Welcome to the Unified Functionl Testing Tutoril for GUI Testing.7 Unified Functionl Testing Tutoril for GUI Testing Overview...7 Help Contents...9 Additionl Online Resources...13 Lesson 1: Introducing Unified Functionl Testing...15 Benefits of Automted GUI Testing...16 Testing Process...17 UFT Window...19 Lesson 2: Anlyzing Your Appliction nd Creting Actions...25 Getting to Know Your Appliction...26 Explore the Mercury Tours We Site...27 Creting Tests...30 Crete New Solution, Test, nd Actions...32 Lesson 3: Creting Oject Repositories...39 Introducing Test Ojects nd Oject Repositories...39 Lern Ojects in Your Appliction...41 Use Multiple Oject Repositories...50 Lesson 4: Creting Functions nd Function Lirries...55 Introducing Functions...55 Crete Function...56 Associte the Function Lirry with Your Test...59 Lesson 5: Adding Steps...61 Prepring to Add Steps to Test...61 Add Steps to the Login Action...62 Anlyzing the Login Action in the Keyword View...68 Add the Remining Steps to Your Test

6 Tle of Contents Lesson 6: Running nd Anlyzing Tests...87 Run Test...87 Nvigting the Run Results Viewer...91 Anlyze the Run Results...93 Lesson 7: Creting Checkpoints nd Using Functions...95 Understnding Checkpoint Types...96 Crete Checkpoint Test...98 Check Oject Vlues Check Pges Check Tle Vlues Check Text Vlues Mnge Checkpoints in the Oject Repository Run nd Anlyze Test with Checkpoints Perform Check Using Function Lesson 8: Prmeterizing Steps nd Ojects Prmeterizing n Action Crete Test for Prmeteriztion Define Dt Tle Prmeter Add Prmeter Vlues to Dt Tle Modify Steps Affected y Prmeteriztion Running nd Anlyzing Prmeterized Test Lesson 9: Where Do You Go From Here? Modifying UFT Settings to Sve Disk Spce Testing Your Own Appliction Getting Strted

7 Welcome to the Unified Functionl Testing Tutoril for GUI Testing This chpter includes: "Unified Functionl Testing Tutoril for GUI Testing Overview" on pge 7 "Help Contents" on pge 9 "Additionl Online Resources" on pge 13 Unified Functionl Testing Tutoril for GUI Testing Overview The HP Unified Functionl Testing Tutoril for GUI Testing is self-pced guide tht teches you the sics of testing your GUI ppliction with Unified Functionl Testing (UFT). It will fmilirize you with the process of creting nd running utomted GUI tests nd nlyzing the run results. After completing the tutoril, you cn pply the skills you hve lerned to testing your own ppliction or We site. Note: To lern more out creting nd running API tests, see the HP Unified Functionl Testing API Testing Tutoril, ville from the <UFT instlltion folder>\help directory. 7

8 Welcome to the Unified Functionl Testing Tutoril for GUI Testing Using UFT with Business Process Testing In ddition to tests, UFT enles you to crete service nd keyword-driven usiness components for use in usiness process tests, if you re connected to n ALM server tht supports Business Process Testing. The procedures descried in this tutoril re designed for creting GUI tests, ut you cn lso pply the mjority of these procedures to creting keyword-driven components. For more detils on usiness components nd Business Process Testing, see the HP Unified Functionl Testing User Guide nd the HP Business Process Testing User Guide. Note: Unless otherwise specified, references to Appliction Lifecycle Mngement or ALM in this guide pply to ll currently supported versions of ALM nd Qulity Center. Note tht some fetures nd options my not e supported in the specific edition of ALM or Qulity Center tht you re using. For list of the supported versions of ALM or Qulity Center, see the HP Unified Functionl Testing Product Avilility Mtrix, ville from the UFT Help or the root folder of the Unified Functionl Testing DVD. The most up-to-dte product vilility mtrix is ville from the HP Softwre Product Mnuls site, t mnuls (requires n HP Pssport). For detils on ALM or Qulity Center editions, see the HP Appliction Lifecycle Mngement User Guide or the HP Qulity Center User Guide. 8

9 Welcome to the Unified Functionl Testing Tutoril for GUI Testing Tutoril Audience nd Scope This tutoril is intended for users who re new to UFT. No prior knowledge of UFT or QuickTest is required. A generl understnding of testing concepts nd functionl testing processes my e helpful, ut is not mndtory. UFT enles you to crete GUI tests, usiness process tests, nd API tests. This tutoril reviews topics relted to GUI testing only. While performing the lessons in this tutoril, you my notice unfmilir menu items or other UFT GUI elements tht re not descried in the tutoril. These my e relevnt for Business Process Testing or API testing only, nd re not relevnt for GUI testing t ll. For detils out these elements, see the HP Unified Functionl Testing User Guide. Note: This tutoril refers to file system pths tht re relevnt for Windows 7 operting systems. The pths in other operting systems my e slightly different. Help Contents This tutoril is prt of the Unified Functionl Testing Help. The Help provides single-point of ccess for ll Unified Functionl Testing documenttion. You cn ccess the Help y using the following: Select Help > HP Unified Functionl Testing Help. In the Strt menu, select Progrm Files > HP Softwre > HP Unified Functionl Testing > Documenttion > HP Unified Functionl Testing Help. In selected UFT windows nd dilog oxes, click the help utton or press F1. View description, syntx, nd exmples for UFT test oject, method, or property y plcing the cursor on it nd pressing F1. 9

10 Welcome to the Unified Functionl Testing Tutoril for GUI Testing The Help includes the following: Type Getting Strted Documenttion Included Documenttion Redme provides the ltest news nd informtion out UFT. Select Strt > Progrms > HP Softwre > HP Unified Functionl Testing > Redme. HP Unified Functionl Testing Instlltion Guide explins how to instll nd set up UFT. Select Help > HP Unified Functionl Testing Help nd click the link to the Instlltion Guide from the UFT Help tle of contents. HP Unified Functionl Testing Tutoril teches you sic UFT skills nd shows you how to design tests for your pplictions. Select Help > Unified Functionl Testing Tutoril. Product Feture Movies provide n overview nd step-y-step instructions descriing how to use selected UFT fetures. Select Help > Product Feture Movies. Using this Help. Informtion on the structure, nvigtion, nd content of the Unified Functionl Testing Help. Select Help > HP Unified Functionl Testing Help. Wht s New provides n overview of the fetures, enhncements nd supported environments tht re new in the current version of UFT. Select Help > Wht s New. 10

11 Welcome to the Unified Functionl Testing Tutoril for GUI Testing Type Feture Documenttion Included Documenttion UFT Help includes: Home provides links to specific topics in the Help tht descrie how to perform key or dvnced tsks, nd lists relevnt externl links, such s support sites nd product forums. Wht s New in Unified Functionl Testing descries the newest fetures, enhncements, nd supported environments in the ltest version of UFT. HP Unified Functionl Testing User Guide descries how to use UFT to test your ppliction. HP Unified Functionl Testing Add-ins Guide descries how to work with supported environments using UFT dd-ins, nd provides environment-specific informtion for ech dd-in. HP Unified Functionl Testing Oject Model Reference descries UFT test ojects, lists the methods nd properties ssocited with ech oject, nd provides syntx informtion nd exmples for ech method nd property. 11

12 Welcome to the Unified Functionl Testing Tutoril for GUI Testing Type Reference Documenttion Included Documenttion HP Unified Functionl Testing Advnced References contins documenttion for the following UFT COM nd XML references: HP Unified Functionl Testing Automtion Oject Model provides syntx, descriptive informtion, nd exmples for the utomtion ojects, methods, nd properties. It lso contins detiled overview to help you get strted writing UFT utomtion scripts. The utomtion oject model ssists you in utomting test mngement, y providing ojects, methods nd properties tht enle you to control virtully every UFT feture nd cpility. HP Unified Functionl Testing Run Results Schem documents the run results XML schem, which provides the informtion you need to customize your run results. HP Unified Functionl Testing Test Oject Schem documents the test oject XML schem, which provides the informtion you need to extend test oject support in different environments. HP Unified Functionl Testing Oject Repository Schem documents the oject repository XML schem, which provides the informtion you need to edit n oject repository file tht ws exported to XML. HP Unified Functionl Testing Oject Repository Automtion documents the Oject Repository utomtion oject model, which provides the informtion you need to mnipulte UFT oject repositories nd their contents from outside of UFT. VBScript Reference contins Microsoft VBScript documenttion, including VBScript, Script Runtime, nd Windows Script Host. 12

13 Welcome to the Unified Functionl Testing Tutoril for GUI Testing Additionl Online Resources Smple ppliction. The Mercury Tours smple We site is the sis for mny exmples in this guide. The URL for this We site is newtours.demout.com. Trouleshooting & Knowledge Bse ccesses the Trouleshooting pge on the HP Softwre Support We site where you cn serch the Self-solve knowledge se. Choose Help > Trouleshooting & Knowledge Bse. The URL for this We site is HP Softwre Support ccesses the HP Softwre Support We site. This site enles you to rowse the Self-solve knowledge se. You cn lso post to nd serch user discussion forums, sumit support requests, downlod ptches nd updted documenttion, nd more. Choose Help > HP Softwre Support. The URL for this We site is Most of the support res require tht you register s n HP Pssport user nd sign in. Mny lso require support contrct. To find more informtion out ccess levels, go to: To register for n HP Pssport user ID, go to: HP Softwre We site ccesses the HP Softwre We site. This site provides you with the most up-to-dte informtion on HP Softwre products. This includes new softwre releses, seminrs nd trde shows, customer support, nd more. Choose Help > HP Softwre We site. The URL for this We site is 13

14 Welcome to the Unified Functionl Testing Tutoril for GUI Testing 14

15 1 Introducing Unified Functionl Testing This lesson provides you with n overview of utomted testing nd UFT, nd gets you set up to perform the tutoril. Note: It is recommended to work with n soft copy of this tutoril ecuse there re sections in which you will e sked to copy nd pste test steps into UFT. However, keep in mind tht in selected prts of this tutoril, UFT will e recording your opertions or lerning ojects tht you point to with the mouse. During such sessions, you should refrin from switching focus to the PDF or Help window. You cn open PDF of this tutoril from your <Unified Functionl Testing instlltion folder>\help folder or y selecting Help > Printer-Friendly Documenttion in UFT. You cn ccess the HTML version of this tutoril, y selecting Help > Unified Functionl Testing Tutoril. This lesson includes: Benefits of Automted GUI Testing on pge 16 Testing Process on pge 17 UFT Window on pge 19 15

16 Lesson 1 Introducing Unified Functionl Testing Benefits of Automted GUI Testing If you hve ever tested pplictions or We sites mnully, you re wre of the drwcks of mnul testing. Mnul testing is time-consuming nd tedious, nd requires hevy investment in humn resources. Worst of ll, time constrints often mke it impossile to mnully test every feture thoroughly efore the ppliction is relesed. This leves you wondering whether serious ugs hve gone undetected. Automted GUI testing with UFT ddresses these prolems y drmticlly speeding up the testing process. You cn crete tests tht check ll spects of your ppliction or We site, nd then run these tests every time your site or ppliction chnges. As UFT runs tests, it simultes humn user y moving the cursor in We pge or ppliction window, clicking GUI ojects, nd entering keyord input. However, UFT does ll this fster thn ny humn user. Benefits of Automted Testing Fst Relile Repetle Progrmmle Comprehensive Reusle Automted tests re significntly fster thn humn users. Tests perform precisely the sme opertions ech time they re run, therey eliminting humn error. You cn test how the We site or ppliction rects fter repeted execution of the sme opertions. You cn progrm sophisticted tests tht ring out hidden informtion. You cn uild suite of tests tht covers every feture in your We site or ppliction. You cn reuse tests on different versions of We site or ppliction, even if the user interfce chnges. 16

17 Lesson 1 Introducing Unified Functionl Testing Testing Process The UFT testing process consists of the following min phses: 1 Anlyzing your ppliction The first step in plnning your test is to nlyze your ppliction to determine your testing needs. Wht re your ppliction s development environments? You will need to lod UFT dd-ins for these environments to enle UFT to identify nd work with the ojects in your ppliction. Exmples of development environments cn include environments such s We, Jv, or.net. Wht usiness processes nd functionlity do you wnt to test? To nswer this, think out the vrious ctivities tht customers perform in your ppliction to ccomplish specific tsks. How cn you rek your test into smll testle units nd tsks? You should rek the processes nd functionlity you wnt to test into smller tsks, so tht you cn crete UFT ctions sed on those tsks. Smller nd more modulr ctions mke your tests esier to red nd follow, nd help ese mintennce in the long run. At this stge, you cn lredy egin creting test skeletons nd dding ctions. 2 Prepring the testing infrstructure Bsed on your testing needs, you must determine wht resources re required nd crete these resources ccordingly. Exmples of resources include shred oject repositories, which contin test ojects tht represent ojects in your ppliction, nd function lirries, which contin functions tht enhnce UFT functionlity. You lso need to configure UFT settings so tht UFT will perform ny dditionl tsks you my you need, such s displying results report every time you run test. 17

18 Lesson 1 Introducing Unified Functionl Testing 3 Building your tests nd dding steps to ech test After the testing infrstructure is redy, you cn egin uilding your tests. You cn crete one or more empty tests nd dd ctions to them to crete the testing skeletons. You ssocite your oject repositories with the relevnt ctions, nd ssocite your function lirries with the relevnt tests, so tht you cn insert steps using keywords. You cn lso dd ll your tests to single solution. A solution enles you to store, mnge, nd edit ny relted tests together, without hving to close one test efore opening nother. You my lso need to configure test preferences t this point. 4 Enhncing your test You cn test whether your ppliction is functioning correctly y inserting checkpoints into your tests. Checkpoints serch for specific vlue of pge, oject, or text string. You cn roden the scope of your test nd test how your ppliction performs the sme opertions with multiple sets of dt. Do this y replcing fixed vlues with prmeters. You cn dd other sophisticted checks to your test y dding progrmming nd conditionl or loop sttements nd other progrmming logic to your test using VBScript. This tutoril includes steps for checkpoints nd prmeters only. For dditionl detils out VBScript sttements, see the HP Unified Functionl Testing User Guide. 5 Deugging, running, nd nlyzing your test You cn deug your test using deugging functionlity to ensure tht it opertes smoothly nd without interruption. After the test is working correctly, you run it to check the ehvior of your ppliction. While running, UFT opens the ppliction nd performs ech step in your test. Exmine the run results to pinpoint defects in your ppliction. 18

19 Lesson 1 Introducing Unified Functionl Testing 6 Reporting defects If you hve ALM instlled, you cn report the defects you discover to dtse. ALM is the HP test mngement solution. For detils out working with ALM, see the HP Unified Functionl Testing User Guide. UFT Window Before you egin creting tests, fmilirize yourself with the min UFT window. The imge elow shows UFT window s it would pper right fter you crete test, with the test flow shown in the cnvs, nd with the toolr, Solution Explorer, Dt pne, nd Properties pne displyed: 19

20 Lesson 1 Introducing Unified Functionl Testing Tke few minutes to explore the components of the min UFT window. You cn then continue to nlyze the ppliction you will e testing in this tutoril, s descried in Lesson 2, "Anlyzing Your Appliction nd Creting Actions". Document Types UFT displys open documents in the document pne. Use the document ts locted just elow the toolr to nvigte to open documents nd ring them into focus. The document pne cn disply the following types of files: Tests. You cn crete, view, nd modify your test in the Cnvs, which enles you to edit the flow of your test, ction, or component. Actions or Business Components. Enles you to crete, view, nd modify your ction or usiness component, in the following views: Keyword View. Contins ech step, nd displys the oject hierrchy, in modulr, icon-sed tle. Editor. Contins ech step s VBScript line, displyed in text nd code editor. In oject-sed steps, the VBScript line defines the oject hierrchy. Function Lirry. Enles you to crete, view, nd modify functions (opertions) for use with your test. Function lirries open s seprte ts in the document pne, similr to tests or ctions. Appliction Ares. Enles you to edit the ppliction re settings nd resource ssocitions. Strt Pge. Welcomes you to UFT nd provides links to recent files, descriptions of new fetures, product forums, nd other support links. You cn use the shortcut uttons to open new nd existing documents. Product Movies. Accessile from the Strt Pge or Help menu, nd teches you out some of the min UFT fetures using descriptive nd instructionl movies. Internl Browser Pges. Enles you to open internet pges for forums nd other product relted pge, such s those ccessile from the Strt Pge or the Help menu. 20

21 Lesson 1 Introducing Unified Functionl Testing Toolrs nd Menus In ddition to the document pne, the UFT window contins the following key elements: Title r. Displys the pth of the current test or solution. Menu r. Displys menus of UFT commnds. UFT toolr. Contins commonly used uttons to ssist you in designing your testing documents. For detils, see the HP Unified Functionl Testing User Guide. Pnes Some of the pnes nd toolr options listed elow re descried in detil in susequent lessons. For detils on other pnes nd toolr options, see the HP Unified Functionl Testing User Guide. Nme Toolr Button Description Defult Loction Solution Explorer Displys ll the resources ssocited with your current test, nd enles you to mnge these resources. A t on the left side of the UFT window. To disply: Select View > Solution Explorer. Click the Solution Explorer utton in the toolr. Toolox Displys ll the keywords ville to your test, nd enles you to drg nd drop ojects, or clls to functions, from the Toolox pne into your test. A t on the left side of the UFT window. To disply: Select View > Toolox. Click the Toolox utton in the toolr. 21

22 Lesson 1 Introducing Unified Functionl Testing Nme Toolr Button Description Defult Loction Document pne N/A Displys ll open documents. Ech document hs t tht you cn click to ring the document into focus. An unleled pne in the center of the UFT window. Ech document t is leled with the document nme. To disply: Open testing document. Properties Displys ll properties for the currently selected test, ction, component, or ppliction re. Dt Assists you in prmetrizing your test. Output N/A Displys informtion sent during the run session. Errors N/A Displys list of syntx errors found in your test or function lirry. Provides list of the resources tht re referenced in your test ut cnnot e found, such s missing Recovery Scenrios nd missing Function Lirries. A pne on the right side of the UFT window. To disply: Select View > Properties. Click the Properties utton in the toolr. A t t the ottom of the UFT window. To disply: Select View > Dt. Click the Dt utton in the toolr. A t t the ottom of the UFT window. To disply: Select View > Output. A t t the ottom of the UFT window. To disply: Select View > Errors. 22

23 Lesson 1 Introducing Unified Functionl Testing Nme Toolr Button Description Defult Loction Active Screen N/A Provides snpshot of your ppliction s it ppered when you performed certin step during recording session. A t t the ottom of the UFT window. To disply: Select View > Active Screen. Deug pnes Assists you in deugging your test. The Deug pnes include the Brekpoints, Cll Stck, Locl Vriles, Console, nd Wtch pnes. Ts t the ottom of the UFT window. Not displyed y defult. To disply: Select View > Deug. Click the Deug utton in the toolr, nd then select the individul deug pne from the drop-down list. Tsks N/A Displys nd enles you to mnge the tsks defined for the current test. Displys the TODO comment steps of the test s ctions or currently open function lirries. A t t the ottom of the UFT window. To disply: Select View > Tsks. 23

24 Lesson 1 Introducing Unified Functionl Testing Nme Toolr Button Description Defult Loction Serch Results N/A Displys ll occurrences of the serch criteri you define in the Find dilog ox or using other Serch menu items. A t t the ottom of the UFT window. To disply: Select View > Serch Results. Perform serch. Bookmrks N/A Displys the loction of ookmrks in your ction, scripted component, or function lirry, nd enles you to nvigte to these ookmrks. A t t the ottom of the UFT window. To disply: Select View > Bookmrks. 24

25 2 Anlyzing Your Appliction nd Creting Actions Lesson 1, "Introducing Unified Functionl Testing" gve you n overview of utomted testing nd UFT, nd helped you set up your system to perform the tutoril. In this lesson, you will nlyze n ppliction to determine wht needs to e tested, nd you will lern to crete n ction in UFT. An ction is logicl unit in your test tht focuses on testing prticulr prt of your ppliction. This lesson includes: Getting to Know Your Appliction on pge 26 Explore the Mercury Tours We Site on pge 27 Creting Tests on pge 30 Crete New Solution, Test, nd Actions on pge 32 25

26 Lesson 2 Anlyzing Your Appliction nd Creting Actions Getting to Know Your Appliction Before you egin creting tests, you must determine exctly wht you wnt to test in your ppliction. To do this, you need to nlyze your ppliction in terms of its usiness processes the distinct ctivities tht customers perform in your ppliction to complete prticulr tsks. For the purpose of this tutoril, you need to ecome fmilir with the Mercury Tours We site. Mercury Tours is smple we ppliction tht simultes we-sed flight informtion nd reservtion service. You cn ccess the Mercury Tours We site using ny we rowser, ut you cn perform the tutoril using only Microsoft Internet Explorer. As you nvigte the site nd fmilirize yourself with its content, consider the following: How is the ppliction orgnized? Are there seprte res for ech ctivity? Wht re these res? Wht re these ctivities? Wht re the expected outcomes for ech ctivity? Wht screens must e tested in ech of these res? Wht ojects need to e tested in ech screen? Wht ctivities might e used in multiple scenrios? One exmple of such n ctivity is logging on to the ppliction. Think of these ctivities s "reusle" prts. Anlyzing your ppliction in terms of its seprte prts cn help you to design your tests so tht they comprise smll, modulr units, which re esier to understnd, deug, nd mintin over time. Wht usiness processes might users perform using this ppliction? One scenrio discussed in this tutoril is reserving flights. Other scenrios might include mking cruise or hotel reservtions, or even registering on the We site. Which development environments need to e supported for testing purposes? UFT provides dd-ins to support mny testing environments. You lod these dd-ins when you open UFT. When working with this tutoril, you need to lod the We Add-in ecuse Mercury Tours is We ppliction. Your ppliction might require you to lod Jv or other dd-ins. 26

27 Lesson 2 Anlyzing Your Appliction nd Creting Actions Explore the Mercury Tours We Site Open the Mercury Tours We site nd explore it for while. As you nvigte the site nd fmilirize yourself with its content, consider the questions posed in "Getting to Know Your Appliction" on pge Lunch the Mercury Tours We site In Microsoft Internet Explorer, rowse to the Mercury Tours We site: The Mercury Tours home pge opens. 2 Log in to Mercury Tours In the Find Flight re, enter tutoril in oth the User Nme nd Pssword oxes nd click Sign-In. Note: If you re prompted to hve Internet Explorer rememer the pssword, click No. 27

28 Lesson 2 Anlyzing Your Appliction nd Creting Actions The Flight Finder pge opens. 28

29 Lesson 2 Anlyzing Your Appliction nd Creting Actions 3 Explore the Mercury Tours site Beginning with the Flight Finder pge, follow the on-screen instructions to get flight informtion nd reserve flight. As you nvigte the ppliction, think out wht you might wnt to test, nd which pges nd ojects need to e included in ech test tht you might crete. Note: On the Book Flight pge, you do not hve to fill out ctul personl or credit crd informtion; just enter the required informtion, indicted in red, in the Pssengers nd Credit Crd sections. You my enter fictitious informtion. 4 End your Mercury Tours session nd close the rowser When you finish exploring the Mercury Tours We site, click LOG OUT on the Flight Confirmtion pge or SIGN-OFF t the top of ny ppliction pge. To sign on gin, simply enter tutoril in the User Nme nd Pssword oxes in the SIGN-ON pge or in the Mercury Tours home pge. After logging out, close the Internet Explorer window. You re now redy to use this tutoril to crete tests on the Mercury Tours We site using UFT. See "Creting Tests" on pge 30 for detils, nd then continue with "Crete New Solution, Test, nd Actions" on pge

30 Lesson 2 Anlyzing Your Appliction nd Creting Actions Creting Tests Ech UFT test includes clls to ctions. Actions re units tht divide your test into logicl sections. When you crete new test, it contins cll to one ction. By dividing your tests into clls to multiple ctions, you cn design more modulr nd efficient tests. You cn lso group your tests ccording to functionlity nd store them together in solutions. By dding tests nd other documents to solutions, you cn open nd edit the documents in the sme UFT session without hving to open, sve, nd close ech test s you modify it, nd you cn shre resources cross relted tests. Internl nd Externl Actions UFT lets you insert severl types of ctions into tests. An internl ction is n ction tht is stored in the locl test (lso known s source test). An externl ction is referenced cll to n ction tht is stored in different test. For exmple, you my hve n ction tht you wnt to use in multiple tests you would store the ction s n internl ction in one test nd insert clls to tht ction from other tests. In the other tests the ction would e ville s n externl ction. Reusle Actions When you insert cll to new ction, it is reusle y defult, enling you to insert clls to the ction from ny test. When working with reusle ctions, you only need to updte the existing ction stored with the originl test. When you modify the originl ction, ll tests contining clls to the reusle ction re updted. Reusle ctions re red-only in the clling test, nd you modify them in the test in which they re stored. 30

31 Lesson 2 Anlyzing Your Appliction nd Creting Actions Reusle ctions re especilly useful when: You hve process tht you my need to include in severl tests, such s logging in to your ppliction You my hve process tht you need to insert severl times in the sme test, such s filling in user credentil dilog oxes tht open whenever user tries to ccess secure prt of your ppliction. If you wnt to prevent n ction from eing reused in ny test, you cn mke it non-reusle. Non-reusle ctions re internl ctions tht cn e used only once. Tip: If you pln to use the sme or similr ctions in mny tests, you might consider creting repository test to store your reusle ctions. Then you cn insert clls to these existing ctions from other tests, linking these ctions to the source test. You cn store the repository test in the sme solution s your other tests, enling esier ccess to your reusle ctions. Copied Actions You cn lso insert copy of n ction in your tests if you pln to mke chnges to the ction steps. This inserts the ction s n internl ction in the current test. Copies of ctions re not linked to the source test, so tht when you insert cll to copy of n existing ction, you cn mke chnges to the copied ction, nd your chnges will neither ffect, nor e ffected y, ny other test. 31

32 Lesson 2 Anlyzing Your Appliction nd Creting Actions Crete New Solution, Test, nd Actions In this exercise, you will crete new solution nd test for the Mercury Tours We site tht you explored in "Explore the Mercury Tours We Site" on pge 27. The ctions you crete in this exercise will e reused in susequent lessons. 1 Strt UFT Do one of the following: If UFT is not currently open: Doule-click the UFT icon on your desktop. Select Strt > All Progrms > HP Softwre > HP Unified Functionl Testing > HP Unified Functionl Testing In the Add-in Mnger, confirm tht the We Add-in is selected, nd cler ll other dd-ins. Click OK to close the Add-in Mnger nd open UFT. The UFT splsh screen is displyed while UFT lods your selected dd-ins. This my tke few seconds. If UFT is lredy open: Check which dd-ins re loded y selecting Help > Aout HP Unified Functionl Testing. The dd-ins re listed under Instlled Fetures. If the We Add-in is not loded, you must exit nd restrt UFT. When the Add-in Mnger opens, select the We Add-in, nd cler ll other dd-ins. Note: If the Add-in Mnger does not open when strting UFT, select Tools > Options. In the Strtup Options pne of the Generl t, select Disply Add-in Mnger on strtup. When you exit nd restrt UFT, the Add-in Mnger opens. 32

33 Lesson 2 Anlyzing Your Appliction nd Creting Actions 2 Explore the Strt Pge The Strt Pge provides links to recent files, informtion out new fetures in this version of UFT, s well s links to helpful support nd community forums. In the top-right corner of the pge, you cn define options for displying nd closing the Strt Pge. If it is not lredy displyed, in the Document Pne, click the Strt Pge t. In the top-right corner of the Strt Pge, select the Options drop-down rrow, nd then select Close Strt Pge fter test lods. The Strt Pge will close utomticlly fter you crete test. 3 Crete new test Click the New utton. By defult, UFT ssumes tht you wnt to crete new test, nd the New Test dilog ox opens. Select GUI Test, populte the fields s follows: Nme: Enter MercuryTours. Loction: Tests re utomticlly sved t C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing, nd you do not need to modify this pth. Solution Nme: Enter Tutoril. 33

34 Lesson 2 Anlyzing Your Appliction nd Creting Actions c Select Crete directory for solution. The Solution Loction vlue is utomticlly updted with your new directory. d Click Crete. A lnk test opens, with the test flow displyed in the cnvs, nd lnk ction t opened in the ckground. The test nme (MercuryTours) nd pth re displyed in the title r of the min UFT window. In the Solution Explorer, you cn see tht the test is loded s prt of the Tutoril solution. Note: If the Solution Explorer is hidden, click the Solution Explorer utton or select View > Solution Explorer to disply it. 4 Renme Action1 so tht it hs logicl nme In the cnvs, right-click the Action1 imge nd select Action Properties. In the Action Properties dilog ox, in the Nme ox, enter Login s the new nme. In the messge tht opens, click Yes. 34

35 Lesson 2 Anlyzing Your Appliction nd Creting Actions 5 Crete new ction nmed FlightFinder Right-click nywhere in the cnvs, nd select Cll to New Action. The Insert Cll to New Action dilog ox opens.. c In the Nme ox, enter FlightFinder, nd confirm tht oth Reusle Action nd At the end of the test re selected. Click OK. The dilog ox closes nd the FlightFinder ction is dded to the end of your test. 6 Crete clls to dditionl ctions Repet step 5 to dd the following ctions: SelectFlight BookFlight Your test now contins ll of the ctions needed to egin this tutoril. 35

36 Lesson 2 Anlyzing Your Appliction nd Creting Actions 7 Sve your test Click Sve. Note: You my hve noticed tht efore you clicked sve, n sterisk (*) ws displyed in the MercuryTours document t nd Solution Explorer node. Asterisks re displyed to indicte tht you hve unsved content, nd dispper when you sve the file. When you sve test, ll test ctions re sved too. 8 Explore the test flow in the cnvs Click the Mercury Tours t in the document pne to view the entire test flow in the cnvs. You cn zoom in or out on the test flow using the mouse or the zoom r locted ove the cnvs. Once the test flow is zoomed in to the mximum, nd no longer fits in the cnvs, you cn lso use the minimp in the ottom left corner of the cnvs to nvigte through the test flow. If the minimp is not displyed, click the Minimp utton ove the cnvs to disply it. The minimp cn e helpful if you hve test with mny ctions or nested ctions. You cn continue with creting test ojects for use in your test, s descried in Lesson 3, "Creting Oject Repositories". Types of Action Clls You cn insert the following types of ction clls to your test: Clls to new ctions. Inserts new, empty ction in your test. Clls to copy of n ction. Inserts copy of n existing ction in your test. The ction is not linked to the source test or ction from which you copied it. 36

37 Lesson 2 Anlyzing Your Appliction nd Creting Actions Cll to n existing ction. Inserts cll to n existing ction in your test. You cn insert cll to n ction tht is stored in the current test (if you wnt to insert the sme ction twice, for exmple), or you cn insert cll to n ction from nother test. The ction remins linked to the source test from which you clled it. 37

38 Lesson 2 Anlyzing Your Appliction nd Creting Actions 38

39 3 Creting Oject Repositories In Lesson 2, "Anlyzing Your Appliction nd Creting Actions" you lerned out the Mercury Tours We-sed ppliction nd determined wht needs to e tested. You then creted solution, test, nd ctions. This lesson introduces test ojects nd run-time ojects, nd descries how to crete shred oject repositories tht you cn ssocite with the ctions in your test. This lesson includes: Introducing Test Ojects nd Oject Repositories on pge 39 Lern Ojects in Your Appliction on pge 41 Use Multiple Oject Repositories on pge 50 Introducing Test Ojects nd Oject Repositories Before you dd steps to your test, you must set up the resources tht will e used y tht test. One of the most importnt resources for ny test is the oject repository. An oject repository is storehouse for the test ojects (nd other oject types) used in your test. Run-Time Ojects During run session, UFT performs the opertions on the run time ojects in your ppliction. 39

40 Lesson 3 Creting Oject Repositories Test ojects re stored representtions of the ctul run time ojects (or controls) in your ppliction. UFT cretes test ojects y lerning select set of the properties nd vlues of the ojects in your ppliction, nd uses tht dt to uniquely identify ojects in your ppliction during run time. Ech test oject is prt of test oject hierrchy. For exmple, Link oject my e prt of Browser/Pge/Link hierrchy. Top-level ojects, such s Browser ojects, re known s continer ojects, s they cn contin lower-level ojects, such s Frme or Pge ojects. In this lesson, you will use the Oject Spy dilog ox to view the properties nd opertions of ojects in your ppliction. Oject Repositories UFT cn store the test ojects it lerns in the following types of oject repository files: Shred oject repositories. Contin test ojects tht cn e used in multiple ctions. This verstility mkes it the preferred repository type for storing nd mintining test ojects. By ssociting shred oject repository with n ction, you mke the test ojects in tht repository ville for use in the ction. Any mintennce you perform on n oject in shred oject repository is reflected in ll steps (within ll ctions) using tht oject. Locl oject repositories. Contin test ojects tht cn e used in one specific ction. The ojects in this type of repository cnnot e used in ny other ction. Locl oject repositories re useful for cking up your test ojects, or for lerning new ojects. During run session, UFT references the test ojects stored in the ssocited oject repositories in order to perform opertions on the corresponding run time ojects in your ppliction. When you crete n oject repository, try to include only the ojects you need for testing purposes. This keeps the oject repository reltively smll nd helps to simplify mintennce nd oject selection. Also, mke sure tht you provide logicl nmes so tht others cn esily select the correct ojects when creting or modifying tests. 40

41 Lesson 3 Creting Oject Repositories Note: Oject repositories cn lso include checkpoint nd output ojects. Checkpoint oject types re covered in Lesson 7, "Creting Checkpoints nd Using Functions." Lern Ojects in Your Appliction In this exercise, you will crete n oject repository for use in the Login ction. Use the UFT Nvigte nd Lern option to dd ojects from the Mercury Tours We site to shred oject repository, nd then ssocite the oject repository with your test. 1 Strt UFT nd open the MercuryTours test If UFT is not currently open, open UFT s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. On the Strt pge, in the Recent solutions re, click Tutoril. The Tutoril solution opens, displying the MercuryTours test. (You creted the MercuryTours test in step 3 of "Crete New Solution, Test, nd Actions" on pge 32.) 2 Set the lern settings for UFT c Select Record > Record And Run Settings. The Record nd Run Settings dilog ox opens. In the We t, select Open the following ddress when record or run session egins. Confirm tht the URL in the first ox is In the second ox, select rowser on which to run your test session. Microsoft Internet Explorer is the rowser used in this tutoril. 41

42 Lesson 3 Creting Oject Repositories d Confirm tht the following options re selected: Do not record nd run on rowsers tht re lredy open Close the rowser when the test closes e Click OK. Lter, when you run the test or record steps for it, your rowser will open to the Mercury Tours We site. When the record or run session ends, your rowser will close. 3 Open the Mercury Tours We site Open Internet Explorer nd rowse to the Mercury Tours We site: newtours.demout.com. Ensure tht the rowser window is mximized. Note: Be sure to open new Internet Explorer window fter UFT. If you use rowser tht ws lredy open efore you opened UFT, UFT my not properly recognize the ojects in it. 42

43 Lesson 3 Creting Oject Repositories 4 View the properties nd opertions for some of the ojects in the Mercury Tours We site c In UFT, click the Oject Spy toolr utton. The Oject Spy dilog ox opens. Drg the Oject Spy dilog ox to the right side of your screen. This enles you to see the ojects you wnt to spy on more clerly. Verify tht the Keep Oject Spy on top while spying toggle utton is pressed. Click the pointing hnd utton. UFT is hidden, nd the Oject Spy dilog ox is displyed over the Mercury Tours We site Welcome pge. Tip: If you need to switch ck nd forth etween Welcome pge, UFT, or ny other window currently open, press CTRL to chnge the pointing hnd ck to regulr Windows pointer. Hold down the CTRL utton s long s you need the pointer, nd then relese it when you re redy to use the pointing hnd. d Hover the mouse cursor over the vrious ojects on the pge nd wtch to see wht hppens in the Oject Spy dilog ox. Note: If UFT does not recognize your ojects in the correct loction, check to see tht you re viewing the pge t 100%, nd re not zooming in or out of the pge. For exmple, if you view the pge t 90% or 120%, you my e required to click or select n re to the left or the right of the ctul oject in order to recognize it. e Position the mouse cursor in the User Nme edit ox (ut do not click it). The test oject hierrchy of tht oject is displyed. In the hierrchy ox, notice tht the nme of the oject is WeEdit, which is its oject clss type. 43

44 Lesson 3 Creting Oject Repositories f g Click the User Nme edit ox. UFT opens gin. In the Oject hierrchy ox, notice tht the oject clss nd nme re now selected (WeEdit:userNme). Close the Oject Spy dilog ox. 5 Strt the Nvigte nd Lern process y setting up the Define Oject Filter In this step, you instruct UFT to lern only the ojects tht re needed for your test nd dd them to the oject repository. This helps keep oject repository mintennce to minimum. In UFT, select Resources > Oject Repository Mnger. The Oject Repository Mnger window opens. In the Oject Repository Mnger window, select Oject > Nvigte nd Lern. Both UFT nd the Oject Repository Mnger re hidden, nd the Nvigte nd Lern toolr ppers. Note: The first time you use Nvigte nd Lern, messge ox displying tooltip opens. Click OK to enle the Nvigte nd Lern toolr. c In the Nvigte nd Lern toolr, click the Define Oject Filter utton. The Define Oject Filter dilog ox opens. 44

45 Lesson 3 Creting Oject Repositories d In the Define Oject Filter dilog ox, select Selected oject types nd then click Select. The Select Oject Types dilog ox opens. e Click Cler All to cler ll of the check oxes. Then select the Edit Box nd Imge check oxes nd click OK. f In the Define Oject Filter dilog ox, click OK. 45

46 Lesson 3 Creting Oject Repositories 6 Lern the selected oject types from the Welcome pge In this step, you instruct UFT to lern ll of the ojects in the Mercury Tours We site Welcome pge tht mtch the filter you defined in step 5, nd to dd them to shred oject repository. In the Mercury Tours We site Welcome pge, click the Welcome: Mercury Tours title t to ring it into focus s the We pge you wnt UFT to lern. In the Nvigte nd Lern toolr, click Lern. The We pge flickers nd the Adding Ojects messge ox is displyed s UFT dds representtions of the ojects on the We pge to new oject repository. Note: Adding these ojects tkes few seconds. Do not interct with the We pge while Nvigte nd Lern runs. Nvigte nd Lern hs finished dding the ojects to the oject repository when the flshing stops nd the Adding Ojects ox closes. c Close the Nvigte nd Lern toolr. UFT nd the Oject Repository Mnger window re visile gin. 46

47 Lesson 3 Creting Oject Repositories 7 Remove extr ojects from the oject repository In step 6, UFT dded ll of the ojects tht mtch your filter selection to the oject repository. You only need few ojects for this test, so in this step, you will delete the extrneous ojects. In the Oject Repository Mnger window, expnd the ojects in the Test Ojects tree. You should see list of ojects similr to the following: 47

48 Lesson 3 Creting Oject Repositories Delete ll of the test ojects except for Sign-In (imge), pssword (edit ox), nd usernme (edit ox). Select the ojects nd press Delete. Click Yes in the confirmtion ox. Note: You cn select multiple ojects simultneously using the SHIFT nd CTRL keys. After you delete the extrneous ojects, your tree should resemle the following: Tip: If you delete Sign-In, pssword, or usernme y mistke, click Undo to restore the deleted ojects. 48

49 Lesson 3 Creting Oject Repositories 8 See wht UFT lerned out one of the ojects In the Test Ojects tree, select the usernme oject, nd notice the oject properties displyed in the right pne. These re the descriptive properties tht UFT will use to identify the oject during run session. 9 Sve the oject repository In the Oject Repository Mnger window, click Sve. The Sve Shred Oject Repository dilog ox opens. Browse to the loction in which you wnt to sve your oject repositories, such s C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril. Crete new folder nmed Tutoril_OjectRepositories, nd open it. In the File Nme ox, enter MercuryToursLogin nd click Sve. 49

50 Lesson 3 Creting Oject Repositories 10 Associte the oject repository with the Login ction Associting n oject repository with n ction enles you to use ny oject from tht repository in ny step in the ssocited ction. c d Switch to the UFT window. If the Solution Explorer is not lredy open, open it y clicking the Solution Explorer utton. In the Solution Explorer, expnd the MercuryTours test node. Right-click the Login ction nd select Associte Repository with Action. The Open Shred Oject Repository dilog ox opens. Locte nd open the MercuryToursLogin.tsr shred oject repository. The oject repository is now ssocited with the Login ction, nd is displyed in the Solution Explorer s child of tht ction. 11 Sve your test Select File > Sve. Congrtultions! You hve creted shred oject repository for the Welcome pge of the Mercury Tours We site, nd ssocited it with your test s first ction. Continue with creting oject repositories for the other ctions in your test nd ssociting them with the relevnt ctions, s descried in "Use Multiple Oject Repositories" on pge 50. Use Multiple Oject Repositories In "Lern Ojects in Your Appliction" on pge 41, you creted shred oject repository for the Welcome pge of the Mercury Tours We site. Now, you will crete shred oject repository for ech of the remining pges in the site. Tip: It is recommended to lwys crete seprte shred oject repository for ech pge in your We site or ech re of your ppliction. This mkes it esier to find the correct oject when dding or modifying test steps or when performing mintennce tsks. 50

51 Lesson 3 Creting Oject Repositories For the purposes of this tutoril, you will instruct UFT to lern ll of the ojects on ech pge. At this point, you do not need to ssocite the oject repositories with specific ction. 1 Log in to the Mercury Tours We site Flight Finder pge c If it is not currently open, open Internet Explorer nd rowse to the Mercury Tours We site: In the User Nme nd Pssword oxes, enter tutoril. Click Sign-In. The Flight Finder pge opens. 2 Crete new shred oject repository If the Oject Repository Mnger is closed, open it y selecting Resources > Oject Repository Mnger in UFT. The Oject Repository Mnger window opens. In the Oject Repository Mnger window, click New. A lnk shred oject repository opens. 3 Strt the Nvigte nd Lern process y setting up the Define Oject Filter In the Oject Repository Mnger window, select Oject > Nvigte nd Lern. Both UFT nd the Oject Repository Mnger re hidden. In the Nvigte nd Lern toolr, click the Define Oject Filter utton. The Define Oject Filter dilog ox opens. c In the Define Oject Filter dilog ox, select All oject types nd click OK. 51

52 Lesson 3 Creting Oject Repositories 4 Lern ll of the ojects from the Flight Finder pge In this step, you instruct UFT to lern ll of the ojects in the Mercury Tours We site Flight Finder pge tht mtch your filter, nd to dd them to shred oject repository. In the Mercury Tours We site Flight Finder pge, click the Flight Finder: Mercury Tours title t to ring it into focus s the We pge you wnt UFT to lern. In the Nvigte nd Lern toolr, click Lern. The We pge flickers nd the Adding Ojects messge ox is displyed s UFT egins dding representtions of the ojects on the We pge to new oject repository. Note: Adding these ojects tkes few seconds. Do not interct with the We pge while Nvigte nd Lern runs. c Close the Nvigte nd Lern toolr. UFT nd the Oject Repository Mnger window re visile gin. 5 Sve the shred oject repository In the Oject Repository Mnger window, click Sve. The Sve Shred Oject Repository dilog ox opens. If you need to, rowse to nd open the Tutoril_OjectRepositories folder. In the File Nme ox, enter MercuryToursFlightFinder nd click Sve. 6 Crete new shred oject repository for the Select Flight pge c In the Mercury Tours We site Flight Finder pge, click Continue. The Select Flight pge opens. You re now redy to dd ojects from this pge. Switch to the Oject Repository Mnger window nd click New. A lnk shred oject repository opens. In the Oject Repository Mnger window, select Oject > Nvigte nd Lern. Both UFT nd the Oject Repository Mnger re hidden. 52

53 Lesson 3 Creting Oject Repositories d e In the Mercury Tours We site Select Flight pge, click the Select Flight: Mercury Tours title t to ring it into focus s the We pge you wnt UFT to lern. In the Nvigte nd Lern toolr, click Lern. The We pge flickers nd the Adding Ojects messge ox is displyed s UFT egins dding representtions of the ojects on the We pge to new oject repository. Note: Adding these ojects tkes few seconds. Do not interct with the We pge while Nvigte nd Lern runs. f g h Close the Nvigte nd Lern toolr. UFT nd the Oject Repository Mnger window re visile gin. In the Oject Repository Mnger window, click Sve. The Sve Shred Oject Repository dilog ox opens. If you need to, rowse to nd open the Tutoril_OjectRepositories folder. In the File Nme ox, enter MercuryToursSelectFlight nd click Sve. 7 Crete oject repositories for the remining We pges Repet step 6 to crete new shred oject repositories for ech of the following pges: Book Flight Flight Confirmtion Nme the oject repositories MercuryToursBookFlight nd MercuryToursFlightConfirmtion, respectively. 8 Associte the MercuryToursFlightFinder.tsr oject repository with the FlightFinder ction Switch to the UFT window. If the Solution Explorer is not lredy open, open it y clicking the Solution Explorer utton. In the Solution Explorer, right-click the FlightFinder ction nd select Associte Repository with Action. The Open Shred Oject Repository dilog ox opens. 53

54 Lesson 3 Creting Oject Repositories c Locte nd open the MercuryToursFlightFinder.tsr shred oject repository. The oject repository is now ssocited with the FlightFinder ction, nd is displyed in the Solution Explorer s child of tht ction. 9 Associte the remining oject repositories with the relevnt ctions Repet step 8 nd: Associte the SelectFlight ction with the MercuryToursSelectFlight.tsr. Associte the BookFlight ction with the following repositories: MercuryToursBookFlight.tsr MercuryToursFlightConfirmtion.tsr Lter, when you dd steps to ech ction, ll of the required test ojects will e ville for use. 10 Sve your test Click Sve. Continue setting up your test infrstructure y dding dditionl resources to your test, s descried in Lesson 4, "Creting Functions nd Function Lirries." 54

55 4 Creting Functions nd Function Lirries UFT provides uilt-in functions nd methods tht will stisfy mny of your testing needs. However, there my e times when you need to perform tsk tht is not ville y defult for prticulr test oject clss. You cn crete user-defined function to perform this tsk, sve it in function lirry file, nd then insert it s step every time tht you need to perform this tsk. In Lesson 3, "Creting Oject Repositories", you creted shred oject repositories nd ssocited them with the ctions in your test. In this lesson, you will crete function nd function lirry, nd ssocite the function lirry with your entire test. Associting function lirry with test enles you to cll ny of the functions in the function lirry from tht test. This lesson includes: Introducing Functions on pge 55 Crete Function on pge 56 Associte the Function Lirry with Your Test on pge 59 Introducing Functions A function is set of coded steps tht perform prticulr tsk for which no suitle method exists y defult. You my wnt your test to include such tsk, nd even repet this tsk severl times. Therefore, you wnt the function to e esily ccessile. 55

56 Lesson 4 Creting Functions nd Function Lirries For exmple, you my wnt to crete step tht genertes text file nd sves it to the file system, or tht ccesses dt from Microsoft Excel worksheet. In this lesson, you will crete function tht checks the dte formt on pge generted y the Mercury Tours We site, nd then dd the function to your test. Begin with "Crete Function" on pge 56. Crete Function In this exercise, you will crete function tht you will lter cll from your test. This function checks whether dte is displyed in MM/DD/YYYY formt. The function lso verifies tht the dte is potentilly vlid, for exmple, tht the month does not exceed 12 or tht the dte does not exceed Strt UFT nd open the MercuryTours test c If UFT is not currently open, open UFT s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. Select File > Open > Solution. The Open Solution dilog ox opens. Nvigte to the Tutoril.ftsln file, locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. (You creted the MercuryTours test in step 3 of "Crete New Solution, Test, nd Actions" on pge 32.) Note: If you copy this pth, mke sure to replce <usernme> with your usernme. 56

57 Lesson 4 Creting Functions nd Function Lirries 2 Crete new function lirry Click New down rrow nd select New Function Lirry. The New Function Lirry dilog ox opens. Note: If you simply clicked the New utton, nd not the New utton down rrow, the New Test dilog ox opens insted. c In the New Function Lirry dilog ox, populte the fields s follows: Look in: Browse to the C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril directory, crete new folder nmed Tutoril_FunctionLirries, nd open it to define it s the function lirry loction. (If you copy this pth, mke sure to replce <usernme> with your usernme.) File nme: Enter CheckDteFunction. Click Crete. The lnk function lirry opens in the document pne. 57

58 Lesson 4 Creting Functions nd Function Lirries 3 Copy the following function nd pste it into the editor 'The following function checks whether dte string (dtestr) 'hs 10 chrcters representing MM/DD/YYYY Function check_dt_vlidity( dtestr ) Dim firstslshpos, secondslshpos Dim mmprt, ddprt, yyyyprt firstslshpos = instr( dtestr, "/" ) secondslshpos = instrrev( dtestr, "/" ) If ( firstslshpos <> 3 or secondslshpos <> 6 ) Then reporter.reportevent micfil,"formt check", "Dte string is missing t lest one slsh ( / )." check_dt_vlidity = Flse Exit function End If mmprt = mid( dtestr, 1,2 ) ddprt = mid ( dtestr, firstslshpos+1, 2 ) yyyyprt = mid( dtestr, secondslshpos +1, 4 ) If mmprt > 12 Then reporter.reportevent micfil, "Formt Check", "The month vlue is invlid. It exceeds 12." check_dt_vlidity = Flse Exit function End If If ddprt > 31 Then reporter.reportevent micfil, "Formt Check", "The dte vlue is invlid. It exceeds 31." check_dt_vlidity = Flse Exit function End If If yyyyprt < 2000 Then reporter.reportevent micfil, "Formt Check", "The yer vlue is invlid. (Prior to 2000)" check_dt_vlidity = Flse Exit function End If check_dt_vlidity = True End Function 58

59 Lesson 4 Creting Functions nd Function Lirries 4 Sve the function lirry Click Sve. 5 Close the function lirry Select File > Close. Continue working with your function lirry, s descried in "Associte the Function Lirry with Your Test" on pge 59. Associte the Function Lirry with Your Test In "Crete Function" on pge 56, you creted function lirry with single function. In this exercise, you will ssocite the function lirry with your test so tht its function will e ville to your test. 1 Strt UFT nd open the MercuryTours test c If UFT is not currently open, open UFT s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. Click the Open utton down rrow, nd select Open Solution. The Open Solution dilog ox opens. Nvigte to the Tutoril.ftsln file, locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. (You creted the MercuryTours test in step 3 of "Crete New Solution, Test, nd Actions" on pge 32.) Note: If you copy this pth, mke sure to replce <usernme> with your usernme. 59

60 Lesson 4 Creting Functions nd Function Lirries 2 Associte the CheckDteFunction.qfl with the MercuryTours test c If the Solution Explorer is not lredy open, open it y clicking the Solution Explorer utton. In the Solution Explorer, right-click the MercuryTours test node nd select Add > Associte Function Lirry. The Open Function Lirry dilog ox opens. Locte nd open the CheckDteFunction.qfl function lirry. In the Automtic Reltive Pth Conversion dilog ox, click Yes. This converts the pth to reltive pth. Note: Using reltive pth keeps the pth vlid when you move folders contining tests nd other files from one loction to nother, s long s the folder hierrchy remins the sme. The function lirry is now ssocited with the MercuryTours test, nd is displyed in the Solution Explorer s child of the MercuryTours test node. 3 Sve the test Select the MercuryTours document t, nd then click Sve. All the resources required for your test re now set up, nd you cn continue to populte your test, s descried in Lesson 5, "Adding Steps." 60

61 5 Adding Steps In Lesson 2, "Anlyzing Your Appliction nd Creting Actions," you creted unique ctions for most of the pges in the Mercury Tours We site nd dded them to your test. In other lessons, you creted other prts of the required utomtion infrstructure, such s oject repositories nd function lirries. In this lesson, you will dd steps to the ctions in your test. This lesson includes: Prepring to Add Steps to Test on pge 61 Add Steps to the Login Action on pge 62 Anlyzing the Login Action in the Keyword View on pge 68 Add the Remining Steps to Your Test on pge 70 Prepring to Add Steps to Test Before you dd steps to test, ensure tht your ppliction nd UFT re set to mtch the needs of your test. For the purposes of this tutoril: 1 Set the relevnt Internet Explorer options nd close ll rowsers In Microsoft Internet Explorer, cler the AutoComplete option for ll forms, user nmes, nd psswords (select Tools > Internet Options > Content t > AutoComplete Settings). Close ll rowser windows. 61

62 Lesson 5 Adding Steps 2 Set the relevnt UFT We Pge/Frme options If UFT is not currently open, open it s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. If you do not currently hve test open, open recent test or crete dummy test. To crete dummy test, click New, nd crete new test using the defult vlues in the New Test dilog ox. You do not need to sve this test. Note: You must hve test or component open in UFT in order to see the We node in the Options dilog ox. c d Select Tools > Options > GUI Testing t > We > Pge/Frme Options node. In the Crete new Pge test oject for re, select Different URLs or chnge in dt trnsfer nd select the first four check oxes. You re now redy to strt dding steps to your ctions. Begin with "Add Steps to the Login Action" on pge 62. Add Steps to the Login Action Ech opertion performed y UFT on n ppliction is represented y step in your ction. For exmple, step might click n imge or insert vlue into n edit ox. In this exercise, you will mke reservtion for flight from New York to Sn Frncisco on the Mercury Tours We site, dding steps in vrious wys. After you dd steps to the first ction, you will nlyze the steps to lern more out the Keyword View. 62

63 Lesson 5 Adding Steps 1 Strt UFT nd open the MercuryTours test If UFT is not currently open, open it s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. On the Strt pge, in the Recent solutions re, click Tutoril. The Tutoril solution opens, displying the MercuryTours test. (You creted the MercuryTours test in step 3 of "Crete New Solution, Test, nd Actions" on pge 32.) 2 Open the Login ction nd disply the Keyword View c If the cnvs is not currently open, click the MercuryTours t in the document pne to ring it into focus. In the cnvs, doule-click the Login ction. The Login ction opens. If the Editor is displyed, click the Keyword View utton to disply the Keyword View. 3 Add the first step to log in to the Mercury Tours We site In the Keyword View, click in the Item column, directly elow the Login row. The Item list opens, displying the top-level (prent) test oject in the ssocited oject repository, nd instructing you to select n item. In this step, the prent test oject is the Welcome: Mercury Tours rowser oject. Do not select this rowser oject ecuse you do not wnt to perform n opertion on the min rowser window. You only need to insert steps on the ojects on which you wnt to perform opertions. 63

64 Lesson 5 Adding Steps c Select Oject from repository to open the Select Test Oject dilog ox. Expnd the test oject tree. d Select usernme nd click OK. The Select Oject for Step dilog ox closes nd one step is dded to the ction. Note tht three rows re dded to the Keyword View. UFT dds row for ech of the prent test ojects, even though it does not perform n opertion on these ojects. These rows re prt of the pth to the oject upon which the step is performed. During run session, UFT uses the prent ojects to identify the ctul oject on which it needs to perform n opertion. 64

65 Lesson 5 Adding Steps In this step, represented y the lst of the three new rows: The selected usernme WeEdit test oject is dded to the Item cell. The defult method, Set, is dded to the Opertion cell. Text is dded to the Documenttion cell indicting tht this step clers the text in the edit ox. This is ecuse the step is still missing required vlue in the Vlue cell, nd needs to e updted with the usernme. e In the Vlue cell, enter tutoril. Inserting this vlue completes the step. When you click nother re in the Keyword View, the documenttion for this step is updted in the Documenttion cell. Tip: Quotes re utomticlly dded round the vlue you entered in the Vlue column, indicting tht this is String vlue. If the method supported n Index vlue, nd you entered n Index vlue, no quotes would e dded. 65

66 Lesson 5 Adding Steps f Select View > Editor to disply the Editor, which displys the syntx of the step in VBScript. Browser("Welcome: Mercury Tours").Pge("Welcome: Mercury Tours").WeEdit("userNme").Set "tutoril" g Notice tht this step is eing performed on WeEdit (edit ox) test oject, nmed usernme, nd tht: The test oject hierrchy for the WeEdit (edit ox) test oject is displyed prior to the test oject. In this step the hierrchy includes Browser oject nd Pge oject. The method to e performed on the oject is displyed immeditely fter the test oject. In this step, the method is Set. The text to enter in the usernme edit ox is displyed immeditely fter the Set method. The text is displyed in quotes, which indicte tht this vlue is string. In this step, the text to enter is tutoril. Full stops (periods) seprte ech prt of the step. Click the Keyword View utton to return to the Keyword View. 4 Add the next step Click in the Item column, directly elow the usernme row. The Item list opens, listing the siling ojects of the previous step's test oject. Select pssword from the Item list. This time, only one new row is dded ecuse the oject shres the sme prent ojects s the previous step. In this step: The pssword WeEdit test oject is dded to the Item cell. The defult method, Set, is dded to the Opertion cell. You need to chnge this method ecuse the pssword needs to e encoded. Text is dded to the Documenttion cell indicting tht this step clers the text in the edit ox. This is ecuse the step is still missing required vlue in the Vlue cell, nd needs to e updted with the pssword. 66

67 Lesson 5 Adding Steps c Click in the Opertion cell to disply the down rrow, nd then click the down rrow to disply the list of ville methods for the selected test oject. Select SetSecure from the list. This method enles the use of encrypted text. Now you need to generte the encrypted text nd insert it in the Vlue cell. 5 Generte n encoded pssword using the HP Pssword Encoder ppliction Select Strt > All Progrms > HP Softwre > HP Unified Functionl Testing > Tools > Pssword Encoder. The Pssword Encoder dilog ox opens. c d e In the Pssword ox, enter tutoril. Click Generte. The Pssword Encoder encrypts the pssword nd displys it in the Encoded String ox. Click Copy. Pste the encoded vlue in the Vlue cell for the pssword step. Documenttion for this step is displyed in the Documenttion cell. Close the Pssword Encoder dilog ox. If you rn your ction t this point, UFT would utomticlly open the Mercury Tours We site nd insert the vlues you specified in the User Nme nd Pssword oxes. 6 Insert the lst step in the Login ction Click in the Item column elow the lst step to insert the next step. The Item list opens, listing the siling ojects of the previous step's test oject. 67

68 Lesson 5 Adding Steps Select Sign-In from the Item list. This step instructs UFT to click Sign-In on the Welcome pge nd log in to the Mercury Tours site. 7 Sve your test Select File > Sve. Lern more out the Keyword View in "Anlyzing the Login Action in the Keyword View" on pge 68, nd then continue with "Add the Remining Steps to Your Test" on pge 70. Anlyzing the Login Action in the Keyword View Let s tke look t the steps in your first ction. Ech step represents n opertion to e performed in the We rowser. The columns in the Keyword View show different informtion for ech step, s follows: Item. The item for the step (test oject, utility oject, function cll, or sttement) in hierrchicl icon-sed tree. Opertion. The opertion to e performed on the item, for exmple, Click, Set, or Select. Vlue. The rgument vlues for the selected opertion, if required. For exmple, the text to enter in n edit ox, or the mouse utton to use when clicking the imge. Documenttion. Automticlly provided documenttion of wht the step does, in n esy-to-understnd sentence. For exmple: Click the "Sign-In" imge. Assignment. The ssignment of vlue to or from vrile so you cn use the vlue lter in the test. This column is not visile y defult. Comment. Any textul informtion you wnt to dd regrding the step, for exmple, Return to pge used in first step of the test. This column is not visile y defult. 68

69 Lesson 5 Adding Steps Note: You cn hide or disply individul columns y right-clicking the column heding in the Keyword View, nd selecting column nme from the list. In the Item column of the Keyword View, you cn click the rnch rrows to expnd or collpse the steps under ech We pge. You cn collpse or expnd ech ction y selecting the ction nme t the top nd then selecting View > Collpse All or View > Expnd All. When you expnd your ction, it should look similr to this: Tke few minutes to exmine the Keyword View in detil, trcing the steps you performed while creting this ction. Then, continue to dd dditionl steps, s descried in "Add the Remining Steps to Your Test" on pge 70. The tle elow descries the steps shown in the ction in the Keyword View ove. Step Description Login is the ction nme. Actions re test units tht divide your test into logicl sections. The rowser oject invokes the Welcome: Mercury Tours We site. Welcome: Mercury Tours is the nme of the We pge. 69

70 Lesson 5 Adding Steps Step Description usernme is the nme of the edit ox. Set is the method performed on the edit ox. tutoril is the vlue entered in the usernme edit ox. pssword is the nme of the edit ox. SetSecure is n encryption method performed on the edit ox. The list of digits is the encrypted vlue entered in the pssword edit ox. Sign-In is the nme of the imge link. Click is the method performed on the imge. For more informtion on the Keyword View, see the HP Unified Functionl Testing User Guide. Add the Remining Steps to Your Test Now tht you dded steps using the Keyword View in "Add Steps to the Login Action" on pge 62, you cn continue with other methods of dding steps, s follows: "Add Steps to the FlightFinder Action y Recording" on pge 71 "Add Step to the SelectFlight Action Using the Toolox Pne" on pge 76 "Add Steps to the BookFlight Action Using the Editor nd Step Genertor" on pge 78 70

71 Lesson 5 Adding Steps Add Steps to the FlightFinder Action y Recording In "Add Steps to the Login Action" on pge 62, you dded steps to perform on the Mercury Tours Welcome pge. If you were to run your test t this point, the lst step would open the Flight Finder pge in the Mercury Tours We site. In this exercise, you will record steps for the FlightFinder ction you creted for the Flight Finder pge. The steps you dd will use test ojects from the ssocited MercuryToursFlightFinder shred oject repository. 1 Strt UFT nd open the MercuryTours test c If UFT is not currently open, open UFT s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. Select File > Open > Solution. The Open Solution dilog ox opens. Nvigte to the Tutoril.ftsln file, locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. (You creted the MercuryTours test in step 3 of "Crete New Solution, Test, nd Actions" on pge 32.) Note: If you copy this pth, mke sure to replce <usernme> with your usernme. 2 Open the FlightFinder ction If the cnvs is not currently open, click the MercuryTours t in the document pne to ring it into focus. In the cnvs, doule-click the FlightFinder ction. The FlightFinder ction opens. 3 Lunch the Mercury Tours We site nd open the Flight Finder pge In Microsoft Internet Explorer, rowse to the Mercury Tours We site: The Mercury Tours home pge opens. 71

72 Lesson 5 Adding Steps In the Find Flight re, enter tutoril in oth the User Nme nd Pssword oxes nd click Sign-In. The Flight Finder pge opens. 72

73 Lesson 5 Adding Steps c In UFT, select Record > Record nd Run Settings. The Record nd Run Settings dilog ox opens. In the We t, select Record nd run test on ny open rowser nd click OK. This enles UFT to record on the open We pge. d e In UFT, click the Record utton. The recording toolr ppers, nd UFT egins recording. The UFT window disppers, nd your rowser displys the Flight Finder pge in the Mercury Tours We site. In the Mercury Tours Flight Finder We pge, chnge the following selections y selecting from the drop-down lists. (Do not use the clendr option.) Deprting From: New York On: Decemer 29 Arriving In: Sn Frncisco Returning: Decemer 31 73

74 Lesson 5 Adding Steps Note: If you re performing this tutoril in the month of Decemer, or on the 29th or the 31st of ny month, then select different month or dte while recording. This ensures tht the step is recorded, s UFT records n opertion only when you mke chnge in the ppliction. If you ccept defult vlue (or re-select the defult vlue), then UFT does not record this s n opertion. f g h Click CONTINUE to ccept the other defult selections. The Select Flight pge opens. On the Recording toolr, click Stop to stop the recording process. You hve now reserved n imginry ticket from New York to Sn Frncisco. UFT recorded your We rowser opertions from the time you clicked the Record utton in UFT until you clicked Stop on the Recording toolr. In UFT, select Record > Record nd Run Settings to restore the required run settings. The Record nd Run Settings dilog ox opens. In the We t: Select Open the following ddress when record or run session egins. Confirm tht the URL in the first ox is In the second ox, select rowser on which to run your test session. Microsoft Internet Explorer is the rowser used in this tutoril. Confirm tht Do not record nd run on rowsers tht re lredy open nd Close the rowser when the test closes re selected. 74

75 Lesson 5 Adding Steps Click OK to sve your chnges nd close the dilog ox. 4 Sve your test Click Sve. Do not close the test, ecuse you still wnt to dd steps to other ctions. Continue with "Add Step to the SelectFlight Action Using the Toolox Pne" on pge

76 Lesson 5 Adding Steps Add Step to the SelectFlight Action Using the Toolox Pne In "Add Steps to the FlightFinder Action y Recording" on pge 71, you dded steps to perform on the Mercury Tours Flight Finder pge. If you were to run your test t this point, the lst step would open the Select Flight pge in the Mercury Tours We site. For the purpose of this tutoril, you do not need to mke ny chnges in the Select Flight pge, ut you do need to instruct UFT to ccept the defult options nd continue to the next pge. Therefore, in this exercise, you will dd one step tht instructs UFT to click CONTINUE. You will drg the relevnt test oject into your ction from the Toolox Pne, which is nother wy of creting steps in your ction. Note: Toolox items re listed ccording to the ction in focus in the document re. If test or function lirry is in focus, or if you do not hve test open t ll, the Toolox Pne is empty. 1 Strt UFT nd open the MercuryTours test c If UFT is not currently open, open UFT s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. Click the Open utton down rrow, nd select Open Solution. The Open Solution dilog ox opens. Nvigte to the Tutoril.ftsln file, locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. (You creted the MercuryTours test in step 3 of "Crete New Solution, Test, nd Actions" on pge 32.) Note: If you copy this pth, mke sure to replce <usernme> with your usernme. 76

77 Lesson 5 Adding Steps 2 Open the SelectFlight ction In the Solution Explorer, doule-click the SelectFlight ction. If the Solution Explorer is not lredy open, open it y clicking the Solution Explorer utton. The SelectFlight ction opens. The Toolox pne works in oth the Editor nd the Keyword View, so there is no need to switch. 3 Disply the Toolox Pne Click the Toolox utton. 4 Select the oject tht represents the CONTINUE utton on the Select Flight We pge In the Toolox Pne, expnd the Test Ojects tree. Locte nd drg the reserveflights Imge oject into the ction, in either the Editor or the Keyword View. (The reserveflights Imge oject should e close to the top of the list of ojects.) Note: You my notice tht this oject repository hs mny more ojects thn the MercuryToursLogin repository. This is ecuse you did not delete extrneous ojects in Lesson 3, "Creting Oject Repositories." 77

78 Lesson 5 Adding Steps The selected Imge test oject is dded to the step, together with its defult method, Click. In the Keyword View, the Documenttion cell descries wht the step does in plin English. Agin, this step is displyed on three rows in the Keyword View ecuse the prent test ojects re prt of the step. In the Editor, the step is displyed s follows: Browser("Select Flight: Mercury").Pge("Select Flight: Mercury").Imge("reserveFlights").Click 5 Sve your test Select File > Sve. Do not close the test, ecuse you still wnt to dd steps to other ctions. Continue to dd steps, s descried in "Add Steps to the BookFlight Action Using the Editor nd Step Genertor" on pge 78. Add Steps to the BookFlight Action Using the Editor nd Step Genertor In "Add Step to the SelectFlight Action Using the Toolox Pne" on pge 76, you dded step to perform on the Mercury Tours Select Flight pge. If you were to run your test t this point, the lst step would open the Book Flight pge in the Mercury Tours We site. In this exercise, you will crete steps y copying nd psting content into the Editor, which is nother wy of creting steps in your ction. The psted steps do not include vlues. You will then insert vlues for ech step using the Keyword View. Finlly, you will use the Step Genertor to insert single step. The Step Genertor enles you to define n entire step in one dilog ox, insted of inserting different prts of step in the vrious columns of the Keyword View. 78

79 Lesson 5 Adding Steps 1 Strt UFT nd open the MercuryTours test If UFT is not currently open, open UFT s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. On the Strt pge, in the Recent solutions re, click Tutoril. The Tutoril solution opens, displying the MercuryTours test. (You creted the MercuryTours test in step 3 of "Crete New Solution, Test, nd Actions" on pge 32.) 2 Open the BookFlight ction In the Solution Explorer, doule-click the BookFlight ction. (If the Solution Explorer is not lredy open, open it y clicking the Solution Explorer utton.) The BookFlight ction opens. 3 Add steps to the BookFlight ction Click the Editor utton to disply the Editor. Copy the following steps nd pste them into the editor: Browser("Book Flight: Mercury").Pge("Book Flight: Mercury").WeEdit("pssFirst0").Set Browser("Book Flight: Mercury").Pge("Book Flight: Mercury").WeEdit("pssLst0").Set Browser("Book Flight: Mercury").Pge("Book Flight: Mercury").WeList("creditCrd").Select Browser("Book Flight: Mercury").Pge("Book Flight: Mercury").WeEdit("creditnumer").Set Browser("Book Flight: Mercury").Pge("Book Flight: Mercury").WeList("cc_exp_dt_mn").Select Browser("Book Flight: Mercury").Pge("Book Flight: Mercury").WeList("cc_exp_dt_yr").Select Browser("Book Flight: Mercury").Pge("Book Flight: Mercury").Imge("uyFlights").Click 79

80 Lesson 5 Adding Steps 4 Fill in the missing step detils Select View > Keyword View to disply the Keyword View. Look t the Documenttion column. Notice tht for ech step, either no documenttion is ville, or the documenttion indictes tht the step is clering text ox. This is ecuse the steps you just inserted re missing vlues. For exmple, in the first step, vlue needs to e filled in for the pssenger s first nme. The detils tht you need to dd re encircled in the following exmple. 80

81 Lesson 5 Adding Steps c In the Vlue cell for the relevnt step in the Keyword View, enter the following: For: pssfirst0 psslst0 creditcrd creditnumer cc_exp_dt_mn cc_exp_dt_yr Enter: Your first nme (or fictitious first nme) Your lst nme (or fictitious lst nme) Any of the following credit crd nmes: Americn Express MsterCrd (one word) Vis Discover Diners Clu Crte Blnche Any 8-digit numer. (This is fictitious credit crd numer.) Any month from 01 to 12. Mke sure tht you enter the vlue s two-digit numer. (This is the month prt of the credit crd expirtion dte.) Any yer from 2008 to 2010, s four-digit numer. (This is the yer prt of the credit crd expirtion dte.) Note: Notice tht quottion mrks re dded to the vlues you enter in the Vlue column fter you click outside of the cell. These quotes re necessry for the test to run correctly, nd indicte to UFT tht the vlue is string. If you go ck nd chnge vlue, you must dd these quottion mrks mnully, ecuse they re not utomticlly dded second time. 81

82 Lesson 5 Adding Steps 5 Add step using the Step Genertor to confirm the ooking nd return to the Home pge The lst step tht you psted into the BookFlight ction clicks SECURE PURCHASE in the Book Flight pge to complete the trnsction. During run session, this opens the Flight Confirmtion pge in the Mercury Tours We site. You will now use the Step Genertor to define step to return to the Mercury Tours Welcome pge. Click in the Item column elow the lst step to ensure tht the next step will e inserted fter the lst existing step in this ction. Scroll down to the ottom of the Item list nd select Step Genertor. The Step Genertor dilog ox opens. 82

83 Lesson 5 Adding Steps c Click the Select Oject utton. The Select Test Oject dilog ox opens. Expnd the Flight Confirmtion: Mercury node of the tree. Note: You my wnt to collpse the Book Flight: Mercury node of the tree to view the Flight Confirmtion: Mercury node. 83

84 Lesson 5 Adding Steps d Select the home Imge oject, nd click OK. The Step Genertor displys the defult options for the home test oject. Define the rguments nd vlues in the Step Genertor just s you would in the Keyword View columns: You use the Ctegory nd Oject drop-down lists to define the vlue in the Item column in the Keyword View. You use the Opertion drop-down lists to define the vlue in the Opertion column. In this step, the defult opertion for the home test oject, Click, is displyed in the Opertion ox. Although you could potentilly select different opertion for this test oject y clicking the down rrow, Click is the opertion needed for this step. You use the Arguments tle to define vlues for the rguments in the Vlue cell in the Keyword View. If ny of the rguments were mndtory, red sterisk would e displyed next to the rgument nme. In this step, there re no mndtory rguments, nd you do not need to define ny vlues. 84

85 Lesson 5 Adding Steps The Step documenttion ox displys the instruction for this step s it will e displyed in the Documenttion cell of the Keyword View. If you wnted to insert nother step fter this one, you could select the Insert nother step check ox to open the Step Genertor dilog ox gin fter dding this step. In this ction, this is the only step you need in, so there is no need to select this check ox. e Click OK. The Step Genertor closes nd the step is dded to the Keyword View. Click the Editor utton to disply the Editor. You cn see tht the sme step is displyed s follows: Browser("Flight Confirmtion: Mercury").Pge("Flight Confirmtion: Mercury").Imge("home").Click 6 Sve your test Click Sve. Congrtultions! You hve creted your first test nd re redy to run it. Continue with Lesson 6, "Running nd Anlyzing Tests." 85

86 Lesson 5 Adding Steps 86

87 6 Running nd Anlyzing Tests In Lesson 5, "Adding Steps," you dded steps to ech of your test ctions, nd you re now redy to run your test. When you run your test in this lesson, UFT opens the pproprite ppliction nd performs ech step in the test sequentilly. When UFT finishes running the test, it displys the results of the run. This lesson includes: Run Test on pge 87 Nvigting the Run Results Viewer on pge 91 Anlyze the Run Results on pge 93 Run Test In this exercise, you will run the test you prepred in "Adding Steps" on pge Strt UFT nd open the MercuryTours test If UFT is not currently open, open UFT s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. Select File > Open > Solution. The Open Solution dilog ox opens. 87

88 Lesson 6 Running nd Anlyzing Tests c Nvigte to the Tutoril.ftsln file, locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. (You creted the MercuryTours test in step 3 of "Crete New Solution, Test, nd Actions" on pge 32.) Note: If you copy this pth, mke sure to replce <usernme> with your usernme. 2 Configure UFT to sve ll imges to the run results UFT llows you to determine when to sve imges to the run results. In this lesson, ll imges should e sved to the run results. c Select Tools > Options > GUI Testing t > Screen Cpture node. Select the Sve still imge cptures to results checkox, nd then select Alwys from the drop-down menu. Click OK to close the Options dilog ox. 88

89 Lesson 6 Running nd Anlyzing Tests 3 Strt running your test In the Solution Explorer, select the MercuryTours test. Click the Run utton. The Run Test dilog ox opens. Click the Options r to expnd the Run Test Options re, nd verify tht New run results folder is selected. Accept the defult results folder nme. 89

90 Lesson 6 Running nd Anlyzing Tests c Click Run to close the Run dilog ox nd strt running the test. Wtch crefully s UFT opens your rowser nd strts running the test. In the rowser, you cn see UFT perform ech step you inserted; yellow rrow in the left mrgin of the Keyword View nd the highlighted row indicte the step tht UFT is running. If ny errors pper, go to the point in the test tht is indicted in the error messge, nd verify tht the step is configured s descried in the relevnt tsk in this tutoril. When the test run is complete, lern more out the run results, s descried in "Nvigting the Run Results Viewer" on pge 91 nd "Anlyze the Run Results" on pge

91 Lesson 6 Running nd Anlyzing Tests Nvigting the Run Results Viewer When UFT finishes running the test, the Run Results Viewer opens. Drg the pne orders s needed to clerly view ll populted pnes. 91

92 Lesson 6 Running nd Anlyzing Tests Initilly, the Run Results Viewer displys the following pnes: Run Results Tree pne. A grphicl representtion of the results in n expndle tree, orgnized ccording to the ctions nd the We pges visited during the test run. The steps performed during the run re represented y icons in the tree, which cn e expnded (rrow) to view ech step. You cn instruct UFT to run test or ction more thn once using different sets of dt in ech run. Ech run is clled n itertion, nd ech itertion is numered. (The test you rn hd only one itertion.) Result Detils pne. A high-level results overview report, contining generl informtion out the test, which steps pssed or filed, sttistics in pie chrt formt, nd so on. Cptured Dt pne. A still imge of the stte of your ppliction t prticulr step. This pne is only populted when you select step from the Run Results tree, nd the selected step hs recorded imge. Note: The Test Flow pne is n dditionl pne in the Run Results Viewer, nd is relevnt for API tests only. This pne is not populted for the current GUI test, nd you cn close it. For detils out API testing, see the HP Unified Functionl Testing User Guide. Your test run succeeded ecuse UFT ws le to nvigte the Mercury Tours site ccording to the steps tht you dded. If n error occurred nd your test did not run successfully, the error will e shown in the Run Results Viewer. In such cses, go ck nd mke sure tht the steps re configured exctly s descried in this tutoril. 92

93 Lesson 6 Running nd Anlyzing Tests Anlyze the Run Results In this exercise, you will inspect the steps UFT performed when running your test in "Run Test" on pge 87. You cn view snpshots of the ppliction window for ech step. 1 View the results for specific step In the results tree, use the rrow to expnd the MercuryTours Itertion 1 (Row 1) > FlightFinder Summry > Find Flight: Mercury > Find Flight: Mercury node to disply ll of the steps performed on the Flight Finder pge. In the run results tree, select fromport:select. 93

94 Lesson 6 Running nd Anlyzing Tests The Run Results Viewer now displys the following informtion: The Run Results Tree pne, with one step highlighted. The Result Detils pne, displying detils of the highlighted step. The Cptured Dt pne, showing screen cpture of the We pge on which the step ws performed UFT. When you click pge in the results tree, UFT displys the corresponding pge in the Cptured Dt pne. When you click step (n opertion performed on n oject) in the results tree, the corresponding oject is highlighted in the Cptured Dt pne. In this cse, the Deprting From text ox is highlighted. 2 Close the Run Results Viewer Select File > Exit. You hve now successfully creted nd run test tht reserves flight from New York to Sn Frncisco on the Mercury Tours We site. You cn enhnce your test y continuing with the following lessons: Lesson 7, "Creting Checkpoints nd Using Functions" Lesson 8, "Prmeterizing Steps nd Ojects" 94

95 7 Creting Checkpoints nd Using Functions In Lesson 6, "Running nd Anlyzing Tests," you rn test tht you d creted in previous lessons, to check tht series of steps performed on the Mercury Tours We site runs smoothly. Your test is now redy for dditionl enhncements, including checkpoints. A checkpoint verifies tht expected informtion is displyed in your ppliction while the test is running. In this lesson, you will insert checkpoints nd use function to check the vlidity of the some of the ojects in the Mercury Tours We site. This lesson includes: Understnding Checkpoint Types on pge 96 Crete Checkpoint Test on pge 98 Check Oject Vlues on pge 100 Check Pges on pge 104 Check Tle Vlues on pge 107 Check Text Vlues on pge 113 Mnge Checkpoints in the Oject Repository on pge 118 Run nd Anlyze Test with Checkpoints on pge 121 Perform Check Using Function on pge

96 Lesson 7 Creting Checkpoints nd Using Functions Understnding Checkpoint Types UFT offers the following types of checkpoints: Checkpoint Type Stndrd Checkpoint Imge Checkpoint Tle Checkpoint Pge Checkpoint Text Checkpoint Text Are Checkpoint Bitmp Checkpoint Dtse Checkpoint Description Checks vlues of n oject s properties. Checks the property vlues of n imge. (Select the Stndrd Checkpoint option nd then selecting to check We Imge oject.) Checks informtion in tle. (Select the Stndrd Checkpoint option nd then selecting to check ny tle oject.) Checks the chrcteristics of We pge. (Select the Stndrd Checkpoint option nd then selecting to check We Pge oject.) Checks tht text string is displyed in the pproprite plce in n ppliction. Checks tht text string is displyed within defined re in Windows-sed ppliction. Checks n re of n ppliction fter cpturing it s itmp. Checks the contents of dtses ccessed y n ppliction or We site. Exmple of Use Check tht rdio utton is selected. Check tht the imge source file is correct. Check tht the vlue in tle cell is correct. Check how long We pge tkes to lod or if We pge contins roken links. Check whether the expected text string is displyed in the expected loction in test oject. Check tht n re of dilog ox includes text tht ws entered in nother prt of the ppliction. Check tht We pge (or ny portion of it) is displyed s expected. Check tht the vlue in dtse query is correct. 96

97 Lesson 7 Creting Checkpoints nd Using Functions Checkpoint Type Description Exmple of Use Accessiility Checkpoint File Content Checkpoint XML Checkpoint Identifies res of We site to check for Section 508 complincy. Checks the text in document generted or ccessed during run session. Checks the dt content of XML documents. Check if the imges on We pge include ALT properties, required y the W3C We Content Accessiility Guidelines. Check tht the heders in dynmiclly-generted PDF file disply the regionl corporte hedqurters contct informtion correctly. Check the content of n element to mke sure tht its tgs, ttriutes, nd vlues hve not chnged. Note: XML file checkpoints re used to check specified XML file; XML ppliction checkpoints re used to check n XML document within We pge. You cn dd most checkpoints to your test either while inserting steps or while recording. The following sections explin how to crete some of the checkpoints descried ove, in the test you creted in "Add Steps to the Login Action" on pge 62. Note: When UFT cretes checkpoint, it ssigns nme sed on informtion inside the checkpoint the checked vlue, for exmple. The checkpoint nme remins unchnged, even if you susequently modify the informtion on which it ws sed. Keep this in mind when looking for checkpoints displyed in the Keyword View. Note lso, tht UFT my shorten the nme displyed in the Keyword View. 97

98 Lesson 7 Creting Checkpoints nd Using Functions For dditionl detils out checkpoints, see the HP Unified Functionl Testing User Guide. To dd checkpoints to your test, egin with "Crete Checkpoint Test" on pge 98. Crete Checkpoint Test In this exercise, you will sve the MercuryTours test tht you rn in Lesson 6, "Running nd Anlyzing Tests" s new test to crete your checkpoints. Checkpoints do not need to e mnged in seprte tests, nd you re only creting new test now for the ske of the tutoril. During your regulr working process, you cn dd checkpoints to ny test. 1 Strt UFT nd open the MercuryTours test If UFT is not currently open, open it s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. c Click the Open utton down rrow, nd select Open Solution. The Open Solution dilog ox opens. Nvigte to the Tutoril.ftsln file, locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. (You creted the MercuryTours test in step 3 of "Crete New Solution, Test, nd Actions" on pge 32.) Note: If you copy this pth, mke sure to replce <usernme> with your usernme. 2 Sve the test s Checkpoint In the Solution Explorer, select the MercuryTours test node, nd then select File > Sve As. In the Sve Test As dilog ox, rowse to the C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril directory, nd sve the test s Checkpoint. 98

99 Lesson 7 Creting Checkpoints nd Using Functions In the Solution Explorer, the MercuryTours test is replced y the new Checkpoint test. The MercuryTours test is still sved seprtely in the file system. 3 Add the MercuryTours test ck to the solution You cn hve oth the MercuryTours nd the Checkpoint tests open t the sme time if they re oth referenced from the sme solution. This enles you switch ck nd forth etween them if you wnt to compre or edit the tests. You cn only run single test t time. Select File > Add > Existing Test. Nvigte to the MercuryTours test locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Add. (You creted the MercuryTours test in step 3 of "Crete New Solution, Test, nd Actions" on pge 32.) Note: If you copy this pth, mke sure to replce <usernme> with your usernme. c The MercuryTours test ppers in the Solution Explorer. Tests re orgnized in the Solution Explorer lpheticlly. The solution is sved utomticlly. Continue with "Check Oject Vlues" on pge

100 Lesson 7 Creting Checkpoints nd Using Functions Check Oject Vlues In this exercise, you will dd stndrd checkpoint to the test you creted in "Crete Checkpoint Test" on pge 98, in the Book Flight ction. This checkpoint verifies the vlue entered in the ox contining the pssenger s first nme. Note: The Mercury Tours We site must e open to the pge you wnt to check efore you insert the checkpoint. 1 Strt UFT nd open the Checkpoint test If UFT is not currently open, open it s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. c On the Strt pge, in the Recent Solutions re, click Tutoril. The Tutoril solution opens. In the Solution Explorer, select the Checkpoint test node. (You creted the Checkpoint test in step 2 of "Crete Checkpoint Test" on pge 98.) 2 Disply the ction in which you wnt to dd checkpoint You wnt to dd checkpoint tht checks the property vlues of the First Nme edit ox fter the test utomticlly enters the pssenger s nme in the ox. In the cnvs, doule-click the BookFlight ction to open it. 3 Open the Mercury Tours ppliction to the Book Flight pge Log in to the Mercury Tours We site: In the User Nme nd Pssword oxes, enter tutoril. Click Sign-In. The Flight Finder pge opens. Enter flight detils. 100

101 Lesson 7 Creting Checkpoints nd Using Functions Chnge the following selections y selecting from the drop-down lists. (Do not use the clendr option.) Deprting From: New York On: Decemer 29 Arriving In: Sn Frncisco Returning: Decemer 31 Note: If you re performing this tutoril in the month of Decemer, or on the 29th or the 31st of ny month, select the sme vlues tht you selected in step 3 e of "Add Steps to the FlightFinder Action y Recording" on pge 71. c Click CONTINUE to ccept the other defult selections. The Select Flight pge opens. In the Select Flight pge, click CONTINUE to ccept the defult flight selections. The Book Flight pge opens. 4 Crete stndrd checkpoint If the Editor is displyed, click the Keyword View utton to disply the Keyword View. In the Item column, select the pssfirst0 row. 101

102 Lesson 7 Creting Checkpoints nd Using Functions c Select Design > Checkpoint > Stndrd Checkpoint. The Checkpoint Properties dilog ox opens.. The dilog ox displys the oject s properties: The Nme is the nme of the oject s defined in the HTML code of the We pge, in this cse pssfirst0. The Clss is the type of oject, in this cse WeEdit, indicting tht the oject is n edit ox. The ABC icon in the Type column indictes tht the vlue of the property is constnt. 102

103 Lesson 7 Creting Checkpoints nd Using Functions UFT recommends defult property checks for ech oject clss,. The tle elow descries the defult checks recommended for the WeEdit clss. Property Vlue Explntion html tg INPUT INPUT is the html tg s defined in the HTML source code. innertext In this cse, the vlue of innertext is empty. The checkpoint checks tht the vlue is empty. nme pssfirst0 pssfirst0 is the nme of the edit ox. type text text is the type of oject s defined in the HTML source code. vlue Currently, the vlue is empty. You need to enter the sme vlue tht you specified for the First Nme edit ox. d e In the Nme ox, enter CheckNme s the new checkpoint nme. Scroll down in the oject properties re nd select the row contining the property nmed vlue. You need to enter the vlue tht mtches the vlue you entered in the ctul step. To do this, click in the Constnt ox nd enter the vlue you defined s the pssenger s first nme, in step 4 c of "Add Steps to the BookFlight Action Using the Editor nd Step Genertor" on pge 78. Note: You cn see wht you entered y moving the Checkpoint Properties dilog ox so tht you cn view the Keyword View. The vlue tht you entered is listed in the Vlue column of the pssfirst0 row, in quotes. f In the Insert sttement re t the ottom of the Checkpoint Properties dilog ox, select After current step. This inserts the checkpoint fter the pssfirst0 Set... step. (This is the step in which the pssenger s first nme is entered in the First Nme ox.) 103

104 Lesson 7 Creting Checkpoints nd Using Functions g Accept the rest of the settings s defult nd click OK. UFT dds stndrd checkpoint step to your test elow the selected step. 5 Sve the test Click Sve. You cn use this process to insert mny checkpoints. Continue to enhnce your test y dding pge checkpoint, s descried in "Check Pges" on pge 104. Check Pges In this exercise, you will dd pge checkpoint to the test you creted in "Crete Checkpoint Test" on pge 98. The pge checkpoint checks tht the numer of links nd imges in the pge when you run your test is the sme s when UFT lerned the ojects on which you inserted steps in your test. 1 Strt UFT nd open the Checkpoint test If UFT is not currently open, open it s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. c Select File > Open > Solution. The Open Solution dilog ox opens. Nvigte to the Tutoril.ftsln file, locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. (You creted the Checkpoint test in step 2 of "Crete Checkpoint Test" on pge 98.) Note: If you copy this pth, mke sure to replce <usernme> with your usernme. d In the Solution Explorer, select the Checkpoint test node. 104

105 Lesson 7 Creting Checkpoints nd Using Functions 2 Locte the step where you wnt to dd pge checkpoint If the Checkpoint BookFlight ction is not lredy open, in the Solution Explorer, doule-click the BookFlight ction. The BookFlight ction opens. In the Item column of the Keyword View, locte the Book Flight: Mercury row. (This is the row directly ove the row displying pssfirst0.) 3 Crete pge checkpoint Right-click the Book Flight: Mercury row, nd select Insert Stndrd Checkpoint. The Pge Checkpoint Properties dilog ox opens. 105

106 Lesson 7 Creting Checkpoints nd Using Functions When you run the test, UFT checks the numer of links nd imges in the pge, nd the lod time, ginst those descried in the tle t the top of the dilog ox. The pge lod time my vry from computer to computer nd your lod time results my not mtch the ove imge. UFT lso checks the ctul trget URL of ech link nd the ctul source of ech imge. c d In the Nme ox, enter CheckLinks s the new checkpoint nme. Mke sure tht ll three check oxes re selected in the Type column in the tle t the top of the dilog ox. Accept the rest of the settings s defult nd click OK. UFT dds the pge checkpoint to your test. Becuse this is the first opertion on the Book Flight: Mercury pge, the opertion is dded directly to the existing Book Flight: Mercury pge node. It is displyed in the Keyword View s checkpoint opertion on the Book Flight: Mercury pge. 4 Sve the test Click Sve. Continue to enhnce your test y dding tle checkpoint, s descried in "Check Tle Vlues" on pge

107 Lesson 7 Creting Checkpoints nd Using Functions Check Tle Vlues In this exercise, you will dd tle checkpoint to the test you creted in "Crete Checkpoint Test" on pge 98. The tle checkpoint will check the cost of the outound flight, s displyed in the Book Flight: Mercury pge. 1 Strt UFT nd open the Checkpoint test If UFT is not currently open, open it s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. c Click the Open utton down rrow, nd select Open Solution. The Open Solution dilog ox opens. Nvigte to the Tutoril.ftsln file, locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. (You creted the Checkpoint test in step 2 of "Crete Checkpoint Test" on pge 98.) Note: If you copy this pth, mke sure to replce <usernme> with your usernme. d In the Solution Explorer, select the Checkpoint test node. 2 Locte the step where you wnt to dd tle checkpoint If the BookFlight ction is not lredy open, in the Solution Explorer, doule-click the BookFlight ction. The ction is displyed in the Keyword View. Select the pssfirst0 step (the step tht enters the pssenger s first nme into the First Nme edit ox). 3 Open the Mercury Tours We site to the Book A Flight pge c If it is not lredy open, log in to the Mercury Tours We site: newtours.demout.com In the User Nme nd Pssword oxes, enter tutoril. Click Sign-In. The Flight Finder pge opens 107

108 Lesson 7 Creting Checkpoints nd Using Functions d Enter flight detils. Chnge the following selections y selecting from the drop-down lists. (Do not use the clendr option.) Deprting From: New York On: Decemer 29 Arriving In: Sn Frncisco Returning: Decemer 31 Note: If you re performing this tutoril in the month of Decemer, or on the 29th or the 31st of ny month, select the sme vlues tht you selected in step 3 e of "Add Steps to the FlightFinder Action y Recording" on pge 71. e f Click CONTINUE to ccept the other defult selections. The Select Flight pge opens. In the Select Flight pge, click CONTINUE to ccept the defult flight selections. The Book Flight pge opens. 108

109 Lesson 7 Creting Checkpoints nd Using Functions 4 Configure UFT to record on the open rowser pge In UFT, select Record > Record nd Run Settings. The Record nd Run Settings dilog ox opens. Select Record nd run test on ny open rowser nd click OK to close the dilog ox. 5 Crete tle checkpoint c In the Book Flight pge of the Mercury Tours We site, under the flight deprture dte nd the Price text, highlight 270 (the fre price of the first leg etween New York nd Sn Frncisco). In UFT, click the Record utton. UFT egins recording session nd the UFT window is hidden. Disply the UFT window gin nd expnd it if you need to. 109

110 Lesson 7 Creting Checkpoints nd Using Functions d Select Design > Checkpoint > Stndrd Checkpoint. The UFT window is hidden, nd the pointer chnges into pointing hnd. Note: If you need to switch ck nd forth etween Welcome pge, UFT, or ny other window currently open, press CTRL to chnge the pointing hnd ck to regulr Windows pointer. Hold down the CTRL utton s long s you need the pointer, nd then relese it when you re redy to use the pointing hnd. Using the pointing hnd to click ojects tht you do not need my cuse errors in your test. e Click the highlighted string, 270. The Stndrd Checkpoint dilog ox opens, displying the oject hierrchy. f Select the second-to-lst item in the hierrchy (WeTle: New York to Sn Frncisco), nd click OK. The Tle Checkpoint Properties dilog ox opens, showing the rows nd columns of the tle. 110

111 Lesson 7 Creting Checkpoints nd Using Functions g Enter CheckCost s the new checkpoint nme in the Nme ox of the Tle Checkpoint Properties dilog ox. Note tht y defult, check mrks pper in ll cells. You cn doule-click cell to toggle the cell selection, or doule-click row or column heder to toggle the selection for ll the cells in the selected row or column. h i Doule-click ech column heder to cler the check mrks. Doule-click column 3, row 3 to check the vlue of this cell. (UFT checks only cells contining check mrks.) 111

112 Lesson 7 Creting Checkpoints nd Using Functions j Scroll through the rows nd columns to mke sure tht only the cell in column 3, row 3 is checked. If ny other cells re checked, doule-click them to remove the check. Tip: You cn chnge the column widths nd row heights y drgging the oundries of the column nd row heders. k Accept the rest of the settings s defult nd click OK. 6 Stop the recording session Click Stop to stop recording. UFT dds the tle checkpoint to your test. It is displyed in the Keyword View s new step under the Book Flight: Mercury pge. 7 Sve the test Click Sve. In "Check Text Vlues" on pge 113, you will need to nvigte to the next pge in the Mercury Tours We site the Flight Confirmtion pge. Therefore, you my wnt to keep the Mercury Tours We site open to the current pge. Continue to enhnce your test y dding text checkpoint, s descried in "Check Text Vlues" on pge

113 Lesson 7 Creting Checkpoints nd Using Functions Check Text Vlues In this exercise, you will dd text checkpoint to the test you creted in "Crete Checkpoint Test" on pge 98. The text checkpoint will check whether New York is displyed in the Flight Confirmtion pge. 1 Strt UFT nd open the Checkpoint test If UFT is not currently open, open it s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. c On the Strt pge, in the Recent Solutions re, click Tutoril. The Tutoril solution opens. In the Solution Explorer, select the Checkpoint test node. (You creted the Checkpoint test in step 2 of "Crete Checkpoint Test" on pge 98.) 2 Locte the pge where you wnt to dd text checkpoint In the Solution Explorer, doule-click the BookFlight ction. The BookFlight ction opens. If it opens in the Editor click the Keyword View utton to disply the Keyword View. In the Keyword View, highlight Flight Confirmtion: Mercury step (locted in the third to lst row, if you hve ll the steps fully expnded). 3 Open the Mercury Tours We site to the Flight Confirmtion pge Log in to the Mercury Tours We site: In the User Nme nd Pssword oxes, enter tutoril. Click Sign-In. The Flight Finder pge opens. Enter flight detils. Chnge the following selections y selecting from the drop-down lists. (Do not use the clendr option.) Deprting From: New York On: Decemer 29 Arriving In: Sn Frncisco Returning: Decemer

114 Lesson 7 Creting Checkpoints nd Using Functions Note: If you re performing this tutoril in the month of Decemer, or on the 29th or the 31st of ny month, select the sme vlues tht you selected in step 3 e of "Add Steps to the FlightFinder Action y Recording" on pge 71. c d Click CONTINUE to ccept the other defult selections. The Select Flight pge opens. In the Select Flight pge, click CONTINUE to ccept the defult flight selections. In the Book Flight pge, click SECURE PURCHASE. The Flight Confirmtion pge opens. 4 Configure UFT to record on the open rowser pge In UFT, select Record > Record nd Run Settings. The Record nd Run Settings dilog ox opens. Confirm tht Record nd run test on ny open rowser is selected nd click OK to close the dilog ox. 114

115 Lesson 7 Creting Checkpoints nd Using Functions 5 Crete text checkpoint c d In the Flight Confirmtion pge, under Deprting, highlight the text New York (include the spce fter it). If you need to, disply nd expnd the UFT window. In the UFT window, click the Record utton. UFT egins recording session, nd the Recording toolr opens. Select Design > Checkpoint > Text Checkpoint. The UFT window is hidden, nd the pointer chnges into pointing hnd. Note: If you need to switch ck nd forth etween Welcome pge, UFT, or ny other window currently open, press CTRL to chnge the pointing hnd ck to regulr Windows pointer. Hold down the CTRL utton s long s you need the pointer, nd then relese it when you re redy to use the pointing hnd. Using the pointing hnd to click ojects tht you do not need my cuse errors in your test. 115

116 Lesson 7 Creting Checkpoints nd Using Functions e Click the highlighted text string, New York. The Text Checkpoint Properties dilog ox opens. When Checked Text ppers in the list ox, the Constnt field displys the text string you highlighted. This is the text UFT looks for when running the test. f g In the Nme ox, enter CheckDeprtingText s the new checkpoint nme. Remove Sn Frncisco from the Checkpoint Summry pne, s follows: Click Configure to open the Configure Text Selection dilog ox. Highlight the to text string. (Do not highlight Sn Frncisco). 116

117 Lesson 7 Creting Checkpoints nd Using Functions Click Text After. Sn Frncisco chnges from lck to gry. Click OK to close the dilog ox. Sn Frncisco is removed from the text fter prt of the Checkpoint Summry pne. h Accept the rest of the settings s defult nd click OK. 6 Stop the recording session On the Recording toolr, click Stop to stop recording. UFT dds the text checkpoint to your test. It is displyed in the Keyword View s checkpoint opertion on the Flight Confirmtion: Mercury pge. 117

118 Lesson 7 Creting Checkpoints nd Using Functions 7 Mke sure tht the checkpoint is locted ove the home step Drg the new step up row if needed, to mke sure tht UFT does not click BACK TO HOME efore performing the checkpoint. In the Keyword View, the step should look s follows: 8 Sve the test Click Sve. Lern more out checkpoint mngement in "Mnge Checkpoints in the Oject Repository" on pge 118, nd then continue with "Run nd Anlyze Test with Checkpoints" on pge 121. Mnge Checkpoints in the Oject Repository In ddition to viewing checkpoints in specific ction, you cn lso view them in the oject repository nd modify their properties. If pplicle, you cn even use the sme checkpoint in more thn one loction. For exmple, if you wnt to verify tht your orgniztion s logo ppers on every pge in your ppliction, you cn crete checkpoint nd insert it in wherever steps open nother pge. For the purposes of this tutoril, you will not e reusing checkpoints. 1 Strt UFT nd open the Checkpoint test If UFT is not currently open, open it s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. Select File > Open > Solution. The Open Solution dilog ox opens. 118

119 Lesson 7 Creting Checkpoints nd Using Functions c Nvigte to the Tutoril.ftsln file, locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. (You creted the Checkpoint test in step 2 of "Crete Checkpoint Test" on pge 98.) Note: If you copy this pth, mke msure to replce <usernme> with your usernme. 2 Open the Oject Repository window In the Solution Explorer, doule-click the BookFlight ction. The BookFlight ction opens. Click the Oject Repository utton. The Oject Repository window opens, displying tree of ll test ojects nd ll checkpoint nd output ojects in the current ction. 119

120 Lesson 7 Creting Checkpoints nd Using Functions The tree includes ll locl ojects nd ll ojects in ny shred oject repositories ssocited with the ction. 3 Select n Action to view its checkpoints In the Action drop-down menu directly ove the tree, select n ction to disply its test ojects, checkpoint ojects, nd output vlue ojects. Close the Oject Repository Mnger window when you re done. Note: For the purposes of this tutoril, you do not need to modify ny oject properties. For detils out oject properties, see the HP Unified Functionl Testing User Guide. You re redy to run your test. Continue with "Run nd Anlyze Test with Checkpoints" on pge

121 Lesson 7 Creting Checkpoints nd Using Functions Run nd Anlyze Test with Checkpoints In this exercise, you will run the test you creted in "Crete Checkpoint Test" on pge 98, nd nlyze the checkpoint results. 1 Configure UFT to open the Mercury Tours We pge In UFT, select Record > Record nd Run Settings. The Record nd Run Settings dilog ox opens. Select Open the following ddress when record or run session egins nd click OK to close the dilog ox. 2 Strt running your test c Click the Run utton. The Run dilog ox opens. Ensure tht New run results folder is selected. Accept the defult results folder nme. Click OK. When the test run is completed, the Run Results Viewer opens. 3 View the run results When UFT finishes running the test, the Run Results Viewer opens. The run result should e Pssed, indicting tht ll checkpoints pssed. If one or more checkpoints hd filed, the run result would e Filed. 121

122 Lesson 7 Creting Checkpoints nd Using Functions 4 View the results of the pge checkpoint In the run results tree, expnd ll the child nodes of Checkpoint Itertion 1 (Row 1) until you rech Book Flight: Mercury, nd then select Checkpoint "CheckLinks". The Results Detils pne displys ll the detils of the pge checkpoint, including ll items checked. You cn drg the ottom of the Result Detils pne to enlrge it nd/or scroll within the pne to view ll of the checkpoint detils. Note: The lod time of the pge my vry from computer to computer nd your results my not mtch the imge elow. 122

123 Lesson 7 Creting Checkpoints nd Using Functions The checkpoint pssed ecuse the ctul vlues of the checked properties mtch the expected vlues. 5 View the results of the tle checkpoint In the results tree, expnd the Book Flight: Mercury > Acpulco to Acpulco node, nd then select Checkpoint "CheckCost" The Result Detils pne displys the detils of the tle checkpoint, nd the Cptured Dt pne displys the vlues of the tle cells: Cell vlues tht were checked re displyed in lck. Cell vlues tht were not checked re displyed in gry. 123

124 Lesson 7 Creting Checkpoints nd Using Functions The checkpoint pssed ecuse the ctul vlue of the checked cell mtches the expected vlue. 6 View the results of the stndrd checkpoint In the results tree, expnd the Book Flight: Mercury > pssfirst0 node, nd then select Checkpoint "CheckNme". The Results Detils pne displys the detils of the stndrd checkpoint, including the properties tht were checked nd their vlues. 124

125 Lesson 7 Creting Checkpoints nd Using Functions The checkpoint pssed ecuse the ctul vlues of the checked properties mtch the expected vlues. 7 View the results of the text checkpoint In the results tree, expnd Flight Confirmtion: Mercury nd highlight Checkpoint "CheckDeprtingText". The Results Detils pne displys the detils of the text checkpoint. The checkpoint pssed ecuse the ctul text mtches the expected text. 125

126 Lesson 7 Creting Checkpoints nd Using Functions 8 Close the Run Results Viewer Select File > Exit. You cn lso enhnce your test using function lirry. For detils, continue with "Perform Check Using Function" on pge 126. Perform Check Using Function In "Run nd Anlyze Test with Checkpoints" on pge 121, you used checkpoints to check vrious ojects in the Mercury Tours We site. In this exercise, you will use the function you creted in Lesson 4, "Creting Functions nd Function Lirries" to check the dte formt of We element in the SelectFlight ction. 1 If UFT is not currently open, strt UFT nd open the Checkpoint test c Open UFT s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. Click the Open utton down rrow, nd select Open Solution. The Open Solution dilog ox opens. Nvigte to the Tutoril.ftsln file, locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. (You creted the Checkpoint test in step 2 of "Crete Checkpoint Test" on pge 98.) Note: If you copy this pth, mke sure to replce <usernme> with your usernme. 126

127 Lesson 7 Creting Checkpoints nd Using Functions 2 Sve the test s Function In the Solution Explorer, select the Checkpoint test node, nd select File > Sve As. In the Sve Test As dilog ox, rowse to C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd sve the test s Function. In the Solution Explorer, the Checkpoint test is replced y the new Function test. The Checkpoint test is still sved seprtely in the file system. 3 Add the Checkpoint test ck to the solution You cn hve the MercuryTours, Checkpoint, nd Function test open t the sme time, if they re ll referenced from the sme solution. This enles you to switch ck nd forth etween them if you wnt to compre or edit the tests. You cn only run single test t time. Click the Add utton drop-down rrow, nd select Add Existing Test. Nvigte to the Checkpoint test, locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. (You creted the Checkpoint test in step 2 of "Crete Checkpoint Test" on pge 98.) Note: If you copy this pth, mke sure to replce <usernme> with your usernme. c The Checkpoint test ppers in the Solution Explorer. Tests re orgnized in the Solution Explorer lpheticlly. The solution is sved utomticlly. 4 Disply the Select Flight pge in The Mercury Tours We site Log in to the Mercury Tours We site: In the User Nme nd Pssword oxes, enter tutoril. Click Sign-In. The Flight Finder pge opens. 127

128 Lesson 7 Creting Checkpoints nd Using Functions Enter flight detils. Chnge the following selections y selecting from the drop-down lists. (Do not use the clendr option.) Deprting From: New York On: Decemer 29 Arriving In: Sn Frncisco Returning: Decemer 31 Note: If you re performing this tutoril in the month of Decemer, or on the 29th or the 31st of ny month, select the sme vlues tht you selected in step 3 e of "Add Steps to the FlightFinder Action y Recording" on pge 71. Click CONTINUE to ccept the other defult selections. The Select Flight pge opens. Notice the dte displyed in the DEPART re. The dte is in MM/DD/YYYY formt. 5 Add the 12/29/<current yer> oject to your repository c d In the UFT window, select Resources > Oject Repository Mnger. The Oject Repository Mnger window opens. In the Oject Repository Mnger, click Open, nd rowse to nd open the MercuryToursSelectFlight.tsr oject repository. Click Enle Editing to enle the repository for editing. Click the rowser window to mke the Mercury Tours We site ctive. 128

129 Lesson 7 Creting Checkpoints nd Using Functions e Lern the 12/29/<current yer> oject. From the Oject Repository Mnger, select Oject > Add Ojects. The Oject Repository Mnger window is minimized, nd the cursor chnges to pointing hnd. Note: If you need to switch ck nd forth etween Welcome pge, UFT, or ny other window currently open, press CTRL to chnge the pointing hnd ck to regulr Windows pointer. Hold down the CTRL utton s long s you need the pointer, nd then relese it when you re redy to use the pointing hnd. Using the pointing hnd to click ojects tht you do not need my cuse errors in your test. Click the text string 12/29/<current yer>. The Oject Selection - Add to Repository dilog ox opens. 129

130 Lesson 7 Creting Checkpoints nd Using Functions Mke sure tht the oject WeElement: 12/29/<current yer> is highlighted in the Oject Selection dilog ox. Click OK. The 12/29/<current yer> oject is dded to your repository. Note: If you re performing this tutoril in the month of Decemer, or on the 29th of ny month, use the sme vlues tht you selected in step 4 on pge 80. f Click Sve to sve the repository. 6 In UFT, disply the ction in which you wnt to dd function You wnt to dd function tht checks the innertext property vlues of the dte displyed in the SelectFlight ction. In the Solution Explorer, expnd the Function test node, nd doule-click the SelectFlight ction. 7 Pste steps in the Editor In this step, you will dd the check_dt_vlidity function defined in the ssocited function lirry to the SelectFlight ction. You creted this function lirry in Lesson 4, "Creting Functions nd Function Lirries." Click the Editor utton to disply the Editor In the Editor, plce your cursor efore the single existing step, nd pste the function shown elow. deprturedte=browser("select Flight: Mercury").Pge("Select Flight: Mercury").WeElement("12/29/ 2012").GetROProperty("innertext") if check_dt_vlidity( deprturedte ) then reporter.reportevent micpss, "Dte is vlid", deprturedte end if 130

131 Lesson 7 Creting Checkpoints nd Using Functions c d After you pste the steps, mke sure tht the originl step still strts on its own line fter the psted steps. If it does not, plce your cursor efore the step strts, t Browser("Select Flight: Mercury"), nd press Enter. You wnt the function to run efore UFT nvigtes to the next pge in the ppliction. In the first line of the function, insert the current yer. For exmple, if you re performing this tutoril in 2013, chnge 2012 to In the PDF version of this tutoril, the first line of the code reks cross two lines. If you re copying nd psting from the PDF, mke sure to remove the line rek fter 29/: so tht the first line of the code egins with deprturedte nd ends with ("innertext"). (The Pge prt should e displyed s: Pge("Select Flight: Mercury") with single spce etween Flight: nd Mercury.) Note: Additionlly, if you re performing this tutoril in the month of Decemer, or on the 29th of ny month, replce 12/29 with the deprture dte you selected in step 4 on pge Look t these steps in the Keyword View Select View > Keyword to disply the Keyword View. (The highlighted step is not prt of the function it is the step tht nvigtes to the next pge in the Mercury Tours We site.) 9 Sve your test Select File > Sve. 131

132 Lesson 7 Creting Checkpoints nd Using Functions 10 Strt running your test c Click the Run utton. The Run dilog ox opens. In the Run dilog ox, ensure tht New run results folder is selected. Accept the defult results folder nme. Click OK. When the test run is completed, the Run Results Viewer opens. 11 Anlyze the run results The run result should e Pssed, indicting tht the function pssed ecuse the dte is displyed in the expected formt, nd it contins cceptle vlues. For detils out the Run Results Viewer, see "Nvigting the Run Results Viewer" on pge 91 nd the HP Unified Functionl Testing User Guide. 132

133 Lesson 7 Creting Checkpoints nd Using Functions 12 Close the Run Results Viewer Select File > Exit to close the Run Results Viewer. Continue to enhnce your test y dding multiple sets of dt, s descried in Lesson 8, "Prmeterizing Steps nd Ojects." 133

134 Lesson 7 Creting Checkpoints nd Using Functions 134

135 8 Prmeterizing Steps nd Ojects In Lesson 6, "Running nd Anlyzing Tests," you rn test tht you creted in previous lessons, to check tht series of steps performed on the Mercury Tours We site runs smoothly. Even fter dding dditionl checks in Lesson 7, "Creting Checkpoints nd Using Functions,", you rn this test with only single set of dt. However, when you test your pplictions, you my wnt to see the sme opertions performed with multiple sets of dt. For exmple, you my wnt to run test on your We site using ten seprte sets of dt. You cn crete ten seprte tests, ech with its own set of dt, or you cn dd ten sets of prmeters to single test. If you dd the prmeters, your test will run ten times, ech time using different set of dt. In this lesson, you will dd prmeters to your test nd run your test with multiple sets of dt. This lesson includes: Prmeterizing n Action on pge 136 Crete Test for Prmeteriztion on pge 136 Define Dt Tle Prmeter on pge 138 Add Prmeter Vlues to Dt Tle on pge 141 Modify Steps Affected y Prmeteriztion on pge 145 Running nd Anlyzing Prmeterized Test on pge

136 Lesson 8 Prmeterizing Steps nd Ojects Prmeterizing n Action The Dt pne t the ottom of the UFT window in the ny test displys t for ech ction in the test, s well s Glol t. Note: If the Dt pne is not displyed, select View > Dt to disply it, or click the Dt utton. The Glol t is dt sheet whose dt is used for the entire test. If five rows of dt re displyed in the Glol dt tle, the test will run five times (five full itertions). In ddition, you cn crete dt sets for ech ction, using the relevnt ction sheet. If you prmeterize step using Dt pne prmeter from locl ction sheet nd enter five rows of dt in tht sheet, you cn define tht ction to run five times within one test itertion. UFT enles you to insert vrious types of prmeters. This tutoril introduces you to Glol Dt pne prmeters. For detils on other types of prmeters, see the HP Unified Functionl Testing User Guide. Crete Test for Prmeteriztion In Lesson 5, "Adding Steps," you reserved flight from New York to Sn Frncisco. In those steps, New York is constnt vlue, which mens tht New York is the deprture city ech time you run the test. In this exercise you will crete new test, in which you define the deprture city s prmeter, so tht you cn use different deprture city for ech test run. 1 Strt UFT nd open the Checkpoint test Open UFT s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. On the Strt pge, in the Recent Solutions re, click Tutoril. The Tutoril solution opens. The Checkpoint, Function, nd MercuryTours tests pper in the Solution Explorer. 136

137 Lesson 8 Prmeterizing Steps nd Ojects 2 Sve the test s Prmeter In the Solution Explorer, select the Checkpoint test node. (You creted the Checkpoint test in step 2 of "Crete Checkpoint Test" on pge 98.) Select File > Sve As. In the Sve Test As dilog ox, rowse to C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd sve the test s Prmeter. In the Solution Explorer, the Checkpoint test is replced y the new Prmeter test. The Checkpoint test is still sved seprtely in the file system. 3 Add the Checkpoint test ck to the solution You cn ll of your tests open t the sme time if they re oth referenced from the sme solution. This enles you switch ck nd forth etween them if you wnt to compre or edit the tests. You cn only run single test t time. Select File > Add > Existing Test. Nvigte to the Checkpoint test locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. (You creted this test in step 2 of "Crete Checkpoint Test" on pge 98.) Note: If you copy this pth, mke sure to replce <usernme> with your usernme. c The Checkpoint test ppers in the Solution Explorer. Tests re orgnized in the Solution Explorer lpheticlly. The solution is sved utomticlly. Continue with "Define Dt Tle Prmeter" on pge

138 Lesson 8 Prmeterizing Steps nd Ojects Define Dt Tle Prmeter In this exercise you will define the deprture city s prmeter, so tht you cn use different deprture city for ech test run. 1 Strt UFT nd open the Prmeter test c Open UFT s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. Select File > Open > Solution. The Open Solution dilog ox opens. Nvigte to the Tutoril.ftsln file, locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. (You creted the Prmeter test in step 2 of "Crete Test for Prmeteriztion" on pge 136.) Note: If you copy this pth, mke sure to replce <usernme> with your usernme. d In the Solution Explorer, select the Prmeter test node. 2 Mke sure tht the Dt Pne option is visile If you do not see the Dt pne t the ottom of the UFT window, select View > Dt. 3 Open the FlightFinder ction In the cnvs, doule-click the FlightFinder ction. The FlightFinder ction opens. If the Editor is displyed, select View > Keyword View to disply the Keyword View. 4 Select the text to prmeterize In the Keyword View, in the fromport row, click the Vlue cell nd then click the prmeteriztion utton. 138

139 Lesson 8 Prmeterizing Steps nd Ojects The Vlue Configurtion Options dilog ox opens. 5 Set the prmeteriztion properties Select the Prmeter rdio utton. This enles you to replce the constnt vlue (New York) with prmeter. Confirm tht the DtTle option is selected from the Prmeter drop-down menu. This mens tht the vlue of the prmeter will e tken from the UFT Dt pne. The Nme ox is enled nd displys p_item. Delete p_item nd enter deprture. Click OK to close the dilog ox. UFT dds the deprture prmeter to the Dt pne s new column nd inserts New York in the first row under it. 139

140 Lesson 8 Prmeterizing Steps nd Ojects New York will e the first of severl deprture cities tht UFT will use during test runs of the ppliction. Note the chnge in the step s ppernce in the Keyword View. Previously, the step ws displyed s fromport Select New York. Now, when you click the Vlue cell, the following informtion is displyed, indicting tht the vlue is prmeterized using Dt pne prmeter clled deprture: When you click nother re in the Keyword view, the step is displyed s: Continue with "Add Prmeter Vlues to Dt Tle" on pge

141 Lesson 8 Prmeterizing Steps nd Ojects Add Prmeter Vlues to Dt Tle As you sw in "Crete Test for Prmeteriztion" on pge 136, UFT displys prmeter vlues in the Dt pne. In this exercise, you will dd nother deprture city to the Dt pne (in the FlightFinder ction of the Prmeter test), so tht UFT cn test the ppliction with this dt. 1 Strt UFT nd open the Prmeter test c Open UFT s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. Click the Open utton down rrow, nd select Open Solution. The Open Solution dilog ox opens. Nvigte to the Tutoril.ftsln file, locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. (You creted the Prmeter test in step 2 of "Crete Test for Prmeteriztion" on pge 136.) Note: If you copy this pth, mke sure to replce <usernme> with your usernme. d In the Solution Explorer, select the Prmeter test node. 2 Open the FlightFinder ction In the Solution Explorer, doule-click the FlightFinder ction. 3 Enter n dditionl city in the deprture column In the Dt pne, click row 2 in the deprture column, enter London nd then press Enter. (If the Dt pne is not displyed, select View > Dt.) 141

142 Lesson 8 Prmeterizing Steps nd Ojects 4 Modify other steps ffected y prmeteriztion. In step 3, you dded prmeter vlues for the deprture city in the FlightFinder ction. In this step, you will modify the text checkpoint so tht UFT checks for the text tht mtches the current deprture city during the test run. Note: After prmeterizing one step in test, test ojects in other steps might e ffected when the vlue of the prmeterized step chnges. If so, you must modify the expected vlues of those ojects to mtch the vlue resulting from the prmeterized step. In the Solution Explorer, doule-click the Prmeter test BookFlight ction. The BookFlight ction opens. (If the Editor is displyed, click the Keyword View utton to disply the Keyword View.) Right-click the Flight Confirmtion: Mercury row with the existing CheckDeprtingText checkpoint nd select Checkpoint Properties. Note: You my need to expnd the Flight Confirmtion: Mercury step to see the row with the checkpoint. 142

143 Lesson 8 Prmeterizing Steps nd Ojects The Text Checkpoint Properties dilog ox opens. In the Checked Text re, New York is displyed in the Constnt ox. New York is the expected vlue for the checkpoint for every itertion. 143

144 Lesson 8 Prmeterizing Steps nd Ojects c Select the Prmeter rdio utton, nd then click the Prmeter Options utton. The Prmeter Options dilog ox opens. d e In the Nme ox, select deprture. This instructs the checkpoint to use the deprture prmeter vlues in the Dt pne for the expected results. Click OK to close the Prmeter Options dilog ox, nd then click OK gin to close the Text Checkpoint Properties dilog ox. The checkpoint is now prmeterized. 5 Sve the test Click Sve. Continue with "Modify Steps Affected y Prmeteriztion" on pge

145 Lesson 8 Prmeterizing Steps nd Ojects Modify Steps Affected y Prmeteriztion After prmeterizing one step in test, test ojects in other steps might e ffected when the vlue of the prmeterized step chnges. If so, you must modify the expected vlues of those ojects to mtch the vlue resulting from the prmeterized step. In "Add Prmeter Vlues to Dt Tle" on pge 141, you dded prmeter vlues for the deprture city in the FlightFinder ction. In this exercise, you will modify the text checkpoint so tht UFT checks for the text tht mtches the current deprture city during the test run. 1 Strt UFT nd open the Prmeter test c Open UFT s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. On the Strt pge, in the Recent Solutions re, click Tutoril. The Tutoril solution opens, displying the MercuryTours, Checkpoint, nd Prmeter tests. In the Solution Explorer, select the Prmeter test node. (You creted the Prmeter test in step 2 of "Crete Test for Prmeteriztion" on pge 136.) 2 Locte the text checkpoint to modify In the Solution Explorer, doule-click the Prmeter test BookFlight ction. The BookFlight ction opens. (If the Editor is displyed, click the Keyword View utton to disply the Keyword View.) Right-click the Flight Confirmtion: Mercury row with the existing checkpoint nd select Checkpoint Properties. Note: You my need to expnd the Flight Confirmtion: Mercury step to see the row with the checkpoint. 145

146 Lesson 8 Prmeterizing Steps nd Ojects The Text Checkpoint Properties dilog ox opens. In the Checked Text re, New York is displyed in the Constnt ox. New York is the expected vlue for the checkpoint for every itertion. 146

147 Lesson 8 Prmeterizing Steps nd Ojects 3 Prmeterize the text checkpoint Select Prmeter nd click the Prmeter Options utton. The Prmeter Options dilog ox opens. c In the Nme ox, select deprture. This instructs the checkpoint to use the deprture prmeter vlues in the Dt pne for the expected results. Click OK to close the Prmeter Options dilog ox, nd then click OK gin to close the Text Checkpoint Properties dilog ox. The checkpoint is now prmeterized. 4 Sve the test Select File > Sve or click Sve. You cn now run your test. Continue with "Running nd Anlyzing Prmeterized Test" on pge

148 Lesson 8 Prmeterizing Steps nd Ojects Running nd Anlyzing Prmeterized Test In "Modify Steps Affected y Prmeteriztion" on pge 145, you finished creting single dt set for the Prmeter test. In this exercise, you will run the modified Prmeter test. UFT will run the test twice, once for deprture from New York, nd second time for deprture from London. If you go ck nd dd dditionl prmeters in the Dt pne (such s dditionl deprture cities), dditionl itertions will e dded for ech dt set, ech represented y row in the dt tle. 1 Strt UFT nd open the Prmeter test c Open UFT s descried in step 1 on pge 32, mking sure tht only the We Add-in is loded. Select File > Open > Solution. The Open Solution dilog ox opens. Nvigte to the Tutoril.ftsln file, locted in C:\Documents nd Settings\<usernme>\My Documents\Unified Functionl Testing\Tutoril, nd click Open. The Tutoril solution opens, displying the MercuryTours, Checkpoint, nd Prmeter tests. Note: If you copy this pth, mke sure to replce <usernme> with your usernme. d In the Solution Explorer, select the Prmeter test node. (You creted the Prmeter test in step 2 of "Crete Test for Prmeteriztion" on pge 136.) 148

149 Lesson 8 Prmeterizing Steps nd Ojects 2 Configure UFT to open the Mercury Tours We pge In UFT, select Record > Record nd Run Settings. The Record nd Run Settings dilog ox opens. Select Open the following ddress when record or run session egins nd click OK to close the dilog ox. 3 Run the Prmeter test c Click the Run utton. The Run dilog ox opens. Select New run results folder nd ccept the defult results folder nme. Click OK. When the test run is completed, the Run Results Viewer opens. 149

150 Lesson 8 Prmeterizing Steps nd Ojects 4 Exmine the results summry The Run Results Viewer shows tht the itertions of the test pssed. Drill down in the run results tree to view the vrious results. 5 Close the Run Results Viewer Select File > Exit to close the Run Results Viewer. You ve now completed the exercises in this tutoril. Continue with pplying the concepts nd skills you lerned to testing your own pplictions, s descried in Lesson 9, "Where Do You Go From Here?." 150