Pre-requisites:

• You have completed Installing and Configuring Box For Salesforce for your organization. This means: 
  • The Box Service Account is signed in
  • The Box User is signed in, and is a different user than the Box Service Account
  • The Box for Salesforce Root Folder exists
  • Applicable permissions are assigned to Users
    
• Your organization is eligible to use Box Doc Gen (please reach out to your Account Manager for more information.)
• Box Doc Gen is enabled in the Box Admin console (Enterprise Settings > Content & Sharing > Box Doc Gen > Edit Configuration)
  • After Box Doc Gen is enabled, the Salesforce Admin needs to re-connect the Box Service Account and Box User, to approve the new Doc Gen application scopes.

Assign Box Doc Gen Permission Sets

Box Doc Gen for Salesforce enables you to assign specific users in Salesforce to: 

1. Create and manage the templates used in Salesforce and/or
2. Use the templates to generate documents. 

To do this, you will need to assign applicable users custom Box permission sets. 

As the Salesforce Admin:

1. In the Salesforce App Launcher, search for and navigate to Box Settings. 
2. In the Assign Permissions section, click Assign.
   1. For Box Doc Gen Template Manager, click Manage Assignments and manage the permission set for users who will create, edit, or set up Box Doc Gen templates.
      

      Note: This permission set allows these users to see Box Doc Gen and Box Doc Gen Templates from the App Launcher.

   2. For Box Doc Gen Users, click Manage Assignments to manage the permission set for users who will generate documents in Salesforce.

Adding Box Doc Gen Templates to Salesforce

In the Box Doc Gen Templates tab, Box enables users with Box Doc Gen Template Manager permissions to create and manage  templates for generating documents. The Box Doc Gen Templates tab displays a list of all available templates, including sObject, status, and folder ID.

As a user with the Box DocGen Template Manager permission set:

1. From the App Launcher, search and navigate to Box Doc Gen Templates.
2. In the top right corner, click New to launch the template manager.
3. While in the Create Template step:
   1. In Template Name, choose a name for the template in Salesforce
   2. In Generated File Name, choose the name you want the generated file to be named
   3. In Object, choose the Salesforce Object associated with the template. 
   4. Click Next.
4. In the Download JSON step:
   1. Click Download JSON File to download a file named {ObjectName}DocGen.json. This is used to pull the tags into the Microsoft Word Add In .
   2. Click Next.
5. Create and edit your template in the Box Doc Gen Template Creator, Microsoft Word Add-in. (See next step)
6. In the Upload Template step:
   1. Attach your template as a docx or pdf file.
   2. Click Upload.
   3. Once the upload is complete, click Next. 
7. (Optional) In the Preview step, test your template on a sample record.
   1. In Sample Record, search and select the record you would like to test your template on.
   2. Click Preview. 
   3. Click Next.
8. In the Settings step, you can finalize the template settings:
   1. Check the Available for Box Sign checkbox to make it available for approval and signature.
   2. In Output type, choose the desired file type to be generated.
   3. Click Save and Finish. 

On completion, the Box Doc Gen Template tab displays the details, tabs for previewing the document, previous jobs ran, and tags within the document

Creating a Template with the Box Doc Gen Template Creator in Microsoft Word

To create and edit Box Doc Gen templates, Box recommends using the Box Doc Gen Template Creator Word Add-in. For more information on how to create a Box Doc Gen template, see here.

To begin using Salesforce tags in the Box Doc Gen Template Creator, you will first need to import the tags. To import tags:

1. Open the file that will be your template in Microsoft Word, and open the Box Doc Gen Template.
2. Click Start with your data.
3. Upload the json file you previously downloaded. 
4. Click Generate tags. 
5. Search and select the appropriate fields to build your own template. The tags are displayed next to your cursor.

Adding and Displaying the Box Doc Gen button in Objects

Before your users can generate documents, you need to create a button and add it to your applicable Object page(s).

1. Navigate to Setup by clicking on the gear icon in the top-right hand corner of your Salesforce instance.
2. In the upper-left, navigate to Object Manager tab.
3. Select the Object(s) where you want to add the button for your users to generate documents.
4. Go to Buttons, Links, and Actions in the left-hand side-bar.
5. Click New Action from the upper right corner.
   • In the Action Type dropdown, select Lightning Component.
   • In the Lightning Component dropdown, select “box:dgRecordPage”.
   • In the Label field, type in the name you want to call your Button (example: “Generate Doc”)
     1. Optionally, edit the pre-populated field (without spaces.)
     2. Optionally, change the Icon to a different logo.
6. Once complete, click Save.
   

Once you’ve added the Box Doc Gen button to the applicable Object(s), you can begin editing the pages where you want to add the Box Doc Gen button.

1. From Salesforce Object Manager, in the applicable Object(s), navigate to Page Layouts.
2. Select the applicable Page Layout.
3. Select Mobile and Lightning Actions.
4. From the palette, find the Box Doc Gen button you have created, and drag it down to the desired position in Salesforce Mobile and Lightning Experience Actions. (Box recommends hovering your cursor over the button to confirm it is the created Box button. There is also a standard button named Generate Document.)
5. Click Save.

Setting up Batch Doc Gen

You can also enable users to generate documents for multiple records for a given object at once, from a Salesforce List View. First create a button and add it to your applicable List View(s).

First, create the Batch DocGen button:

1. Navigate to Setup..
2. Navigate to Object Manager, nested under Objects.
3. Select the Object(s) where you want to add the button for your users to generate documents.
4. In the left-hand side-bar, go to Buttons, Links, and Actions.
5. In the upper right corner, click New Button or Link.
   • In Label, select a label to call your Button
   • In Name, select a Name (or edit the pre-populated Name field - without spaces)
   • For Display Type, select List Button
   • Populate the formula with “/flow/box/Generate_Box_Documents?retURL=001/o”
6. Click Save.
   

After you create the Batch DocGen button, make an Object's List View to be viewable to your users.

To edit an Object's List View:

1. In the Object manager, select the Object where you want to add the List View button.
2. In the left-hand sidebar, navigate to List View Button Layout.
3. In the List View row, click the dropdown then Edit. 
4. Scroll to the Custom Buttons section, select the newly created button and click the Add arrow to add the button. 
5. Click Save.
   

Now the button is available in your users’ List views.