Enabling the Box Integration

Follow

Overview

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

There are a few prerequisites for setting up this integration:

  1. The user should have an enterprise Practifi account

  2. The user should also have an enterprise Box account.

  3. 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.
  4. If you don’t already have a Box service account, create one by adding boxforsalesforce@example.com 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.

Installation

Install from the AppExchange

  1. Log into your Practifi organization using your System Administrator credentials.
  2. Navigate to Salesforce Setup by selecting the gear icon in the upper right-hand corner (represented byScreen_Shot_2020-05-21_at_12.20.32_PM.png) and selecting Setup from the drop-down menu. 

    Setup.png
  3. Use the Global Search bar at the top of the screen to search for and select AppExchange Marketplace.

    AppSearch.png

  4. Within the AppExchange Marketplace, search for Box and select the Box app from the results.
  5. On the Box AppExchange listing, select the Get It Now button.
    0ec8e791-138b-4aa5-a92f-148b3c758978.png
  6. 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. 
    1a2a4886-31d2-4f1a-8c12-9ac91c171d62.png
  7. 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.
    f80c601a-2d0c-406a-a8b0-7b794ae3bf36__1_.png

  8.  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.
    99e2295e-809e-4424-8f0b-b673f77c041a.png

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:

  1. Log in to Practifi as a System Administrator.
  2. 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.
    • Please note: Both the System Administrator and Practifi license holders have access to the Box Settings tab. However, only the System Administrator can view the Box Admin Settings section within this tab. If you do not see an the Box Admin Settings section within the page, you are not the System Administrator.

Connect Box Service Account

  1. Once in Box Settings, open the Authentication tab located on the left-hand side of the screen.
  2. Enter the registered email ID of your Box Service Account and select the Connect button.
  3. 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.5631a92d-980c-48b1-949e-02ef77f9c162.png

Change Box Service Account

After the initial connection, the Box Service Account can be changed by completing the following steps:

  1. From the top right of your window, go to Your Name > Developer Console to launch the Developer Console

  2. Go to Debug > Open Execute Anonymous Window

  3. Run the following command: box.Toolkit.deleteServiceUserAssociation();

Set Up Root Folder

  1. Within Box, specify a name for your firm's Root Folder as Practifi -<Your Firm's Name> and select Save to finalize its creation.
  2. Copy the sharing link of this folder and paste it into the default folder field on the Box Settings page.
  3. Select Save.9e9e820e-a9d7-49b4-92be-ebfacd3649a9.png

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

  1. Select the Permissions tab on the Box Settings page to schedule a regular sync job. 
  2. 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.
        83e8c95a-5907-473a-8343-b2f721d19cf3__1_.png

  3. Once a frequency and cadence are specified, choose a preferred start time from the drop-down menu.
    c6cc7d10-7e9a-47b8-a7e8-8d1b82e69830.png
  4. Select Save to finalize the sync job creation. Once created, the sync job can be edited or removed.
    • Please note: Creating a daily sync job is advisable 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.

  1. If not already in Salesforce Setup, navigate to Salesforce Setup by selecting the gear icon in the upper right-hand corner (represented byScreen_Shot_2020-05-21_at_12.20.32_PM.png) and selecting Setup from the drop-down menu.
  2. Use the Quick Find search bar located on the left-hand side to search for Apex Classes.
  3. Select the Schedule Apex button and select the BatchErrorScheduler apex class for the job.
  4. 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 whenever they access Box content within Salesforce in a new browsing session.

d72a0fe9-ee16-460f-a042-53512479080b.png

Adding Box to Client Record Pages

To add the Box App Shortcut to Practifi Client record pages, the following steps should be followed:
  1. Within Practifi, navigate to a Client record page.
  2. Select the cog icon in the upper-right-hand corner. From the drop-down menu, select Edit Page.
  3. Search for the Practifi - Navigation Section component in the left-hand side search bar. Drag and drop the component over the Activities navigation section. 
    BoxNav1.png
  4. One added, name the title of the navigation section as Box and set the icon field as fad fa-box to create the Box shortcut in the record side panel and have an icon display. 
    Box_Nav_2.png
  5. After adding the navigation section, search for Box in the components search bar and drag and drop the Box Application to be within the navigation section.
    BoxNav3.png
  6. Press Save to finalize the changes. 
    BoxNav4.png
  7. Once saved, select the Activation button located beside the Save button. 
    BoxNav5.png
  8. On the Activation page, there will be multiple subtabs where you must select the following options to ensure users can access the Box functionality correctly. These are as follows:
    1. Select the App, Record Type and Profile section. Select the Add Assignments button and select the following: Advisor, Client Service, Marketing, Management, and Settings. Once these are selected, click Next. 
      c4f95737-a32f-4994-a44d-cf6d44155ca0.png
    2. You will be asked to select the Form Factor in the next step. This will be set to Desktop as default and should remain at this value. Select Next to continue. 
      3f174de8-54f7-4a22-959f-ea24790ee2fa.png
    3. Select the following options Household Client, Individual ClientOrganization ClientHousehold Prospect, Individual Prospect and Organization Prospect. Once these are selected, click Next to continue. 
      b511f35a-0642-4ee5-9180-380503f2b682.png
    4. In this step, select the Profiles who will need access to this page and the Box functionality. 
      7f831b49-351e-4db4-a3ca-af97b5f305a3.png
    5. On the final page, review the page assignments to ensure their accuracy and select Save to finalize the page changes within your Practifi organization. 
      37863d9d-3705-4cab-8967-3409b95a8f5a.png
0 out of 0 found this helpful

Comments

0 comments

Article is closed for comments.