Salto for Salesforce

Salto’s Salesforce adapter allows you to:

• Fetch and deploy common Salesforce metadata items, e.g., custom objects and fields, apex classes and triggers, email templates, layouts, process builders, profiles.
• In many cases a salesforce org is also configured via data records, e.g., CPQ, SBAA. Salto introduces a unified approach for managing both data records and metadata items from a single place.
• Validate and deploy configuration changes from one Salesforce org to another.
• Compare orgs.
• Audit / document configuration changes.
• Monitor specific changes of interest in your Salesforce orgs, e.g., Profiles or Permissions.

Authentication Instructions

In order to connect Salesforce to Salto you can either:

• Connect via OAuth:
  • Choose OAuth authorization method and click 'Authenticate'.
  • If you are connecting to a sandbox, check 'Sandbox account'.
  • You will be prompted to choose one of your authenticated orgs or login to a new one.
  • Click 'Allow'.
• Connect with your username, password and token:
  • Choose 'Username / Password' Authorization Method.
  • If you are connecting to a sandbox, check 'Sandbox account'.
  • Enter your username, password and token (leave the token field empty if your org uses IP whitelisting).

Fetch and Connection Configuration File

Fetch Configuration

To learn what is the default salesforce configuration and how you can modify it to support different use-cases such as fetching profiles or CPQ, check out our written guide or step-by-step video guide.

🚧

Note: Adding more types to your fetch configuration is likely to influence the fetch duration, especially if these types have many instances.

Excluded Types

The following types are not fetched by default and require modifications to the configuration file:

• Email Template (video guide)
• Profile (video guide)
• Permission Set
• Report
• Report Type
• Report Folder
• Dashboard
• Dashboard Folder
• Site Dot Com
• Content Asset
• Custom Object Translation
• Standard Value Set
• Connected App
• Additional configuration data records, e.g. CPQ (video guide)

Fetch Targets

Reduce fetch time by specifying metadata types. Once specified, Salto will fetch only instances of these types.

• Certain metadata types cannot be fetched on their own and when specifying them, additional types will be fetched. The following lists of types are always fetched together
  • CustomObject, BusinessProcess, CompactLayout, FieldSet, Index, ListView, RecordType, SharingReason, ValidationRule, WebLink
  • Workflow, WorkflowAlert, WorkflowFieldUpdate, WorkflowFlowAction, WorkflowKnowledgePublish, WorkflowOutboundMessage, WorkflowRule, WorkflowTask
• Fetching CustomMetadata configuration:
  • Specifying CustomObject type will include CustomMetadata types definitions without their records
  • Specifying CustomMetadata type will include CustomMetadata types definitions and their records, in addition to CustomObject and all the types in its group as specified above
• If your fetch configuration includes data records, e.g. for CPQ, they will be fetched when specifying CustomObject type as one of the fetch targets

🚧

• Deletions can not be detected when specifying fetch targets
• References in fetched elements will be updated as part of the partial fetch as long as the referenced element exists in the Salto environment. If the referenced element does not exist in the Salto environment (meaning it is new in that environment and was not fetched yet), its reference will be omitted until a full regular fetch is performed

Salesforce tests

When deploying changes to a salesforce org, you can configure how and which tests are run, by opening the deploy configuration modal:

If you choose "Run Specific Tests", you'll need to supply the lists of tests to run.

Validation deployments

When deploying changes to a salesforce org, you can validate the changes without deploying them, and view the success or failure messages you would receive with an actual deploy.

To do that, you can choose to review a deployment plan or a validation plan when selecting element for deployment:

After selection "validation plan", you will be able to review the elements to be validated, and run the validation. The validation result will indicate "success" or "failure" according to the SF validation result. You can also view the validation result in Salesforce.

🚧

Note: CPQ and other data records can not be validated, and will not be included in validate-only deployment plans

FAQs