Heute widme ich dem Thema, wie man Dynamics CRM in SharePoint integriert. Wieso sollte man das tun? Kurz gesagt, Dokumente rund um einen Kunden sind in SharePoint gut aufgehoben und werden über CRM gleichzeitig verlinkt – einfaches Auffinden ohne stundenlange Suche ist das Ergebnis.
Und seien wir mal ehrlich, jeder von uns kennt das Problem, dass eine Dokumentation von einem Kunden nicht auffindbar ist. Die Integration ist einfach herzustellen und zu konfigurieren. Es spielt dabei keine Rolle ob wir SharePoint / Dynamics CRM klassisch on-premise oder in der Cloud betreiben. Auch ein Mischbetrieb im sog. Hybrid Modus ist möglich. Als Ergänzung zu diesem Blog-Eintrag könnte auch folgende Präsentation (Englisch) helfen: http://download.hobmaier.net/_layouts/15/WopiFrame.aspx?sourcedoc=%7BBC039CB6-CF18-4D0E-A035-2C38D921B6AE%7D&file=Integrating%20SharePoint%20with%20Microsoft%20Dynamics%20CRM.pptx&action=default
Voraussetzung
Ich gehe davon aus, dass bereits Microsoft Dynamics CRM als auch Microsoft SharePoint installiert ist. Sobald die Verbindung von Dynamics CRM nach SharePoint eingerichtet ist, kann der Zugriff auf das eigentliche Dokument sowohl über Dynamics CRM als auch SharePoint erfolgen. Wenn ich über CRM gehe, ergibt sich für das hochgeladene Dokument folgender Weg:
- Dokument wird über Dynamics CRM hochgeladen. Gleichzeitig wird eine Ordner Struktur in SharePoint erstellt
- Bereits zum ersten Schritt befinden wir uns eigentlich schon auf dem SharePoint WFE, da im Prinzip nur ein Control eingebettet ist.
- SharePoint selbst speichert das Dokument nach dem Upload in der SQL-Datenbank ab – das erfolgt nach SharePoint Standard für alle Dokumente. Sprich die Datenbank kann durchaus groß werden, das ist dann für die Sicherung und Wiederherstellung wieder wichtig.
Einrichtung
Die Einrichtung erfolgt letztendlich auf beiden Seiten. Auf der SharePoint Seite sollte folgendes vorbereitet werden:
Download List Component (optional)
Die List Component wird verwendet um die Struktur automatisch anzulegen. Alternativ kann das ohne Solution von Hand erfolgen. Ich empfehle die Verwendung der Solution.
Dabei spielt es keine Rolle ob wir uns on-premise oder in der Cloud bewegen.
- -Für CRM 2013 inklusive SP1 und Cloud: Microsoft Dynamics CRM 2013 List Component for Microsoft SharePoint Server 2010 and Microsoft SharePoint Server 2013 (for multiple browsers)
http://www.microsoft.com/en-us/download/details.aspx?id=40345
- -Für CRM 2013 RTM (also ohne jegliches Service Pack): Microsoft Dynamics CRM 2011 List Component for Microsoft SharePoint Server 2010 and Microsoft SharePoint Server 2013 (for multiple browsers)
http://www.microsoft.com/en-us/download/details.aspx?id=5283
Install List Component
Nachdem das zuvor genannte Update ausgepackt wurde, gibt es noch zwei Schritte die ausgeführt werden müssen. ![]()
- PowerShell Skirpt “AllowHtcExtn.ps1” ausführen, unter Angabe der Web Anwendung, z.B. AllowHtcExtn.ps1 http://intranet
Dies richtet zwei Sachen ein. Wichtig ist, dass das Skript aus einer SharePoint Management Shell aufgerufen wird, d.h. auf dem SharePoint Server.- SharePoint Dienst Sandboxed Solutions Service (SPUserCodeV4) wird gestartet
- Die Erweiterung htc wird als weiterer MIME-Type für die o.g. IIS Web Anwendung eingerichtet
Websitesammlung erstellen
Websitesammlung / Site Collection erstellen. Auf dieser Ebene können wir am einfachsten Berechtigungen, Datenbanken und Quota (Speicherplatz) verwalten. Das geht (on-premise) in der Central Administration – Create Site Collection:
Anschließend URL, Beschreibung und die Adresse. Diese Adresse werden wir später in CRM angeben, hier http://intranet/sites/CRM
Anschließend noch Experience Version natürlich auf 2013 und als Vorlage kann man durchaus eine Team Site verwenden:
An dieser Stelle kann man auch noch ein Quota einstellen, z.B. 25 GB (ggf. muss hierzu vorher ein Quota Template eingerichtet werden). Nachdem die Site Collection erstellt wurde, rufen wir diese auf, z.B. http://intranet/sites/CRM
List Component aktivieren
Dazu müssen wir nun die Solution hochladen und aktivieren. Dazu über das Rädchen auf Site Settings gehen:
Dort Solutions auswählen:
Jetzt können wir die “WSP” Datei aus dem zuvor heruntergeladenem Patch hochladen und gleichzeitig aktivieren. Im Anschluss sollte es wie folgt aussehen: ![]()
Site Collection Feature aktivieren
Im letzten Schritt muss in SharePoint nur noch das Site Collection Feature, was durch die Solution bereit gestellt wird, aktiviert werden. Dazu geht man auf Site Settings – Site Collection Features und aktiviert “Microsoft Dynamics CRM List Component” – falls nicht schon automatisch aktiviert: ![]()
Dynamics Integration aktivieren
Hierzu öffnen wir Dynamics CRM und gehen auf: Settings – Document Management – Document Management Settings:
Dort geben wir die Entitäten an, an denen wir ermöglichen möchten, diese in SharePoint zu speichern. Hier geben wir als “URL” unsere zuvor erstellte Site Collection an:
Standardmäßig sind folgende Entitäten ausgewählt:
- Account
- KbArticle
- Lead
- Opportunity
- Product
- Quote
- SalesLiterature
- Custom = EntityMetadata.IsDocumentManagementEnabled attribute value to true
Anschließend wird die URL geprüft. Ich empfehle die “Based on entity Account” auszuwählen, damit im Anschluss alle Dokumente unterhalb von Account strukturiert werden, nicht nur Dokumente die am Account direkt hängen, z.B. ein Dokument was an einer Opportunity hängt, wird anschließend auch unter Account abrufbar sein:
Jetzt erstellt CRM die Struktur (Bibliotheken) in SharePoint:
Und ein Blick auf SharePoint:
Wenn Sie sich jetzt wundern, wieso in den Bibliotheken noch keine Strukturen erstellt sind, diese werden erst im nächsten Schritt angelegt.
Dynamics Integration verwenden
Wir werden jetzt ein Dokument über Dynamics CRM hochladen, damit einmalig die Struktur erstellt wird. Anschließend können wir mit reinen SharePoint Benutzern beliebig Dokumente hinzufügen, Workflows verwenden, Versionierung aktiveren – all diese schönen SharePoint Funktionen. Dazu gehen wir auf einen Account – Documents:
Beim ersten Zugriff werden wir gefragt ob die Ordner in SharePoint erstellt werden sollen – Ja:
Ab diesem Zeitpunkt kann ich auf beiden Seiten Dateien hinzufügen:
Besonders charmant – Die Verwendung von Workflows in SharePoint z.B. kann man so einen Prozess für die Freigabe von Angeboten erstellten, die direkt von einem Sales Manager genehmigt werden müssen.
Referenz
- Integrate SharePoint with Microsoft Dynamics CRM: http://msdn.microsoft.com/en-us/library/gg334768.aspx



