Maintaining page objects
A Page Object lists field names and their locators for a single Visualforce or non-Salesforce webpage. Provar provides various locator methods:
- Visualforce: The recommended method for locating Visualforce fields, this locator anchors a field to the variable definition in the Visualforce APEX code. Refer to Visualforce Testing for more information.
- Label: Used to locate fields by the immediately preceding label, this locator can be used when testing a non-Salesforce webpage.
- Id or XPath: Alternative methods for use on non-Salesforce webpages; these are the standard locators for identifying a field when using Selenium. These values are typically identified by inspecting a webpage, but Provar has a built-in option to help with optimization. Refer to Creating an XPath for more information.
Finding page objects in the test project
Page Objects can be found in the /src/pageobjects directory of your Test Project. Since Page objects are Java classes, the compiled code can be found in /bin/pageobjects.
You can create additional folders underneath the pageobjects folder. When setting your Page Object name, precede the name with the name of your folder followed by a period (‘.’).
Viewing page objects
There are two views of the Page Object. The first is the Page Object Editor View. This enables you to modify locators using the GUI.
The second view is the Java Source, where you can directly update source code.
Changing a locator field type
Provar will always default the field type of a locator. This generally helps to prevent you from passing incorrect data for the field.
It is possible, however, to change the field type of a locator by overriding the Editor in the Page Object.
The most common options are as follows:
- Text Editor (with expressions): Allows strings, variables, and formulas
- Link or Button Editor: Use this for clicking links or buttons
- Choice Editor: Use this for adding picklist values
To set the field type, navigate to the Page Object Editor View and change the Value Type.
Then save the test case.
Adding field waits
Sometimes, your tests may need to wait for a field to appear or for logic to complete, such as a dependent picklist, before execution can proceed.
Adding a Sleep or a Wait condition to the overall test case is possible. However, if a particular field always requires a specific wait condition, an efficient method of accomplishing this can be to add a Wait to the field in the Page Object.
There are three Wait options:
- Wait for a field to appear or become enabled. This option is recommended since Provar will check at regular intervals whether the field is available, helping to ensure accuracy and efficiency. This can be applied to the selected field or a different field.
- Wait for a fixed duration: This option specifies a duration in seconds. The disadvantage of this option is the difficulty of predicting what fixed duration to add. Option 1 is generally recommended over this option.
- Wait for background requests to complete: This option will wait for synchronous page call-outs before continuing.
To apply a Wait option, navigate to the Page Object Editor View locator.
Add a Before Wait or an After Wait.
Then, save the test case.
Debugging page objects
If a Page Object is not correctly updated, there may be a compilation issue.
Use the Problems view and search under the Error grouping to find the error. When you locate the error, right-click and select Go To Resource to go straight to the relevant Page Object (or test case).
You may also find a Quick Fix option for the error.
A red X icon in the left margin also identifies errors in the Page Object Java Source.
Hovering over the X will provide information about the error.
- 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
- Functions
- 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
- NitroX
- Provar desktop
- Provar Test Builder
- Refresh and Recompile
- Reintroduction of CLI license Check
- Reload Org Cache
- Reporting
- 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
- Using custom APIs
- Callable tests
- Data-driven testing
- Page objects
- Block locator strategies
- Introduction to XPaths
- Creating an XPath
- JavaScript locator support
- Label locator strategies
- Maintaining page objects
- Mapping non-Salesforce fields
- Page object operations
- ProvarX™
- Refresh and reselect field locators in Test Builder
- Using Java method annotations for custom objects
- Applications testing
- 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
- CircleCI
- Copado
- Docker
- Flosum
- Gearset DevOps CI/CD
- 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
- Jenkins
- Execution Environment Security Configuration
- Provar Jenkins Plugin
- Parallel Execution
- Running Provar on Linux
- Reporting
- Salesforce DX
- Git
- Team Foundation Server
- Version control
- Provar Automation trial guide and extensions
- Salesforce Testing
- Provar Manager
- Best Practices
- Troubleshooting
- Release Notes