Managing Test Steps
Once you’ve created your test case you can start adding test steps to it. You can do this via the Salesforce UI with the Test Builder, or add a Salesforce API to set up some test data, or use one of Automation’s many test steps to perform other tasks.
In Automation, use the test case view to review all the test steps in your current test case. Click on any test step to see its Parameters and Settings. You can make changes and save your test case at any time.
Parameters
Parameters are containers of information relating to your test steps and to the overall test case. Each Parameter will have a defined format for entering the information, but these formats can often be amended by the tester depending on requirements. Most formats are readily intuitive as they have guided inputs.
Some common formats are as follows.
Expression (): A common format that supports complex expressions, variables or text (see Writing Expressions section below for more information).
Choice (): Another common format that supplies a picklist/dropdown of defined data options.
Date (): Supports date values, entered using a calendar view.
Boolean (): Supports boolean/checkbox values.
Number (): Supports only numeric values.
Password (): Accepts alphanumeric and special characters, values entered are obscured and stored in the project .secrets file.
UI Choice (): Defines the screen and field options for UI testing (generally autopopulated through the Test Builder)
UI Action (): Defines the actions available such as Click, Set or Hover (generally autopopulated).
Specific parameters will vary according to the Test Step, but refer to the common test step parameters below for information on generic parameters such as Test Scope and Screenshot Options.
Writing expressions
The Expression icon () against a parameter indicates the parameter supports expressions in addition to normal text. In Provar, expressions are declared inside curly braces {}. They can include functions and variables as well as static text. This gives the user great flexibility but it also presents the opportunity for errors.
Note: We recommend using Content Assist when building expressions to help prevent syntax issues. You can access Content Assist by choose CTRL + spacebar, or right-click and choose Content Assist. Provar will provide a list of possible options to choose from.
See below for some examples of using expressions to calculate values and access queried information. Refer to Using Functions for more information on the functions available in Automation.
Simple examples
{1+1} – Will perform simple addition e.g. 2.
{1/2} – Will perform simple division e.g. 0.5.
{itemvalue + total} – Will work with variables (where itemvalue and total are previously created variables).
My name is {name} – Combine strings and variables (where name is a variable set to “David”), e.g. “My name is David”.
{(item + total)>100} – Expressions, where Item and Total > 100 e.g. true.
{(item + total)>100 and (item + total) <200} – Supports and/or logic gates e.g. true.
Complex expressions
When testing with Salesforce we work with objects and fields. We can access these values in different ways.
In the examples below we have an Account object which has a FirstName and LastName from running a query. Using expressions, we can access these values in various ways:
{AccountRows.FirstName} – Select full stop to see a list of available child variables.
{AccountRows[LastName=”ReECA1″].FirstName} – Filter a list of values using inline criteria.
{AccountRows[1].FirstName} – Choose the first value.
Common test step parameters
There are certain test step parameters which you will see in many Test Steps.
Result scope
All values in Provar have a scope which determines how long they live for. This prevents long test runs from accumulating lots of values that are no longer needed, while allowing you to store important ones for the entire duration if you need to.
The following scope options are supported:
- Test Run: Values are retained for the entire duration of your test run
- Test Folder: Values are discarded when the folder they were created in finishes
- Test Case: Values are discarded at the end of the Test Case they were created in
- Group Step: Values are discarded at the end of the parent Group Step they belong to
- Test Step: Values are discarded at the end of the Test Step that created them
Wait
Wait indicates that Provar will wait after performing the current action and before executing the next step.
The Before Wait setting gives you the ability to set a wait time before the step executes.
The After Wait setting gives you the ability to set a wait time after the step executes.
Note: Before/After Wait settings are useful when dealing with unpredictable page load times.
The Auto Retry setting is selected by default, Provar will proceed right after the current operation is finished and will manage the sync automatically. Additionally, it automatically retries the operation if for any reason the field does not appear. For options other than Auto Retry, enter the timeout value in seconds. This defines a maximum amount of time that Provar should wait for the condition to be fulfilled before moving on to the next Test Step.
If the option For a Pop to Appear is chosen, the name of the pop-up window must also be specified.
Screenshot options
This section contains two options:
Screenshot Before: Take a screenshot prior to executing the test step.
Screenshot After: Take a screenshot once the test step is executed.
Each option has the following choices:
- No Screenshot: No screenshot is required. This is the default value
- Capture the Visible Area: A screenshot will be taken that consists of only the area currently visible around the active field
- Capture the Entire Page: A screenshot will be taken that consists of the entire page when scrolled from top to bottom
These screenshots are displayed in the Test Runner after the test case is executed. Screenshots will also appear on run reports.
For more information, check out this course on University of Provar.
- Provar Automation
- System Requirements
- Browser and Driver Recommendations
- Installing Provar Automation
- Updating Provar Automation
- Licensing Provar
- Granting Org Permissions to Provar Automation
- Optimizing Org and Connection Metadata Processing in Provar
- Using Provar Automation
- API Testing
- Behavior-Driven Development
- Consolidating Multiple Test Execution Reports
- 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
- Japanese Language Support
- Override Auto-Retry for Test Step
- Mapping and Executing the Lightning Article Editor in Provar
- Managing Test Steps
- Namespace Org Testing
- NitroX
- Provar Automation
- Provar Test Builder
- ProvarDX
- 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
- 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
- DevOps
- 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
- CircleCI
- Copado
- Docker
- Flosum
- Gearset
- 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
- Version Control
- Masking Provar Credentials on CI
- Salesforce Testing
- Best Practices
- Improve Your Metadata Performance
- Java 21 Upgrade
- Salesforce Connection Best Practices
- 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
- Troubleshooting
- How to Use Keytool Command for Importing Certificates
- Installing Provar After Upgrading to macOS Catalina
- Browsers
- Configurations and Permissions
- Connections
- DevOps
- Error Messages
- Provar Manager 3.0 Install Error Resolution
- Provar Manager Test Case Upload Resolution
- Administrator has Blocked Access to Client
- JavascriptException: Javascript Error
- 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
- Memory
- Test Builder and Test Cases
- Release Notes