Provar Test Results Package

Important Note! The Test Results application is no longer supported and we encourage you to upgrade to Provar Manager. For ease of integration, without changing your test cases please refer to our guide Integration with Provar Manager.

Provar has a managed package on the Salesforce AppExchange that is for storing and displaying Provar test results in a dashboard view inside of your Salesforce org.  For information on how to install and setup this package, please refer to the Salesforce Test Integration Package.

Provar Test Results package can be used to write your test results back into your Salesforce org, which can then be linked to your Copado Deployment jobs.

The following is a zipped project which contains the necessary test cases to get started with your Provar test results implementation: Provar Copado Integration Tests. Once you have this project downloaded to your machine locally, you can extract this folder anywhere. 

You can copy the test case files directly to your project. Included are also some sample build files and a test spreadsheet for the sample test. 

Image showing how to copy the test case files to your project for Provar Integrations in Copado

Note: tests/Copado contains all test cases.

Provar callable test results package

Relevant Test Cases for Writing your Test Results Back to Salesforce 

Create Test Suite.setup: This test case is a setup test case that runs at the start to create the Provar test suite execution object. The two customizable fields being used here are:

sample of a Suite.setup test case that runs at the start to create the Provar test suite execution object

The provarti__Name__c field is the name of your test suite execution.

The Deployment__c is a reference field to the Copado deployment. We will be pulling this Id from the environment variables. Since all build parameters passed to Jenkins are saved as environment variables, this is the DEPLOYMENT_ID environment variable. This may also be the EXTERNAL_ID environment variable, if you have set the build parameter as such.

Create Test Case.testcase: This is a callable test case that must be run inside of a Finally block at the end of each test case you want to track results for. Examples can be seen inside of the CreateAndConverLead.testcase and CreateAccountsFromExcel.testcase tests.

You will need to pass the name of the test case being executed to this test case so it can be tracked properly in your Salesforce org. A good way to do this is by using the TestCaseName() function built-in to Provar and pass that as a test case parameter. 

Update Test Suite.teardown: This test case is a teardown test case that will always run at the end of the test run to update the Provar test case execution object with the total test run duration.

Once you have checked in your Provar project with these changes implemented, you can begin to see your test results inside of your Salesforce org, along with your linked Copado deployment.

Linking your Copado Deployment to Test Suites

Finally, if you want to link our test results to the Copado deployment log record id, then you need to create a new Lookup relationship from test execution suite object to the Copado deployment object. When this is populated in the Provar test case the test results will automatically become visible from Copado.

Linking your Copado Deployment to Test Suites figure A

Once this is added, you can begin testing your deployments with the added test cases to see if they are updating the records properly.

If so, you should see some test suite executions being created, and the Copado deployment record link:

Linking your Copado Deployment to Test Suites figure B

Review Provar on G2
Documentation library

Other available resources

Looking for something different?

We use cookies to better understand how our website is used so we can tailor content for you. For more information about the different cookies we use please take a look at our Privacy Policy.

Scroll to Top