The integration between Practifi and Box allows users to share files seamlessly without changing the interface or logging out of Practifi. With this integration, users can share files with external users.
This article outlines the steps to enable the Box integration in your organization. For more information about the Box integration, please consult our Using the Box Integration article.
**Note: This content is intended for system administrators and is technical in nature. Please discuss your integration installation plans with your Practifi Customer Support Team for their assistance.*
- Before you begin
Before you begin
There are a few prerequisites for setting up this integration:
The user should have an enterprise Practifi account
The user should also have an enterprise Box account.
- The user should have the following settings enabled on their Box account:
- A Box service account, which can be any managed user.
- If you have enabled the Restrict Content Creation enterprise setting, the service account must be either the primary admin or a co-admin, with either the manage groups or manage users permissions assigned.
- If you don’t already have a Box service account, create one by adding firstname.lastname@example.org as a managed user.
- It's best to reserve this account exclusively for integration purposes rather than to assign it to any user. In addition, this account "owns" the Salesforce content on Box and makes API calls from Salesforce to Box for the entire enterprise.
Install from the AppExchange
- Log into your Practifi organization using your System Administrator credentials.
- Navigate to Salesforce Setup by selecting the gear icon in the upper right-hand corner (represented by) and selecting Setup from the drop-down menu.
- Use the Global Search bar at the top of the screen to search for and select AppExchange Marketplace.
- Within the AppExchange Marketplace, search for Box and select the Box app from the results.
- On the Box AppExchange listing, select the Get It Now button.
- Once selected, a pop-up window will display asking for authorization. The System Administrator should select Open Login Screen and log in using their Practifi credentials.
Once authorized, a window will display where the admin needs to select the organization in which to install the application. It is recommended to be installed in a sandbox first and then in the production organization after testing.
- A form will display where the administrator needs to fill out the required fields. Select Confirm and Install to accept the terms and conditions to install the application.
Access Box Settings
Once the installation of the application is complete, there are a few settings that the admin needs to configure before using the Box app. To access these settings:
- Log in to Practifi as a System Administrator.
- Select the App Launcher located in the upper left-hand corner and use the Search apps and items search bar to search for and select Box Settings.
Connect Box Service Account
- Once in Box Settings, open the Authentication tab located on the left-hand side of the screen.
- Enter the registered email ID of your Box Service Account and select the Connect button.
- A pop-up window to enter the user name and the password will display; enter your credentials. Once this process is complete your account will be connected to the Box Service Account.
Change Box Service Account
After initial connection, the Box Service Account can be changed by completing the following steps:
From the top right of your window, go to Your Name > Developer Console to launch the Developer Console
Go to Debug > Open Execute Anonymous Window
Run the following command: box.Toolkit.deleteServiceUserAssociation();
Set up Root Folder
- Within Box, specify a name for your Root Folder Firm'sas Practifi -<Your Firm's Name>) and select Save to finalize its creation.
- Copy the sharing link of this folder and paste it into the default folder field on the Box Settings page.
- Select Save.
Enable the Box Enterprise sub-domain (Optional)
If you use a sub-domain for your Box Enterprise organization (for example, cloud.app.box.com instead of app.box.com), you must enter your sub-domain on the Box Settings tab. If your sub-domain is"cloud"app.box.com enter "cloud". This prevents issues that could occur when using various Send with options on files within Box.
In Box, navigate to Admin Console > Enterprise Settings > Custom Setup, enter your sub-domain and save your changes.
Schedule sync jobs
- To schedule a regular sync job, select the Permissions tab on the Box Settings page.
- Select the Schedule New Job button. You must then specify the following:
- A frequency (Weekly/Monthly)
- A cadence
- For a Weekly frequency, select the day(s) you would like the sync to run. For day selection there will be a selection box, where the user will select the days for which he has to keep the sync running.
For a Monthly frequency, select the occurrence day.
- Once a frequency and cadence are specified, choose a preferred start time from the drop-down menu.
- Select Save to finalize the sync job creation. Once created, the sync job can be edited or removed.
- Please note: It is advisable to create a daily sync job to maintain seamless data.
Clean-up job sync
If you observe many records being retained in the BOSS Exception custom object (API name: BOSS_Exception__c) a clean-up job sync may be run to remove these records. You do not need to run this process often as it runs as part of your scheduled BOSS process. Instead, this is intended for use as a one-time cleanup.
- If not already in Salesforce Setup, navigate to Salesforce Setup by selecting the gear icon in the upper right-hand corner (represented by) and selecting Setup from the drop-down menu.
- Use the Quick Find search bar located on the left-hand side to search for Apex Classes.
- Select the Schedule Apex button and select the BatchErrorScheduler apex class for the job.
- Press Save to initiate the clean-up job sync.
Seamless Login (Organization-wide)
This feature provides seamless login to Box from within Salesforce. When you enable this feature, users see the Seamless Login setting in the Box Settings tab. They can then enable or disable seamless login for their accounts. If individuals enable seamless login for their accounts, they are prompted to log into their Box accounts once during setup.
Seamless Login is enabled by default organization-wide. If you disable it, the system prompts Box account holders to log into Box every time they access Box content within Salesforce in a new browsing session.