HPE Unified Functional Testing

Transcription

1 HPE Unified Functinal Testing Sftware Versin: GUI Testing Tutrial fr Web Applicatins G t HELP CENTER ONLINE Dcument Release Date: Nvember 21, 2017 Sftware Release Date: Nvember 2017

2 HPE Unified Functinal Testing Legal Ntices Disclaimer Certain versins f sftware and/r dcuments ( Material ) accessible here may cntain branding frm Hewlett-Packard Cmpany (nw HP Inc.) and Hewlett Packard Enterprise Cmpany. As f September 1, 2017, the Material is nw ffered by Micr Fcus, a separately wned and perated cmpany. Any reference t the HP and Hewlett Packard Enterprise/HPE marks is histrical in nature, and the HP and Hewlett Packard Enterprise/HPE marks are the prperty f their respective wners. Warranty The nly warranties fr Hewlett Packard Enterprise Develpment LP prducts and services are set frth in the express warranty statements accmpanying such prducts and services. Nthing herein shuld be cnstrued as cnstituting an additinal warranty. HPE shall nt be liable fr technical r editrial errrs r missins cntained herein. The infrmatin cntained herein is subject t change withut ntice. Restricted Rights Legend Cnfidential cmputer sftware. Valid license frm HPE required fr pssessin, use r cpying. Cnsistent with FAR and , Cmmercial Cmputer Sftware, Cmputer Sftware Dcumentatin, and Technical Data fr Cmmercial Items are licensed t the U.S. Gvernment under vendr's standard cmmercial license. Cpyright Ntice Cpyright Hewlett Packard Enterprise Develpment LP Trademark Ntices Adbe is a trademark f Adbe Systems Incrprated. Micrsft and Windws are U.S. registered trademarks f Micrsft Crpratin. UNIX is a registered trademark f The Open Grup. HPE Unified Functinal Testing (14.02) Page 2 f 112

3 HPE Unified Functinal Testing Cntents HPE Unified Functinal Testing 1 Welcme t the UFT Tutrial fr GUI Testing 5 Intrducing Unified Functinal Testing - GUI Testing fr Web Applicatins 7 Benefits f Autmated GUI Testing 8 Testing Prcess 9 UFT Windw 10 Analyzing Yur Applicatin and Creating Actins 15 Getting t Knw Yur Applicatin 16 Explre the Mercury Turs Web Site 16 Creating Tests 18 Create a New Slutin, Test, and Actins 19 Creating Object Repsitries 24 Intrducing Test Objects and Object Repsitries 25 Learn Objects in Yur Applicatin 26 Use Multiple Object Repsitries 33 Creating Functins and Functin Libraries 37 Intrducing Functins 38 Create a Functin 38 Assciate the Functin Library with Yur Test 40 Adding Steps 41 Preparing t Add Steps t a Test 42 Add Steps t the Lgin Actin 42 Analyzing the Lgin Actin in the Keywrd View 47 Add the Remaining Steps t Yur Test 48 Add Steps t the FlightFinder Actin by Recrding 49 Add a Step t the SelectFlight Actin Using the Tlbx Pane 54 Add Steps t the BkFlight Actin Using the Editr and Step Generatr 55 Running and Analyzing Tests 63 Run a Test 64 Navigating the Run Results 66 Analyze the Run Results 66 HPE Unified Functinal Testing (14.02) Page 3 f 112

4 HPE Unified Functinal Testing Creating Checkpints and Using Functins 68 Understanding Checkpint Types 69 Create a Checkpint Test 70 Check Object Values 71 Check Pages 74 Check Table Values 77 Check Text Values 82 Manage Checkpints in the Object Repsitry 87 Run and Analyze a Test with Checkpints 88 Perfrm a Check Using a Functin 92 Parameterizing Steps and Objects 98 Parameterizing an Actin 99 Create a Test fr Parameterizatin 99 Define a Data Table Parameter 100 Add Parameter Values t a Data Table 102 Mdify Steps Affected by Parameterizatin 103 Running and Analyzing a Parameterized Test 105 Where D Yu G Frm Here? 108 Mdifying UFT Settings t Save Disk Space 109 Testing Yur Own Applicatin - Getting Started 109 Send Us Feedback 111 HPE Unified Functinal Testing (14.02) Page 4 f 112

5 Welcme t the UFT Tutrial fr GUI Testing The UFT Tutrial fr GUI Testing fr Web applicatins is a self-paced guide that teaches yu the basics f testing yur Web applicatin with UFT. It will familiarize yu with the prcess f creating and running autmated GUI tests and analyzing the run results. After cmpleting the tutrial, yu can apply the skills yu have learned t testing yur wn applicatin r Web site. Nte: T learn mre abut creating and running API tests, see the main Tutrial in the UFT Online Help.. Tutrial audience and scpe This tutrial is intended fr users wh are new t UFT. N prir knwledge f UFT is required, althugh a general understanding f testing cncepts and functinal testing prcesses may be helpful. UFT enables yu t create GUI tests, business prcess tests, and API tests. This tutrial reviews tpics related t GUI testing nly, and yu may ntice UI elements that are nt described here. These may be relevant fr BPT r API testing nly, and are nt relevant fr GUI testing at all. File system paths This tutrial refers t file system paths that are relevant fr Windws 7 perating systems. The paths in ther perating systems may be slightly different. Tutrial dem site This tutrial uses the legacy Mercury Turs dem site. By default, UFT nw sets yur Recrd and Run settings t the newer Advantage Online Shpping dem site. When using this tutrial, be sure t update the Recrd and Run Settings t pen when yu recrd r run yur test. Using UFT with BPT In additin t tests, UFT enables yu t create service and keywrd-driven business cmpnents fr use in business prcess tests, if yu are cnnected t an ALM server that supprts BPT. The prcedures described in this tutrial are designed fr creating GUI tests, but yu can als apply the majrity f these prcedures t creating keywrd-driven cmpnents. Fr mre details n business cmpnents and BPT, see the Unified Functinal Testing User Guide and the Business Prcess Testing User Guide. Nte: Unless therwise specified, references t Applicatin Lifecycle Management r ALM apply t all currently supprted versins f ALM and Quality Center. HPE Unified Functinal Testing (14.02) Page 5 f 112

6 Welcme t the UFT Tutrial fr GUI Testing Sme features and ptins may nt be supprted in the specific editin f ALM r Quality Center that yu are using. HPE Unified Functinal Testing (14.02) Page 6 f 112

7 Intrducing Unified Functinal Testing - GUI Testing fr Web Applicatins This lessn prvides yu with an verview f autmated GUI testing and UFT, and gets yu set up t perfrm the tutrial. Nte: We recmmend wrking with an sft cpy f this tutrial because there are sectins in which yu will be asked t cpy and paste test steps int UFT. Hwever, keep in mind that in selected parts f this tutrial, UFT will be recrding yur peratins r learning bjects that yu pint t with the muse. During such sessins, yu shuld refrain frm switching fcus t the PDF r Help windw. Yu can pen a PDF f this tutrial frm yur <Unified Functinal Testing installatin>\help flder. Yu can access the HTML versin f this tutrial, by selecting Help > UFT Help > UFT Tutrials > GUI Testing Tutrial fr Web Applicatins. This chapter includes: Benefits f Autmated GUI Testing 8 Testing Prcess 9 UFT Windw 10 HPE Unified Functinal Testing (14.02) Page 7 f 112

8 Benefits f Autmated GUI Testing If yu have ever tested applicatins r Web sites manually, yu are aware f the drawbacks f manual testing. Manual testing is time-cnsuming and tedius, and requires a heavy investment in human resurces. Wrst f all, time cnstraints ften make it impssible t manually test every feature thrughly befre the applicatin is released. This leaves yu wndering whether serius bugs have gne undetected. Autmated GUI testing with UFT addresses these prblems by dramatically speeding up the testing prcess. Yu can create tests that check all aspects f yur applicatin r Web site, and then run these tests every time yur site r applicatin changes. As UFT runs tests, it simulates a human user by mving the cursr in a Web page r applicatin windw, clicking GUI bjects, and entering keybard input. Hwever, UFT des all this faster than any human user. Benefits f Autmated Testing Fast Reliable Repeatable Prgrammable Cmprehensive Reusable Autmated tests are significantly faster than human users. Tests perfrm precisely the same peratins each time they are run, thereby eliminating human errr. Yu can test hw the Web site r applicatin reacts after repeated executin f the same peratins. Yu can prgram sphisticated tests that bring ut hidden infrmatin. Yu can build a suite f tests that cvers every feature in yur Web site r applicatin. Yu can reuse tests n different versins f a Web site r applicatin, even if the user interface changes. HPE Unified Functinal Testing (14.02) Page 8 f 112

9 Intrducing Unified Functinal Testing - GUI Testing fr Web Applicatins Testing Prcess The UFT testing prcess cnsists f the fllwing main phases: 1. Analyzing yur applicatin. The first step in planning yur test is t analyze yur applicatin t determine yur testing needs. What are yur applicatin's develpment envirnments? Yu will need t lad UFT add-ins fr these envirnments t enable UFT t identify and wrk with the bjects in yur applicatin. Examples f develpment envirnments include Web, Java, and.net. What business prcesses and functinality d yu want t test? T answer this, think abut the varius activities that custmers perfrm in yur applicatin t accmplish specific tasks. Hw can yu break yur test int small testable units and tasks? Yu shuld break the prcesses and functinality yu want t test int smaller tasks, s that yu can create UFT actins based n thse tasks. Smaller and mre mdular actins make yur tests easier t read and fllw, and help ease maintenance in the lng run. At this stage, yu can already begin creating test skeletns and adding actins. 2. Preparing the testing infrastructure. Based n yur testing needs, yu must determine what resurces are required and create these resurces accrdingly. Examples f resurces include shared bject repsitries, which cntain test bjects that represent bjects in yur applicatin, and functin libraries, which cntain functins that enhance UFT functinality. Yu als need t cnfigure UFT settings s that UFT will perfrm any additinal tasks yu may yu need, such as displaying a results reprt every time yu run a test. 3. Building yur tests and adding steps t each test. After the testing infrastructure is ready, yu can begin building yur tests. Yu can create ne r mre empty tests and add actins t them t create the testing skeletns. Yu assciate yur bject repsitries with the relevant actins, and assciate yur functin libraries with the relevant tests, s that yu can insert steps using keywrds. Yu can als add all yur tests t a single slutin. A slutin enables yu t stre, manage, and edit any related tests tgether, withut having t clse ne test befre pening anther. Yu may als need t cnfigure test preferences at this pint. 4. Enhancing yur test. Yu can test whether yur applicatin is functining crrectly by inserting checkpints int yur tests. Checkpints search fr a specific value f a page, bject, r text string. Yu can braden the scpe f yur test and test hw yur applicatin perfrms the same peratins with multiple sets f data. D this by replacing fixed values with parameters. HPE Unified Functinal Testing (14.02) Page 9 f 112

10 Intrducing Unified Functinal Testing - GUI Testing fr Web Applicatins Yu can add ther sphisticated checks t yur test by adding prgramming and cnditinal r lp statements and ther prgramming lgic t yur test using VBScript. This tutrial includes steps fr checkpints and parameters nly. Fr additinal details abut VBScript statements, see the Unified Functinal Testing User Guide. 5. Debugging, running, and analyzing yur test. Yu can debug yur test using debugging functinality t ensure that it perates smthly and withut interruptin. After the test is wrking crrectly, yu run it t check the behavir f yur applicatin. While running, UFT pens the applicatin and perfrms each step in yur test. Examine the run results t pinpint defects in yur applicatin. 6. Reprting defects. If yu have ALM installed, yu can reprt the defects yu discver t a database. ALM is the test management slutin. Fr details abut wrking with ALM, see the Applicatin Lifecycle Management User Guide. UFT Windw Befre yu begin creating tests, familiarize yurself with the main UFT windw. Take a few minutes t explre the cmpnents f the main UFT windw. Yu can then cntinue t analyze the applicatin yu will be testing in this tutrial, as described in "Analyzing Yur Applicatin and Creating Actins" n page 15. Dcument Types UFT displays pen dcuments in the dcument pane. Use the dcument tabs lcated just belw the tlbar t navigate t pen dcuments and bring them int fcus. The dcument pane can display the fllwing types f files: Tests. Yu can create, view, and mdify yur test in the Canvas, which enables yu t edit the flw f yur test, actin, r cmpnent. Actins r Business Cmpnents. Enables yu t create, view, and mdify yur actin r business cmpnent, in the fllwing views: Keywrd View. Cntains each step, and displays the bject hierarchy, in a mdular, icn-based table. Editr. Cntains each step as a VBScript line, displayed in a text and cde editr. In bject-based steps, the VBScript line defines the bject hierarchy. Functin Library. Enables yu t create, view, and mdify functins (peratins) fr use with yur test. Functin libraries pen as separate tabs in the dcument pane, similar t tests r actins. Applicatin Areas. Enables yu t edit the applicatin area settings and resurce assciatins. Start Page. Welcmes yu t UFT and prvides links t recent files, descriptins f new features, prduct frums, and ther supprt links. Yu can use the shrtcut buttns t pen new and existing dcuments. Prduct Mvies. Accessible frm the Start Page r Help menu, and teaches yu abut sme f the HPE Unified Functinal Testing (14.02) Page 10 f 112

11 Intrducing Unified Functinal Testing - GUI Testing fr Web Applicatins main UFT features using descriptive and instructinal vide. Internal Brwser Pages. Enables yu t pen internet pages fr frums and ther prduct related page, such as thse accessible frm the Start Page r the Help menu. Tlbars and Menus In additin t the dcument pane, the UFT windw cntains the fllwing key elements: Title bar. Displays the path f the current test r slutin. Menu bar. Displays menus f UFT cmmands. UFT tlbar. Cntains cmmnly used buttns t assist yu in designing yur testing dcuments. Fr details, see the Unified Functinal Testing User Guide. Panes Sme f the panes and tlbar ptins listed belw are described in detail in subsequent lessns. Fr details n ther panes and tlbar ptins, see the Unified Functinal Testing User Guide. Name Tlbar Buttn Descriptin Default Lcatin Slutin Explrer Tlbx Displays all the resurces assciated with yur current test, and enables yu t manage these resurces. Displays all the keywrds available t yur test, and enables yu t drag and drp bjects, r calls t functins, frm the Tlbx pane int yur test. A tab n the left side f the UFT windw. T display: Select View > Slutin Explrer. Click the Slutin Explrer buttn in the tlbar. A tab n the left side f the UFT windw. T display: Select View > Tlbx. Click the Tlbx buttn in the tlbar. HPE Unified Functinal Testing (14.02) Page 11 f 112

12 Intrducing Unified Functinal Testing - GUI Testing fr Web Applicatins Name Tlbar Buttn Descriptin Default Lcatin Dcument pane N/A Displays all pen dcuments. Each dcument has a tab that yu can click t bring the dcument int fcus. An unlabeled pane in the center f the UFT windw. Each dcument tab is labeled with the dcument name. T display: Open a testing dcument. Prperties Displays all prperties fr the currently selected test, actin, cmpnent, r applicatin area. A pane n the right side f the UFT windw. T display: Select View > Prperties. Click the Prperties buttn in the tlbar. Data Assists yu in parameterizing yur test. A tab at the bttm f the UFT windw. T display: Select View > Data. Click the Data buttn in the tlbar. Output N/A Displays infrmatin sent during the run sessin. A tab at the bttm f the UFT windw. T display: Select View > Output. Errrs N/A Displays a list f syntax errrs fund in yur test r functin library. Prvides a list f the resurces that are referenced in yur test but cannt be fund, such as missing Recvery Scenaris and missing Functin Libraries. A tab at the bttm f the UFT windw. T display: Select View > Errrs. Active Screen N/A Prvides a snapsht f yur applicatin as it appeared when yu perfrmed a certain step during a recrding sessin. A tab at the bttm f the UFT windw. T display: Select View > Active Screen. HPE Unified Functinal Testing (14.02) Page 12 f 112

