Refresh and Reselect Field Locators in Test Builder
We’ve made it easier to manage field locators directly within Test Builder. You can refresh locators to repair a broken locator in just a few clicks. You can also change them to a different type of locator based on your preference.
Notes: This feature is designed to help you test custom Salesforce components and non-Salesforce applications. Since Provar is designed to natively adapt to Salesforce and is metadata-driven, you do not need to use this feature for standard Salesforce components/functionality.
Who does this impact?
Provar users who would like to change and/or fix a broken locator directly within the Test Builder.
Why is this important?
This feature is designed to address these challenges:
- Sometimes, a field locator may stop working when existing tests are run against a new application release due to technical changes. This is often due to changes in how the web page source is structured.
- You can also use this feature to change the locator type if you feel Provar has not selected your preferred one by default.
If I use the same field more than once in a test, do I need to manually repair the field locator for every test step that interacts with that field?
No. if you repair a broken field locator in one test step, this will repair all of the test steps that use the same mapping locator. The same field mapping information for a page object is stored and shared across those steps.
How can I use this feature?
We now offer a simple click-to-fix solution. You can access this feature while adding a new test step or editing an existing test step to repair a broken locator or to change a locator on demand.
If you find a test step failing due to a broken locator, Provar can help suggest a new locator to fix the test step.
Step 1: Navigate to the Test Builder and right-click the test step you want to edit.
Step 2: Select Edit the Test Step from the drop-down menu.
Step 3: Click the Edit button next to Field Details. The Field Locator field will now appear.
Step 4: In the application you are testing, right-click the target element for the current test step you are editing and select Refresh Field Locators from the drop-down menu. Provar will recalculate the new, recommended locator and an alternate set of locators. You can view the full list of updated locators in the Field Locator drop-down menu by clicking the caret icon.
Step 5: Select your preferred option from the drop-down menu. You can optionally edit the field parameters.
Step 6: Click Save & Do to save your changes.
Changing locators on demand
You can change field locators while adding a new test step or editing an existing one.
Step 1: Right-click the field and select Add to Test Case. (You can skip this step if editing an existing test step. If you are editing an existing test step, navigate to the Test Builder and right-click the test step you want to edit. Select Edit the Test Step from the drop-down menu.
Step 2: Click the Edit button next to Field Details. The Field Locator field will now appear.
Step 3: Click the caret icon above the Field Locator field to view the available field locator options. You can populate additional options if you only see one locator in the drop-down menu. In the application you are testing, right-click the target element for the current test step you are editing and select Refresh Field Locators from the drop-down menu. Provar will recalculate the new, recommended locator and an alternate set of locators. You can view the full list of updated locators in the Field Locator drop-down menu by clicking the caret icon.
Step 4: Select your preferred option from the drop-down menu. You can optionally edit the field parameters.
Step 5: Click Save & Do to save your changes.
- Provar Automation
- Installing Provar Automation
- Updating Provar Automation
- Using Provar Automation
- API Testing
- Behavior-Driven Development
- Creating and Importing Projects
- Creating Test Cases
- Custom Table Mapping
- Debugging Tests
- Defining a Namespace Prefix on a Connection
- Defining Proxy Settings
- Environment Management
- Exporting Test Cases into a PDF
- Exporting Test Projects
- Override Auto-Retry for Test Step
- Managing Test Steps
- Namespace Org Testing
- Provar Automation
- Provar Test Builder
- Refresh and Recompile
- Reintroduction of CLI License Check
- Reload Org Cache
- Running Tests
- Searching Provar with Find Usages
- Secrets Management and Encryption
- Setup and Teardown Test Cases
- Tags and Service Level Agreements (SLAs)
- Test Cycles
- Test Plans
- Testing Browser Options
- Tooltip Testing
- Using the Test Palette
- Test Palette Introduction
- Control Test Steps
- Generate Test Case
- List Compare
- Page Object Cleaner
- Read Test Step
- String Test Steps
- UI Test Steps
- Using Custom APIs
- Callable Tests
- Data-Driven Testing
- Page Objects
- Block Locator Strategies
- Introduction to XPaths
- Creating an XPath
- Label Locator Strategies
- Maintaining Page Objects
- Mapping Non-Salesforce fields
- Page Object Operations
- Refresh and Reselect Field Locators in Test Builder
- Using Java Method Annotations for Custom Objects
- Applications Testing
- Database Testing
- Document Testing
- Email Testing
- Mobile Testing
- OrchestraCMS Testing
- Salesforce CPQ Testing
- ServiceMax Testing
- Skuid Testing
- Vlocity API Testing
- Webservices Testing
- Provar Manager
- How to Use Provar Manager
- Provar Manager Setup
- Provar Manager Integrations
- Release Management
- Test Management
- Test Operations
- Provar Manager and Provar Automation
- Setting Up a Connection to Provar Manager
- Object Mapping Between Automation and Manager
- How to Upload Test Plans, Test Plan Folders, Test Plan Instances, and Test Cases
- Provar Manager Filters
- Uploading Callable Test Cases in Provar Manager
- Uploading Test Steps in Provar Manager
- How to Know if a File in Automation is Linked in Test Manager
- Test Execution Reporting
- Metadata Coverage with Manager
- Provar Grid
- Introduction to Provar DevOps
- Introduction to Test Scheduling
- Apache Ant
- Configuration for Sending Emails via the Automation Command Line Interface
- Continuous Integration
- AutoRABIT Salesforce DevOps in Provar Test
- Azure DevOps
- Running a Provar CI Task in Azure DevOps Pipelines
- Configuring the Automation secrets password in Microsoft Azure Pipelines
- Parallel Execution in Microsoft Azure Pipelines using Multiple build.xml Files
- Parallel Execution in Microsoft Azure Pipelines using Targets
- Parallel execution in Microsoft Azure Pipelines using Test Plans
- Bitbucket Pipelines
- GitHub Actions
- Integrating GitHub Actions CI to Run Automation CI Task
- Remote Trigger in GitHub Actions
- Parameterization using Environment Variables in GitHub Actions
- Parallel Execution in GitHub Actions using Multiple build.xml Files
- Parallel Execution in GitHub Actions using Targets
- Parallel Execution in GitHub Actions using Test Plan
- Parallel Execution in GitHub Actions using Job Matrix
- GitLab Continuous Integration
- Travis CI
- Execution Environment Security Configuration
- Provar Jenkins Plugin
- Parallel Execution
- Running Provar on Linux
- Salesforce DX
- Team Foundation Server
- Version Control
- Masking Provar Credentials on CI
- Salesforce Testing
- Adding a Salesforce Connection
- Assert Page Error Messages on Add/Edit Product
- Internationalization Support
- List and Table Testing
- Salesforce Console Testing
- Salesforce Lightning Testing
- Salesforce Lightning Web Component (LWC) Locator Support
- Salesforce Release Updates
- Visualforce Testing
- Best Practices
- Salesforce Connection Best Practices
- Improve Your Metadata Performance
- Testing Best Practices
- Automation Planning
- Supported Testing Phases
- Provar Naming Standards
- Test Case Design
- Create records via API
- Avoid using static values
- Abort Unused Test Sessions/Runs
- Avoid Metadata performance issues
- Increase auto-retry waits for steps using a global variable
- Create different page objects for different pages
- The Best Ways to Change Callable Test Case Locations
- Working with the .testProject file and .secrets file
- Best practices for the .provarCaches folder
- Best practices for .pageObject files
- Configurations and Permissions
- Error Messages
- Provar Manager 3.0 Install Error Resolution
- Provar Manager Test Case Upload Resolution
- Administrator has Blocked Access to Client
- macOS Big Sur Upgrade
- Resolving Failed to Create ChromeDriver Error
- Resolving Jenkins License Missing Error
- Resolving Metadata Timeout Errors
- Test Execution Fails – Firefox Not Installed
- Selenium 4 Upgrade
- Licensing, Installation and Firewalls
- Test Builder and Test Cases
- Release Notes