Manage SharePoint documents from within Microsoft Dynamics CRM
This topic is prerelease documentation and is subject to change.
Store your documents on Microsoft SharePoint and manage these from within Microsoft Dynamics CRM by using the document management capabilities of SharePoint.
Integrate Microsoft Dynamics CRM with SharePoint to access, share, and collaborate more effectively. You can protect your stored documents in SharePoint from unauthorized access or use. More information: Manage permissions for a list, library, folder, document, or list item
Enable document management on entities
To manage documents for an entity, you must enable document management for that entity. You can manage documents for any entities on SharePoint. By default, document management is automatically enabled on the following entities when you enable document management for the organization:
Define which entities manage documents on Microsoft Dynamics CRM in the Document Management Settings dialog box. More information: Enable document management on entities
When you set up document management, SharePoint creates document libraries and folders in the context of the Microsoft Dynamics CRM entities and records.
How document management works
When you set up document management, you specify a SharePoint site collection or site URL where the documents will be stored. More information: TechNet: Overview of sites and site collections in SharePoint 2013
Microsoft Dynamics CRM uses the specified site collection or site to create document libraries for entities and folders for records on SharePoint.
When the document libraries and folders are created automatically on SharePoint, corresponding document location records are created on Microsoft Dynamics CRM that point to the newly created folders.
If you do not want to use the automatic creation feature, you can manually create document libraries and folders on SharePoint. Then, create document location records in Microsoft Dynamics CRM that point to the document libraries and folders on SharePoint, and then associate the document location records with the entity records.
After the folder structure to store the documents is in place, you can start using all the document management capabilities.
How document libraries and folders are created automatically
There are two ways to create a folder structure:
Manually create document libraries and folders in the context of Microsoft Dynamics CRM entities and records. Then, associate the SharePoint folders with Microsoft Dynamics CRM records.
Let Microsoft Dynamics CRM automatically create the document libraries and folders in SharePoint.
Microsoft Dynamics CRM automatically creates document libraries and folders on SharePoint if the URL you specify is for one of the following:
A site collection that is on Microsoft SharePoint Server 2010 or Microsoft SharePoint Server 2013, and has the Microsoft Dynamics CRM List Component installed on it.
A site under a site collection that is on Microsoft SharePoint Server 2010 or Microsoft SharePoint Server 2013, and the site collection has the Microsoft Dynamics CRM List Component installed.
When you choose to have Microsoft Dynamics CRM automatically create folders for you, you must specify whether you want the folders to be created based on the default (generic) structure or based on the entity.
Default structure. A folder is created for each record in the document library for the entity. This is the default folder structure.
For example, you have 100 bikes and 250 bikes opportunity records. These are opportunities for Margie's Travel. Microsoft Dynamics CRM creates this folder structure:
In this structure:
Structure based on entity. A folder is created so that folders for primary entities (for which you want to manage documents) and their records are created under the document library of the related entity that you select. To create folders using this structure, select the Based on entity check box and then select an entity from the list (such as Account or Contact).
For example, you have 100 bikes and 250 bikes opportunity records. These opportunities are associated with Margie's Travel as the parent customer. You select Account for the entity. This is the created folder structure:
../account/Margie's Travel/opportunity/100 bikes
In this structure:
account is the document library.
Margie's Travel is the folder for the related records.
opportunity is the folder for the related opportunity records.
100 bikes and 250 bikes are related opportunity record folders for the main entity.
Microsoft Dynamics CRM creates the document library when you set up document management. However, Microsoft Dynamics CRM creates the various folders in the document library only when you open the Documents list for a record.