13 Intrducing Unified Functinal Testing - GUI Testing fr Web Applicatins Name Tlbar Buttn Descriptin Default Lcatin Debug panes Assists yu in debugging yur test. The Debug panes include the Breakpints, Call Stack, Lcal Variables, Cnsle, and Watch panes. Tabs at the bttm f the UFT windw. Nt displayed by default. T display: Select View > Debug Click the Debug buttn in the tlbar, and then select the individual debug pane frm the drp-dwn list. Tasks N/A Displays and enables yu t manage the tasks defined fr the current test. Displays the TODO cmment steps f the test's actins r currently pen functin libraries. A tab at the bttm f the UFT windw. T display: Select View > Tasks. Search Results N/A Displays all ccurrences f the search criteria yu define in the Find dialg bx r using ther Search menu items. A tab at the bttm f the UFT windw. T display: Select View > Search Results. Perfrm a search. Bkmarks N/A Displays the lcatin f bkmarks in yur actin, scripted cmpnent, r functin library, and enables yu t navigate t these bkmarks. A tab at the bttm f the UFT windw. T display: Select View > Bkmarks. Accessing UFT in Windws 8.X r Higher Operating Systems By default, yu can access UFT directly frm the Start r Apps Screen in Windws 8.x r higher. In additin, yu can add UFT tls and files that were accessible frm the Start menu in previus versins f Windws t the Start screen, including: Applicatins (.exe files). Fr example: The Run Results Viewer All UFT tls, such as the Passwrd Encder and the License Validatin Utility HPE Unified Functinal Testing (14.02) Page 13 f 112

14 Intrducing Unified Functinal Testing - GUI Testing fr Web Applicatins The API testing sample Flight applicatins Nn-prgram files. Yu can access dcumentatin and the link t the Mercury Turs Website frm the Apps screen. Nte: By default, the Start and Apps screens n Windws 8.x r higher are set t pen Internet Explrer in Metr Mde. Hwever, if User Accunt Cntrl is turned ff n yur cmputer, Windws 8 will nt pen Internet Explrer in Metr mde. Therefre, if yu try t pen an HTML shrtcut frm the Start r Apps screen, such as the UFT Help r Readme file, an errr will be displayed. T slve this, yu can change the default behavir f Internet Explrer s that it never pens in Metr mde. In the Internet Prperties dialg bx > Prgrams tab, select Always in Internet Explrer n the desktp fr the Chse hw yu pen links ptin. Fr mre details, see and HPE Unified Functinal Testing (14.02) Page 14 f 112

15 Analyzing Yur Applicatin and Creating Actins "Intrducing Unified Functinal Testing - GUI Testing fr Web Applicatins" n page 7 gave yu an verview f autmated testing and UFT, and helped yu set up yur system t perfrm the tutrial. In this lessn, yu will analyze an applicatin t determine what needs t be tested, and yu will learn t create an actin in UFT. An actin is a lgical unit in yur test that fcuses n testing a particular part f yur applicatin. This chapter includes: Getting t Knw Yur Applicatin 16 Explre the Mercury Turs Web Site 16 Creating Tests 18 Create a New Slutin, Test, and Actins 19 HPE Unified Functinal Testing (14.02) Page 15 f 112

16 Getting t Knw Yur Applicatin Befre yu begin creating tests, yu must determine exactly what yu want t test in yur applicatin. T d this, yu need t analyze yur applicatin in terms f its business prcesses the distinct activities that custmers perfrm in yur applicatin t cmplete particular tasks. Fr the purpse f this tutrial, yu need t becme familiar with the Mercury Turs Web site. Mercury Turs is a sample web applicatin that simulates a web-based flight infrmatin and reservatin service. Yu can access the Mercury Turs Web site using any web brwser, but yu can perfrm the tutrial using nly Micrsft Internet Explrer. As yu navigate the site and familiarize yurself with its cntent, cnsider the fllwing: Hw is the applicatin rganized? Are there separate areas fr each activity? What are these areas? What are these activities? What are the expected utcmes fr each activity? What screens must be tested in each f these areas? What bjects need t be tested in each screen? What activities might be used in multiple scenaris? One example f such an activity is lgging n t the applicatin. Think f these activities as "reusable" parts. Analyzing yur applicatin in terms f its separate parts can help yu t design yur tests s that they cmprise small, mdular units, which are easier t understand, debug, and maintain ver time. What business prcesses might users perfrm using this applicatin? One scenari discussed in this tutrial is reserving flights. Other scenaris might include making cruise r htel reservatins, r even registering n the Web site. Which develpment envirnments need t be supprted fr testing purpses? UFT prvides addins t supprt many testing envirnments. Yu lad these add-ins when yu pen UFT. When wrking with this tutrial, yu need t lad the Web Add-in because Mercury Turs is a Web applicatin. Yur applicatin might require yu t lad Java r ther add-ins. Explre the Mercury Turs Web Site Open the Mercury Turs Web site and explre it fr a while. As yu navigate the site and familiarize yurself with its cntent, cnsider the questins psed in "Getting t Knw Yur Applicatin" abve. 1. Launch the Mercury Turs Web site. In Micrsft Internet Explrer, brwse t the Mercury Turs Web site: The Mercury Turs hme page pens. 2. Lg in t Mercury Turs. In the Find a Flight area, enter tutrial in bth the User Name and Passwrd bxes and click Sign-In. Nte: If yu are prmpted t have Internet Explrer remember the passwrd, click N. HPE Unified Functinal Testing (14.02) Page 16 f 112

17 Analyzing Yur Applicatin and Creating Actins The Flight Finder page pens. 3. Explre the Mercury Turs site. Beginning with the Flight Finder page, fllw the n-screen instructins t get flight infrmatin and reserve a flight. HPE Unified Functinal Testing (14.02) Page 17 f 112

18 Analyzing Yur Applicatin and Creating Actins As yu navigate the applicatin, think abut what yu might want t test, and which pages and bjects need t be included in each test that yu might create. Nte: On the Bk a Flight page, yu d nt have t fill ut actual persnal r credit card infrmatin; just enter the required infrmatin, indicated in red, in the Passengers and Credit Card sectins. Yu may enter fictitius infrmatin. 4. End yur Mercury Turs sessin and clse the brwser. a. When yu finish explring the Mercury Turs Web site, click LOG OUT n the Flight Cnfirmatin page r SIGN-OFF at the tp f any applicatin page. T sign n again, simply enter tutrial in the User Name and Passwrd bxes in the SIGN-ON page r in the Mercury Turs hme page. b. After lgging ut, clse the Internet Explrer windw. Yu are nw ready t use this tutrial t create tests n the Mercury Turs Web site using UFT. See "Creating Tests" belw fr details, and then cntinue with "Create a New Slutin, Test, and Actins" n the next page. Creating Tests Each UFT test includes calls t actins. Actins are units that divide yur test int lgical sectins. When yu create a new test, it cntains a call t ne actin. By dividing yur tests int calls t multiple actins, yu can design mre mdular and efficient tests. Yu can als grup yur tests accrding t functinality and stre them tgether in slutins. By adding tests and ther dcuments t slutins, yu can pen and edit the dcuments in the same UFT sessin withut having t pen, save, and clse each test as yu mdify it, and yu can share resurces acrss related tests. Internal and External Actins UFT lets yu insert several types f actins int tests. An internal actin is an actin that is stred in the lcal test (als knwn as a surce test). An external actin is a referenced call t an actin that is stred in a different test. Fr example, yu may have an actin that yu want t use in multiple tests yu wuld stre the actin as an internal actin in ne test and insert calls t that actin frm ther tests. In the ther tests the actin wuld be available as an external actin. Reusable Actins When yu insert a call t a new actin, it is reusable by default, enabling yu t insert calls t the actin frm any test. When wrking with reusable actins, yu nly need t update the existing actin stred with the riginal test. When yu mdify the riginal actin, all tests cntaining calls t the reusable actin are updated. Reusable actins are read-nly in the calling test, and yu mdify them in the test in which they are stred. HPE Unified Functinal Testing (14.02) Page 18 f 112

19 Analyzing Yur Applicatin and Creating Actins Reusable actins are especially useful when: Yu have a prcess that yu may need t include in several tests, such as lgging in t yur applicatin Yu may have a prcess that yu need t insert several times in the same test, such as filling in user credential dialg bxes that pen whenever a user tries t access a secure part f yur applicatin. If yu want t prevent an actin frm being reused in any test, yu can make it nn-reusable. Nnreusable actins are internal actins that can be used nly nce. Tip: If yu plan t use the same r similar actins in many tests, yu might cnsider creating a repsitry test t stre yur reusable actins. Then yu can insert calls t these existing actins frm ther tests, linking these actins t the surce test. Yu can stre the repsitry test in the same slutin as yur ther tests, enabling easier access t yur reusable actins. Cpied Actins Yu can als insert a cpy f an actin in yur tests if yu plan t make changes t the actin steps. This inserts the actin as an internal actin in the current test. Cpies f actins are nt linked t the surce test, s that when yu insert a call t a cpy f an existing actin, yu can make changes t the cpied actin, and yur changes will neither affect, nr be affected by, any ther test. Create a New Slutin, Test, and Actins In this exercise, yu will create a new slutin and test fr the Mercury Turs Web site that yu explred in "Explre the Mercury Turs Web Site" n page 16. The actins yu create in this exercise will be reused in subsequent lessns. 1. Start UFT. D ne f the fllwing: If UFT is nt currently pen: Duble-click the UFT icn n yur desktp r n the Start Screen (in Windws 8.x r higher) In Windws 7, select Start > All Prgrams > HPE Sftware > HPEUnified Functinal Testing. Nte: Fr details n accessing UFT and UFT tls and files in Windws 8.X r higher and Windws Server 2012, see "Accessing UFT in Windws 8.X r Higher Operating Systems" n page 13. In the Add-in Manager, cnfirm that the Web Add-in is selected, and clear all ther add-ins. Click OK t clse the Add-in Manager and pen UFT. HPE Unified Functinal Testing (14.02) Page 19 f 112

20 Analyzing Yur Applicatin and Creating Actins The UFT splash screen is displayed while UFT lads yur selected add-ins. This may take a few secnds. If UFT is already pen: Check which add-ins are laded by selecting Help > Abut HPE Unified Functinal Testing. The add-ins are listed under Installed Features. If the Web Add-in is nt laded, yu must exit and restart UFT. When the Add-in Manager pens, select the Web Add-in, and clear all ther add-ins. Nte: If the Add-in Manager des nt pen when starting UFT, select Tls > Optins. In the Startup Optins pane f the General tab, select Display Add-in Manager n startup. When yu exit and restart UFT, the Add-in Manager pens. 2. Explre the Start Page. The Start Page prvides links t recent files, infrmatin abut new features in this versin f UFT, as well as links t helpful supprt and cmmunity frums. In the tp-right crner f the page, yu can define ptins fr displaying and clsing the Start Page. If it is nt already displayed, in the Dcument Pane, click the Start Page tab. 3. Create a new test. a. Click the New buttn. By default, UFT assumes that yu want t create a new test, and the New Test dialg bx pens. b. Select GUI Test, ppulate the fields as fllws: Name: Enter MercuryTurs. Lcatin: Tests are autmatically saved at C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing, and yu d nt need t mdify this path. An example f a default test lcatin is C:\Dcuments and Settings\<username>\My Dcuments\Unified Functinal Testing. Slutin Name: Enter Tutrial. HPE Unified Functinal Testing (14.02) Page 20 f 112

21 Analyzing Yur Applicatin and Creating Actins c. Select Create directry fr slutin. The Slutin Lcatin value is autmatically updated with yur new directry. d. Click Create. A blank test pens, with the test flw displayed in the canvas, and a blank actin tab pened in the backgrund. The test name (MercuryTurs) and path are displayed in the title bar f the main UFT windw. In the Slutin Explrer, yu can see that the test is laded as part f the Tutrial slutin. Nte: If the Slutin Explrer is hidden, click the Slutin Explrer buttn View > Slutin Explrer t display it. r select 4. Rename Actin1 s that it has a lgical name. a. In the canvas, right-click the Actin1 image and select Actin Prperties. b. In the Actin Prperties dialg bx, in the Name bx, enter Lgin as the new name. In the message that pens, click Yes. HPE Unified Functinal Testing (14.02) Page 21 f 112

22 Analyzing Yur Applicatin and Creating Actins 5. Create a new actin named FlightFinder. a. Right-click anywhere in the canvas, and select Call t New Actin. The Insert Call t New Actin dialg bx pens. b. In the Name bx, enter FlightFinder, and cnfirm that bth Reusable Actin and At the end f the test are selected. c. Click OK. The dialg bx clses and the FlightFinder actin is added t the end f yur test. 6. Create calls t additinal actins. Add the fllwing actins t yur test: SelectFlight BkFlight Use the same steps yu used in the previus step t create the FlightFinder actin. Yur test nw cntains all f the actins needed t begin this tutrial. HPE Unified Functinal Testing (14.02) Page 22 f 112

23 Analyzing Yur Applicatin and Creating Actins 7. Save yur test. Click Save. Nte: Yu may have nticed that befre yu clicked save, an asterisk (*) was displayed in the MercuryTurs dcument tab and Slutin Explrer nde. Asterisks are displayed t indicate that yu have unsaved cntent, and disappear when yu save the file. When yu save a test, all test actins are saved t. 8. Explre the test flw in the canvas. Click the Mercury Turs tab in the dcument pane t view the entire test flw in the canvas. Yu can zm in r ut n the test flw using the muse r the zm bar lcated abve the canvas. Once the test flw is zmed in t the maximum, and n lnger fits in the canvas, yu can als use the minimap in the bttm left crner f the canvas t navigate thrugh the test flw. If the minimap is nt displayed, click the Minimap buttn abve the canvas t display it. The minimap can be helpful if yu have a test with many actins r nested actins. Yu can cntinue with creating test bjects fr use in yur test, as described in "Creating Object Repsitries" n page 24. Types f Actin Calls Yu can insert the fllwing types f actin calls t yur test: Calls t new actins. Inserts a new, empty actin in yur test. Calls t a cpy f an actin. Inserts a cpy f an existing actin in yur test. The actin is nt linked t the surce test r actin frm which yu cpied it. Call t an existing actin. Inserts a call t an existing actin in yur test. Yu can insert a call t an actin that is stred in the current test (if yu want t insert the same actin twice, fr example), r yu can insert a call t an actin frm anther test. The actin remains linked t the surce test frm which yu called it. HPE Unified Functinal Testing (14.02) Page 23 f 112

24 Creating Object Repsitries In "Analyzing Yur Applicatin and Creating Actins" n page 15 yu learned abut the Mercury Turs Web-based applicatin and determined what needs t be tested. Yu then created a slutin, test, and actins. This lessn intrduces test bjects and run-time bjects, and describes hw t create shared bject repsitries that yu can assciate with the actins in yur test. This chapter includes: Intrducing Test Objects and Object Repsitries 25 Learn Objects in Yur Applicatin 26 Use Multiple Object Repsitries 33 HPE Unified Functinal Testing (14.02) Page 24 f 112

25 Intrducing Test Objects and Object Repsitries Befre yu add steps t yur test, yu must set up the resurces that will be used by that test. One f the mst imprtant resurces fr any test is the bject repsitry. An bject repsitry is a strehuse fr the test bjects (and ther bject types) used in yur test. Run-Time Objects During a run sessin, UFT perfrms the peratins n the run time bjects in yur applicatin. Test bjects are stred representatins f the actual run time bjects (r cntrls) in yur applicatin. UFT creates test bjects by learning a select set f the prperties and values f the bjects in yur applicatin, and uses that data t uniquely identify bjects in yur applicatin during run time. Each test bject is part f a test bject hierarchy. Fr example, a Link bject may be part f a Brwser/Page/Link hierarchy. Tp-level bjects, such as Brwser bjects, are knwn as cntainer bjects, as they can cntain lwer-level bjects, such as Frame r Page bjects. In this lessn, yu will use the Object Spy dialg bx t view the prperties and peratins f bjects in yur applicatin. Object Repsitries UFT can stre the test bjects it learns in the fllwing types f bject repsitry files: Shared bject repsitries. Cntain test bjects that can be used in multiple actins. This versatility makes it the preferred repsitry type fr string and maintaining test bjects. By assciating a shared bject repsitry with an actin, yu make the test bjects in that repsitry available fr use in the actin. Any maintenance yu perfrm n an bject in a shared bject repsitry is reflected in all steps (within all actins) using that bject. Lcal bject repsitries. Cntain test bjects that can be used in ne specific actin. The bjects in this type f repsitry cannt be used in any ther actin. Lcal bject repsitries are useful fr backing up yur test bjects, r fr learning new bjects. During a run sessin, UFT references the test bjects stred in the assciated bject repsitries in rder t perfrm peratins n the crrespnding run time bjects in yur applicatin. When yu create an bject repsitry, try t include nly the bjects yu need fr testing purpses. This keeps the bject repsitry relatively small and helps t simplify maintenance and bject selectin. Als, make sure that yu prvide lgical names s that thers can easily select the crrect bjects when creating r mdifying tests. Nte: Object repsitries can als include checkpint and utput bjects. Checkpint bject types are cvered in "Creating Checkpints and Using Functins" n page 68. HPE Unified Functinal Testing (14.02) Page 25 f 112

