Branch Validate

Validate checks your branch metadata against a Salesforce org without deploying. It confirms compatibility, ensures dependencies are satisfied, and runs Apex tests if required.

What is Validate

The Validate feature allows you to check your branch’s components against a target Salesforce org without deploying them. This process ensures metadata compatibility, verifies dependencies, and executes Apex tests when required. By running validation before deployment, you can proactively detect issues and reduce deployment failures.

It helps prevent deployment failures by:

  • Checking metadata compatibility with the target org

  • Ensuring dependencies are satisfied

  • Running Apex tests (based on selected test level)

This gives you confidence that the deployment will succeed once executed.

Prerequisites

  • A connected Salesforce org available as a validation target.

  • A branch containing metadata components to be validated.

  • Appropriate permissions to run validation jobs in Revvy.

How to Run Validate

  1. Open the branch

    • Navigate to your branch.

    • In the branch header, click the three-dot menu (⋮).

    • Select Validate.

  2. Select components

    • You’ll see a list of branch components.

    • Choose one or more components to validate.

    • You can also use Add all to select everything in the branch.

    • When ready, click Next.

  3. Select connection

    • Pick the Salesforce org where the validation should run (this acts as the target org).

    • The org list shows details like name, last retrieve date, and who created the connection.

    • Once selected, click Next.

  4. Configure settings

    • Choose the test level for Apex tests. Options typically include:

      • Default – Runs only the tests included in the package.

      • Do not run tests – Skips all Apex tests (allowed only in non-production orgs).

      • Run local tests – Executes all tests in the org except those from installed managed packages.

      • Run all tests – Runs every test in the org, including managed package tests.

      • Run specified tests – Lets you define individual test classes or methods to run.

    • Click Run to start the validation.

How to Check Validation Status

  • After starting, the Validate job appears under Activities → Jobs.

  • Status values include: Queued, In Progress, Completed, Exception.

  • Filters (type, status, date) help you quickly find Validate jobs.

How to view validation results and logs

  1. From Activities → Jobs, click the completed Validate job entry.

  2. The results page shows:

    • Connection used

    • Status, duration, start/end time

    • Who triggered the job

  3. Logs on the right display details such as:

    • Job started

    • Salesforce components retrieved

    • Validation steps completed

    • Apex test results (if applicable)

  4. Use Refresh to update logs while the job is still running.

Best Practices

  • Always run Validate before deploying into UAT or Production.

  • Include dependent components to avoid validation errors.

  • Use RunLocalTests in lower environments for higher quality checks.

  • Use Do not run tests only for quick validations in sandboxes.

  • Review logs carefully before proceeding with deployment.

  • Re-run Validate after resolving conflicts, updating metadata, or retrieving missing dependencies.

Last updated

Was this helpful?