What are XF Definitions and How to use them in Worksoft certify?

What are XF Definitions

Worksoft Certify has grown over the years to support many applications developed using diverse technology stack. For web applications, certify uses its factory XF definitions and configurations to identify and learn the objects for automation. Definitions tell Certify how to interact with the object and Configurations tell Certify how to learn them.

Whenever a new or custom web object is encountered that are not defined in Certify’s factory definitions, the definitions and configurations in Certify should then need to be modified to support the new web object. Fortunately, this can be done without having to modify Certify code, thanks to its developers. The developers in the engineering team would create definitions and configurations XML file to let Certify know how to interact and learn the new object.

Extensibility Framework Tool located at C:\Program Files (x86)\Worksoft\Certify\Interface Client\Worksoft\wsTest\HTML is used for creating such definitions and configurations.

Certify automation developers should strictly avoid modifying these settings as it would result in object recognition failures for everyone using the XF.

When will you need XF’s?

  • Objects that are not supported by the existing factory definitions and configurations.
  • Objects that may require multiple steps to perform an action. Ex: [Dropdown] Click Dropdown, Type Keys for choosing the value, Pressing Enter to select the value (3 steps). Usually automating drop-down selection will need only one step in
  • Objects may render as a different class. Ex: HTML Table may be identified as HTML Link.
  • Objects that work only for the first time and fail during other runs
  • Objects that are supported but contain a combination of objects etc.

Where to download them?

Most of your applications may not need an XF definition, use it only if you were directed by Worksoft’s support/engineering team. You can download XF’s for many standard ERP applications in the Worksoft’s community portal.

Where to download themconfiguration XML files

 

Once you have downloaded the package, it should contain definition and configuration XML files.

 

download XF’s for many standard

How to import XF definitions into Certify?

After you have received the XF package either from Worksoft or by community download, you must import them into Certify to use them for your AUT. Follow the steps below to do so,

Step 1: In Certify’s home screen, Navigate to Tools Configure Web Options

 

How to import XF definitions into Certify

 

Step 2: You should see the Certify Web Interface Options screen below. Under Global Settings,choose the “Definitions” tab and click on Import to successfully import the definition XML file provided in the XF package.

Global Settings

XF package

 

Step 3: Under Global Settings, choose the “Configurations” tab and click on Import to successfully import the configuration XML file provided in the XF package.

Global Settings Configurations

Note: You must import both the files in XF package for Certify to interact with objects correctly.

How to use an imported XF definition in Certify?

Step 1: In Certify’s home screen, Navigate to Tools Configure Web Options

Step 2: You should see the Certify Web Interface Options screen below. Under User Settings, select your Configuration, Definition, Execution Engine as Cross Browser and Cross Browser LiveTouch as True.

How to use an imported XF definition in Certify

Note: These settings are applicable only to the individual Certify user. If you want the XF definition to be used globally by all the users, kindly use the global settings tab.

Certify now recognizes the objects through LiveTouch, Web Learn and Capture

global settings tab

Web Learn and Capture

Certify now recognizes the objects throughLiveTouch

 

Reference & Credit

Web eXtensibility Framework (XF) Definitions from Docs.Worksoft.com

Leave a Reply

Please wait...

Subscribe to our newsletter

Want to be notified when our article is published? Enter your email address and name below to be the first to know.