Moving Salesforce Triggers to Production

Use these steps when using a Salesforce Realtime or change data source integration to move the custom Apex triggers and objects to the production environment. For this we will be using Salesforce Change Sets.

• Moving Salesforce Triggers to Production
  • Connector Setup
  • Apex Unit Tests
  • Enable Salesforce Deployments
  • Create an Outbound Change Set
  • Process an Inbound Change Set
  • Reregister SmartConnect integrations
  • Managing Future Changes
    • Changes not Requiring a Change Set
    • Changes Requiring a Change Set
  • Troubleshooting

Connector Setup

1. Navigate to Connections > and Edit your Salesforce Sandbox connector.
2. Verify the Create Tests box is checked.
   • Note: If this checkbox is left unselected the Apex test class will need to be manually created.

Apex Unit Tests

Before Apex code can be moved from a Sandbox environment to Production, the code needs to pass code tests. SmartConnect automatically builds the test classes, but it may be required to manually edit the tests if they fail. It is good practice to run the Unit Tests in the Sandbox first, before pushing the changes to Production.

1. Log into the Salesforce Sandbox > Setup
2. Search for Apex Test Execution
3. Click Select Tests
4. Choose the eOne_Master_Tests test class
5. Click Run
6. Wait for the test to complete
7. If the test fails, correct the errors and run the test again from step 3.

Enable Salesforce Deployments

The Salesforce Production instance will need to allow deployments from the sandbox.

1. Log into the Salesforce Production > Setup
2. Search for Deployment Settings
3. Click Edit
4. Make sure the Allow Inbound Changes check box is checked
5. Click Save

Create an Outbound Change Set

When sending customizations to a Production instance of Salesforce, all changes need to be bundled into a Change Set and pushed to the Production environment before they can be deployed.

1. Log into the Salesforce Sandbox > Setup
2. Search for Outbound Change Sets
3. Click New
4. Provide a Name for the test
5. Click Save

6. Click Add on the Change Set Components.

7. Add the following Components

Component Type	Name	Required For
Apex Class	eOne_Master_Tests1	All
Apex Class	eOne*SC_RTDS12	Realtime
Remote Site	SmartConnect3	Realtime
Apex Trigger	eOneCh_<mapId>__tr_I4	Change Tracking
Apex Trigger	eOneCh_<mapId>_tr_U4	Change Tracking
Apex Trigger	eOneSC_RTDS1<SFobject>_I5	Realtime
Apex Trigger	eOneSC_RTDS1<SFobject>_U5	Realtime
Custom Object	eOne Realtime Data Source Master6	Realtime
Custom Object	Change <object> (.com)7	Change Tracking

1. The Apex Test class needs to be moved over for all trigger types.
2. If using Realtime data sources, you will also bring the trigger class definition.
3. If using Realtime data sources, you will need to bring the Remote Site setting allowing communication with the SmartConnect web service.
4. If using Change data sources, a unique trigger will be created for each action and map combination. In the below screenshot, I have a create and update trigger on an integration named Product.
5. If using Realtime data sources, a unique trigger will be created for each action linked to that object. If multiple integrations are linked to the data source, they will all use the same trigger.
6. If using Realtime data sources, this object is required as it stores a list of registered integrations and their SOQL queries.
7. If using Change data sources, a custom change tracking object will be required for each table being tracked. In the below screenshot, I am tracking changes on the Product2 object.

8. Click View/Add Dependencies
9. Navigate to the bottom of the screen
10. Click Add Profile
11. Add a profile with access to deploy to Production
12. Click Upload

Process an Inbound Change Set

Now that the Change Set has been pushed to the Production environment, it can be tested and deployed into the Production environment.

1. Log into the Salesforce Production > Setup
2. Search for Inbound Change Sets
3. Open the Change Set you previously created in the Sandbox
4. Click the Validate button

5. Check the box for Run specific tests
6. In the text box enter eOne_Master_Test

7. Click Validate
8. After the validation completes, click View Results
9. If the tests passed successfully you can now click Deploy
10. The triggers and custom objects are now in the Production environment

Reregister SmartConnect integrations

The Apex triggers that are now in production need to be pointed to the correct integrations.

1. Log into SmartConnect
2. If using Realtime data sources:
   1. Open Data Sources > Realtime Triggers
   2. Open each Salesforce Realtime data source and make these changes
   3. Check the box for Production
   4. Click Validate
   5. Click Save
   6. Click Register
   • Note: you will also want to make sure your linked integration is pointed to the Production target system too.

3. If using a Change data source:
   1. Open Data Sources > Change Triggers > Trigger
   2. Open each Salesforce Change data source and make these changes
   3. Check the box for Production
   4. Click Validate
   5. Click Save
   • Note: you will also want to make sure your linked integration is pointed to the Production target system too.

Managing Future Changes

If changes are made to a Change based or Realtime data source after the triggers are deployed into Production it may require a new change set.

Changes not Requiring a Change Set

• Modifications to field mappings in the integration.
• Adding new fields to the Realtime or Change based SOQL query.
• Enabling or disabling the Salesforce triggers.
• Registering an additional integration to a Realtime trigger.

Changes Requiring a Change Set

Change data sources:

Any of these actions will require a new change set.

• Creation of a new change data source tracking an Object not currently tracked.
• Linking an additional integration to an existing change data source.
• Add/remove change tracked fields on the data source setup.
• Editing the triggers on a change data source integration.
  • Example: Checking the box for Track Updates when previously only Track Creates was selected.

This change set only needs to include the following components.

Component Type	Name	Required For
Apex Class	eOne_Master_Tests1	All
Apex Trigger	eOneCh_<mapId>__tr_I2	Change Tracking
Apex Trigger	eOneCh_<mapId>_tr_U2	Change Tracking
Custom Object	Change <object> (.com)3	Change Tracking

1. The master test class is always required.
2. The Apex trigger is only required if it was a new tracked action or if the change tracked fields was modified.
3. This is only required if the Salesforce object being tracked was not previously tracked.

Realtime data sources:

Any of these actions will require a new change set.

• Creation of a new Realtime data source tracking an Object not currently tracked.
• Add/remove change tracked fields on the data source setup.
• Editing the triggers on a Realtime data source registration.
  • Example: Checking the box for Track Updates when previously only Track Creates was selected.

This change set only needs to include the following components.

Component Type	Name	Required For
Apex Class	eOne_Master_Tests1	All
Apex Trigger	eOneSC_RTDS1<SFobject>_I2	Realtime
Apex Trigger	eOneSC_RTDS1<SFobject>_U2	Realtime

1. The master test class is always required.
2. The Apex trigger is only required if it was a newly tracked action, object or field.

Troubleshooting

• Error Message: ‘Allow Outbound Change Set from Production To Sandbox‘

  • When deploying the change set, if you see the above error revisit the Enable Salesforce Deployments step.

• If Realtime data sources are not running, you can refer to this help article Troubleshooting Realtime data sources.

If you have any other issues, please reach out to our support team at support@eonesolutions.com.