Installation and configuration guide

This article serves as a configuration guide for the Drive Connect Salesforce app. The first section covers the pre-installation and installation of the Drive Connect package. The following sections will walk you through app configuration and completing the Setup Assistant. This app supports Contacts, Person Accounts, and custom objects.

Table of Contents

  1. Introduction
  2. Preinstallation
    1. Workstation configuration
    2. Configuring a Domain in Salesforce
  3. Installation
    1. Installing the Drive Connect Package
  4. Drive Connect Configuration
    1. Drive Connect Setup (Setup Assistant)
    2. Initial Configuration
    3. Link Your Google Workspace Account
    4. Add the Component to Page Layouts
    5. Licensing & Permissions
    6. Create a Drive Connect Templates Folder in Drive
  5. Drive Links Lightning Component
    1. Manually Adding Component to Desktop Page Layouts

Introduction

This guide is meant to walk you through configuring your org in a Lightning Experience environment. If using the Salesforce Classic interface, you can switch to Lightning by clicking Switch to Lightning Experience at the top of the page.

Switch to Lightning

Throughout this guide, you will be instructed to navigate through Setup. To do so, you will need to click on the gear to the upper right and select Setup. Once in Setup, you may use the Quick Find box to find and navigate to the appropriate section.

Navigate to Setup

Preinstallation

Workstation configuration

Before using Drive Connect for Salesforce, it is important to consider workstation configuration properties for the best experience and security. Follow the Recommendations and Requirements for All Browsers guidelines to ensure Salesforce’s accessibility and functionality.

Configuring a Domain in Salesforce

In order to enable lightning components, you must ensure your domain is set up in your Salesforce org. For additional help or information on this, you can view our guide on Configuring a Domain in Salesforce.

Installation

Installing the Drive Connect Package

  • Go to our Salesforce AppExchange Listing and click Get It Now
    Install from AppExchange
  • Select a Connected Salesforce Account and click Install in Production
    Install in production
  • Select I have read and agree to the terms and conditions and click Confirm and Install.
  •  If you are not already logged into the org you wish to install the package into, Salesforce will prompt you to log in with your org credentials.
    Confirm installation details
  • Install for Admins Only is recommended – this option allows for controlling access and permissions after the package has been installed.For further information, please click here to refer to salesforce documentation on Package Installations
    Install for admins
  • Approve Third-Party Access – check off the box and click Continue to start the package installation when the modal appears. As it states, this is to allow data to be sent back and forth between your Salesforce org and Drive Connect:
    • api.driveconnect.app – allows for API calls
      Approve third-party access

Drive Connect Configuration

Drive Connect Setup (Setup Assistant)

The Drive Connect Setup Assistant will need to be completed to connect your Salesforce org to your Google Suite account, in order to access Drive files from Salesforce.

  • To start the Setup Assistant, navigate to App Launcher > Drive Connect
    Open App LauncherDrive Connect in the App Launcher

Note: To alleviate issues accessing Drive Connect features, you must have a domain configured first. Otherwise you must grant tab visibility permissions for the Setup and Template Builder tabs on the setup user’s profile/permission set to access these features.

For more information on creating permission sets and setting permissions please see User Permission and Access.

Initial Configuration

If installing the application for the first time, you will be automatically prompted to complete the first setup flow automatically.

The first section of the wizard requires you sign into your Google account:

  • Click Sign in and Link
  • Login to your Google Account using the Google OAuth flow
    Sign into Google
  • Once authenticated in successfully, click Next
    Auth next

Add the Component to Page Layouts

  • In this section, you have the option to add the Drive Links component to any of your existing flexi page layouts. Note this section can be skipped and you can add the component later. To remove the component, this must be done from Lightning App Builder
    Add component to layouts
  • Click Done when completed with this step
    Done adding to layouts

Your users are now able to link files to records from the Drive Links component.

Licensing & Permissions

If your organization will be using the Document Generation feature in Drive Connect, complete the following steps below. Otherwise, skip this step and go to the Drive Links Lightning Component section.

  • Click Licensing & Permissions
    Licensing and permissions
  • Optionally assign the permission sets and/or licenses to enable features for users
    Perms-&-License-2.0-update(1)
  • Close the Licensing and Permissions page

Your users are now able to create merge templates and generate files with Drive Connect.

Create a Drive Connect Templates Folder in Drive

  • Go to the Template Builder tab once setup is complete
  • Sign into Drive Connect if you aren’t already
  • Name the folder used to store your Drive Connect templates then click Create Folder
  • Note this folder will be created in the Drive of the user who is currently logged into Google at that moment
    Create root folder
  • Once created, you can start building templates for generating documents

Manually Adding Component to Desktop Page Layouts

The Drive Links component can be added to any object supported by Salesforce Content. This can be done using the steps below or from Initial Configuration in Setup Assistant.

To add the component to a lightning record page, navigate to Salesforce Setup Setup > Object Manager.

  • Select the object to modify
    Select object
  • Select Lightning Record Pages
    Lightning Record Pages
  • Select a lightning record page, then click Edit to add the component to an existing lightning page layout. This will launch the Lightning App Builder
    Lightning record page
    Edit record pageNote: You may also click Edit Page in the Salesforce Setup Setup dropdown menu from the object record page to get to the Lightning App Builder
    Edit page
  • Once in the Lightning App Builder, from the list of components on the left panel, find the Drive Links component under the Custom-Managed components section and drag and drop it onto the page layout
    Drag the Drive Links component
  • Click Save
  • Click Activate from the Page Saved modal or click Activation… from the Lightning App Builder if activation is required
    Activate page
    Manual page activation

Note: To add the Drive Links lightning component to Experience Cloud sites, see the Drive Connect for Experience Cloud Sites article.