26 Creating Object Repsitries Learn Objects in Yur Applicatin In this exercise, yu will create an bject repsitry fr use in the Lgin actin. Use the UFT Navigate and Learn ptin t add bjects frm the Mercury Turs Web site t a shared bject repsitry, and then assciate the bject repsitry with yur test. 1. Start UFT and pen the MercuryTurs test. a. If UFT is nt currently pen, pen UFT as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. On the Start page, in the Recent slutins area, click Tutrial. The Tutrial slutin pens, displaying the MercuryTurs test that yu created in "Create a New Slutin, Test, and Actins" n page 19.) 2. Set the learn settings fr UFT. a. Select Recrd > Recrd And Run Settings. The Recrd and Run Settings dialg bx pens. b. In the Web tab, select Open the fllwing address when a recrd r run sessin begins. c. In the first bx, enter the fllwing URL: In the secnd bx, select a brwser n which t run yur test sessin. Micrsft Internet Explrer is the brwser used in this tutrial. HPE Unified Functinal Testing (14.02) Page 26 f 112

27 Creating Object Repsitries d. Cnfirm that the fllwing ptins are selected: D nt recrd and run n brwsers that are already pen Clse the brwser when the test clses e. Click OK. Later, when yu run the test r recrd steps fr it, yur brwser will pen t the Mercury Turs Web site. When the recrd r run sessin ends, yur brwser will clse. 3. Open the Mercury Turs Web site. Open Internet Explrer and brwse t the Mercury Turs Web site: Ensure that the brwser windw is maximized. Nte: Be sure t pen a new Internet Explrer windw after UFT. If yu use a brwser that was already pen befre yu pened UFT, UFT may nt prperly recgnize the bjects in it. HPE Unified Functinal Testing (14.02) Page 27 f 112

28 Creating Object Repsitries 4. View the prperties and peratins fr sme f the bjects in the Mercury Turs Web site. a. In UFT, click the Object Spy tlbar buttn. The Object Spy dialg bx pens. b. Drag the Object Spy dialg bx t the right side f yur screen. This enables yu t see the bjects yu want t spy n mre clearly. Verify that the Keep Object Spy n tp while spying tggle buttn is pressed. c. Click the pinting hand buttn. UFT is hidden, and the Object Spy dialg bx is displayed ver the Mercury Turs Web site Welcme page. Tip: If yu need t switch back and frth between Welcme page, UFT, r any ther windw currently pen, press CTRL t change the pinting hand back t a regular Windws pinter. Hld dwn the CTRL buttn as lng as yu need the pinter, and then release it when yu are ready t use the pinting hand. d. Hver the muse cursr ver the varius bjects n the page and watch t see what happens in the Object Spy dialg bx. Nte: If UFT des nt recgnize yur bjects in the crrect lcatin, check t see that yu are viewing the page at 100%, and are nt zming in r ut f the page. Fr example, if yu view the page at 90% r 120%, yu may be required t click r select an area t the left r the right f the actual bject in rder t recgnize it. e. Psitin the muse cursr in the User Name edit bx (but d nt click it). The test bject hierarchy f that bject is displayed. In the hierarchy bx, ntice that the name f the bject is WebEdit, which is its bject class type. f. Click the User Name edit bx. UFT pens again. In the Object hierarchy bx, ntice that the bject class and name are nw selected (WebEdit:userName). g. Clse the Object Spy dialg bx. 5. Start the Navigate and Learn prcess by setting up the Define Object Filter. In this step, yu instruct UFT t learn nly the bjects that are needed fr yur test and add them t the bject repsitry. This helps keep bject repsitry maintenance t a minimum. a. In UFT, select Resurces > Object Repsitry Manager. The Object Repsitry Manager windw pens. HPE Unified Functinal Testing (14.02) Page 28 f 112

29 Creating Object Repsitries b. In the Object Repsitry Manager windw, select Object > Navigate and Learn. Bth UFT and the Object Repsitry Manager are hidden, and the Navigate and Learn tlbar appears. Nte: The first time yu use Navigate and Learn, a message bx displaying a tltip pens. Click OK t enable the Navigate and Learn tlbar. c. In the Navigate and Learn tlbar, click the Define Object Filter buttn. The Define Object Filter dialg bx pens. d. In the Define Object Filter dialg bx, select Selected bject types and then click Select. The Select Object Types dialg bx pens. HPE Unified Functinal Testing (14.02) Page 29 f 112

30 Creating Object Repsitries e. Click Clear All t clear all f the check bxes. Then select the EditBx and Image check bxes and click OK. f. In the Define Object Filter dialg bx, click OK. 6. Learn the selected bject types frm the Welcme page. In this step, yu instruct UFT t learn all f the bjects in the Mercury Turs Web site Welcme page that match the filter yu defined, and t add them t a shared bject repsitry. a. In the Mercury Turs Web site Welcme page, click the Welcme: Mercury Turs title tab t bring it int fcus as the Web page yu want UFT t learn. b. In the Navigate and Learn tlbar, click Learn. The Web page flickers and the Adding Objects message bx is displayed as UFT adds representatins f the bjects n the Web page t a new bject repsitry. Nte: Adding these bjects takes a few secnds. D nt interact with the Web page while Navigate and Learn runs. Navigate and Learn has finished adding the bjects t the bject repsitry when the flashing stps and the Adding Objects bx clses. Depending n the number f bjects in the page, UFT can ptentially take a lnger time t learn all the bjects. c. Clse the Navigate and Learn tlbar. UFT and the Object Repsitry Manager windw are visible again. HPE Unified Functinal Testing (14.02) Page 30 f 112

31 Creating Object Repsitries 7. Remve extra bjects frm the bject repsitry. In the previus step, UFT added all f the bjects that match yur filter selectin t the bject repsitry. Yu nly need a few bjects fr this test, s in this step, yu will delete the extraneus bjects. a. In the Object Repsitry Manager windw, expand the bjects in the Test Objects tree. Yu shuld see a list f bjects similar t the fllwing: b. Delete all f the test bjects except fr Sign-In (image), passwrd (edit bx), and username (edit bx). Select the bjects and press Delete. Click Yes in the cnfirmatin bx. Nte: Yu can select multiple bjects simultaneusly using the Shift and Ctrl keys. After yu delete the extraneus bjects, yur tree shuld resemble the fllwing: HPE Unified Functinal Testing (14.02) Page 31 f 112

32 Creating Object Repsitries Tip: If yu delete Sign-In, passwrd, r username by mistake, click Und the deleted bjects. t restre 8. See what UFT learned abut ne f the bjects. In the Test Objects tree, select the username bject, and ntice the bject prperties displayed in the right pane. These are the descriptive prperties that UFT will use t identify the bject during a run sessin. HPE Unified Functinal Testing (14.02) Page 32 f 112

33 Creating Object Repsitries 9. Save the bject repsitry. a. In the Object Repsitry Manager windw, click Save. The Save Shared Object Repsitry dialg bx pens. b. Brwse t the lcatin in which yu want t save yur bject repsitries, such as C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial. Create a new flder named Tutrial_ObjectRepsitries, and pen it. In the File Name bx, enter MercuryTursLgin and click OK. 10. Assciate the bject repsitry with the Lgin actin. Assciating an bject repsitry with an actin enables yu t use any bject frm that repsitry in any step in the assciated actin. a. Switch t the UFT windw. If the Slutin Explrer is nt already pen, pen it by clicking the Slutin Explrer buttn. b. In the Slutin Explrer, expand the MercuryTurs test nde. c. Right-click the Lgin actin and select Assciate Repsitry with Actin. The Open Shared Object Repsitry dialg bx pens. d. Click the MercuryTursLgin.tsr shared bject repsitry and click Open. e. In the dialg bx that pens, click Yes. The bject repsitry is nw assciated with the Lgin actin, and is displayed in the Slutin Explrer as a child f that actin. 11. Save yur test. Select File > Save <TestName>. Cngratulatins! Yu have created a shared bject repsitry fr the Welcme page f the Mercury Turs Web site, and assciated it with yur test's first actin. Cntinue with creating bject repsitries fr the ther actins in yur test and assciating them with the relevant actins, as described in "Use Multiple Object Repsitries" belw. Use Multiple Object Repsitries In "Learn Objects in Yur Applicatin" n page 26, yu created a shared bject repsitry fr the Welcme page f the Mercury Turs Web site. Nw, yu will create a shared bject repsitry fr each f the remaining pages in the site. Tip: We recmmend always creating a separate shared bject repsitry fr each page in yur Web site r each area f yur applicatin. This makes it easier t find the crrect bject when adding r mdifying test steps r when perfrming maintenance tasks. Fr the purpses f this tutrial, yu will instruct UFT t learn all f the bjects n each page. At this pint, yu d nt need t assciate the bject repsitries with a specific actin. HPE Unified Functinal Testing (14.02) Page 33 f 112

34 Creating Object Repsitries 1. Lg in t the Mercury Turs Web site Flight Finder page. a. If it is nt currently pen, pen Internet Explrer and brwse t the Mercury Turs Web site: b. In the User Name and Passwrd bxes, enter tutrial. c. Click Sign-In. The Flight Finder page pens. 2. Create a new shared bject repsitry. a. If the Object Repsitry Manager is clsed, pen it by selecting Resurces > Object Repsitry Manager in UFT. The Object Repsitry Manager windw pens. b. In the Object Repsitry Manager windw, click New. A blank shared bject repsitry pens. 3. Start the Navigate and Learn prcess by setting up the Define Object Filter. a. In the Object Repsitry Manager windw, select Object > Navigate and Learn. Bth UFT and the Object Repsitry Manager are hidden. b. In the Navigate and Learn tlbar, click the Define Object Filter buttn. The Define Object Filter dialg bx pens. c. In the Define Object Filter dialg bx, select All bject types and click OK. 4. Learn all f the bjects frm the Flight Finder page. In this step, yu instruct UFT t learn all f the bjects in the Mercury Turs Web site Flight Finder page that match yur filter, and t add them t a shared bject repsitry. a. In the Mercury Turs Web site Flight Finder page, click the Flight Finder: Mercury Turs title tab t bring it int fcus as the Web page yu want UFT t learn. b. In the Navigate and Learn tlbar, click Learn. The Web page flickers and the Adding Objects message bx is displayed as UFT begins adding representatins f the bjects n the Web page t a new bject repsitry. Nte: Adding these bjects takes a few secnds. D nt interact with the Web page while Navigate and Learn runs. HPE Unified Functinal Testing (14.02) Page 34 f 112

35 Creating Object Repsitries c. Clse the Navigate and Learn tlbar. UFT and the Object Repsitry Manager windw are visible again. 5. Save the shared bject repsitry. a. In the Object Repsitry Manager windw, click Save. The Save Shared Object Repsitry dialg bx pens. b. If yu need t, brwse t and pen the Tutrial_ObjectRepsitries flder. In the File Name bx, enter MercuryTursFlightFinder and click OK. 6. Create a new shared bject repsitry fr the Select Flight page. a. In the Mercury Turs Web site Flight Finder page, click Cntinue. The Select Flight page pens. Yu are nw ready t add bjects frm this page. b. Switch t the Object Repsitry Manager windw and click New. A blank shared bject repsitry pens. c. In the Object Repsitry Manager windw, select Object > Navigate and Learn. Bth UFT and the Object Repsitry Manager are hidden. d. In the Mercury Turs Web site Select Flight page, click the Select Flight: Mercury Turs title tab t bring it int fcus as the Web page yu want UFT t learn. e. In the Navigate and Learn tlbar, click Learn. The Web page flickers and the Adding Objects message bx is displayed as UFT begins adding representatins f the bjects n the Web page t a new bject repsitry. Nte: Adding these bjects takes a few secnds. D nt interact with the Web page while Navigate and Learn runs. f. Clse the Navigate and Learn tlbar. UFT and the Object Repsitry Manager windw are visible again. g. In the Object Repsitry Manager windw, click Save. The Save Shared Object Repsitry dialg bx pens. h. If yu need t, brwse t and pen the Tutrial_ObjectRepsitries flder. In the File Name bx, enter MercuryTursSelectFlight and click Save. 7. Create bject repsitries fr the remaining Web pages. a. Using the prcess described in step 6, create new shared bject repsitries fr each f the fllwing pages: Bk a Flight Flight Cnfirmatin b. Name the bject repsitries MercuryTursBkFlight and s, respectively. 8. Assciate the MercuryTursFlightFinder.tsr bject repsitry with the FlightFinder actin. a. Switch t the UFT windw. If the Slutin Explrer is nt already pen, pen it by clicking the Slutin Explrer buttn. HPE Unified Functinal Testing (14.02) Page 35 f 112

36 Creating Object Repsitries b. In the Slutin Explrer, right-click the FlightFinder actin and select Assciate Repsitry with Actin. The Open Shared Object Repsitry dialg bx pens. c. Click the MercuryTursFlightFinder.tsr shared bject repsitry and click Open. d. In the dialg bx that pens, click Yes The bject repsitry is nw assciated with the FlightFinder actin, and is displayed in the Slutin Explrer as a child f that actin. 9. Assciate the remaining bject repsitries with the relevant actins. Assciate the SelectFlight actin with the MercuryTursSelectFlight.tsr. Assciate the BkFlight actin with the fllwing repsitries: MercuryTursBkFlight.tsr MercuryTursFlightCnfirmatin.tsr Later, when yu add steps t each actin, all f the required test bjects will be available fr use. 10. Save yur test. Click Save. Cntinue setting up yur test infrastructure by adding additinal resurces t yur test, as described in "Creating Functins and Functin Libraries" n page 37. HPE Unified Functinal Testing (14.02) Page 36 f 112

37 Creating Functins and Functin Libraries UFT prvides built-in functins and methds that will satisfy many f yur testing needs. Hwever, there may be times when yu need t perfrm a task that is nt available by default fr a particular test bject class. Yu can create a user-defined functin t perfrm this task, save it in a functin library file, and then insert it as a step every time that yu need t perfrm this task. In "Creating Object Repsitries" n page 24, yu created shared bject repsitries and assciated them with the actins in yur test. In this lessn, yu will create a functin and functin library, and assciate the functin library with yur entire test. Assciating a functin library with a test enables yu t call any f the functins in the functin library frm that test. This chapter includes: Intrducing Functins 38 Create a Functin 38 Assciate the Functin Library with Yur Test 40 HPE Unified Functinal Testing (14.02) Page 37 f 112

38 Intrducing Functins A functin is a set f cded steps that perfrm a particular task fr which n suitable methd exists by default. Yu may want yur test t include such a task, and even repeat this task several times. Therefre, yu want the functin t be easily accessible. Fr example, yu may want t create a step that generates a text file and saves it t the file system, r that accesses data frm a Micrsft Excel wrksheet. In this lessn, yu will create a functin that checks the date frmat n a page generated by the Mercury Turs Web site, and then add the functin t yur test. Begin with "Create a Functin" belw. Create a Functin In this exercise, yu will create a functin that yu will later call frm yur test. This functin checks whether a date is displayed in MM/DD/YYYY frmat. The functin als verifies that the date is ptentially valid, fr example, that the mnth des nt exceed 12 r that the date des nt exceed Start UFT and pen the MercuryTurs test. a. If UFT is nt currently pen, pen UFT as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. Select File > Open > Slutin. The Open Slutin dialg bx pens. c. Navigate t the Tutrial.ftsln file, lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Open. (Yu created the MercuryTurs test in "Create a New Slutin, Test, and Actins" n page 19.) 2. Create a new functin library. a. Click New dwn arrw and select New Functin Library. The New Functin Library dialg bx pens. Nte: If yu simply clicked the New buttn, and nt the New buttn dwn arrw, the New Test dialg bx pens instead. b. In the New Functin Library dialg bx, ppulate the fields as fllws: Lk in: Brwse t the C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial directry, create a new flder named Tutrial_FunctinLibraries, and pen it t define it as the functin library lcatin. (If yu cpy this path, make sure t replace <username> with yur username.) File name: Enter CheckDateFunctin. c. Click Create. The blank functin library pens in the dcument pane. 3. Cpy the fllwing functin and paste it int the editr. 'The fllwing functin checks whether a date string (datestr) HPE Unified Functinal Testing (14.02) Page 38 f 112

