HP UFT Java Add-in Extensibility Developer Guide

223 Pages·2013·1.53 MB·English

HP UFT Java Add-in Extensibility
Forthe Windows ® operating systems
Software Version:11.50
Developer Guide
DocumentReleaseDate:October2013
SoftwareReleaseDate:September2012
DeveloperGuide
Legal Notices
Warranty
TheonlywarrantiesforHPproductsandservicesaresetforthintheexpresswarrantystatements
accompanyingsuchproductsandservices.Nothinghereinshouldbeconstruedasconstitutingan
additionalwarranty.HPshallnotbeliablefortechnicaloreditorialerrorsoromissionscontained
herein.
Theinformationcontainedhereinissubjecttochangewithoutnotice.
Restricted Rights Legend
Confidentialcomputersoftware.ValidlicensefromHPrequiredforpossession,useorcopying.
ConsistentwithFAR12.211and12.212,CommercialComputerSoftware,ComputerSoftware
Documentation,andTechnicalDataforCommercialItemsarelicensedtotheU.S.Government
undervendor'sstandardcommerciallicense.
Copyright Notice
©Copyright1992-2013Hewlett-PackardDevelopmentCompany,L.P.
Trademark Notices
Adobe®isatrademarkofAdobeSystemsIncorporated.
Microsoft®andWindows®areU.S.registeredtrademarksofMicrosoftCorporation.
UNIX®isaregisteredtrademarkofTheOpenGroup.
Page2of223 HPUFTJavaAdd-inExtensibility(11.50)
DeveloperGuide
Documentation Updates
Thetitlepageofthisdocumentcontainsthefollowingidentifyinginformation:
SoftwareVersionnumber,whichindicatesthesoftwareversion.
l
DocumentReleaseDate,whichchangeseachtimethedocumentisupdated.
l
SoftwareReleaseDate,whichindicatesthereleasedateofthisversionofthesoftware.
l
Tocheckforrecentupdatesortoverifythatyouareusingthemostrecenteditionofadocument,go
to:
http://h20230.www2.hp.com/selfsolve/manuals
ThissiterequiresthatyouregisterforanHPPassportandsignin.ToregisterforanHPPassport
ID,goto:
http://h20229.www2.hp.com/passport-registration.html
OrclicktheNewusers-pleaseregisterlinkontheHPPassportloginpage.
Youwillalsoreceiveupdatedorneweditionsifyousubscribetotheappropriateproductsupport
service.ContactyourHPsalesrepresentativefordetails.
HPUFTJavaAdd-inExtensibility(11.50) Page3of223
DeveloperGuide
Support
VisittheHPSoftwareSupportOnlinewebsiteat:
http://www.hp.com/go/hpsoftwaresupport
Thiswebsiteprovidescontactinformationanddetailsabouttheproducts,services,andsupport
thatHPSoftwareoffers.
HPSoftwareonlinesupportprovidescustomerself-solvecapabilities.Itprovidesafastand
efficientwaytoaccessinteractivetechnicalsupporttoolsneededtomanageyourbusiness.Asa
valuedsupportcustomer,youcanbenefitbyusingthesupportwebsiteto:
Searchforknowledgedocumentsofinterest
l
Submitandtracksupportcasesandenhancementrequests
l
Downloadsoftwarepatches
l
Managesupportcontracts
l
LookupHPsupportcontacts
l
Reviewinformationaboutavailableservices
l
Enterintodiscussionswithothersoftwarecustomers
l
Researchandregisterforsoftwaretraining
l
MostofthesupportareasrequirethatyouregisterasanHPPassportuserandsignin.Manyalso
requireasupportcontract.ToregisterforanHPPassportID,goto:
http://h20229.www2.hp.com/passport-registration.html
Tofindmoreinformationaboutaccesslevels,goto:
http://h20230.www2.hp.com/new_access_levels.jsp
Page4of223 HPUFTJavaAdd-inExtensibility(11.50)
DeveloperGuide
Contents
Contents
Contents 5
Welcome to HP UFT Java Add-in Extensibility 10
AbouttheUFTJavaAdd-inExtensibilitySDK 10
AbouttheUFTJavaAdd-inExtensibilityDeveloperGuide 11
WhoShouldReadThisGuide 12
UnifiedFunctionalTestingHelp 12
AdditionalOnlineResources 13
Part1:Working with Java Add-in Extensibility 14
Chapter1:IntroducingUFTJavaAdd-inExtensibility 15
AboutUFTJavaAdd-inExtensibility 16
IdentifyingtheBuildingBlocksofJavaAdd-inExtensibility 16
DecidingWhentoUseJavaAdd-inExtensibility 17
AnalyzingtheDefaultUFTSupportandExtensibilityOptionsforaSampleCustom
Control 18
Chapter2:InstallingtheHP UFTJavaAdd-inExtensibilitySoftwareDevelopmentKit 23
AboutInstallingtheHP UFTJavaAdd-inExtensibilitySDK 24
Pre-InstallationRequirements 25
InstallingtheHP UFTJavaAdd-inExtensibilitySDK 25
UninstallingtheHP UFTJavaAdd-inExtensibilitySDK 28
TroubleshootingandLimitations-JavaAdd-inExtensibilityEclipsePlug-in 29
Chapter3:ImplementingCustomToolkitSupport 30
AboutCustomToolkitSupport 31
IntroducingJavaAdd-inExtensibilityTerminology 32
PreparingtoCreateSupportforaCustomToolkit 32
CreatingaCustomToolkitSupportSet 33
UnderstandingtheToolkitSupportClass 35
UnderstandingtheToolkitConfigurationFile 36
UnderstandingtheTestObjectConfigurationFile 37
HowUFTLoadstheTestObjectConfigurationXML 42
HPUFTJavaAdd-inExtensibility(11.50) Page5of223
DeveloperGuide
Contents
UnderstandingHowUFTMergesTestObjectConfigurationFiles 42
UnderstandingCustomSupportClasses 43
DeterminingtheInheritanceHierarchyforaSupportClass 45
MappingaCustomControltoaTestObjectClass 48
SupportingIdentificationProperties 48
SupportingTestObjectMethods 51
SupportingtheRecordOption 53
SupportingTop-LevelObjects 55
SupportingWrapperControls 56
SupportClassSummary 60
UsingMethodsfromMicAPI 61
DeployingandRunningtheCustomToolkitSupport 61
AboutDeployingtheCustomToolkitSupport 61
DeployingtheCustomToolkitSupport 62
ModifyingDeployedSupport 65
ModifyingIdentificationPropertyAttributesinaTestObjectConfigurationFile 65
RemovingDeployedSupport 66
LoggingandDebuggingtheCustomSupportClass 67
WorkflowforImplementingJavaAdd-inExtensibility 69
Chapter4:PlanningCustomToolkitSupport 70
AboutPlanningCustomToolkitSupport 71
DeterminingtheCustomToolkitRelatedInformation 71
DeterminingtheSupportInformationforEachCustomClass 71
UnderstandingtheCustomClassSupportPlanningChecklist 72
CustomClassSupportPlanningChecklist 74
WhereDoYouGofromHere? 75
Chapter5:UsingtheUFTJavaAdd-inExtensibilityEclipsePlug-In 76
AbouttheUFTJavaAdd-inExtensibilityEclipsePlug-In 77
NewUFTJavaAdd-inExtensibilityProjectWizard 77
UFTJavaAdd-inExtensibilityProjectScreen 79
CustomToolkitDetailsScreen 81
Page6of223 HPUFTJavaAdd-inExtensibility(11.50)
DeveloperGuide
Contents
ProjectSummaryScreen 85
ModifyingUFTJavaAdd-inExtensibilityProjectProperties 86
NewUFTCustomSupportClassWizard 87
CustomClassSelectionScreen 88
TestObjectClassSelectionScreen 93
CustomSupportTestObjectIdentificationPropertiesScreen 95
CustomSupportTestObjectMethodsScreen 98
UnderstandingtheTestObjectMethodDialogBox 101
CustomControlRecordingSupportScreen 104
NewTestObjectClassDetailsScreen 108
CustomControlSupportClassSummaryScreen 111
NewUFTCustomStatic-TextSupportClassWizard 112
CustomStatic-TextClassSelectionScreen 114
CustomStatic-TextSupportClassSummaryScreen 115
WorkingwithUFTCommandsinEclipse 116
Part2:Tutorial:Learning to Create Java CustomToolkitSupport 124
Chapter6:UsingtheUFTJavaAdd-inExtensibilityTutorial 125
UnderstandingtheTutorialLessonStructure 126
CheckingTutorialPrerequisites 127
Chapter7:LearningtoSupportaSimpleControl 129
PreparingforThisLesson 130
ModifyingtheSampleApplicationtoRunFromAnotherLocation 131
PlanningSupportfortheImageButtonControl 132
CustomClassSupportPlanningChecklist 135
CreatingaNewUFTJavaAdd-inExtensibilityProject 135
UnderstandingYourNewCustomToolkitSupportSet 140
CreatingaNewUFTCustomSupportClass 142
UnderstandingtheNewCustomSupport 150
UnderstandingtheBasicsoftheImageButtonCSClass 151
UnderstandingIdentificationPropertyandTestObjectMethodSupport 151
UnderstandingEventRecordingSupport 152
HPUFTJavaAdd-inExtensibility(11.50) Page7of223
DeveloperGuide
Contents
DeployingandTestingtheNewCustomToolkitSupport 153
ChangingtheNameoftheTestObject 154
ImplementingSupportforaTestObjectMethod 156
ImplementingEventHandlerMethodstoSupportRecording 157
LessonSummary 159
WhereDoYouGofromHere? 159
Chapter8:LearningtoSupportaCustomStatic-TextControl 160
PreparingforThisLesson 161
PlanningSupportfortheImageLabelControl 161
CustomClassSupportPlanningChecklist 165
CreatingtheUFTCustomStatic-TextSupportClass 166
UnderstandingtheNewCustomStatic-TextSupportClass 170
DeployingandTestingtheNewCustomStatic-TextSupportClass 170
CompletingtheSupportfortheStatic-TextControl 172
OptimizingtheImageControlsToolkitSupport 175
CreatingSupportfortheImageControlCustomClass 175
ModifyingtheImageControlsToolkitSupportHierarchy 182
DeployingandTestingtheNewImageControlsToolkitSupport 183
LessonSummary 184
WhereDoYouGofromHere? 184
Chapter9:LearningtoSupportaComplexControl 185
PreparingforThisLesson 186
PlanningSupportfortheAllLightsControl 187
CustomClassSupportPlanningChecklist 191
CreatingtheUFTJavaAdd-inExtensibilityProject 192
CreatingtheNewUFTCustomSupportClass 197
UnderstandingtheNewCustomSupportFiles 211
UnderstandingtheAllLightsCSCustomSupportClass 211
UnderstandingtheJavaboutiqueTestObjectConfigurationFile 212
DeployingandTestingtheNewCustomToolkitSupport 213
ImplementingSupportfortheAllLightsControl 216
Page8of223 HPUFTJavaAdd-inExtensibility(11.50)
DeveloperGuide
Contents
ImplementingSupportforNewIdentificationProperties 216
ImplementingSupportforNewTestObjectMethods 217
ImplementingSupportforRecording 218
TestingtheCompletedSupport 219
LessonSummary 221
WhereDoYouGofromHere? 221
We appreciate yourfeedback! 222
HPUFTJavaAdd-inExtensibility(11.50) Page9of223
DeveloperGuide
WelcometoHP UFTJavaAdd-inExtensibility
Welcome to HP UFT Java Add-in Extensibility
HP UFTJavaAdd-inExtensibilityisanSDK(SoftwareDevelopmentKit)packagethatenablesyou
tosupporttestingapplicationsthatusethird-partyandcustomJavacontrolsthatarenotsupported
out-of-the-boxbytheUFTJavaAdd-in.
Thischapterincludes:
AbouttheUFTJavaAdd-inExtensibilitySDK 10
AbouttheUFTJavaAdd-inExtensibilityDeveloperGuide 11
WhoShouldReadThisGuide 12
UnifiedFunctionalTestingHelp 12
AdditionalOnlineResources 13
About the UFT Java Add-in Extensibility SDK
TheUFTJavaAdd-inExtensibilitySDKinstallationprovidesthefollowing:
AnAPI thatenablesyoutoextendtheUFTJavaAdd-intosupportcustomJavacontrols.
l
Aplug-infortheEclipseJavadevelopmentenvironment,whichprovideswizardsand
l
commandsthathelpyoucreateandeditcustomtoolkitsupportsets.
TheJavaAdd-inExtensibilityHelp,whichincludesthefollowing:
l
Adeveloperguide,includingastep-by-steptutorialinwhichyoudevelopsupportforasample
n
customcontrol.
AnAPIReference.
n
AToolkitConfigurationSchemaHelp.
n
TheUFTTestObjectSchemaHelp.
n
TheHelpisavailablefromStart> All Programs> HP Software> HP UnifiedFunctional
Testing> Extensibility> Documentation
Aprinter-friendlyAdobeportabledocumentformat(PDF)versionofthedeveloperguide
l
(availablefromStart> All Programs> HP Software> HP UnifiedFunctional Testing>
Extensibility> Documentationandinthe<UnifiedFunctional Testing
installation>\help\Extensibilityfolder).
AsetofsampleapplicationsandcompletedJavaAdd-inExtensibilityprojectsthatextend
l
supportfortheseapplications.
HPUFTJavaAdd-inExtensibility(11.50) Page10of223