Before you configure the new server-based SharePoint integration, any document locations that were created by using absolute URLs must be either changed to use relative URLs or removed from Microsoft Dynamics CRM.
Step 1 - Verify the URL type
To verify which document locations in Microsoft Dynamics CRM have absolute URLs, follow these steps:
- In Microsoft Dynamics CRM, open the Settings page.
- Select Document Management from the Settings list in the navigation bar.
- Click SharePoint Document Locations.
- Click the ellipses button on the Microsoft Dynamics CRM command bar, and then click View.
Note A dialog box for editing the current view appears. - Click Add Columns.
- Select Absolute URL from the list of available columns.
- Click Save & Close.
Step 2 - Change or delete the document locations
Use one of the following methods, depending on the result that you want.
Method 1 - Update absolute URLs
Use this method to update all existing document location references. After you do this, the integration will be already connected to SharePoint when you locate to the "Regarding" record. In this case, the user is not prompted to connect to a new document location.
To update absolute URLs, follow these steps:
- Determine the absolute URL for a document location. To do this, follow these steps:
- In Microsoft Dynamics CRM, open the Settings page.
- On the navigation bar, select Document Management from the Settings list.
- Click SharePoint Document Locations.
- In the SharePoint Document Locations section, select a document location that points to an absolute URL.
- Click Edit.
- In the editing form, copy the URL that is specified in the Absolute URL field for your reference. For example, copy https://contoso.sharepoint.com/account/exampleAccount.
- Create a document location to point to the document library found in the absolute URL. To do this, follow these steps:
- On the Microsoft Dynamics CRM command bar, click New in the SharePoint Document Locations section.
- Enter the name of the new document location. For example, enter Account to reference the Account document library in https://contoso.sharepoint.com/account/exampleAccount.
- Under URL Type, select Relative URL.
- Make sure that the Parent Site field or Location field points to the SharePoint site that the document library is located on. For example, verify or enter https://contoso.sharepoint.com.
- In the Relative URL field, type the name of the SharePoint document library that is being referenced. For example, type Account to reference the Account document library in https://contoso.sharepoint.com/account/exampleAccount.
- Click Save and Close.
- Change the original document location that is configured to use an absolute URL to use a relative URL instead. To do this, follow these steps:
- Reopen the document location that is discussed in Step 1.
- Under URL Type, select Relative URL.
- In the Parent Site field or Location field, select the document location that references the document library in which this folder is located. For example, select the document location record that is named Account and that was created in Step 2.
- Under Relative URL, type the name of the SharePoint folder that is being referenced. For example, type exampleAccount for the folder that is represented in https://contoso.sharepoint.com/account/exampleAccount.
- Click Save and Close.
Method 2 - Delete absolute URLs
Use this method to remove document locations that are associated with some records. After you do this, a user who is accessing those records will again receive the following prompt to create a document location for the records.
To delete absolute URLs, follow these steps:
- In Microsoft Dynamics CRM, open the Settings page.
- On the navigation bar, select Document Management from the Settings list.
- Click SharePoint Document Locations.
- In the SharePoint Document Locations section, select all the document location records that use an absolute URL.
- Click Delete.
After you replace any document locations that use absolute URLs by using relative URLs, or after you remove any document locations that use absolute URLs, try to enable server-based SharePoint integration again.