Skip to content

Editing Test Instruction for Locator Changes

Typically any deployment of Application under Test (AUT) can have an impact on the locator of a field. If the field that has modified locators are used in a Test Script, execution would fail with error "Element not found." In such cases, you have to edit the instruction (in the specific test script(s)) to modify the locators to the recent ones.

When a test script is created using QaSCRIBE, Worksoft SaaS will capture multiple locators for every field to reduce the likeliness of a test execution failing. Whether it is one or more of the locators that are impacted, you may want to update these to the latest ones. You can edit test script and manually update the locator or use QaSCRIBE to update these (refer to article Understanding how to build test scripts by using QaSCRIBE).

Irrespective of how the locator of instruction is updated, you may have to be wary of the same field used more than once in the same test script. In such cases, you would need locators to be modified at all the instructions. Worksoft SaaS does take care of this without you having to search for all instructions with the same locator.

Edit Locator and Save

When you modify a locator and save the changes (by clicking save icon at the locator level or instruction level or test script level) Worksoft SaaS would prompt you with a popover with all the instructions wherein the same locator is used. You can review all the instructions before you choose to save the test script and Worksoft SaaS will update all of them.

Worksoft SaaS provides you a great feature where having the same locator(s) available in the multiple instructions within the test script can be auto-updated by updating one of the locators. This can be done by following multiple approaches that give you a provision to auto-update the locators accordingly.



The popover "Magic Wand - Instructions that can benefit from auto-updated locators" provides the details of the instruction modified by you and also other instructions where the same locators is used within the test script. Information provided on the popover includes

Instruction # of the instruction modified
Instruction # of the instructions where the same locator is used
Locator type
Old & New(updated) values of the Locator


Here is the viewport for viewing the new(modified) and old locators as shown below.

Once the locators are auto-updated, you can see them highlighted and shown in the blue background color.

Feedback and Knowledge Base