Unified Functional Testing Installation Guide

14 Pages·2016·0.28 MB·English

HP Unified Functional Testing
Software Version:12.52
Windows® operatingsystems
Runtime Engine Guide
DocumentReleaseDate:January2016
SoftwareReleaseDate:January2016
RuntimeEngineGuide
Legal Notices
Warranty
TheonlywarrantiesforHPproductsandservicesaresetforthintheexpresswarrantystatementsaccompanyingsuch
productsandservices.Nothinghereinshouldbeconstruedasconstitutinganadditionalwarranty.HPshallnotbeliable
fortechnicaloreditorialerrorsoromissionscontainedherein.
Theinformationcontainedhereinissubjecttochangewithoutnotice.
Restricted RightsLegend
Confidentialcomputersoftware.ValidlicensefromHPrequiredforpossession,useorcopying.ConsistentwithFAR
12.211and12.212,CommercialComputerSoftware,ComputerSoftwareDocumentation,andTechnicalDatafor
CommercialItemsarelicensedtotheU.S.Governmentundervendor'sstandardcommerciallicense.
Copyright Notice
©Copyright1992-2016Hewlett-PackardDevelopmentCompany,L.P.
TrademarkNotices
Adobe®andAcrobat®aretrademarksofAdobeSystemsIncorporated.
Google™andGoogleMaps™aretrademarksofGoogleInc
Intel®andPentium®aretrademarksofIntelCorporationintheU.S.andothercountries.
Microsoft®,Windows®,Windows®XP,andWindowsVista®areU.S.registeredtrademarksofMicrosoftCorporation.
OracleandJavaareregisteredtrademarksofOracleand/oritsaffiliates.
Documentation Updates
Thetitlepageofthisdocumentcontainsthefollowingidentifyinginformation:
SoftwareVersionnumber,whichindicatesthesoftwareversion.
l
DocumentReleaseDate,whichchangeseachtimethedocumentisupdated.
l
SoftwareReleaseDate,whichindicatesthereleasedateofthisversionofthesoftware.
l
Tocheckforrecentupdatesortoverifythatyouareusingthemostrecenteditionofadocument,goto:
https://softwaresupport.hp.com.
ThissiterequiresthatyouregisterforanHPPassportandsignin.ToregisterforanHPPassportID,goto
https://softwaresupport.hp.comandclickRegister.
Support
VisittheHPSoftwareSupportOnlinewebsiteat:https://softwaresupport.hp.com
Thiswebsiteprovidescontactinformationanddetailsabouttheproducts,services,andsupportthatHPSoftware
offers.
HPUnifiedFunctionalTesting(12.52) Page2
RuntimeEngineGuide
HPSoftwareonlinesupportprovidescustomerself-solvecapabilities.Itprovidesafastandefficientwaytoaccess
interactivetechnicalsupporttoolsneededtomanageyourbusiness.Asavaluedsupportcustomer,youcanbenefitby
usingthesupportwebsiteto:
Searchforknowledgedocumentsofinterest
l
Submitandtracksupportcasesandenhancementrequests
l
Downloadsoftwarepatches
l
Managesupportcontracts
l
LookupHPsupportcontacts
l
Reviewinformationaboutavailableservices
l
Enterintodiscussionswithothersoftwarecustomers
l
Researchandregisterforsoftwaretraining
l
MostofthesupportareasrequirethatyouregisterasanHPPassportuserandsignin.Manyalsorequireasupport
contract.ToregisterforanHPPassportID,goto:https://softwaresupport.hp.comandclickRegister.
Tofindmoreinformationaboutaccesslevels,goto:https://softwaresupport.hp.com/web/softwaresupport/access-
levels.
HP Software Solutions& Integrationsand Best Practices
VisitHPSoftwareSolutionsNowathttps://h20230.www2.hp.com/sc/solutions/index.jsptoexplorehowtheproducts
intheHPSoftwarecatalogworktogether,exchangeinformation,andsolvebusinessneeds.
VisittheCrossPortfolioBestPracticesLibraryathttps://hpln.hp.com/group/best-practices-hpswtoaccessawide
varietyofbestpracticedocumentsandmaterials.
HPUnifiedFunctionalTesting(12.52) Page3
RuntimeEngineGuide
AbouttheUFT RuntimeEngine
About the UFT Runtime Engine
TheUFTRuntimeEngineenablesyoutorunUFTtests (bothGUIandAPI)andbusinessprocesstestson
yourcomputerwithoutinstallingtheentireUFTIDE.Inaddition,youcanalsoinstalltheRuntimeEngine
withouttheRunResultsViewer,UFTAdd-inforALM,sampleapplications,orHelpdocumentation.This
canpotentiallysaveyouvaluablediskspaceonyourcomputer.
WhenyouruntestswiththeRuntimeEngine,youcanaccessandrunthetestfromanumberof
differentplaceswithouttheneedtoopentheUFTinterfaceandconfigureUFToptions.Whenthetest
runsitrunsinthebackground.Attheendofthetestrun,youcanviewthetestresults.
UsingtheRuntimeEnginerequiresverylittleexperienceinusingUFT-youdonotneedtoedittests,
changeconfigurationsorsettings,orunderstandhowtomakeUFTworkwithyourapplication.You
simplyselectthetest,runthetest,andviewtherunresults.
TheRuntimeEnginecanbeusedinanumberofdifferentscenarios:
Running YoucansetuptestrunsfromtheTestLabmoduleinALM,andruntheseonacomputerusingtheRuntime
testsand Engine.UsingtheRuntimeEngineenablesyoutorunthetest,withouttheneedtointeractwiththeUFT
components interface(suchasloadingUFTadd-insintheAdd-inManagerdialogbox).
fromALM
Running YoualsocanruntestsusingautomationusingtheRuntimeEngine.TheRuntimeEngineinstallationenables
testsfrom youtosavediskspaceonthecomputerrunningthesetests,freeingupsystemresourcesonthatcomputerfor
automation: othertasks
Running TheRuntimeEnginecanbeinstalledonabuildserverorcomputerrunningbuildsofyourapplications.Using
testsusing theJenkinsplug-in,yourunaUFTtestasapost-buildactionofyourapplication'sbuildprocess.Havingthe
theJenkins RuntimeEngineinstalledonthiscomputertoruntheUFTtestenablesyoutofreeupsystemresourcesforthe
plug-in: importantapplicationbuildtasks.
Running WhenyouinstalltheRuntimeEngine,youalsohaveexternaltoolswhichenableyoutorunUFTtestslocally,
testsusing includingtheTestBatchRunnerandtheSilentTestRunner.Thesetoolsenableyoutorunatestlocallyagainst
external yourapplicationasitisdeveloped,andviewtheresultsinstantlyafterthetestrun.BecausetheRuntimeEngine
UFTtools doesnotenableyoutoeditatest,thisversionoftheUFTinstallationcanbeusedbyyourapplication's
developersandQAonanongoingbasistoprovideregulartestingoftheapplicationthroughoutthe
developmentprocess.
TheRuntimeEnginealsosupportsalltheUFTAdd-insasthethefullUFTIDE,soyoucanruntestsusing
anysupportedtechnologyusingtheRuntimeEngine.AllobjectsandmethodsforallUFTAdd-insare
supportedforusewiththeRuntimeEngine.
Aspartofrunningatest,youcansetspecificrun-timeoptions.TheseoptionsaresetintheRuntime
EngineSettingsdialogbox,availablefromtheStartMenu(Start> All Programs > HPSoftware > HP
UnifiedFunctional Testing> Tools> Runtime Engine Settings):
Add-ins Youcanspecifyadd-instobeloaded.
Runoptions YoucanspecifyhowtheRuntimeEnginerunstests,includingtheformatoftherunresults,whetherthe
runresultsareopenedautomaticallyafteratestrun,andiftheRuntimeEnginetakesscreencapturesor
HPUnifiedFunctionalTesting(12.52) Page4
RuntimeEngineGuide
AbouttheUFT RuntimeEngine
moviesoftherunsession.
Remote YoucanspecifyifotherHPapplicationsarepermittedtoruntestsonthiscomputerusingtheRuntime
connection EngineorspecifyhowanothercomputercanruntestsviaRemoteDesktopConnection.
options
Runresult YoucanspecifyhowandwhattheRuntimeEngineshouldexportfromtherunresultsafterarunsession.
exportoptions
TextRecogition YoucanspecifyhowtheRuntimeEngineworkswithtextinyourapplicationwhenrunningaGUItest.
options
Weband YoucanspecifyhowtheRuntimeEnginerunstestsforspecificscenariosagainstaWebapplicationor
Windows Windowsapplication.
Application
options
FortaskdetailsonhowtousetheRuntimeEngine,see"HowtoUsetheUFTRuntimeEngine"onpage6.
FordetailsontheRuntimeEngineSettings,see"Prerequisite-Howtosettestrunoptions"onpage8.
HPUnifiedFunctionalTesting(12.52) Page5
RuntimeEngineGuide
HowtoUsetheUFTRuntimeEngine
How to Use the UFT Runtime Engine
Whatisthe UFTRuntime Engine?TheUFTRuntimeEngineisaslimmerinstallationofUFTthatenables
youtorunUFTtestswithouttheentireUFTIDE.
Whenyoushoulduse the UFTRuntime Engine? YoucanusetheUFTRuntimeEngineinanumberof
differentscenarios:
RunningtestsandcomponentsfromALM(eitherfromtheTestPlan,TestLab,orBusiness
l
Componentsmodules)
Runningtestsfromanautomationscript
l
RunningtestsfromtheJenkinsplugin
l
RunningtestsfromexternalUFTtoolssuchastheTestBatchRunnerortheSilentTestRunner
l
Runningtestslocallyagainstyourapplication(afterithasbeenupdated) withoutneedingtoeditthe
l
test
What do you want to know?
"Prerequisite-HowtoensuretheRuntimeEngineisinstalledcorrectly"below
l
"Prerequisite- Howtoinstallyourlicense"below
l
"Prerequisite-Howtosettestrunoptions"onpage8
l
"HowtoruntestsfromALM"onpage9
l
"Howtoruntestsusingautomation"onpage10
l
"HowtoruntestsfromtheJenkinsplugin"onpage11
l
"HowtorunrestsusingtheTestBatchRunner"onpage11
l
"HowtoruntestsusingtheSilentTestRunner"onpage12
l
Prerequisite-Howto ensuretheRuntimeEngineisinstalled correctly
BeforerunningatestusingtheRuntimeEngine,ensurethefollowing:
Youhaveinstalledandloadedthecorrectadd-insforyourtest.Thecurrentlyloadedadd-inscanbe
l
modifiedintheRuntimeEnginesettingsdialogbox.
YouhaveselectedtheAllow otherHPproductstoruntestsandcomponentsoptionintheUFT
l
Configurationsscreenoftheinstallationwizard
Ifyoudidnotperformoneorbothoftheseoptions,youcanconfigurethisoptionbyrunningtheUFT
SetupagainandselectingtheChangeoptionintheinstallationwizard.
Prerequisite- Howto install yourlicense
BeforeyoucanruntestswiththeRuntimeEngine,youmustinstallavalidUFTlicense.Youdothiseither
usingthelicenseinstallationwizardorwiththecommandline:
HPUnifiedFunctionalTesting(12.52) Page6
RuntimeEngineGuide
HowtoUsetheUFTRuntimeEngine
Fromthe 1. FromtheStartMenu,opentheLicenseInstallationWizard(Start> AllPrograms> HPSoftware
License > UnifiedFunctionalTesting> Tools> LicenseInstallationWizard).
Wizard 2. Followthestepsinthewizardtoinstallthecorrectlicensetype.
Note:
l Whenrequestingalicense,youneedthelicensetypeUFT RuntimeEngine.
Foraseatlicense,youneedalicensekeystringoralicensekeyfile.
l
Foraconcurrentlicenseinstallation,youneedtheaddressoftheLicenseServeronwhichyour
l
licensesareinstalled.
3. Exitthewizard.
WhentheRuntimeEnginerunsyourtest,itwillcheckforthelicensebeforerunningthetest.
Fromthe 1. Openacommandwindow.
Command 2. Inthecommandwindow,enteroneofthefollowing:
Line
l Foraseatlicense:"<UFT installation
directory>\bin\HP.UFT.LicenseInstall.exe" seat "<license key
string>"/seat "<path to the license key file"
Note:Youneedtoprovideeitherthelicensekeystringorthepathtothelicensekeyfile,notboth.
l Foraconcurrentlicense:"<UFT installation
directory>\bin\HP.UFT.LicenseInstall.exe" concurrent <license ID>
<license version> <server name/address> [<redundant server
name/address>] [/force]
Note:
o The<server name/address>or<redundant server name/address>uses
theformatserver name/address:port.Theportnumberisoptional.
o The<server name/address>or<redundant server name/address>must
beinthesameformatastheservernameoraddresslistedintheMaintaboftheConfiguration
paneoftheLicenseServer.FormoredetailsonsettinguptheLicenseServeraddress,seethe
AutopassLicenseServerUserGuide.
o Boththe[redundant server name/address]and/forceparametersare
optional.
o The/forceparametersavesthelicenseinstallationinformationevenifthecurrent
installationfails.OnsubsequentUFTsessions,UFTwillcheckthelistedlicenseserverforthe
listedlicense.
3. Exitthewizard.
WhentheRuntimeEnginerunsyourtest,itwillcheckforthelicensebeforerunningthetest.
HPUnifiedFunctionalTesting(12.52) Page7
RuntimeEngineGuide
HowtoUsetheUFTRuntimeEngine
Prerequisite-Howto settestrun options
Beforeyourunyourtests,youshouldspecifytheoptionsforrunningyourtests.Youcanusethe
RuntimeEngineSettingsdialogboxtospecifythesesettings.ThisdialogboxisavailablefromtheStart
Menu(Start> All Programs > HP Software > HPUnifiedFunctional Testing> Tools> Runtime Engine
Settings).
Youcanupdatethesettingsinthefollowingways:
Manually Usingtheoptionsprovidedinthedialogbox,selecttherelevantvaluesfromthedrop-downlistsandclick
configurethe Applytosavethesettings.
settings:
Afteryouupdatethesesettings,youcanclicktheExportSettingstoScriptbutton ,which
HPUnifiedFunctionalTesting(12.52) Page8
RuntimeEngineGuide
HowtoUsetheUFTRuntimeEngine
exportsthesesettingsintoanautomationscriptfile(savedwitha.vbsextension).Thisscriptcanbe
reimportedonyourcomputerforlatertestrunsorsharedwithothersrunningtestsviatheRuntime
Engine.
Importthe YoucanalsoupdatethesesettingsfromangeneratedautomationscriptexportedfromtheUFTIDEon
settingsfroma anothercomputerorexportedfromanotherinstallationoftheRuntimeEngine.
configuration Dothefollowing:
script:
1. ClicktheImportSettingsfromScriptbutton .
2. Navigatetothedirectorywhereyourimportscript(witha.vbsextension)issavedandclickOpen.
Thesettingsinthedialogareupdatedaccordinglytoreflectthedatainthescript.
Fordescriptionsofeachoftheoptions,selecttheiteminthedialogboxandviewthedescriptionatthe
bottomofthedialog.
Note: IfyouaresettingtheoptionsfortheRemoteDesktopconnectionintheRuntimeEngine
Settingsdialog,youmustlogintothecomputerasanadministratorandstarttheHP.UFT.Helper
servicebeforechangingtheseoptions.
Howto run testsfrom ALM
UsingtheRuntimeEngine,youcanruntestsandcomponentsdirectlyfromtheTestLabModules:
1. EnsurethattheDCOM hasbeenconfiguredtoruntestsfromALMaspartoftheinstallation.
IfthisconfigurationwasnotdoneduringtheRuntimeEngineinstallation,youcanperformthe
configurationwiththeAdditionalInstallationRequirementstool(installedwiththeRuntime
Engine),foundintheStartMenu (Start> All Programs > HP Software > HPUnifiedFunctional
Testing> Tools> Additional InstallationRequirements > Configure DCOM Settingsfor
ALM Integrationoption).
2. Setyourtestrunoptions,asdescribedin"Prerequisite-Howtosettestrunoptions"onthe
previouspage.
3. StarttheRemoteAgentfromtheStartMenu(Start> All Programs > HP Software > HP Unified
Functional Testing>Tools> Remote Agent).
4. IntheWindowstray,right-clicktheRemote Agenticon andselectSettings.
5. IntheRemoteAgentSettingsdialogbox,configurethefollowingoptionsasneeded:
Restarttestingtool after__ runs
l
Close testingtool after__ idle minutes
l
Restarttestingtool after
l
Note: TheotheroptionsintheRemoteAgentarenotapplicableforusewiththeRuntime
Engine.
HPUnifiedFunctionalTesting(12.52) Page9
RuntimeEngineGuide
HowtoUsetheUFTRuntimeEngine
6. InALM,fromtheTestPlanmodule,runindividualtestsoratestset,dependingonyourneeds.For
detailsonsettinguptestsetsandrunningfromALM,seetheHPApplicationLifecycleManagement
UserGuide.
7. Afterthetestrunisfinished,viewtheresultsasspecifiedinyourtestrunoptions.
Howto run testsusing automation
AutomationisaMicrosofttechnologythatmakesitpossibletoaccesssoftwareobjectsinsideone
applicationfromotherapplications.Theseobjectscanbecreatedandmanipulatedusingascriptingor
programminglanguagesuchasVBScriptorVC++.Automationenablesyoutocontrolthefunctionalityof
anapplicationprogrammatically.
Usingautomation,youcanwritescriptsthatopenUFT,setoptionsandsettings,andrunthetest.This
enablesyoutoautomaticallyruntestsatscheduledtimeswithoutyourmanualintervention.
Forexample,youcancreateandrunanautomationscriptfromMicrosoftVisualBasicthatdoesthe
following:
Loadstherequiredadd-insforatestorcomponent
l
StartsUFT
l
Opensthetestorcomponent
l
ConfiguressettingsthatcorrespondtothoseintheOptionsdialogbox,TestorBusinessComponents
l
Settingsdialogbox,andtheRecordandRunSettingsdialogbox(allinthefullUFTIDE)
Runsthetestorcomponent
l
Whenyouruntestsusingautomation,dothefollowing:
1. Ifanothercomputerisrunningautomationscriptsvia the computerwiththe Runtime
Engine, ensurethattheDCOM hasbeenconfiguredtoruntestswithautomationaspartofthe
installation.
IfthisconfigurationwasnotdoneduringtheRuntimeEngineinstallation,youcanperformthe
configurationwiththeAdditionalInstallationRequirementstool(installedwiththeRuntime
Engine),foundintheStartMenu (Start> All Programs > HP Software > HPUnifiedFunctional
Testing> Tools> Additional InstallationRequirements > Configure DCOM Settingsfor
AutomationScriptsoption).
2. EnsurethatyourscriptisaccessiblefromthecomputerwiththeRuntimeEngine.
3. Setyourtestrunoptions,asdescribedin"Prerequisite-Howtosettestrunoptions"onpage8.
4. Runyourtestscript,usingyourpreferredautomationrunmodel.Fordetailsonrunningtestsvia
automation,seetheHPUnifiedFunctionalTestingUserGuide,availablefromtheHPSoftware
ProductManualsWebsite(https://softwaresupport.hp.com/group/softwaresupport/search-
result?keyword=).
Note: TheoptionsinyourautomationscriptsthatsetUFTtobevisibleareignoredwhen
runningatestwiththeRuntimeEngine.Thetestrunswithoutproblemsevenifyour
automationscriptscontaintheseoptions,includingthefollowingautomationmethods:
HPUnifiedFunctionalTesting(12.52) Page10