In Salesforce, you will need to complete the authentication configuration for the connector. The values needed for this configuration must be gathered after completing the steps provided in the Web Application Registration (SharePoint Add-in) article.
Step 1: Enable Apex Setting
Before installing the connector, the system admin will need to enable the following setting in your Salesforce org:
- Go to Setup
- Type Apex Settings into the Quick Find search box
- Select Apex Settings in the side menu on the left
- Enable the Deploy Metadata from Non-Certified Package Versions via Apex checkbox
- Select Save
Step 2: Install the Package
The installation link will be provided by your account manager. However, if you have not received the installation link, please contact AdvoLogix Support ([email protected]).
Step 3: Assign the Permission Set
Any user that will be using the connector will need to be assigned to the SharePoint User permission set.
Note to System Administrators:
If any SharePoint features or tabs are not visible to a user, then you will need to add this permission to one of the following three choices:
- assign a permission set -OR-
- modify the profile -OR-
- assign to the AdvoLogix permission set
Step 4: Create Remote Site
- In Salesforce Setup, enter Remote Site Settings in the Quick Find box, and select Remote Site Settings.
- Select New Remote Site and set the following options:
- Remote Site Name - Enter a unique remote site name (no spaces).
-
Remote Site URL - Enter your SharePoint Base Site URL. It should be similar to this:
https://[your company name].sharepoint.com - Active - Enable this checkbox.
- Click Save.
Step 5: Set Up SharePoint Configuration
You can find SharePoint Setup tab in the AppLauncher (waffle) at the top left of any Salesforce page.
- From the side menu, click on SharePoint Configuration and click Edit to make changes as highlighted in below steps.
- Authentication Type - Select SharePoint Add-in or Azure AD, based on how you have setup the web application for SharePoint authentication.
-
Base Site URL - (Required) Enter the SharePoint URL here. Based on how users access the connector and how it has been setup for SharePoint authentication, the URL format will look like one of the two examples below:
- If you have setup authentication application under a specific SharePoint site collection, then use this format:
https://[your company name].sharepoint.com/[site collection path] - If your user setup authentication allows users to browse through and connect to any of the SharePoint sites they have access to, then use the following format:
https://[your company name].sharepoint.com
- If you have setup authentication application under a specific SharePoint site collection, then use this format:
- Client Id - (Required) Enter the Client Id copied during the setup of the web application for SharePoint authentication.
- Client Secret - (Required) Enter the Client Secret copied during the setup of the web application for SharePoint Authentication (see step 5).
- Tenant Id - (Required for Azure App) Enter the Tenant Id copied during the setup of the web application for SharePoint authentication.
- Redirect URL - (Required) Enter the redirect URL as it has been provided during the setup of the web application for SharePoint authentication.
- Default Site Path - (Optional) Enter the default site path for users to connect within the connector.
Once all values have been provided, select the Save button to save the configuration values. Your SharePoint setup is complete and the connector is now ready to use.