39 Creating Functins and Functin Libraries 'has 10 characters representing MM/DD/YYYY Functin check_data_validity( datestr ) Dim firstslashps, secndslashps Dim mmpart, ddpart, yyyypart firstslashps = instr( datestr, "/" ) secndslashps = instrrev( datestr, "/" ) If ( firstslashps <> 3 r secndslashps <> 6 ) Then reprter.reprtevent micfail,"frmat check", "Date string is missing at least ne slash ( / )." check_data_validity = False Exit functin End If mmpart = mid( datestr, 1,2 ) ddpart = mid ( datestr, firstslashps+1, 2 ) yyyypart = mid( datestr, secndslashps +1, 4 ) If mmpart > 12 Then reprter.reprtevent micfail, "Frmat Check", "The mnth value is invalid. It exceeds 12." check_data_validity = False Exit functin End If If ddpart > 31 Then reprter.reprtevent micfail, "Frmat Check", "The date value is invalid. It exceeds 31." check_data_validity = False Exit functin End If If yyyypart < 2000 Then reprter.reprtevent micfail, "Frmat Check", "The year value is invalid. (Prir t 2000)" check_data_validity = False Exit functin End If check_data_validity = True End Functin Nte: If yu cpy and paste the abve cde as-is, there will be line breaks splitting up the cmmands at the end f the lines starting with reprter. If yu try t run this cde, the UFT's cmpiler will generate an errr fr each instance f this line break. Therefre, at the end f each brken line in the cde, press Delete t eliminate the break. HPE Unified Functinal Testing (14.02) Page 39 f 112

40 Creating Functins and Functin Libraries 4. Click Save. 5. Save the functin library. 6. Clse the functin library. Select File > Clse. Cntinue wrking with yur functin library, as described in "Assciate the Functin Library with Yur Test" belw. Assciate the Functin Library with Yur Test In "Create a Functin" n page 38, yu created a functin library with a single functin. In this exercise, yu will assciate the functin library with yur test s that its functin will be available t yur test. 1. Start UFT and pen the MercuryTurs test. a. If UFT is nt currently pen, pen UFT as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. Click the Open buttn dwn arrw, and select Open Slutin. The Open Slutin dialg bx pens. c. Navigate t the Tutrial.ftsln file, lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Open. (Yu created the MercuryTurs test in "Create a New Slutin, Test, and Actins" n page 19.) 2. Assciate the CheckDateFunctin.qfl with the MercuryTurs test. a. If the Slutin Explrer is nt already pen, pen it by clicking the Slutin Explrer buttn. b. In the Slutin Explrer, right-click the MercuryTurs test nde and select Add > Assciate Functin Library. The Open Functin Library dialg bx pens. c. Lcate and pen the CheckDateFunctin.qfl functin library. In the Autmatic Relative Path Cnversin dialg bx, click Yes. This cnverts the path t a relative path. The functin library is nw assciated with the MercuryTurs test, and is displayed in the Slutin Explrer as a child f the MercuryTurs test nde. Nte: Using a relative path keeps the path valid when yu mve flders cntaining tests and ther files frm ne lcatin t anther, as lng as the flder hierarchy remains the same. 3. Save the test. Select the MercuryTurs dcument tab, and then click Save. All the resurces required fr yur test are nw set up, and yu can cntinue t ppulate yur test, as described in "Adding Steps " n page 41. HPE Unified Functinal Testing (14.02) Page 40 f 112

41 Adding Steps In "Analyzing Yur Applicatin and Creating Actins" n page 15, yu created unique actins fr mst f the pages in the Mercury Turs Web site and added them t yur test. In ther lessns, yu created ther parts f the required autmatin infrastructure, such as bject repsitries and functin libraries. In this lessn, yu will add steps t the actins in yur test. This chapter includes: Preparing t Add Steps t a Test 42 Add Steps t the Lgin Actin 42 Analyzing the Lgin Actin in the Keywrd View 47 Add the Remaining Steps t Yur Test 48 Add Steps t the FlightFinder Actin by Recrding 49 Add a Step t the SelectFlight Actin Using the Tlbx Pane 54 Add Steps t the BkFlight Actin Using the Editr and Step Generatr 55 HPE Unified Functinal Testing (14.02) Page 41 f 112

42 Preparing t Add Steps t a Test Befre yu add steps t a test, ensure that yur applicatin and UFT are set t match the needs f yur test. Fr the purpses f this tutrial: 1. Set the relevant Internet Explrer ptins and clse all brwsers. In Micrsft Internet Explrer, clear the AutCmplete ptin fr all frms, user names, and passwrds (select Tls > Internet Optins > Cntent tab > AutCmplete Settings). Clse all brwser windws. 2. Set the relevant UFT Web Page/Frame ptins. a. If UFT is nt currently pen, pen it as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. If yu d nt currently have a test pen, pen a recent test r create a dummy test. T create a dummy test, click New, and create a new test using the default values in the New Test dialg bx. Yu d nt need t save this test. Nte: Yu must have a test r cmpnent pen in UFT in rder t see the Web nde in the Optins dialg bx. c. Select Tls > Optins > GUI Testing tab > Web > Page/Frame Optins nde. d. In the Create a new Page test bject fr area, select Different URLs r a change in data transfer and select the first fur check bxes. Click OK. Yu are nw ready t start adding steps t yur actins. Begin with "Add Steps t the Lgin Actin" belw. Add Steps t the Lgin Actin Each peratin perfrmed by UFT n an applicatin is represented by a step in yur actin. Fr example, a step might click an image r insert a value int an edit bx. In this exercise, yu will make a reservatin fr a flight frm New Yrk t San Francisc n the Mercury Turs Web site, adding steps in varius ways. After yu add steps t the first actin, yu will analyze the steps t learn mre abut the Keywrd View. 1. Start UFT and pen the MercuryTurs test. a. If UFT is nt currently pen, pen it as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. On the Start page, in the Recent slutins area, click Tutrial. The Tutrial slutin pens, displaying the MercuryTurs test yu created in "Create a New Slutin, Test, and Actins" n page Open the Lgin actin and display the Keywrd View. a. If the canvas is nt currently pen, click the MercuryTurs tab in the dcument pane t bring it int fcus. HPE Unified Functinal Testing (14.02) Page 42 f 112

43 Adding Steps b. In the canvas, duble-click the Lgin actin. The Lgin actin pens. c. If the Editr is displayed, click the Keywrd View buttn t display the Keywrd View. 3. Add the first step t lg in t the Mercury Turs Web site. a. In the Keywrd View, in the Item clumn, click the New Step buttn. The Item list pens, displaying the tp-level (parent) test bject in the assciated bject repsitry, and instructing yu t select an item. In this step, the parent test bject is the Welcme: Mercury Turs brwser bject. D nt select this brwser bject because yu d nt want t perfrm an peratin n the main brwser windw. Yu nly need t insert steps n the bjects n which yu want t perfrm peratins. b. Select Object frm repsitry t pen the Select Test Object dialg bx. HPE Unified Functinal Testing (14.02) Page 43 f 112

44 Adding Steps c. Expand the test bject tree. d. Select username and click OK. The Select Object fr Step dialg bx clses and ne step is added t the actin. Nte that three rws are added t the Keywrd View. UFT adds a rw fr each f the parent test bjects, even thugh it des nt perfrm an peratin n these bjects. These rws are part f the path t the bject upn which the step is perfrmed. During a run sessin, UFT uses the parent bjects t identify the actual bject n which it needs t perfrm an peratin. HPE Unified Functinal Testing (14.02) Page 44 f 112

45 Adding Steps In this step, represented by the last f the three new rws: The selected username WebEdit test bject is added t the Item cell. The default methd, Set, is added t the Operatin cell. Text is added t the Dcumentatin cell indicating that this step clears the text in the edit bx. This is because the step is still missing a required value in the Value cell, and needs t be updated with the username. e. In the Value cell, enter tutrial. Inserting this value cmpletes the step. When yu click anther area in the Keywrd View, the dcumentatin fr this step is updated in the Dcumentatin cell. Tip: Qutes are autmatically added arund the value yu entered in the Value clumn, indicating that this is a String value. If the methd supprted an Index value, and yu entered an Index value, n qutes wuld be added. f. Select View > Editr t display the Editr, which displays the syntax f the step in VBScript. Brwser("Welcme: Mercury Turs").Page("Welcme: Mercury Turs").WebEdit ("username").set "tutrial" Ntice that this step is being perfrmed n a WebEdit (edit bx) test bject, named username, and that: The test bject hierarchy fr the WebEdit (edit bx) test bject is displayed prir t the test bject. In this step the hierarchy includes a Brwser bject and a Page bject. The methd t be perfrmed n the bject is displayed immediately after the test bject. In this step, the methd is Set. The text t enter in the username edit bx is displayed immediately after the Set methd. The text is displayed in qutes, which indicate that this value is a string. In this step, the text t enter is tutrial. Full stps (perids) separate each part f the step. g. Click the Keywrd View buttn t return t the Keywrd View. HPE Unified Functinal Testing (14.02) Page 45 f 112

46 Adding Steps 4. Add the next step. a. Click in the Item clumn, directly belw the username rw. The Item list pens, listing the sibling bjects f the previus step's test bject. b. Select passwrd frm the Item list. This time, nly ne new rw is added because the bject shares the same parent bjects as the previus step. In this step: The passwrd WebEdit test bject is added t the Item cell. The default methd, Set, is added t the Operatin cell. Yu need t change this methd because the passwrd needs t be encded. Text is added t the Dcumentatin cell indicating that this step clears the text in the edit bx. This is because the step is still missing a required value in the Value cell, and needs t be updated with the passwrd. c. Click in the Operatin cell t display the dwn arrw, and then click the dwn arrw t display the list f available methds fr the selected test bject. Select SetSecure frm the list. This methd enables the use f encrypted text. Nw yu need t generate the encrypted text and insert it in the Value cell. 5. Generate an encded passwrd using the HPE Passwrd Encder applicatin. a. Select Start > All Prgrams > HPE Sftware > HPE > Unified Functinal Testing > Tls > Passwrd Encder r <UFT installatin flder>\bin\cryptnapp.exe. The Passwrd Encder dialg bx pens. Nte: Fr details n accessing UFT and UFT tls and files in Windws 8.X r higher and Windws Server 2012, see "Accessing UFT in Windws 8.X r Higher Operating Systems" n page 13. b. In the Passwrd bx, enter tutrial. c. Click Generate. The Passwrd Encder encrypts the passwrd and displays it in the Encded String bx. d. Click Cpy. Paste the encded value in the Value cell fr the passwrd step. Dcumentatin fr this step is displayed in the Dcumentatin cell. HPE Unified Functinal Testing (14.02) Page 46 f 112

47 Adding Steps e. Clse the Passwrd Encder dialg bx. If yu ran yur actin at this pint, UFT wuld autmatically pen the Mercury Turs Web site and insert the values yu specified in the User Name and Passwrd bxes. 6. Insert the last step in the Lgin actin. a. Click in the Item clumn belw the last step t insert the next step. The Item list pens, listing the sibling bjects f the previus step's test bject. b. Select Sign-In frm the Item list. This step instructs UFT t click Sign-In n the Welcme page and lg in t the Mercury Turs site. 7. Save yur test. Select File > Save. Learn mre abut the Keywrd View in "Analyzing the Lgin Actin in the Keywrd View" belw, and then cntinue with " Add the Remaining Steps t Yur Test" n the next page. Analyzing the Lgin Actin in the Keywrd View Let's take a lk at the steps in yur first actin. Each step represents an peratin t be perfrmed in the Web brwser. The clumns in the Keywrd View shw different infrmatin fr each step, as fllws: Item. The item fr the step (test bject, utility bject, functin call, r statement) in a hierarchical icn-based tree. Operatin. The peratin t be perfrmed n the item, fr example, Click, Set, r Select. Value. The argument values fr the selected peratin, if required. Fr example, the text t enter in an edit bx, r the muse buttn t use when clicking the image. Dcumentatin. Autmatically prvided dcumentatin f what the step des, in an easy-tunderstand sentence. Fr example: Click the "Sign-In" image. Assignment. The assignment f a value t r frm a variable s yu can use the value later in the test. This clumn is nt visible by default. Cmment. Any textual infrmatin yu want t add regarding the step, fr example, Return t page used in first step f the test. This clumn is nt visible by default. Nte: Yu can hide r display individual clumns by right-clicking the clumn heading in the Keywrd View, and selecting a clumn name frm the list. In the Item clumn f the Keywrd View, yu can click the branch arrws t expand r cllapse the steps under each Web page. Yu can cllapse r expand each actin by selecting the actin name at the tp and then selecting View > Cllapse All r View > Expand All. HPE Unified Functinal Testing (14.02) Page 47 f 112

48 Adding Steps When yu expand yur actin, it shuld lk similar t this: Take a few minutes t examine the Keywrd View in detail, tracing the steps yu perfrmed while creating this actin. Then, cntinue t add additinal steps, as described in " Add the Remaining Steps t Yur Test" belw. The table belw describes the steps shwn in the actin in the Keywrd View abve. Step Descriptin The brwser bject invkes the Welcme: Mercury Turs Web site. Welcme: Mercury Turs is the name f the Web page. username is the name f the edit bx. Set is the methd perfrmed n the edit bx. tutrial is the value entered in the username edit bx. passwrd is the name f the edit bx. SetSecure is an encryptin methd perfrmed n the edit bx. The list f digits is the encrypted value entered in the passwrd edit bx. Sign-In is the name f the image link. Click is the methd perfrmed n the image. Fr mre details n the Keywrd View, see the Keywrd View chapter in the Unified Functinal Testing User Guide. Add the Remaining Steps t Yur Test Nw that yu added steps using the Keywrd View in "Add Steps t the Lgin Actin" n page 42, yu can cntinue with ther methds f adding steps, as fllws: "Add Steps t the FlightFinder Actin by Recrding" n the next page "Add a Step t the SelectFlight Actin Using the Tlbx Pane" n page 54 "Add Steps t the BkFlight Actin Using the Editr and Step Generatr" n page 55 HPE Unified Functinal Testing (14.02) Page 48 f 112

49 Adding Steps Add Steps t the FlightFinder Actin by Recrding In "Add Steps t the Lgin Actin" n page 42, yu added steps t perfrm n the Mercury Turs Welcme page. If yu were t run yur test at this pint, the last step wuld pen the Flight Finder page in the Mercury Turs Web site. In this exercise, yu will recrd steps fr the FlightFinder actin yu created fr the Flight Finder page. The steps yu add will use test bjects frm the assciated MercuryTursFlightFinder shared bject repsitry. Tip: Befre yu begin a recrding sessin, yu may want t place the brwser windw and this tutrial windw side-by-side n yur screen. This allws yu t read the tutrial during recrding. 1. Start UFT and pen the MercuryTurs test. a. If UFT is nt currently pen, pen UFT as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. Select File > Open > Slutin. The Open Slutin dialg bx pens. c. Navigate t the Tutrial.ftsln file, lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Open. (Yu created the MercuryTurs test in "Create a New Slutin, Test, and Actins" n page 19.) 2. Open the FlightFinder actin. a. If the canvas is nt currently pen, click the MercuryTurs tab in the dcument pane t bring it int fcus. b. In the canvas, duble-click the FlightFinder actin. The FlightFinder actin pens. 3. Launch the Mercury Turs Web site and pen the Flight Finder page. a. In Micrsft Internet Explrer, brwse t the Mercury Turs Web site: The Mercury Turs hme page pens. HPE Unified Functinal Testing (14.02) Page 49 f 112

