To include Box file activity with Salesforce in the Box App Activity stream, you need some additional preparation in your enterprise. Details are below.
ImportantTo test the Box for Salesforce integration in App Activity, you must upgrade your organization to the new Box for Salesforce v3.57. That is the version that supports App Activity. But keep in mind:
- If your enterprise has a customized deployment of the Box for Salesforce integration via Toolkit or SDK, you must also call a method in your custom instance to enable App Activity. See the Custom Toolkit/SDK Implementations section below for a link to the method to do this.
- This does not include app activity for previously-created Salesforce records. To enable this capability, your Salesforce admin must run an additional backfill script. See the Backfill section below for details.
Default Behavior
- After you install v3.57, each time someone clicks Create Folder to create a new folder, Box records an app activity on that new folder.
- Folders created previously do not have an app activity recorded.
- Folders created via any custom implementation using the Toolkit or the SDK also do not record any app activity. For these, follow the instructions toward the bottom of this page.
Backfill
Because previously-created folders do not have an app activity recorded out of the box, you can download and run a script to do the backfill. Run the script by uploading the code into your org. Then, from the Developer Console, execute the script as follows:
``` Database.executeBatch(new BackfillAppActivities(), 40); ```
ImportantTo avoid Salesforce governor limits, ensure the number of records to process per batch is less than 50. In the above example, the number of records is 40.
When organizations have customized the behavior of their integration with Box, it’s often the case that they are creating folders on their own using either the Toolkit or the SDK. To record an app activity in this scenario, Box provides a global Toolkit method called enableAppActivity that accepts a Box folder ID as a parameter and records an app activity.
The method signature for enableAppActivity looks like this:
| | |
|---|
| Parameter | Type | Description |
| folderId | String | The Box folder ID on which to enable app activities |
Here’s how to call the method: