This page describes each view in Provar Desktop and its uses.
Use the following links to navigate to the relevant section:
Note: a less detailed introduction to Provar Desktop is available in the first minute of this demo video:
The Assistant view shows contextual help information from inside Provar Desktop. Its aim is to provide additional information on the element in use, for example Functions or Test APIs.
The Error Log view shows internal errors and problems related to the running of Provar. It may be useful for debugging issues or for describing them to support.
To open the Error Log, click on the View icon and locate ‘Show Error Logs’ in the dropdown.
The Provar menubar looks like this:
It has the following features:
- New Test: Used for creating new files. This could be a new Test Case, Page Object or Test API. The shortcut CTRL + N can also be used
- Save / Save All: Used for saving one or multiple files. The shortcut CTRL + S can also be used
- Run / Debug / Test Builder: These icons are for running tests. A test can be run in one of three modes. Refer to Running Tests to learn more about the different modes
- Test Environment: Used for selecting the current Test Environment
- Web Browser: Used to select the browser in which to execute tests. Chrome, Firefox, Phantom JS and Safari are available (Safari is supported from Provar version 22.214.171.124). Phantom JS is be used for headless testing, which performs UI tests without needing to use a browser. Refer to phantomjs.org for more information
- View: Used to define the appearance and positioning of your views. You can close views and expand views or return to the default perspective by selecting this View icon. To define your own perspective, you may customise the layout and then choose Window/Save Perspective from the Menubar
The Navigator shows your test project data as it is stored on your machine. By default, tests are stored in the tests folder. You can create sub-folders to further organize your tests.
You can perform standard file-based operations such as Copy, Delete and Rename. If you change any of the files in the filesystem you can also use Refresh to get the latest version.
If you double-click on a file in the Navigator, it will open in the most recently used editor.
The following diagram describes the standard folders and their uses:
When a new Connection is added, Provar will connect to the environment and cache its metadata. The Org Browser shows this metadata as currently cached.
There are filters to locate a specific object (at the top-right of the Org Browser) and to locate a specific row of data (at the bottom of the Org Browser):
It is also possible to drag and drop a row of data from the Org Browser into a Test Case to create an API Test Step:
Refer to API Testing for more information.
Provar will periodically check the state of the cached metadata and prompt a refresh if the data is stale. To perform a refresh on the cache, click the icon in the top-right of the Org Browser:
The options are as follows:
- Just reconnect: Use this option if you have detected a timeout in the Org Browser (this will not refresh the cache)
- Refresh only changed files: This is a fast method of downloading changes
- Reload all files: This will download all files
- Check if metadata is stale: This will manually trigger the stale check
If any inconsistencies are detected that impact Test Cases, these will be highlighted in the Problems view.
The Problems view highlights any current errors in your project by checking through your tests for inconsistencies.
Examples of when an error might appear are:
- When metadata has changed and a Test Step needs to be updated (e.g. if a field referenced in a Test Step has been deleted)
- When a Test Step is missing a mandatory field
- When a Test Step is referring to a Connection which does not exist
When an error occurs, you can double-click on the row to navigate to the exception. A quick fix option is provided where possible to help with the refactoring.
The Test APIs view, also known as the API Palette, provides an API library for use in your automated tests. You can add any Test API as a Test Step by clicking on the API and dragging it into your Test Case. To search for a specific Test API, use the magnifying glass icon at the top of the view.
Refer to the Test APIs section for more information on how to use each Test API.
The Test Plug-ins view displays the plug-ins currently running. Provar is architected to have one plug-in running, for Salesforce APIs.
The Plug-in should have a status of started. Any errors will be displayed in the Log underneath. In case of errors, the Plug-ins can be restarted, started or stopped using the icons in the top right hand corner.
The Test Runner provides a detailed output of the tests you have run. A new Test Run tab is created for each separate Test Run.
You can view the output of each Test Step, including detailed timings and screenshots, by clicking on it:
You can also:
- Access relevant test data by clicking on hyperlinks in the output pane
- Export results to CSV or PDF by clicking on the Export icon
- View runtime variables in the Variables view by clicking on the relevant Test Step and then clicking the Variables icon to bring the Variables View to the front. (Variables are only available when running in Test Builder mode or Debug mode)
Refer to Common Test Step Parameters for information on adding screenshots to a Test Step.
Test Settings contains 6 sub-tabs: Browser Configuration, Connections, Environments, Environment Variables, Tags and SLA, and Test Cycle.
Browser Configuration allows you to launch a browser in the desired resolution when executing your Test Case.
Provar uses an interactive connection into an application to access applications when authoring tests. The Connections tab is where these connection login details are stored.
As well as Salesforce Connections, Provar can create Connections for non-Salesforce testing, database testing, messaging and Google applications. Refer to Adding a Connection for more information.
Double-click on a given Connection to open a new Org Browser for that environment.
This feature allows a Test Case to be run in multiple test environments without modifying the Test Case.
This screen will allow you to create the environments used on your project.
Environment Variables are used for any static variable which can vary between environments. These variables are assigned a default value, which can be overridden for a specific environment. This section will display the variable’s values as they relate to the Test Environment selected in the Menubar.
Tags and SLA
Tags allow you to tag and categorize your test steps for better maintenance and to provide grouping levels in a report. SLAs allow you to measure performance parameters at a specific test step execution, such as time taken to load a page.
Once these have been created, they can be assigned to Test Cases. Refer to Tags and SLAs for more information.
A Test Cycle is conceptually a collection of Test Case executions that are reported on collectively. This feature is extremely helpful in order to get a clean report from a Test suite execution. Refer to Test Cycles for more information.
The Variables view displays information relevant to a specific Test Step of a Test Run. It will be populated after you run tests in Debug mode or Test Builder mode. It will also display any Environment Variables.
To see variables for a given Test Step, click on the Test Step in the Test Runner.
The variables will be split into three groups:
- Parameters: the value of parameters passed into the Test step
- Variables (Before): the state of each Variable prior to executing this Test Step
- Variables (After): the state of each Variable after executing this Test Step