50 Adding Steps b. In the Find a Flight area, enter tutrial in bth the User Name and Passwrd bxes and click Sign-In. The Flight Finder page pens. c. In UFT, select Recrd > Recrd and Run Settings. The Recrd and Run Settings dialg bx pens. HPE Unified Functinal Testing (14.02) Page 50 f 112

51 Adding Steps In the Web tab, select Recrd and run test n any pen brwser and click OK. This enables UFT t recrd n the pen Web page. d. In UFT, click the Recrd buttn. The recrding tlbar appears, and UFT begins recrding. The UFT windw disappears, and yur brwser displays the Flight Finder page in the Mercury Turs Web site. e. In the Mercury Turs Flight Finder Web page, change the fllwing selectins by selecting frm the drp-dwn lists. (D nt use the calendar ptin.) Departing Frm: New Yrk On: December 29 Arriving In: San Francisc Nte: If yu are perfrming this tutrial in the mnth f December, r n the 29th r the 31st f any mnth, select a different mnth r date while recrding. UFT recrds an peratin nly when yu make a change in the applicatin, s this ensures that the step is recrded. If yu accept a default value (r re-select the default value), UFT des nt HPE Unified Functinal Testing (14.02) Page 51 f 112

52 Adding Steps recrd an peratin. f. Click CONTINUE t accept the ther default selectins. The Select Flight page pens. g. On the Recrding tlbar, click Stp t stp the recrding prcess. Yu have nw reserved an imaginary ticket frm New Yrk t San Francisc. UFT recrded yur Web brwser peratins frm the time yu clicked the Recrd buttn in UFT until yu clicked Stp n the Recrding tlbar. HPE Unified Functinal Testing (14.02) Page 52 f 112

53 Adding Steps h. In UFT, select Recrd > Recrd and Run Settings t restre the required run settings. The Recrd and Run Settings dialg bx pens. In the Web tab: Select Open the fllwing address when a recrd r run sessin begins. Cnfirm that the URL in the first bx is In the secnd bx, select a brwser n which t run yur test sessin. Micrsft Internet Explrer is the brwser used in this tutrial. Cnfirm that D nt recrd and run n brwsers that are already pen and Clse the brwser when the test clses are selected. Click OK t save yur changes and clse the dialg bx. 4. Save yur test. Click Save. D nt clse the test, because yu still want t add steps t ther actins. Cntinue with "Add a Step t the SelectFlight Actin Using the Tlbx Pane" n the next page. HPE Unified Functinal Testing (14.02) Page 53 f 112

54 Adding Steps Add a Step t the SelectFlight Actin Using the Tlbx Pane In "Add Steps t the FlightFinder Actin by Recrding" n page 49, yu added steps t perfrm n the Mercury Turs Flight Finder page. If yu were t run yur test at this pint, the last step wuld pen the Select Flight page in the Mercury Turs Web site. Fr the purpse f this tutrial, yu d nt need t make any changes in the Select Flight page, but yu d need t instruct UFT t accept the default ptins and cntinue t the next page. Therefre, in this exercise, yu will add ne step that instructs UFT t click CONTINUE. Yu will drag the relevant test bject int yur actin frm the Tlbx Pane, which is anther way f creating steps in yur actin. Nte: Tlbx items are listed accrding t the actin in fcus in the dcument pane. If a test r functin library is in fcus, r if yu d nt have a test pen at all, the Tlbx Pane is empty. 1. Start UFT and pen the MercuryTurs test. a. If UFT is nt currently pen, pen UFT as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. Click the Open buttn dwn arrw, and select Open Slutin. The Open Slutin dialg bx pens. c. Navigate t the Tutrial.ftsln file, lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Open. (Yu created the MercuryTurs test in "Create a New Slutin, Test, and Actins" n page 19.) 2. Open the SelectFlight actin. In the Slutin Explrer, duble-click the SelectFlight actin. If the Slutin Explrer is nt already pen, pen it by clicking the Slutin Explrer buttn. The SelectFlight actin pens. 3. Display the Tlbx Pane. Click the Tlbx buttn. The Tlbx pane wrks in bth the Editr and the Keywrd View, s there is n need t switch. 4. Select the bject that represents the CONTINUE buttn n the Select Flight Web page. a. In the Tlbx Pane, expand the Test Objects tree. b. Lcate and drag the reserveflights Image bject int the actin, in either the Editr r the Keywrd View. (The reserveflights Image bject shuld be clse t the tp f the list f bjects in the Tlbx Pane.) Nte: Yu may ntice that this bject repsitry has many mre bjects than the HPE Unified Functinal Testing (14.02) Page 54 f 112

55 Adding Steps MercuryTursLgin repsitry. This is because yu did nt delete extraneus bjects in "Creating Object Repsitries" n page 24. The selected Image test bject is added t the step, tgether with its default methd, Click. In the Keywrd View, the Dcumentatin cell describes what the step des in plain English. Again, this step is displayed n three rws in the Keywrd View because the parent test bjects are part f the step. In the Editr, the step is displayed as fllws: 5. Save yur test. Brwser("Select a Flight: Mercury").Page("Select a Flight: Mercury").Image ("reserveflights").click Select File > Save. D nt clse the test, because yu still want t add steps t ther actins. Cntinue t add steps, as described in "Add Steps t the BkFlight Actin Using the Editr and Step Generatr" belw. Add Steps t the BkFlight Actin Using the Editr and Step Generatr In "Add a Step t the SelectFlight Actin Using the Tlbx Pane" n the previus page, yu added a step t perfrm n the Mercury Turs Select Flight page. If yu were t run yur test at this pint, the last step wuld pen the Bk a Flight page in the Mercury Turs Web site. In this exercise, yu will create steps by cpying and pasting cntent int the Editr, which is anther way f creating steps in yur actin. The pasted steps d nt include values. Yu will then insert values fr each step using the Keywrd View. Finally, yu will use the Step Generatr t insert a single step. The Step Generatr enables yu t define an entire step in ne dialg bx, instead f inserting different parts f a step in the varius clumns f the Keywrd View. 1. Start UFT and pen the MercuryTurs test. a. If UFT is nt currently pen, pen UFT as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. On the Start page, in the Recent slutins area, click Tutrial. The Tutrial slutin pens, displaying the MercuryTurs test yu created in "Create a New Slutin, Test, and Actins" n page Open the BkFlight actin. In the Slutin Explrer, duble-click the BkFlight actin. (If the Slutin Explrer is nt already pen, pen it by clicking the Slutin Explrer buttn.) The BkFlight actin pens. HPE Unified Functinal Testing (14.02) Page 55 f 112

56 Adding Steps 3. Add steps t the BkFlight actin. a. Click the Editr buttn t display the Editr. b. Cpy the fllwing steps and paste them int the editr: Brwser("Bk a Flight: Mercury").Page("Bk a Flight: Mercury").WebEdit ("passfirst0").set Brwser("Bk a Flight: Mercury").Page("Bk a Flight: Mercury").WebEdit ("passlast0").set Brwser("Bk a Flight: Mercury").Page("Bk a Flight: Mercury").WebList ("creditcard").select Brwser("Bk a Flight: Mercury").Page("Bk a Flight: Mercury").WebEdit ("creditnumber").set Brwser("Bk a Flight: Mercury").Page("Bk a Flight: Mercury").WebList("cc_ exp_dt_mn").select Brwser("Bk a Flight: Mercury").Page("Bk a Flight: Mercury").WebList("cc_ exp_dt_yr").select Brwser("Bk a Flight: Mercury").Page("Bk a Flight: Mercury").Image ("buyflights").click Nte: If yu cpy and paste the abve cde as-is, there will be line breaks splitting up the cmmands at the end f each line. If yu try t run this cde, the UFT's cmpiler will generate an errr fr each instance f this line break. Therefre, at the end f each line in the cde, press Delete t eliminate the break. 4. Fill in the missing step details. HPE Unified Functinal Testing (14.02) Page 56 f 112

57 Adding Steps a. Select View > Keywrd View t display the Keywrd View. b. Lk at the Dcumentatin clumn. Ntice that fr each step, either n dcumentatin is available, r the dcumentatin indicates that the step is clearing a text bx. This is because the steps yu just inserted are missing values. Fr example, in the first step, a value needs t be filled in fr the passenger's first name. The details that yu need t add are encircled in the fllwing example. c. In the Value cell fr the relevant step in the Keywrd View, enter the fllwing: Fr: passfirst0 passlast0 Enter: Yur first name (r a fictitius first name) Yur last name (r a fictitius last name) HPE Unified Functinal Testing (14.02) Page 57 f 112

58 Adding Steps Fr: creditcard creditnumber cc_exp_dt_ mn cc_exp_dt_yr Enter: Any f the fllwing credit card names: American Express MasterCard (ne wrd) Visa Discver Diners Club Carte Blanche Any 8-digit number. (This is a fictitius credit card number.) Any mnth frm 01 t 12. Make sure that yu enter the value as a tw-digit number. (This is the mnth part f the credit card expiratin date.) Any year frm 2008 t 2010, as a fur-digit number. (This is the year part f the credit card expiratin date.) Nte: Ntice that qutatin marks are added t the values yu enter in the Value clumn after yu click utside f the cell. These qutes are necessary fr the test t run crrectly, and indicate t UFT that the value is a string. If yu g back and change a value, yu must add these qutatin marks manually, because they are nt autmatically added a secnd time. 5. Add a step using the Step Generatr t cnfirm the bking and return t the Hme page. The last step that yu pasted int the BkFlight actin clicks SECURE PURCHASE in the Bk a Flight page t cmplete the transactin. During a run sessin, this pens the Flight Cnfirmatin page in the Mercury Turs Web site. Yu will nw use the Step Generatr t define a step t return t the Mercury Turs Welcme page. a. Belw the last step, click the New Step buttn. A new rw is added t the grid and the drpdwn item list pens in the Item clumn. HPE Unified Functinal Testing (14.02) Page 58 f 112

59 Adding Steps b. In the left margin f the new rw, right-click and select Insert Step > Step Generatr. The Step Generatr dialg bx pens. c. In the Object drp-dwn, select "Flight Cnfirmatin: Mercury". d. Click the Select Object buttn. The Select Test Object dialg bx pens. Expand the Flight Cnfirmatin: Mercury nde f the tree. Nte: Yu may want t cllapse the Bk a Flight: Mercury nde f the tree t view the Flight Cnfirmatin: Mercury nde. HPE Unified Functinal Testing (14.02) Page 59 f 112

60 Adding Steps HPE Unified Functinal Testing (14.02) Page 60 f 112

61 Adding Steps e. Select the hme Image bject, and click OK. The Step Generatr displays the default ptins fr the hme test bject. Define the arguments and values in the Step Generatr just as yu wuld in the Keywrd View clumns: Use the Categry and Object drp-dwn lists t define the value in the Item clumn in the Keywrd View. Use the Operatin drp-dwn lists t define the value in the Operatin clumn. In this step, the default peratin fr the hme test bject, Click, is displayed in the Operatin bx. Althugh yu culd ptentially select a different peratin fr this test bject by clicking the dwn arrw, Click is the peratin needed fr this step. Use the Arguments table t define values fr the arguments in the Value cell in the Keywrd View. If any f the arguments were mandatry, a red asterisk wuld be displayed next t the argument name. In this step, there are n mandatry arguments, and yu d nt need t define any values. The Step dcumentatin bx displays the instructin fr this step as it will be displayed in the Dcumentatin cell f the Keywrd View. If yu want t insert anther step after this ne, select the Insert anther step check bx t HPE Unified Functinal Testing (14.02) Page 61 f 112

62 Adding Steps pen the Step Generatr dialg bx again after adding this step. In this actin, this is the nly step yu need in, s there is n need t select this check bx. f. Click OK. The Step Generatr clses and the step is added t the Keywrd View. g. Click the Editr buttn t display the Editr. h. Yu can see that the same step is displayed as fllws: Brwser("Flight Cnfirmatin: Mercury").Page("Flight Cnfirmatin: Mercury").Image("hme").Click 6. Save yur test. Click Save. Cngratulatins! Yu have created yur first test and are ready t run it. Cntinue with "Running and Analyzing Tests" n page 63. HPE Unified Functinal Testing (14.02) Page 62 f 112

63 Running and Analyzing Tests In "Adding Steps " n page 41, yu added steps t each f yur test actins, and yu are nw ready t run yur test. When yu run yur test in this lessn, UFT pens the apprpriate applicatin and perfrms each step in the test sequentially. When UFT finishes running the test, it displays the results f the run. This chapter includes: Run a Test 64 Navigating the Run Results 66 Analyze the Run Results 66 HPE Unified Functinal Testing (14.02) Page 63 f 112

64 Run a Test In this exercise, yu will run the test yu prepared in "Adding Steps " n page Start UFT and pen the MercuryTurs test. a. If UFT is nt currently pen, pen UFT as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. Select File > Open > Slutin. The Open Slutin dialg bx pens. c. Navigate t the Tutrial.ftsln file, lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Open. (Yu created the MercuryTurs test in "Create a New Slutin, Test, and Actins" n page 19.) 2. Cnfigure UFT t save all images t the run results. UFT allws yu t determine when t save images t the run results. In this lessn, all images shuld be saved t the run results. a. Select Tls > Optins > GUI Testing tab > Screen Capture nde. b. Select the Save still image captures t results checkbx, and then select Always frm the drpdwn menu. c. Click OK t clse the Optins dialg bx. 3. Start running yur test. a. In the Slutin Explrer, select the MercuryTurs test. b. Click the Run buttn. The Run Test dialg bx pens. HPE Unified Functinal Testing (14.02) Page 64 f 112

65 Running and Analyzing Tests c. Click the Optins bar t expand the Run Test Optins area, and verify that New run results flder is selected. Accept the default results flder name. d. Click Run t clse the Run dialg bx and start running the test. Watch carefully as UFT pens yur brwser and starts running the test. In the brwser, yu can see UFT perfrm each step yu inserted; a yellw arrw in the left margin f the Keywrd View and the highlighted rw indicate the step that UFT is running. If any errrs appear, g t the pint in the test that is indicated in the errr message, and verify that the step is cnfigured as described in the relevant task in this tutrial. When the test run is cmplete, learn mre abut the run results, as described in "Navigating the Run Results" n the next page and "Analyze the Run Results" n the next page. HPE Unified Functinal Testing (14.02) Page 65 f 112

66 Running and Analyzing Tests Navigating the Run Results When UFT finishes running the test, the run results pen in the dcument pane: Initially, the Run Results Viewer displays the fllwing panes: Run Results Tree. A graphical representatin f the results in an expandable tree, rganized accrding t the actins and the Web pages visited during the test run. The steps perfrmed during the run are represented by icns in the tree, which can be expanded (arrw) t view each step. Yu can instruct UFT t run a test r actin mre than nce using different sets f data in each run. Each run is called an iteratin, and each iteratin is numbered. (The test yu ran had nly ne iteratin.) Result Details. A high-level results verview reprt, cntaining general infrmatin abut the test, which steps passed r failed, statistics in pie chart frmat, and s n. Captured Data. If pssible, the run results display a still image f the state f yur applicatin at a particular step. This pane is nly ppulated when yu select a step frm the Run Results tree, and the selected step has a recrded image. Yur test run succeeded because UFT was able t navigate the Mercury Turs site accrding t the steps that yu added. If an errr ccurred and yur test did nt run successfully, the errr will be shwn in the Run Results Viewer. In such cases, g back and make sure that the steps are cnfigured exactly as described in this tutrial. Analyze the Run Results In this exercise, yu will inspect the steps UFT perfrmed when running yur test in "Run a Test" n page 64. Yu can view snapshts f the applicatin windw fr each step. HPE Unified Functinal Testing (14.02) Page 66 f 112

