Set up CRM Online to use Sharepoint Online
Applies To: CRM Online
When you use Microsoft SharePoint Online with Microsoft Dynamics CRM Online, you can:
Create, upload, view, and delete documents stored in SharePoint from within Microsoft Dynamics CRM.
Use the SharePoint document management abilities within Microsoft Dynamics CRM, such as checking the document in and out, viewing version history, and changing document properties.
Enable non-Microsoft Dynamics CRM users, such as customers who want to review a bid, to directly access the SharePoint documents, provided they have the appropriate permissions.
|This topic is for organizations who wish to deploy for the first time or upgrade to server-based SharePoint integration. After you enable server-based SharePoint integration, you can’t revert to the previous client-based authentication method. For some organizations, using the Microsoft Dynamics CRM List Component solution might be a better choice. More information: Important considerations for server-based SharePoint integration and SharePoint Document Management software requirements for Microsoft Dynamics CRM.|
|Check out the following video: Microsoft Dynamics CRM 2013 Spring '14 SharePoint New Features.|
To set up CRM Online to use SharePoint Online, complete the following steps.
Assign user permissions to the Team SharePoint site
Your Microsoft Dynamics CRM Online and Microsoft Office 365 users are not automatically allowed access to your SharePoint sites. You must work within the SharePoint site to assign specific permission levels to individual users or groups.
Browse to the Microsoft Office 365 portal (https://portal.microsoftonline.com) and sign in using Global administrator credentials.
Click or tap Sites > Team Site.
On the Home page, click or tap Share your site.
To view the default permissions for your team site, click or tap lots of people.
By default, all users in your Microsoft Office 365 organization are able to add and edit documents on the Team SharePoint site. To invite others, click or tap Invite People and add people external to your organization to share documents.
For more information about SharePoint permissions, see Introduction: Control user access with permissions
Configure CRM Online for SharePoint document management
For CRM Online organizations, Microsoft Dynamics CRM Online Spring ‘14 introduces a new server-based (using server-to-server authentication) SharePoint integration that removes the need to install or continue to use the Microsoft Dynamics CRM List Component solution.
If you are a new organization and have not yet deployed document management, see Configure a new organization.
If you’re using the Microsoft Dynamics CRM List Component to integrate SharePoint document management with CRM Online, you can upgrade to server-based SharePoint and use CRM Online with SharePoint Online. See Configure an existing organization already using the List Component
|The Microsoft Dynamics CRM List Component builds the SharePoint library using the internal name of the document-enabled entity in CRM. Server-based SharePoint integration uses the entity display name. When you upgrade to server-based SharePoint integration, be sure to check that the display names in your document library on SharePoint match the entity display names in CRM. More information: "Validation Error" when you try to configure server-based SharePoint integration for Microsoft Dynamics CRM Online and SharePoint Online.|
These names should match.
Configure a new organization
If your CRM organization has not deployed document management, when a CRM System Administrator logs in an alert message will be displayed to enable server-based SharePoint integration.
|If you don’t see the alert and have not previously enabled server-based SharePoint integration, clear your browser cache or open CRM using Internet Explorer with InPrivate browsing to have the alert display again. Once you configure server-based integration, the alert will no longer appear.|
In the Enable Server-based SharePoint Integration alert click Enable Now to launch the Configuration Wizard.
If your Microsoft Dynamics CRM Online is not connected to a SharePoint online site, enter the URL of your SharePoint site that you will use for auto folder creation, and then click or tap Next.
The URL will be checked for being a valid SharePoint online site and for existing in the same Office 365 tenant as your CRM organization. After enabling server-based SharePoint integration you can’t go back to the previous client-side integration. Click or tap Next and then Finish.
After you enable server-based SharePoint the options to Install List Components and to enable server-based integration will no longer appear as an option in Document Management.
Once server-based SharePoint integration is enabled you will need to enable the entities you want available for document management integration.
Go to Settings > Document Management > Document Management Settings.
Select the entities to be integrated with document management.
Enter the Microsoft Office 365 SharePoint Online URL (for example: https://contoso.sharepoint.com), and then click or tap Next.
Tip To get your SharePoint Online URL, go to your Team site and review the URL in the address bar.
This will validate the URL you entered as well as give you the option to base the folder structure on Account or Contact.
For more information on folder structure click or tap the Help button, or see Enable document management on entities.
Click or tap Next.
Click or tap OK to create Document Libraries.
Your folders will be set up in SharePoint. When the list is complete, click or tap Finish.
Configure an existing organization already using the List Component
If your organization is already using document management with Microsoft Dynamics CRM List Component, you can enable server-based SharePoint integration.
Go to Settings > Document Management > Document Management Settings.
Click or tap Enable server-based SharePoint integration.
If the SharePoint site you connected to with the List Component is valid for server-based SharePoint integration, than you can proceed. Otherwise, you’ll need to remove the site (Microsoft Dynamics CRM > Settings > Document Management > SharePoint Sites) and then come back to this wizard and enter the URL of a new SharePoint online site here.
Click or tap Next to validate existing URLs.
If any of the URLs do not meet the validation requirements, server-based SharePoint integration will fail. Server-based integration cannot be enabled if the URL is not a valid SharePoint online URL or if the SharePoint site you want to connect to is not in the same Office 365 tenant as your CRM organization. Those URLs must be removed before enabling server-based integration, or the List Component would still need to be used.
Click or tap Next and then Finish to complete the wizard.
After you enable server-based SharePoint integration the options to install List Components and to enable server-based integration will no longer appear as options in Document Management.
Using Document Management
You are now ready to add document storage locations to the entities you enabled above and start managing documents. Begin by opening a document management-enabled record (for example, Contact).
Browse to your Microsoft Dynamics CRM Online web application.
Go to Microsoft Dynamics CRM > Sales > Accounts
Click or tap an account, such as the Adventure Works sample account.
On the nav bar, click or tap the down arrow next to the account name, and then click or tap Documents.
Click or tap Upload, and then browse to a document to upload to the new folder in your Microsoft Office 365 SharePoint Online Team site.
The document is now part of your Microsoft Dynamics CRM Online documents list. To see the document in your Microsoft Office 365 SharePoint Online Team site, click or tap Open SharePoint.
The document is now in your Microsoft Office 365 SharePoint Online Team site.
Click or tap Site Contents to see all the document libraries created for the managed entities you selected.
The entities you selected to be managed by Document Management appear as document libraries (for example: Account, Article, Case, Lead, Opportunity, Product, Quote, and Sales Literature).
More information: Manage SharePoint documents from within Microsoft Dynamics CRM
Send comments about this topic to Microsoft.
© 2014 Microsoft Corporation. All rights reserved.