Follow up to Spring ’16 Feature – Run Script for Sandbox

A follow-up post to and the Spring ’16 release feature Run Script after Sandbox Create or Refresh.

This was the original use case I wanted to cover (pending a support case and bug issues), functionality to auto refresh a custom setting with environment information.

In a production environment I have a custom setting (hierarchy type) that contains the environment Id, Name, Type, and URL.


…and it has the following data:


When a sandbox is created or refreshed from the production environment it pulls the custom setting data with it, but in this use case, it no longer relevant for the environment. I’m coming from the production environment, but I now want the relevant Sandbox environment information.  Now with an apex class that implements SandboxPostCopy interface, I can have this data auto populated when the sandbox is created or refreshed.  Here’s what the apex class looks like:

global class sandboxCreateRefreshScript implements SandboxPostCopy

global void runApexClass(SandboxContext context)

Environment_Settings__c es = Environment_Settings__c.getorgdefaults();

es.Environment_Type__c = 'Sandbox';
es.Environment_URL__c = URL.getSalesforceBaseUrl().toexternalform();
es.Environment_Id__c = String.valueof(context.sandboxId());
es.Environment_Name__c = context.sandboxName();
update es;


and test class…..

private class sandboxCreateRefreshScriptTest
@testSetup static void testData()
Environment_Settings__c es = new Environment_Settings__c();
es.Name = 'test';
insert es;
@isTest static void testSandboxPostCopyScript()

sandboxCreateRefreshScript sandboxScriptclass = new sandboxCreateRefreshScript();
Test.testSandboxPostCopyScript(sandboxScriptclass, UserInfo.getOrganizationId(), UserInfo.getOrganizationId(), 'sandboxName');

Environment_Settings__c es2 = Environment_Settings__c.getorgdefaults();
system.assertNotEquals(null, es2.Environment_Id__c);

On the sandbox wizard you’ll see we have the option of specifying the apex class to run that has the SandboxPostCopy interface.  Simply input the class name and submit.



After the sandbox refreshes, we now have our data auto populated:

Screen Shot 2016-04-25 at 12.05.34 PM



Spring ’16 Feature – Run Scripts for Sandbox

A neat feature in the Salesforce Spring ’16 release is the Run Script after Sandbox Create or Refresh.  This could be helpful for environments that need some dummy data or static data populated in developer, partial, or full sandbox.

Let’s take the following very simple use case.  Another update with Spring’16 is the increase number of developer sandboxes.  Now we have the ability to create 25 at a time.  Because developer sandboxes do not copy record data with it, if you need let’s say Accounts then its up to you to create them each time you spin up a sandbox.  With this new sandbox script feature we could automate creating test Accounts.

For this example, I’m going to create 10 Accounts when a sandbox is created or refreshed.  To do this I’ll need to build an apex class that implements the SandboxPostCopy interface.  Inside I’ll loop through and build 10 accounts with some sample data.

global class sandboxRefreshScript implements SandboxPostCopy
global void runApexClass(SandboxContext context)

List<Account> accounts = new List<Account>();
for(Integer x = 1; x < 11; x++)
Account a = new Account();
a.Name = 'Test Account ' + x;
a.Type = 'Client';
a.BillingState = 'NC';
a.BillingCity = 'Greensboro';


insert accounts;

…and of course we need a test class with it.  Under the Test class we now have the method testSandboxPostCopyScript in which we pass the SandboxPostCopy class,  Id’s for sandbox Id and org Id, along with a sandbox name.

private class sandboxRefreshScriptTest
@isTest static void testScriptRun()
system.assertequals(0, [Select count() from Account]);

sandboxRefreshScript sandboxScriptclass = new sandboxRefreshScript();
Test.testSandboxPostCopyScript(sandboxScriptclass, UserInfo.getOrganizationId(), UserInfo.getOrganizationId(), 'sandboxName');

system.assertequals(10, [Select count() from Account]);



When we create or refresh a sandbox we now have the following option to attach a sandbox script.


After my sandbox has been created, I can see I now have 10 accounts!

Screen Shot 2016-04-07 at 8.29.18 AM


Two additional notes:

1.) When you sandbox is activated (manual or auto) you should receive a second email saying that your script has run.

Screen Shot 2016-04-07 at 8.32.13 AM

2.) For record insertion, keep in mind the owner will not be the person that started the sandbox create/refresh.  The owner will be “Automated Process”.