67 Running and Analyzing Tests 1. View the results fr a specific step. In the Test Flw, under the results tree, find the Test Iteratin: (Rw 1) > Actin: FlightFinder nde t display all f the steps perfrmed n the Flight Finder page. In the run results tree, select the first Brwser.Page.WebList.Select step: The run results nw displays the fllwing infrmatin: The Test Flw, with the step highlighted A summary f the test step, displaying details f the highlighted step 2. Clse the run results. In the dcument pane, clse the tab cntaining the run results. Yu have nw successfully created and run a test that reserves a flight frm New Yrk t San Francisc n the Mercury Turs Web site. Yu can enhance yur test by cntinuing with the fllwing lessns: "Creating Checkpints and Using Functins" n page 68 "Parameterizing Steps and Objects" n page 98 HPE Unified Functinal Testing (14.02) Page 67 f 112

68 Creating Checkpints and Using Functins In "Running and Analyzing Tests" n page 63, yu ran a test that yu'd created in previus lessns, t check that a series f steps perfrmed n the Mercury Turs Web site runs smthly. Yur test is nw ready fr additinal enhancements, including checkpints. A checkpint verifies that expected infrmatin is displayed in yur applicatin while the test is running. In this lessn, yu will insert checkpints and use a functin t check the validity f the sme f the bjects in the Mercury Turs Web site. This chapter includes: Understanding Checkpint Types 69 Create a Checkpint Test 70 Check Object Values 71 Check Pages 74 Check Table Values 77 Check Text Values 82 Manage Checkpints in the Object Repsitry 87 Run and Analyze a Test with Checkpints 88 Perfrm a Check Using a Functin 92 HPE Unified Functinal Testing (14.02) Page 68 f 112

69 Understanding Checkpint Types UFT ffers the fllwing types f checkpints: Checkpint Type Descriptin Example f Use Standard Checkpint Image Checkpint Table Checkpint Page Checkpint Text Checkpint Text Area Checkpint Bitmap Checkpint Checks values f an bject's prperties. Checks the prperty values f an image. (Select the Standard Checkpint ptin and then selecting t check a Web Image bject.) Checks infrmatin in a table. (Select the Standard Checkpint ptin and then selecting t check any table bject.) Checks the characteristics f a Web page. (Select the Standard Checkpint ptin and then selecting t check a Web Page bject.) Checks that a text string is displayed in the apprpriate place in an applicatin. Checks that a text string is displayed within a defined area in a Windws-based applicatin. Checks an area f an applicatin after capturing it as a bitmap. Check that a radi buttn is selected. Check that the image surce file is crrect. Check that the value in a table cell is crrect. Check hw lng a Web page takes t lad r if a Web page cntains brken links. Check whether the expected text string is displayed in the expected lcatin in a test bject. Check that an area f a dialg bx includes text that was entered in anther part f the applicatin. Check that a Web page (r any prtin f it) is displayed as expected. HPE Unified Functinal Testing (14.02) Page 69 f 112

70 Creating Checkpints and Using Functins Checkpint Type Descriptin Example f Use Database Checkpint Accessibility Checkpint File Cntent Checkpint XML Checkpint Checks the cntents f databases accessed by an applicatin r Web site. Identifies areas f a Web site t check fr Sectin 508 cmpliance. Checks the text in a dcument generated r accessed during a run sessin. Checks the data cntent f XML dcuments. Check that the value in a database query is crrect. Check if the images n a Web page include ALT prperties, required by the W3C Web Cntent Accessibility Guidelines. Check that the headers in a dynamically-generated PDF file display the reginal crprate headquarters cntact infrmatin crrectly. Check the cntent f an element t make sure that its tags, attributes, and values have nt changed. Nte: XML file checkpints are used t check a specified XML file; XML applicatin checkpints are used t check an XML dcument within a Web page. Yu can add mst checkpints t yur test either while inserting steps r while recrding. The fllwing sectins explain hw t create sme f the checkpints described abve, in the test yu created in "Add Steps t the Lgin Actin" n page 42. Nte: When UFT creates a checkpint, it assigns a name based n infrmatin inside the checkpint the checked value, fr example. The checkpint name remains unchanged, even if yu subsequently mdify the infrmatin n which it was based. Keep this in mind when lking fr checkpints displayed in the Keywrd View. Nte als, that UFT may shrten the name displayed in the Keywrd View. Fr additinal details abut checkpints, see the Unified Functinal Testing User Guide. T add checkpints t yur test, begin with "Create a Checkpint Test" belw. Create a Checkpint Test In this exercise, yu will save the MercuryTurs test that yu ran in "Running and Analyzing Tests" n page 63 as a new test t create yur checkpints. Checkpints d nt need t be managed in separate tests, and yu are nly creating a new test nw fr the sake f the tutrial. During yur regular wrking prcess, yu can add checkpints t any test. 1. Start UFT and pen the MercuryTurs test. a. If UFT is nt currently pen, pen it as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. HPE Unified Functinal Testing (14.02) Page 70 f 112

71 Creating Checkpints and Using Functins b. Click the Open buttn dwn arrw, and select Open Slutin. The Open Slutin dialg bx pens. c. Navigate t the Tutrial.ftsln file, lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Open. (Yu created the MercuryTurs test in "Create a New Slutin, Test, and Actins" n page 19.) 2. Save the test as Checkpint. a. In the Slutin Explrer, select the MercuryTurs test nde, and then select File > Save As. b. In the Save Test As dialg bx, brwse t the C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial directry, and save the test as Checkpint. In the Slutin Explrer, the MercuryTurs test is replaced by the new Checkpint test. The MercuryTurs test is still saved separately in the file system. 3. Add the MercuryTurs test back t the slutin. Yu can have bth the MercuryTurs and the Checkpint tests pen at the same time if they are bth referenced frm the same slutin. This enables yu switch back and frth between them if yu want t cmpare r edit the tests. Yu can nly run a single test at a time. a. Select File > Add > Existing Test. b. Navigate t the MercuryTurs test lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Add. (Yu created the MercuryTurs test in "Create a New Slutin, Test, and Actins" n page 19.) Nte: If yu cpy this path, make sure t replace <username> with yur username. c. The MercuryTurs test appears in the Slutin Explrer. Tests are rganized in the Slutin Explrer alphabetically. The slutin is saved autmatically. Cntinue with "Check Object Values" belw. Check Object Values In this exercise, yu will add a standard checkpint t the test yu created in "Create a Checkpint Test" n the previus page, in the Bk a Flight actin. This checkpint verifies the value entered in the bx cntaining the passenger's first name. Nte: The Mercury Turs Web site must be pen t the page yu want t check befre yu insert the checkpint. 1. Start UFT and pen the Checkpint test. a. If UFT is nt currently pen, pen it as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. On the Start page, in the Recent Slutins area, click Tutrial. The Tutrial slutin pens. c. In the Slutin Explrer, select the Checkpint test nde. (Yu created the Checkpint test in "Create a Checkpint Test" n the previus page.) HPE Unified Functinal Testing (14.02) Page 71 f 112

72 Creating Checkpints and Using Functins 2. Display the actin in which yu want t add a checkpint. Yu want t add a checkpint that checks the prperty values f the First Name edit bx after the test autmatically enters the passenger's name in the bx. In the canvas, duble-click the BkFlight actin t pen it. 3. Open the Mercury Turs applicatin t the Bk a Flight page. a. Lg in t the Mercury Turs Web site: In the User Name and Passwrd bxes, enter tutrial. Click Sign-In. The Flight Finder page pens. b. Enter flight details. Change the fllwing selectins by selecting frm the drp-dwn lists. (D nt use the calendar ptin.) Departing Frm: New Yrk On: December 29 Arriving In: San Francisc Returning: December 31 Nte: If yu are perfrming this tutrial in the mnth f December, r n the 29th r the 31st f any mnth, select a different mnth r date while recrding. UFT recrds an peratin nly when yu make a change in the applicatin, s this ensures that the step is recrded. If yu accept a default value (r re-select the default value), UFT des nt recrd an peratin. c. Click CONTINUE t accept the ther default selectins. The Select Flight page pens. d. In the Select Flight page, click CONTINUE t accept the default flight selectins. The Bk a Flight page pens. 4. Create a standard checkpint. a. If the Editr is displayed, click the Keywrd View buttn t display the Keywrd View. b. In the Item clumn, select the passfirst0 rw. HPE Unified Functinal Testing (14.02) Page 72 f 112

73 Creating Checkpints and Using Functins c. Select Design > Checkpint > Standard Checkpint. The Checkpint Prperties dialg bx pens. The dialg bx displays the bject's prperties: The Name is the name f the bject as defined in the HTML cde f the Web page, in this case passfirst0. The Class is the type f bject, in this case WebEdit, indicating that the bject is an edit bx. The ABC icn in the Type clumn indicates that the value f the prperty is a cnstant. UFT recmmends default prperty checks fr each bject class,. The table belw describes the default checks recmmended fr the WebEdit class. Prperty Value Explanatin html tag INPUT INPUT is the html tag as defined in the HTML surce cde. innertext In this case, the value f innertext is empty. The checkpint checks that the value is empty. name passfirst0 passfirst0 is the name f the edit bx. HPE Unified Functinal Testing (14.02) Page 73 f 112

74 Creating Checkpints and Using Functins Prperty Value Explanatin type text text is the type f bject as defined in the HTML surce cde. value Currently, the value is empty. Yu need t enter the same value that yu specified fr the First Name edit bx. d. In the Name bx f the Checkpint Prperties dialg bx, enter CheckName as the new checkpint name. e. Scrll dwn in the bject prperties area and select the rw cntaining the prperty named value. Yu need t enter the value that matches the value yu entered in the actual step. T d this, click in the Cnstant bx and enter the value yu defined as the passenger's first name, abve in "Add Steps t the BkFlight Actin Using the Editr and Step Generatr" n page 55. Nte: Yu can see what yu entered by mving the Checkpint Prperties dialg bx s that yu can view the Keywrd View. The value that yu entered is listed in the Value clumn f the passfirst0 rw, in qutes. f. In the Insert statement area at the bttm f the Checkpint Prperties dialg bx, select After current step. This inserts the checkpint after the passfirst0 Set... step. (This is the step in which the passenger's first name is entered in the First Name bx.) g. Accept the rest f the settings as default and click OK. UFT adds a standard checkpint step t yur test belw the selected step. 5. Save the test. Click Save. Yu can use this prcess t insert many checkpints. Cntinue t enhance yur test by adding a page checkpint, as described in "Check Pages" belw. Check Pages In this exercise, yu will add a page checkpint t the test yu created in "Create a Checkpint Test" n page 70. The page checkpint checks that the number f links and images in the page when yu run yur test is the same as when UFT learned the bjects n which yu inserted steps in yur test. 1. Start UFT and pen the Checkpint test. a. If UFT is nt currently pen, pen it as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. HPE Unified Functinal Testing (14.02) Page 74 f 112

75 Creating Checkpints and Using Functins b. Select File > Open > Slutin. The Open Slutin dialg bx pens. c. Navigate t the Tutrial.ftsln file, lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Open. (Yu created the Checkpint test in "Create a Checkpint Test" n page 70.) d. In the Slutin Explrer, select the Checkpint test nde. 2. Lcate the step where yu want t add a page checkpint. a. If the Checkpint BkFlight actin is nt already pen, in the Slutin Explrer, duble-click the BkFlight actin. The BkFlight actin pens. b. In the Item clumn f the Keywrd View, lcate the Bk a Flight: Mercury rw. (This is the rw directly abve the rw displaying passfirst0.) 3. Create a page checkpint. a. Right-click the Bk a Flight: Mercury rw, and select Insert Standard Checkpint. The Page Checkpint Prperties dialg bx pens. HPE Unified Functinal Testing (14.02) Page 75 f 112

76 Creating Checkpints and Using Functins When yu run the test, UFT checks the number f links and images in the page, and the lad time, against thse described in the table at the tp f the dialg bx. The page lad time may vary frm cmputer t cmputer and yur lad time results may nt match the abve image. UFT als checks the actual target URL f each link and the actual surce f each image. b. In the Name bx, enter CheckLinks as the new checkpint name. c. Make sure that all three check bxes are selected in the Type clumn in the table at the tp f the dialg bx. d. Accept the rest f the settings as default and click OK. HPE Unified Functinal Testing (14.02) Page 76 f 112

