Migrating Between Environments

Actions, Processes & Forms: 

For deploying Actions, Processes and Forms between organizations you need to use the Work-Relay export/import tool since the actions, processes and forms are data, not meta-data. Here is an overview of the deployment process.

Many clients store these export files in Github to keep a history. 

Exporting can be done in any sequence, however for importing, you should start with any Actions/Action Groups, then Forms, then Processes.

 

Deploying Actions/Action Groups:

  • On Source org, go to Actions tab.
  • Select Actions or Action Groups to export using checkboxes (1) on left (if you export an Action Group, the export will contain all Actions within the Group).
  • Click "Export" button (2) and provide a meaningful name to export file (by default it has .wri extension).
  • On the destination organization go to Actions and click "Import" button (3).
  • Select whether to update existing Actions/Action Groups or to import as new (4).
  • Choose exported file (5). When chosen, system will try to import it automatically.

Notes:

  • File must have .wri ("Work-Relay Imported") extension
  • If file has incorrect format or it is damaged, system will show an error message

Deploying Forms looks the same:

  • On source org, go to Forms tab.
  • Select Forms to export using checkboxes on left.
  • Click Export and provide a meaningful name to export file (with .wri extension).
  • On destination org, go to Forms tab and click Import.
  • Select whether to update existing forms or to import as new.
  • Choose exported file and it will be imported (or not, if any error occurs).

 

Deploying New Processes (Primary Versions only):

  • On source org, go to Processes tab.
  • Select Processes to export using checkboxes on left.

Note: when exporting from this page, it will only export the Primary version of a process

  • Click "Export" and provide a meaningful name to export file (with .wri extension).
  • On destination org, go to Processes tab and click "Import" button.
  • Choose exported file and it will be imported (or not, if any error occurs).

Additional points:

  • If you import the same name as an existing process, it will not overwrite the original (this could be problematic if the structure of the process has changed) but import as a new process
  • If you need to deploy a new version of a process, you should instead use the Version import/export tool

Deploying New Versions of a Process:

  • On source org, go to Processes tab.
  • Click on Process name to drill into the Process details page.
  • Click on Versions.
  • Click Export link next to Version you want to export (6).
  • File will be named based on the Version name + .wrpv extension.
  • On destination org, go to Processes tab.
  • Click on Process name to drill into the Process home page.
  • Click on Versions.
  • Click Import button on top.
  • Select exported file and click Import button (7).

Additional points:

  • If you import the same name as an existing version, it will not overwrite the original (this could be problematic if the structure of the process has changed) but import as a new version

 

Settings Tab Configuration (for new installs):

The following need to be set up in the Settings tab and sub-tabs on new installs:

Add Licenses:

To use the same license across multiple sandboxes, you would follow this process:

  • Switch to Salesforce Classic (8) - License Tool is not Lightning ready yet.
  • Click on "Settings" tab (click on "+" in tab bar to locate).
  • Click on the "Licenses Settings" sub tab.
  • Click on Enter License Key.
  • Enter Org ID of the originally set up sandbox.
  • Enter the sandbox license key.


Turn on Workflow Scheduler:

  • Go to Settings tab (best in Classic) > Schedulers Settings sub-tab and click the Turn On link.

 

Add Email Delivery Contact (used for Salesforce Email Templates):

  • Go to Settings tab > Notifications Settings and add an Email Delivery Contact that is set up as a Contact in that org.

 

Add Super Admins if desired:

  • Go to Settings tab (Classic only) > General Settings and add the User IDs of any super admins (users that can edit all processes and forms in the org).

 

Set up Allowed Objects (option to import from another org):

  • On the source org, go to "Documents" tab and open "Work-Relay" folder.
  • Open the "Allowed Objects" document detail page.
  • On the "View File" link, do "Save Link As.." using the context menu.
  • On the destination org, replace the "Allowed Objects" file with the saved file from the source org.
  • You can also manually add or adjust those Allowed Objects by going to Settings tab > Objects Settings.
  • You can push this same file to all sandboxes.


Activate top level processes:

  • When processes are deployed to a different org, they need to be activated. You can load the parent and activate it and all sub-processes by selecting Activate and choosing the option to activate parent and subs.  


0 Comments

Add your comment

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.