77 Creating Checkpints and Using Functins UFT adds the page checkpint t yur test. Because this is the first peratin n the Bk a Flight: Mercury page, the peratin is added directly t the existing Bk a Flight: Mercury page nde. It is displayed in the Keywrd View as a checkpint peratin n the Bk a Flight: Mercury page. 4. Save the test. Click Save. Cntinue t enhance yur test by adding a table checkpint, as described in "Check Table Values" belw. Check Table Values In this exercise, yu will add a table checkpint t the test yu created in "Create a Checkpint Test" n page 70. The table checkpint will check the cst f the utbund flight, as displayed in the Bk a Flight: Mercury page. 1. Start UFT and pen the Checkpint test. a. If UFT is nt currently pen, pen it as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. Click the Open buttn dwn arrw, and select Open Slutin. The Open Slutin dialg bx pens. c. Navigate t the Tutrial.ftsln file, lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Open. (Yu created the Checkpint test in "Create a Checkpint Test" n page 70.) d. In the Slutin Explrer, select the Checkpint test nde. 2. Lcate the step where yu want t add a table checkpint. a. If the BkFlight actin is nt already pen, in the Slutin Explrer, duble-click the BkFlight actin. The actin is displayed in the Keywrd View. b. Select the passfirst0 step (the step that enters the passenger's first name int the First Name edit bx). 3. Open the Mercury Turs Web site t the Bk A Flight page. a. If it is nt already pen, lg in t the Mercury Turs Web site: b. In the User Name and Passwrd bxes, enter tutrial. c. Click Sign-In. The Flight Finder page pens. d. Enter flight details. HPE Unified Functinal Testing (14.02) Page 77 f 112

78 Creating Checkpints and Using Functins Change the fllwing selectins by selecting frm the drp-dwn lists. (D nt use the calendar ptin.) Departing Frm: New Yrk On: December 29 Arriving In: San Francisc Returning: December 31 Nte: If yu are perfrming this tutrial in the mnth f December, r n the 29th r the 31st f any mnth, select a different mnth r date while recrding. UFT recrds an peratin nly when yu make a change in the applicatin, s this ensures that the step is recrded. If yu accept a default value (r re-select the default value), UFT des nt recrd an peratin. e. Click CONTINUE t accept the ther default selectins. The Select Flight page pens. f. In the Select Flight page, click CONTINUE t accept the default flight selectins. The Bk a Flight page pens. 4. Cnfigure UFT t recrd n the pen brwser page. a. In UFT, select Recrd > Recrd and Run Settings. The Recrd and Run Settings dialg bx pens. HPE Unified Functinal Testing (14.02) Page 78 f 112

79 Creating Checkpints and Using Functins b. Select Recrd and run test n any pen brwser and click OK t clse the dialg bx. 5. Create a table checkpint. a. In the Bk Flight page f the Mercury Turs Web site, under the flight departure date and the Price text, highlight 270 (the fare price f the first leg between New Yrk and San Francisc). b. In UFT, click the Recrd buttn. UFT begins a recrding sessin and the UFT windw is hidden. c. Display the UFT windw again and expand it if yu need t. d. Select Design > Checkpint > Standard Checkpint. The UFT windw is hidden, and the pinter changes int a pinting hand. Nte: If yu need t switch back and frth between Welcme page, UFT, r any ther windw currently pen, press CTRL t change the pinting hand back t a regular Windws pinter. Hld dwn the CTRL buttn as lng as yu need the pinter, and then release it when yu are ready t use the pinting hand. Using the pinting hand t click bjects that yu d nt need may cause errrs in yur test. HPE Unified Functinal Testing (14.02) Page 79 f 112

80 Creating Checkpints and Using Functins e. Click the highlighted string, 270. The Standard Checkpint dialg bx pens, displaying the bject hierarchy. f. Select the secnd-t-last item in the hierarchy (WebTable: New Yrk t San Francisc), and click OK. The Table Checkpint Prperties dialg bx pens, shwing the rws and clumns f the table. HPE Unified Functinal Testing (14.02) Page 80 f 112

81 Creating Checkpints and Using Functins g. Enter CheckCst as the new checkpint name in the Name bx f the Table Checkpint Prperties dialg bx. Nte that by default, check marks appear in all cells. Yu can duble-click a cell t tggle the cell selectin, r duble-click a rw r clumn header t tggle the selectin fr all the cells in the selected rw r clumn. h. Duble-click each clumn header t clear the check marks. i. Duble-click clumn 3, rw 3 t check the value f this cell. (UFT checks nly cells cntaining check marks.) HPE Unified Functinal Testing (14.02) Page 81 f 112

82 Creating Checkpints and Using Functins j. Scrll thrugh the rws and clumns t make sure that nly the cell in clumn 3, rw 3 is checked. If any ther cells are checked, duble-click them t remve the check. Tip: Yu can change the clumn widths and rw heights by dragging the bundaries f the clumn and rw headers. k. Accept the rest f the settings as default and click OK. 6. Stp the recrding sessin. Click Stp t stp recrding. UFT adds the table checkpint t yur test. It is displayed in the Keywrd View as a new step under the Bk a Flight: Mercury page. 7. Save the test. Click Save. In "Check Text Values" belw, yu will need t navigate t the next page in the Mercury Turs Web site the Flight Cnfirmatin page. Therefre, yu may want t keep the Mercury Turs Web site pen t the current page. Cntinue t enhance yur test by adding a text checkpint, as described in "Check Text Values" belw. Check Text Values In this exercise, yu will add a text checkpint t the test yu created in "Create a Checkpint Test" n page 70. The text checkpint will check whether New Yrk is displayed in the Flight Cnfirmatin page. 1. Start UFT and pen the Checkpint test. a. If UFT is nt currently pen, pen it as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. On the Start page, in the Recent Slutins area, click Tutrial. The Tutrial slutin pens. c. In the Slutin Explrer, select the Checkpint test nde. (Yu created the Checkpint test in "Create a Checkpint Test" n page 70.) 2. Lcate the page where yu want t add a text checkpint. a. In the Slutin Explrer, duble-click the BkFlight actin. The BkFlight actin pens. If it pens in the Editr click the Keywrd View buttn t display the Keywrd View. b. In the Keywrd View, highlight Flight Cnfirmatin: Mercury step (lcated in the third t last rw, if yu have all the steps fully expanded). HPE Unified Functinal Testing (14.02) Page 82 f 112

83 Creating Checkpints and Using Functins 3. Open the Mercury Turs Web site t the Flight Cnfirmatin page. a. Lg in t the Mercury Turs Web site: In the User Name and Passwrd bxes, enter tutrial. Click Sign-In. The Flight Finder page pens. b. Enter flight details. Change the fllwing selectins by selecting frm the drp-dwn lists. (D nt use the calendar ptin.) Departing Frm: New Yrk On: December 29 Arriving In: San Francisc Returning: December 31 Nte: If yu are perfrming this tutrial in the mnth f December, r n the 29th r the 31st f any mnth, select a different mnth r date while recrding. UFT recrds an peratin nly when yu make a change in the applicatin, s this ensures that the step is recrded. If yu accept a default value (r re-select the default value), UFT des nt recrd an peratin. c. Click CONTINUE t accept the ther default selectins. The Select Flight page pens. d. In the Select Flight page, click CONTINUE t accept the default flight selectins. e. In the Bk a Flight page, click SECURE PURCHASE. The Flight Cnfirmatin page pens. 4. Cnfigure UFT t recrd n the pen brwser page. a. In UFT, select Recrd > Recrd and Run Settings. The Recrd and Run Settings dialg bx pens. HPE Unified Functinal Testing (14.02) Page 83 f 112

84 Creating Checkpints and Using Functins b. Cnfirm that Recrd and run test n any pen brwser is selected and click OK t clse the dialg bx. 5. Create a text checkpint. a. In the Flight Cnfirmatin page, under Departing, highlight the text New Yrk (include the space after it). b. If yu need t, display and expand the UFT windw. c. In the UFT windw, click the Recrd buttn. UFT begins a recrding sessin, and the Recrding tlbar pens. d. In the main UFT tlbar, select Design > Checkpint > Text Checkpint. The UFT windw is hidden, and the pinter changes int a pinting hand. Nte: If yu need t switch back and frth between Welcme page, UFT, r any ther windw currently pen, press CTRL t change the pinting hand back t a regular Windws pinter. Hld dwn the CTRL buttn as lng as yu need the pinter, and then release it when yu are ready t use the pinting hand. Using the pinting hand t HPE Unified Functinal Testing (14.02) Page 84 f 112

85 Creating Checkpints and Using Functins click bjects that yu d nt need may cause errrs in yur test. e. Click the highlighted text string, New Yrk. The Text Checkpint Prperties dialg bx pens. When Checked Text appears in the list bx, the Cnstant field displays the text string yu highlighted. This is the text UFT lks fr when running the test. f. In the Name bx, enter CheckDepartingText as the new checkpint name. HPE Unified Functinal Testing (14.02) Page 85 f 112

86 Creating Checkpints and Using Functins g. Remve San Francisc frm the Checkpint Summary pane, as fllws: Click Cnfigure t pen the Cnfigure Text Selectin dialg bx. Highlight the t text string. (D nt highlight San Francisc). Click Text After. San Francisc changes frm black t gray. Click OK t clse the dialg bx. San Francisc is remved frm the text after part f the Checkpint Summary pane. h. Accept the rest f the settings as default and click OK. 6. Stp the recrding sessin. On the Recrding tlbar, click Stp t stp recrding. UFT adds the text checkpint t yur test. It is displayed in the Keywrd View as a checkpint peratin n the Flight Cnfirmatin: Mercury page. 7. Make sure that the checkpint is lcated abve the hme step. Drag the new step up a rw if needed, t make sure that UFT des nt click BACK TO HOME befre perfrming the checkpint. In the Keywrd View, the step shuld lk as fllws: HPE Unified Functinal Testing (14.02) Page 86 f 112

87 Creating Checkpints and Using Functins 8. Save the test. Click Save. Learn mre abut checkpint management in "Manage Checkpints in the Object Repsitry" belw, and then cntinue with "Run and Analyze a Test with Checkpints" n the next page. Manage Checkpints in the Object Repsitry In additin t viewing checkpints in a specific actin, yu can als view them in the bject repsitry and mdify their prperties. If applicable, yu can even use the same checkpint in mre than ne lcatin. Fr example, if yu want t verify that yur rganizatin's lg appears n every page in yur applicatin, yu can create a checkpint and insert it in wherever steps pen anther page. Fr the purpses f this tutrial, yu will nt be reusing checkpints. 1. Start UFT and pen the Checkpint test. a. If UFT is nt currently pen, pen it as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. Select File > Open > Slutin. The Open Slutin dialg bx pens. c. Navigate t the Tutrial.ftsln file, lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Open. (Yu created the Checkpint test in "Create a Checkpint Test" n page 70.) 2. Open the Object Repsitry windw. a. In the Slutin Explrer, duble-click the BkFlight actin. The BkFlight actin pens. b. Click the Object Repsitry buttn. The Object Repsitry windw pens, displaying a tree f all test bjects and all checkpint and utput bjects in the current actin. HPE Unified Functinal Testing (14.02) Page 87 f 112

88 Creating Checkpints and Using Functins The tree includes all lcal bjects and all bjects in any shared bject repsitries assciated with the actin. 3. Select an Actin t view its checkpints. a. In the Actin drp-dwn menu directly abve the tree, select an actin t display its test bjects, checkpint bjects, and utput value bjects. b. Clse the Object Repsitry Manager windw when yu are dne. Nte: Fr the purpses f this tutrial, yu d nt need t mdify any bject prperties. Fr details abut bject prperties, see the Unified Functinal Testing User Guide. Yu are ready t run yur test. Cntinue with "Run and Analyze a Test with Checkpints" belw. Run and Analyze a Test with Checkpints In this exercise, yu will run the test yu created in "Create a Checkpint Test" n page 70, and analyze the checkpint results. HPE Unified Functinal Testing (14.02) Page 88 f 112

89 Creating Checkpints and Using Functins 1. Cnfigure UFT t pen the Mercury Turs Web page. a. In UFT, select Recrd > Recrd and Run Settings. The Recrd and Run Settings dialg bx pens. b. Select Open the fllwing address when a recrd r run sessin begins and click OK t clse the dialg bx. 2. Start running yur test. a. Click the Run buttn. The Run dialg bx pens. b. Ensure that New run results flder is selected. Accept the default results flder name. c. Click OK. When the test run is cmpleted, the run results pen. 3. View the run results. In the run results, the run result shuld be Passed, indicating that all checkpints passed. If ne r mre checkpints had failed, the run result wuld be Failed. HPE Unified Functinal Testing (14.02) Page 89 f 112

90 Creating Checkpints and Using Functins 4. View the results f the page checkpint. In the Test Flw, expand the BkFlight nde and then select Standard Checkpint "CheckLinks" nde. The step summary displays all the details f the page checkpint, including all items checked. Nte: The lad time f the page may vary frm cmputer t cmputer and yur results may nt match the image belw. The checkpint passed because the actual values f the checked prperties match the expected values. 5. View the results f the table checkpint. In the Test Flw, in the results tree, expand the BkFlight nde, and then select Standard Checkpint: "New Yrk t...". HPE Unified Functinal Testing (14.02) Page 90 f 112

91 Creating Checkpints and Using Functins The step summary displays the details f the table checkpint: If the checkpint were t fail,the run results wuld display the values f the table cells: Cell values that were checked are displayed in black. Cell values that were nt checked are displayed in gray. The checkpint passed because the actual value f the checked cell matches the expected value. 6. View the results f the standard checkpint. In the Test Flw, search the BkFlight nde, and then select the secnd Standard Checkpint: "CheckName" nde, The step summary displays the details f the standard checkpint, including the prperties that were checked and their values. The checkpint passed because the actual values f the checked prperties match the expected values. 7. View the results f the text checkpint. In the Test Flw, search the FlightCnfirmatin nde and select the Text Checkpint: CheckDepartingText nde. HPE Unified Functinal Testing (14.02) Page 91 f 112

92 Creating Checkpints and Using Functins The step summary displays the details f the text checkpint. The checkpint passed because the actual text matches the expected text. 8. Clse the run results. In the dcument pane, clse the tab cntaining the run results. Yu can als enhance yur test using a functin library. Fr details, cntinue with "Perfrm a Check Using a Functin" belw. Perfrm a Check Using a Functin In "Run and Analyze a Test with Checkpints" n page 88, yu used checkpints t check varius bjects in the Mercury Turs Web site. In this exercise, yu will use the functin yu created in "Creating Functins and Functin Libraries" n page 37 t check the date frmat f a Web element in the SelectFlight actin. 1. If UFT is nt currently pen, start UFT and pen the Checkpint test. a. Open UFT as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. Click the Open buttn dwn arrw, and select Open Slutin. The Open Slutin dialg bx pens. c. Navigate t the Tutrial.ftsln file, lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Open. (Yu created the Checkpint test in "Create a Checkpint Test" n page 70.) HPE Unified Functinal Testing (14.02) Page 92 f 112

93 Creating Checkpints and Using Functins 2. Save the test as Functin. a. In the Slutin Explrer, select the Checkpint test nde, and select File > Save As. b. In the Save Test As dialg bx, brwse t C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and save the test as Functin. In the Slutin Explrer, the Checkpint test is replaced by the new Functin test. The Checkpint test is still saved separately in the file system. 3. Add the Checkpint test back t the slutin. Yu can have the MercuryTurs, Checkpint, and Functin test pen at the same time, if they are all referenced frm the same slutin. This enables yu t switch back and frth between them if yu want t cmpare r edit the tests. Yu can nly run a single test at a time. a. Click the Add buttn drp-dwn arrw, and select Add Existing Test. b. Navigate t the Checkpint test, lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Open. (Yu created the Checkpint test in "Create a Checkpint Test" n page 70.) Nte: If yu cpy this path, make sure t replace <username> with yur username. c. The Checkpint test appears in the Slutin Explrer. Tests are rganized in the Slutin Explrer alphabetically. The slutin is saved autmatically. 4. Display the Select Flight page in The Mercury Turs Web site. a. Lg in t the Mercury Turs Web site: In the User Name and Passwrd bxes, enter tutrial. Click Sign-In. The Flight Finder page pens. b. Enter flight details. Change the fllwing selectins by selecting frm the drp-dwn lists. (D nt use the calendar ptin.) Departing Frm: New Yrk On: December 29 Arriving In: San Francisc Returning: December 31 Nte: If yu are perfrming this tutrial in the mnth f December, r n the 29th r the 31st f any mnth, select a different mnth r date while recrding. UFT recrds an peratin nly when yu make a change in the applicatin, s this ensures that the step is recrded. If yu accept a default value (r re-select the default value), UFT des nt recrd an peratin. HPE Unified Functinal Testing (14.02) Page 93 f 112

94 Creating Checkpints and Using Functins c. Click CONTINUE t accept the ther default selectins. The Select Flight page pens. Ntice the date displayed in the DEPART area. The date is in MM/DD/YYYY frmat. 5. Add the departure date bject t yur repsitry. a. In the UFT windw, select Resurces > Object Repsitry Manager. The Object Repsitry Manager windw pens. b. In the Object Repsitry Manager, click Open, and brwse t and pen the MercuryTursSelectFlight.tsr bject repsitry. c. Click Enable Editing t enable the repsitry fr editing. d. Click the brwser windw t make the Mercury Turs Web site active. e. Learn the departure date bject. This bject is the departure date yu selected when yu entered yur flight details. In the sample image shwn abve, this date is 12/29/2012. Frm the Object Repsitry Manager, select Object > Add Objects. The Object Repsitry Manager windw is minimized, and the cursr changes t a pinting hand. Nte: If yu need t switch back and frth between Welcme page, UFT, r any ther windw currently pen, press CTRL t change the pinting hand back t a regular Windws pinter. Hld dwn the CTRL buttn as lng as yu need the pinter, and then release it when yu are ready t use the pinting hand. Using the pinting hand t click bjects that yu d nt need may cause errrs in yur test. HPE Unified Functinal Testing (14.02) Page 94 f 112

95 Creating Checkpints and Using Functins Click the departure date text string (in the example shwn in this task, 12/29/2012). The Object Selectin - Add t Repsitry dialg bx pens. Make sure that the WebElement bject that represents the departure date yu selected when yu entered yur flight details is highlighted in the Object Selectin dialg bx. Click OK. The departure date bject is added t yur repsitry. f. Click Save t save the repsitry. 6. In UFT, display the actin in which yu want t add a functin. Yu want t add a functin that checks the innertext prperty values f the date displayed in the SelectFlight actin. In the Slutin Explrer, expand the Functin test nde, and duble-click the SelectFlight actin. 7. Paste steps in the Editr. In this step, yu will add the check_data_validity functin defined in the assciated functin library t the SelectFlight actin. Yu created this functin library in "Create a Functin" n page 38. a. Click the Editr buttn t display the Editr b. In the Editr, place yur cursr befre the single existing step, and paste the functin shwn belw. departuredate=brwser("select a Flight: Mercury").Page("Select a Flight: Mercury").WebElement("12/29/2012").GetROPrperty("innertext") if check_data_validity( departuredate ) then reprter.reprtevent micpass, "Date is valid", departuredate end if c. After yu paste the steps, make sure that the riginal step still starts n its wn line after the pasted steps. If it des nt, place yur cursr befre the step starts, at Brwser("Select a Flight: Mercury"), and press Enter. Yu want the functin t run befre UFT navigates t the next page in the applicatin. HPE Unified Functinal Testing (14.02) Page 95 f 112

96 Creating Checkpints and Using Functins d. In the first line f the functin, mdify the date t the date yu selected when yu entered yur flight details, which will match the departure date bject yu added t the bject repsitry. e. In the PDF versin f this tutrial, the first line f the cde breaks acrss tw lines. If yu are cpying and pasting frm the PDF, make sure t remve the line break after 29/: s that the first line f the cde begins with departuredate and ends with ("innertext"). (The Page part shuld be displayed as: Page("Select a Flight: Mercury") with a single space between Flight: and Mercury.) 8. Lk at these steps in the Keywrd View. Select View > Keywrd t display the Keywrd View. (The highlighted step is nt part f the functin it is the step that navigates t the next page in the Mercury Turs Web site.) 9. Save yur test. Select File > Save. 10. Start running yur test. a. Click the Run buttn. The Run dialg bx pens. b. In the Run dialg bx, ensure that New run results flder is selected. Accept the default results flder name. c. Click OK. When the test run is cmpleted, the run results pen. 11. Analyze the run results. The run result shuld be Passed, indicating that the functin passed because the date is displayed in the expected frmat, and it cntains acceptable values. HPE Unified Functinal Testing (14.02) Page 96 f 112

97 Creating Checkpints and Using Functins 12. Clse the run results. In the dcument pane, clse the tab cntaining the run results. Cntinue t enhance yur test by adding multiple sets f data, as described in "Parameterizing Steps and Objects" n page 98. HPE Unified Functinal Testing (14.02) Page 97 f 112

98 Parameterizing Steps and Objects In "Running and Analyzing Tests" n page 63, yu ran a test that yu created in previus lessns, t check that a series f steps perfrmed n the Mercury Turs Web site runs smthly. Even after adding additinal checks in "Creating Checkpints and Using Functins" n page 68, yu ran this test with nly a single set f data. Hwever, when yu test yur applicatins, yu may want t see the same peratins perfrmed with multiple sets f data. Fr example, yu may want t run a test n yur Web site using ten separate sets f data. Yu can create ten separate tests, each with its wn set f data, r yu can add ten sets f parameters t a single test. If yu add the parameters, yur test will run ten times, each time using a different set f data. In this lessn, yu will add parameters t yur test and run yur test with multiple sets f data. This chapter includes: Parameterizing an Actin 99 Create a Test fr Parameterizatin 99 Define a Data Table Parameter 100 Add Parameter Values t a Data Table 102 Mdify Steps Affected by Parameterizatin 103 Running and Analyzing a Parameterized Test 105 HPE Unified Functinal Testing (14.02) Page 98 f 112

99 Parameterizing an Actin The Data pane at the bttm f the UFT windw in the any test displays a tab fr each actin in the test, as well as a Glbal tab. Nte: If the Data pane is nt displayed, select View > Data t display it, r click the Data buttn. The Glbal tab is a data sheet whse data is used fr the entire test. If five rws f data are displayed in the Glbal data table, the test will run five times (five full iteratins). In additin, yu can create data sets fr each actin, using the relevant actin sheet. If yu parameterize a step using a Data pane parameter frm a lcal actin sheet and enter five rws f data in that sheet, yu can define that actin t run five times within ne test iteratin. UFT enables yu t insert varius types f parameters. This tutrial intrduces yu t Glbal Data pane parameters. Fr details n ther types f parameters, see the Unified Functinal Testing User Guide. Create a Test fr Parameterizatin In "Adding Steps " n page 41, yu reserved a flight frm New Yrk t San Francisc. In thse steps, New Yrk is a cnstant value, which means that New Yrk is the departure city each time yu run the test. In this exercise yu will create a new test, in which yu define the departure city as a parameter, s that yu can use a different departure city fr each test run. 1. Start UFT and pen the Checkpint test. a. Open UFT as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. On the Start page, in the Recent Slutins area, click Tutrial. The Tutrial slutin pens. The Checkpint, Functin, and MercuryTurs tests appear in the Slutin Explrer. 2. Save the test as Parameter. a. In the Slutin Explrer, select the Checkpint test nde. (Yu created the Checkpint test in "Create a Checkpint Test" n page 70.) b. Select File > Save As. In the Save Test As dialg bx, brwse t C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and save the test as Parameter. In the Slutin Explrer, the Checkpint test is replaced by the new Parameter test. The Checkpint test is still saved separately in the file system. 3. Add the Checkpint test back t the slutin. Yu can all f yur tests pen at the same time if they are bth referenced frm the same slutin. This enables yu switch back and frth between them if yu want t cmpare r edit the tests. Yu can nly run a single test at a time. HPE Unified Functinal Testing (14.02) Page 99 f 112

100 Parameterizing Steps and Objects a. Select File > Add > Existing Test. b. Navigate t the Checkpint test lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Add. (Yu created this test in "Create a Checkpint Test" n page 70.) c. The Checkpint test appears in the Slutin Explrer. Tests are rganized in the Slutin Explrer alphabetically. The slutin is saved autmatically. Cntinue with "Define a Data Table Parameter" belw. Define a Data Table Parameter In this exercise yu will define the departure city as a parameter, s that yu can use a different departure city fr each test run. 1. Start UFT and pen the Parameter test. a. Open UFT as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. Select File > Open > Slutin. The Open Slutin dialg bx pens. c. Navigate t the Tutrial.ftsln file, lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Open. (Yu created the Parameter test in "Create a Test fr Parameterizatin" n the previus page.) d. In the Slutin Explrer, select the Parameter test nde. 2. Make sure that the Data Pane ptin is visible. If yu d nt see the Data pane at the bttm f the UFT windw, select View > Data. 3. Open the FlightFinder actin. In the canvas, duble-click the FlightFinder actin. The FlightFinder actin pens. If the Editr is displayed, select View > Keywrd View t display the Keywrd View. 4. Select the text t parameterize. In the Keywrd View, in the frmprt rw, in the Value cell and then click the parameterizatin buttn. The parameters list pens: In the parameters list, select the Data Table tab. HPE Unified Functinal Testing (14.02) Page 100 f 112

101 Parameterizing Steps and Objects At the bttm f the Data Table tab, click the Add New Parameter buttn. The Value Cnfiguratin Optins dialg bx pens. 5. Set the parameterizatin prperties. a. Select the Parameter radi buttn. This enables yu t replace the cnstant value (New Yrk) with a parameter. b. Cnfirm that the DataTable ptin is selected frm the Parameter drp-dwn menu. This means that the value f the parameter will be taken frm the UFT Data pane. The Name bx is enabled and displays p_item. Delete p_item and enter departure. HPE Unified Functinal Testing (14.02) Page 101 f 112

102 Parameterizing Steps and Objects c. Click OK t clse the dialg bx. UFT adds the departure parameter t the Data pane as a new clumn and inserts New Yrk in the first rw under it. New Yrk will be the first f several departure cities that UFT will use during test runs f the applicatin. Nte the change in the step's appearance in the Keywrd View. Previusly, the step was displayed as frmprt Select New Yrk. Nw, when yu click the Value cell, the fllwing infrmatin is displayed, indicating that the value is parameterized using a Data pane parameter called departure: Cntinue with "Add Parameter Values t a Data Table" belw. Add Parameter Values t a Data Table As yu saw in "Create a Test fr Parameterizatin" n page 99, UFT displays parameter values in the Data pane. In this exercise, yu will add anther departure city t the Data pane (in the FlightFinder actin f the Parameter test), s that UFT can test the applicatin with this data. 1. Start UFT and pen the Parameter test. a. Open UFT as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. Click the Open buttn dwn arrw, and select Open Slutin. The Open Slutin dialg bx pens. c. Navigate t the Tutrial.ftsln file, lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Open. (Yu created the Parameter test in "Create a Test HPE Unified Functinal Testing (14.02) Page 102 f 112

103 Parameterizing Steps and Objects fr Parameterizatin" n page 99.) d. In the Slutin Explrer, select the Parameter test nde. 2. Open the FlightFinder actin. In the Slutin Explrer, duble-click the FlightFinder actin. 3. Enter an additinal city in the departure clumn. In the Data pane, click rw 2 in the departure clumn, enter Lndn and then press Enter. (If the Data pane is nt displayed, select View > Data.) 4. Save the test. Click Save. Cntinue with "Mdify Steps Affected by Parameterizatin" belw. Mdify Steps Affected by Parameterizatin After parameterizing ne step in a test, test bjects in ther steps might be affected when the value f the parameterized step changes. If s, yu must mdify the expected values f thse bjects t match the value resulting frm the parameterized step. In "Add Parameter Values t a Data Table" n the previus page, yu added parameter values fr the departure city in the FlightFinder actin. In this exercise, yu will mdify the text checkpint s that UFT checks fr the text that matches the current departure city during the test run. 1. Start UFT and pen the Parameter test. a. Open UFT as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. On the Start page, in the Recent Slutins area, click Tutrial. The Tutrial slutin pens, displaying the MercuryTurs, Checkpint, and Parameter tests. c. In the Slutin Explrer, select the Parameter test nde. (Yu created the Parameter test in "Create a Test fr Parameterizatin" n page 99.) 2. Lcate the text checkpint t mdify. a. In the Slutin Explrer, duble-click the Parameter test BkFlight actin. The BkFlight actin pens. (If the Editr is displayed, click the Keywrd View buttn Keywrd View.) t display the b. Right-click the Flight Cnfirmatin: Mercury rw with the existing checkpint and select Checkpint Prperties. Nte: Yu may need t expand the Flight Cnfirmatin: Mercury step t see the rw with the checkpint. HPE Unified Functinal Testing (14.02) Page 103 f 112

104 Parameterizing Steps and Objects The Text Checkpint Prperties dialg bx pens. In the Checked Text area, New Yrk is displayed in the Cnstant bx. New Yrk is the expected value fr the checkpint fr every iteratin. 3. Parameterize the text checkpint. a. Select Parameter and click the Parameter Optins buttn. The Parameter Optins dialg bx pens. HPE Unified Functinal Testing (14.02) Page 104 f 112

105 Parameterizing Steps and Objects b. In the Name bx, select departure. This instructs the checkpint t use the departure parameter values in the Data pane fr the expected results. c. Click OK t clse the Parameter Optins dialg bx, and then click OK again t clse the Text Checkpint Prperties dialg bx. The checkpint is nw parameterized. 4. Save the test. Select File > Save r click Save. Yu can nw run yur test. Cntinue with "Running and Analyzing a Parameterized Test" belw. Running and Analyzing a Parameterized Test In "Mdify Steps Affected by Parameterizatin" n page 103, yu finished creating a single data set fr the Parameter test. In this exercise, yu will run the mdified Parameter test. UFT will run the test twice, nce fr a departure frm New Yrk, and a secnd time fr a departure frm Lndn. If yu g back and add additinal parameters in the Data pane (such as additinal departure cities), additinal iteratins will be added fr each data set, each represented by a rw in the data table. 1. Start UFT and pen the Parameter test. a. Open UFT as described in "Create a New Slutin, Test, and Actins" n page 19, making sure that nly the Web Add-in is laded. b. Select File > Open > Slutin. The Open Slutin dialg bx pens. c. Navigate t the Tutrial.ftsln file, lcated in C:\%HOMEPATH%\My Dcuments\Unified Functinal Testing\Tutrial, and click Open. The Tutrial slutin pens, displaying the MercuryTurs, Checkpint, and Parameter tests. d. In the Slutin Explrer, select the Parameter test nde. (Yu created the Parameter test in "Create a Test fr Parameterizatin" n page 99.) HPE Unified Functinal Testing (14.02) Page 105 f 112

106 Parameterizing Steps and Objects 2. Cnfigure UFT t pen the Mercury Turs Web page. a. In UFT, select Recrd > Recrd and Run Settings. The Recrd and Run Settings dialg bx pens. b. Select Open the fllwing address when a recrd r run sessin begins and click OK t clse the dialg bx. 3. Run the Parameter test. a. Click the Run buttn. The Run dialg bx pens. b. Select New run results flder and accept the default results flder name. c. Click OK. When the test run is cmpleted, the run results pen. HPE Unified Functinal Testing (14.02) Page 106 f 112

107 Parameterizing Steps and Objects 4. Examine the results summary. The run results shws that the iteratins f the test passed. Drill dwn in the run results tree t view the varius results. 5. Clse the run results. In the dcument pane, clse the tab cntaining the run results. Yu've nw cmpleted the exercises in this tutrial. Cntinue with applying the cncepts and skills yu learned t testing yur wn applicatins, as described in "Where D Yu G Frm Here?" n page 108. HPE Unified Functinal Testing (14.02) Page 107 f 112

108 Where D Yu G Frm Here? In "Parameterizing Steps and Objects" n page 98, yu cmpleted adding all the test enhancements described in this tutrial. Yu are nw ready t apply the UFT cncepts and the skills yu learned t testing yur wn applicatin. This chapter includes: Mdifying UFT Settings t Save Disk Space 109 Testing Yur Own Applicatin - Getting Started 109 HPE Unified Functinal Testing (14.02) Page 108 f 112

109 Mdifying UFT Settings t Save Disk Space Sme f the settings yu cnfigured during this tutrial require a lt f disk space. Therefre, yu may want t mdify these settings t save disk space. In "Run a Test" n page 64, yu cnfigured UFT t save all images t the run results. Nw, yu will cnfigure UFT t save images nly when a step fails. 1. Start UFT. Open UFT as described in "Create a New Slutin, Test, and Actins" n page 19. There are n add-in requirements in this lessn. 2. Mdify the glbal settings fr saving images t the run results. a. Select Tls > Optins > GUI Testing tab > Screen Capture nde. b. In the Save still image captures t results ptin, select Fr errrs. (Yu can als clear the Save still image captures t results check bx s that n images are ever saved t the run results. Hwever, this may make trubleshting yur tests mre difficult.) c. Click OK t clse the Optins dialg bx. Testing Yur Own Applicatin - Getting Started This tutrial cvers the basic tls needed fr testing applicatins and Web sites. We suggest that yu use the fllwing prcedure when testing yur wn applicatin. 1. Analyze yur applicatin. Determine the develpment envirnment. This enables yu t lad the relevant UFT add-ins and prvide supprt fr the bjects in yur applicatin. Determine the business prcesses that users will perfrm. Plan yur tests and actins accrdingly. Decide hw t rganize yur test and which peratins t include. Cnsider the gals f the test, and cnfirm that yur applicatin and UFT are set t match the needs f yur test. At this stage, yu can begin creating the skeletal tests and actins t use when testing yur applicatin. 2. Prepare yur testing infrastructure. Decide hw t stre the bjects in yur test. Yu can stre the bjects fr each actin in its crrespnding lcal bject repsitry, r yu can stre the bjects fr each actin in ne r mre cmmn (shared) bject repsitries. Yu can als use the same shared bject repsitry fr multiple actins. If yu are new t testing, yu may want t use a lcal bject repsitry fr each actin. This is the default setting, and all bjects are autmatically added t the lcal repsitry f each actin. If yu are familiar with testing, it is ften mst efficient t wrk with shared bject repsitries, which can be used fr ne r mre actins. Object infrmatin is kept in ne central lcatin, and when the bjects in yur applicatin change, yu can update them in that ne lcatin fr multiple actins, in multiple tests. HPE Unified Functinal Testing (14.02) Page 109 f 112

110 Where D Yu G Frm Here? Althugh nt discussed in this tutrial, yu can als exprt test bjects frm a lcal bject repsitry t a shared bject repsitry, and yu can merge bject repsitries. Yu may als want t create functin libraries t enhance UFT functinality. Fr details, see the Unified Functinal Testing User Guide. 3. Build yur test. While yu create yur test steps (described in "Adding Steps " n page 41), fllw the steps yu expect users t perfrm as they navigate within yur applicatin. 4. Enhance yur test. Add checkpints (described in "Creating Checkpints and Using Functins" n page 68) t search fr specific values f a page, bject, text string, r table cell. Replace fixed values in yur test with parameters (described in "Parameterizing Steps and Objects" n page 98) t check hw yur applicatin perfrms the same peratins with multiple sets f data. Yu can further enhance yur test with prgramming, cnditinal, and lp statements, which add lgic t yur test. Fr details, see the Unified Functinal Testing User Guide. 5. Debug yur test. Debug yur test t check that it perates smthly and withut interruptin. Fr details, see the Unified Functinal Testing User Guide. 6. Run yur test. Run yur test n yur applicatin (described in "Running and Analyzing Tests" n page 63) t check that the applicatin functins as expected. 7. Analyze the run results. Examine the results f yur test t pinpint defects in yur applicatin. (Refer t the apprpriate sectins f this tutrial t understand what t lk fr in the run results fr checkpints r parameters.) 8. Reprt defects. If yu have ALM installed, yu can submit any defects discvered t an ALM database. (ALM is the HPE slutin fr test management. Fr details, see the Applicatin Lifecycle Management User Guide and any ther dcumentatin included with ALM.) HPE Unified Functinal Testing (14.02) Page 110 f 112

111 Send Us Feedback Let us knw hw we can imprve yur experience with the GUI Testing Tutrial fr Web Applicatins. Send yur t: HPE Unified Functinal Testing (14.02) Page 111 f 112