CRM SharePoint Schnittstelle Handbuch zur Konfiguration und Installation der CRM SharePoint Schnittstelle für MS CRM 2011, CRM 2013 und CRM 2015

Transkript

1 CRM SharePoint Schnittstelle Handbuch zur Konfiguration und Installation der CRM SharePoint Schnittstelle für MS CRM 2011, CRM 2013 und CRM 2015 Schnittstellenversion: , 6.0.1, 7.0.1

2 Inhalt 1 Vorwort Installation Voraussetzungen Importieren der Lösung Die Lizensierung Automatisierte Lizenzanforderung Lizenzanforderung ohne Internetverbindung Der Abschnitt Einstellungen im Konfigurationsdatensatz ClientAccessPolicy MIME Types Konfiguration Einbinden der CRM SharePoint Schnittstelle in die Formulare Die Konfigurationsdatensätze Der Datensatz LicenceKey Der Datensatz Configuration Die Konfigurations XML Das Element configuration Das Element global Das Element defaultcolumns Das Element column Das Element titles Das Element title Das Element sharepointurl Das Element sitecollection Das Element sharepointlcid Das Element viewprotocol Das Element isfoldersvisible Das Element sharepointversion Das Element iswaitpageactive Das Element maxsearchcount Das Element isopensharepointavailable Das Element foldertreeviewwidth Das Element isopeninwindowsexploreravailable Das Element isshowdocumentpropertyavailable Das Element windowsexplorerurl Das Element sharepointserver Das Element zeitmessung Das Element entities Das Element entity Das Element sitemapentities Das Element sitemapentity Das Element pluralnames Das Element pluralname Rechte und Browsereinstellungen Deinstallation Entfernen der Navigationseinträge in allen Entitäten Löschen der Konfigurationsdatensätze zur CRM SharePoint Schnittstelle Löschen der Lösung Entfernen der ClientAccessPolicy XML Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 2 von 38

3 1 Vorwort Vielen Dank, dass Sie sich für unsere CRM SharePoint Schnittstelle entschieden haben. Die CRM SharePoint-Schnittstelle bietet die Möglichkeit, Dokumente zentral aus dem CRM-System heraus zu verwalten und zu bearbeiten. Alle SharePoint Funktionalitäten sind in der CRM SharePoint Schnittstelle nutzbar. Somit ist es nicht notwendig im SharePoint Server selbst zu arbeiten, sondern über der gewohnten Oberfläche von Microsoft Dynamics CRM. Bei der SharePoint-Schnittstelle handelt es sich um ein Addon für Microsoft Dynamics CRM 2011, CRM 2013 und CRM Zusätzlich zum Standard-Sharepoint verfügt die Sharepoint-Schnittstelle über eine erweiterte Suchfunktion. Außerdem können auch Dokumente von verknüpften Entitäten angezeigt werden. Auf den folgenden Seiten finden Sie eine ausführliche Konfigurationsanleitung. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 3 von 38

4 2 Installation 2.1 Voraussetzungen Auf dem Server muss mindestens ein Microsoft Dynamics CRM 2011 System mit mindestens Rollup 8 installiert sein. Zum Installieren der CRM SharePoint Schnittstelle wird die Rolle des Systemadministrators im CRM-System benötigt. Ferner ist für die Konfiguration der CRM SharePoint Schnittstelle das Browser-Plug-In Microsoft Silverlight erforderlich. Dieses steht unter zur Verfügung. Es ist ein vorinstallierter Microsoft SharePoint Server der Version 2003, 2007, 2010 und 2013 (Foundation oder Enterprise) notwendig. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 4 von 38

5 2.2 Importieren der Lösung Die Lösung der Schnittstelle steht zum Download auf der Webseite bereit. Der Import der Lösung erfolgt über die Navigationsleiste des Microsoft Dynamics CRM und die Navigationsschaltfläche Lösungen, in der alle aktuellen Lösungen des CRM verwaltet werden. Betätigen Sie jetzt den Button Importieren in der Symbolleiste. Es öffnet sich der Installationsassistent, der durch den gesamten Importvorgang führt: Mit dem Durchsuchen wird die Solution aufgerufen und nachdem die Solution im Datenfeld angezeigt wird, wird der Vorgang mit dem Button Weiter fortgeführt. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 5 von 38

6 Nachdem der Installationsvorgang in den nachfolgenden Fenstern jeweils mit dem Button Weiter fortgeführt worden ist, muss in diesem Fenster in das Feld zur Aktivierung aller Prozesse und Lösungen einen Haken gesetzt und den Vorgang durch Betätigen des Buttons Weiter abgeschlossen werden. Die Solution wird importiert. Dieser Vorgang kann einige Sekunden in Anspruch nehmen. Ist die Installation beendet, öffnet sich die Protokolldatei zur Kontrolle und Information. Sind alle aufgeführten Punkte im Status mit einem Haken versehen, ist die Installation erfolgreich und fehlerfrei abgeschlossen und der Vorgang kann mit dem Button Schließen beenden werden. In dem hier abgebildeten Screenshot sieht man eine Warnungsmeldung. In diesem Fall liegt es daran, da die Schnittstelle in Deutsch und Englisch zur Verfügung steht, das CRM aber nur in deutscher Sprache verfügbar ist. Diese Warnung kann somit ignoriert werden. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 6 von 38

7 Im CRM System unter der Entität Lösungen erscheint der Eintrag mit dem Namen crmsharepointinterface (Anzeigename: SharePoint-Schnittstelle). 2.3 Die Lizensierung Jetzt wird der entsprechenden Lizenzschlüssel für die CRM SharePoint Schnittstelle benötigt. Dazu wird die importierte Lösung mit einem Doppelklick zur Konfigurationsseite geöffnet. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 7 von 38

8 2.3.1 Automatisierte Lizenzanforderung Im Abschnitt Lizenz wird der Button Lizenz anfordern gedrückt. Es ist erforderlich, dass zur automatisierten Lizenzanforderung eine Adresse hinterlegt wird. Weiterhin muss den Vertragsbedingungen zugestimmt werden, bevor man mit dem Button Weiter die Lizenz anfordert. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 8 von 38

9 Der Import der Lizenz kann einige Minuten andauern. Durch das Drücken auf dem Button Weiter stellt der CRM-Server eine einmalige Verbindung zu dem Lizenzserver der Donaubauer Aktiengesellschaft her, welcher anschließend den Lizenzschlüssel automatisch auf Ihr System überträgt Lizenzanforderung ohne Internetverbindung Sollte der CRM-Server keine Internetverbindung haben, so öffnet nach dem Knopfdruck auf Lizenz anfordern dieses Fenster. Die gesamte Lizenz-XML muss in eine kopiert und an die -Adresse gesandt werden. Die manuell erzeugte Lizenz wird an die Absender-E- Mail gesandt. Den Lizenzschlüssel wird zeitnah per übersandt und muss in das CRM-System importiert werden. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 9 von 38

10 Dies erfolgt wieder über die Konfigurationsseite der CRM SharePoint Schnittstelle über den SharePoint Menüpunkt Lizenz. Die Lizenz wird in das Feld Lizenzschlüssel hineinkopiert (1) und mit dem Button Lizenz importieren (2) der Vorgang abgeschlossen. 2.4 Der Abschnitt Einstellungen im Konfigurationsdatensatz In dem Abschnitt Einstellungen im Konfigurationsdatensatz wird die Konfigurations XML hinterlegt. Wie diese im Einzelnen zu erstellen ist, wird im Absatz Die Konfigurations XML in diesem Handbuch näher beschrieben. Die, gemäß Anleitung erstellte, Konfigurations XML wird hier hinterlegt und der Datensatz geschlossen. Damit sind die Verbindung der CRM SharePoint Schnittstelle, das Design und die Funktionsweise definiert und können genutzt werden. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 10 von 38

11 2.5 ClientAccessPolicy Damit das Silverlight Zugriff auf den SharePoint Server hat, ist es notwendig eine Richtliniendatei (ClientAccessPolicy.xml) im Root Verzeichnis der SharePoint Webseite (keine Dokumentenbilbliothek oder Liste) zu hinterlegen. Das Beispiel einer ClientAccessPolicy XML ist der Dokumentation als Anlage 2 beigefügt. Um den Speicherort der Richtlinendatei zu ermitteln, gehen Sie im IIS (InternetInformationService) mit der rechten Maustaste auf die SharePoint Webseite und wählen Im Explorer öffnen aus. In dem geöffneten Explorer Fenster wird die ClientAccessPolicy.xml abgespeichert. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 11 von 38

12 2.6 MIME Types Bis einschließlich IIS 6.0 ist es notwendig unter MIME Types den Type.xap einzutragen, soweit dieses nicht durch andere Anwendungen geschehen ist, da die SharePoint Schnittstelle mit Silverlight entwickelt wurde. Damit Sie alle Funktionen nutzen können, ist es notwendig die Suche und die Versionierung auf Ihrem SharePoint Server anzuschalten und zu konfigurieren. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 12 von 38

13 3 Konfiguration 3.1 Einbinden der CRM SharePoint Schnittstelle in die Formulare Die Konfiguration der CRM SharePoint Schnittstelle muss in allen Entitäten erfolgen, in welchen die CRM SharePoint Schnittstelle genutzt werden soll. Dazu wird im Hauptformular (Beispiel: Angebot) über den Button Navigation in der Menüzeile die Formularnavigation aktiviert. Danach kann über den Reiter Einfügen der Navigationslink ausgelöst werden. Die Navigationslinkeigenschaften müssen wie folgt hinterlegt werden. Name: Symbol: Webressource: geben Sie der Navigationslinkeigenschaft einen logischen Namen wählen Sie hier die Webressource donau_/sharepointinterface/images/navigation.png aus wählen Sie hier die Webressource donau_/sharepointinterface/sharepointinterface.html aus Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 13 von 38

14 Im linken Navigationsbereich erscheint im Formular unter dem ausgewählten Absatz Allgemein, der neu eingetragene Eintrag Dokumente. Die Anpassung des Formulars wird mit Speichern und durch Drücken des Buttons Veröffentlichen in der Menüleiste abgeschlossen. Dieser Vorgang muss in allen Entitäten wiederholt werden, in denen die CRM SharePoint Schnittstelle genutzt werden soll. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 14 von 38

15 3.2 Die Konfigurationsdatensätze In der Navigationsleiste des Microsoft Dynamics CRM, über Einstellungen erreicht man die Navigationsschaltfläche Konfiguration. Nachdem die Lizenz angefordert (automatisch oder manuell) und die Konfigurations XML hinterlegt wurde, sind in dieser Ansicht zwei Konfigurationsdatensätze zur CRM SharePoint Schnittstelle vorhanden Der Datensatz LicenceKey Im Datensatz LicenceKey wurden folgende Informationen hinterlegt: Name: Anwendung: Datentyp: Wert (Mehrere Textzeilen): LicenceKey CRM SharePoint Schnittstelle Mehrere Textzeilen Hier wird der Lizenzschlüssel eingetragen. Ist kein Lizenz-Key angefordert oder die Lizenz abgelaufen, kann man die Schnittstelle als DEMO-Version nutzen. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 15 von 38

16 3.2.2 Der Datensatz Configuration Im Datensatz Configuration sind folgende Informationen hinterlegt: Name: Anwendung: Datentyp: Wert (Mehrere Textzeilen): Configuration CRM SharePoint Schnittstelle Mehrere Textzeilen In diesem Feld wird die Konfigurations-XML hinterlegt Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 16 von 38

17 3.3 Die Konfigurations XML Die Verbindung der CRM SharePoint Schnittstelle zum SharPoint-Server, das Design und die Funktionsweise der CRM Sharpoint Schnittstelle werden in einer XML-Datei definiert. Diese Definition wird im Feld Konfigurations XML des Formulars Einstellungen hinterlegt. Screenshot: Folgende Möglichkeiten der Definition sind möglich: Merke: Alle XML Tags haben die Eigenschaft case sensitive, dass heißt Groß- und Kleinschreibung muss beachtet werden. Das Beispiel einer XML ist der Dokumentation als Anlage 1 beigefügt. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 17 von 38

18 3.3.1 Das Element configuration Element configuration beschreibt das Konfigurationsmodell. <configuration></configuration> Das Element configuration hat keine übergeordneten Elemente und präsentiert das Root-Element global globale Einstellungen global Pflichtfeld entities Definition der Entitäten entities Pflichtfeld Das Element global Im Element global werden die allgemeinen Einstellungen definiert. Einige zu definierende Einstellungen sind Pflichtangaben. Andere sind keine Pflichtangaben und werden bei nicht Angabe mit Standardwerten festgelegt. Welche Standardwerte für welche Einstellung benutzt werden, ist über den Button Weitere Aktionen Protokoll anzeigen ersichtlich. <global></global> Das Element global ist ein Pflicht-Element und kann nur einmal hinterlegt werden. configuration Root-Element (Wurzelelement) configuration Pflichtfeld sharepointurl Protokoll und Name des SharePoint Servers sharepointurl Pflichtfeld sitecollection Angabe der Webseite im SharePoint sitecollection Pflichtfeld defaultcolumns Angabe der Standardspalten defaultcolumns Pflichtfeld Optionale Felder sharepointlcid Angabe der SharePoint Server Sprache SharePoint LCID optional viewprotocol Anzeige der Protokollierung viewprotocol optional isfoldersvisible Anzeige von Unterordnern isfoldersvisible optional sharepointversion Angabe der SharePoint Server Version sharepointversion optional iswaitpageactive Anzeige eines Wartebildschirms iswaitpageactive optional maxsearchcount Maximale Anzahl der Suchergebnisse maxsearchcount optional sharepointserver Einstellung für die Suche sharepointserver optional isopensharepointavai Öffnen des aktuellen Datensatzes im isopensharepoint optional lable SharePoint Server zulassen oder nicht Available foldertreeviewwidth Angabe der Breite des TreeViews in der foldertreeviewwi optional isopeninwindowsexpl oreravailable Ansicht SharePoint Dokumente des Datensatzes im Explorer anzeigen dth isopeninwindows ExplorerAvailable optional Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 18 von 38

19 isshowdocumentprop ertyavailable Dokumentendetails anzeigen isshowdocument PropertyAvailable windowsexplorerurl Dokumente im Explorer anzeigen windowsexplorer Url zeitmessung Zeitmessung Unterschieldicher Prozesse zeitmessung nutzen optional optional optional Das Element defaultcolumns Das Element defaultcolumns umfasst die gesamten Spalten, die in der Schnittstelle angezeigt werden. <defaultcolumns></defaultcolumns> Mit Angabe einer Sortierspalte: <defaultcolumns sortcolumn='name'></defaultcolumns> Bei diesem Beispiel werden die Dokumente nach der Spalte Name sortiert. Das Element defaultcolumns ist ein Pflicht-Element und kann nur einmal hinterlegt werden. global globale Einstellungen global Pflichtfeld Attribute Eigenschaftsnamname Eigenschaftsname Eigenschafts- Eigenschafts name sortcolumn sortcolumn sortcolumn sortcolumn column Festlegung einer Spalte Column Plfichtfeld Das Element column Über das Element column werden die Beschriftungen der Spalten in der SharePoint Schnittstelle definiert. Es enthält eine Menge von weiteren Elementen, die bei keiner weiteren Angabe zur Darstellung der Spalten in der SharePoint Schnittstelle verwendet werden. Mögliche Dokumenteninformationen können in jeweiligen Spalten angezeigt werden: Name CreatedBy ModifiedBy Created Lastmodified TypeContent Size MetaInfo RecordName Alle selbst erstellten Spalten Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 19 von 38

20 <column></ column> Das Element column ist ein Pflicht-Element und kann mehrmals hinterlegt werden. defaultcolumns Standardspalten Angabe DefaultColumns Pflichtfeld Attribute Eigenschaftsname Beschreibung Typ Verwendung name Eindeutiger Bezeichner des Elementes string Pflichtfeld width Spaltenbreite string Pflichtfeld titles Eigenschaften/Informationen zu CRM-Feldern Titles Pflichtfeld Das Element titles Unter dem Element titles werden Eigenschaften/Informationen zu CRM-Feldern hinterlegt. Es können beliebig viele Elemente title unter diesem Element hinterlegt werden. <titles></ titles> Das Element titles ist ein Pflicht-Element und kann nur einmal pro column Element hinterlegt werden. column Spaltenbezeichnung und Spaltenbreite column Pflichtfeld title Eigenschaften pro Feld title Pflichtfeld Das Element title Über dieses Element legen Sie den Beschriftungstext der für die angegebene Sprache der Spalte benutzt wird. <title LCID='' name='' /> Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 20 von 38

21 titles Spaltenbeschriftung Titles Pflichtfeld Attribute Eigenschaftsname Beschreibung Typ Verwendung LCID Sprachcode, Bsp: 1031 string Pflichtfeld name Beschriftung/Titel der Spalte string Pflichtfeld Das Element title hat keine untergeordneten Elemente Das Element sharepointurl Mit dem Element sharepointurl wird die URL zum SharePoint Server angegeben. Diese Angabe ist eine Pflichtangabe. <sharepointurl>protokoll://servername</sharepointurl> global globale Einstellungen global Pflichtfeld Das Element sharepointurl hat keine untergeordneten Elemente Das Element sitecollection Mit dem Element wird die zu nutzende Webseite im SharePoint Server angegeben in der dann alle Dokumentenbibliotheken angelegt werden. Die Angabe von nur einem / ist auch möglich. Diese Angabe ist eine Pflichtangabe. <sitecollection></sitecollection> global globale Einstellungen global Pflichtfeld Das Element sitecollection hat keine untergeordneten Elemente. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 21 von 38

22 3.3.9 Das Element sharepointlcid Mit dem Element wird die benutzte Sprache auf dem SharePoint festgelegt. Wenn diese Angabe nicht angegeben wird, so ist der Standardwert für diese Einstellung auf die Sprache en-us mit Sprachcode 1033 festgelegt. <sharepointlcid>1031</sharepointlcid> global globale Einstellungen global Pflichtfeld Das Element sharepointlcid hat keine untergeordneten Elemente Das Element viewprotocol Mit dem Element viewprotocol werden alle Protokollinformationen der SharePoint Schnittstelle über den Eintrag Protokoll anzeigen im Menü weitere Aktionen sichtbar. Wenn diese Angabe nicht angegeben wird, so ist der Standardwert für diese Einstellung auf standard festgelegt und der Menüeintrag Protokoll anzeigen erscheint. Über diese Funktion sind auch alle benutzten Standardwerte der möglichen globalen Einstellungen sichtbar. Wird dieses Element explizit mit dem Wert false angegeben, so sind die Funktionen Parameter anzeigen und Protokoll anzeigen nicht im Menü vorhanden. <viewprotocol>standard</viewprotocol> Um eine detailliertere und umfangreichere Protokollierung zu erhalten, wird folgende Angabe verwendet: Diese Option sollte nicht im Produktivbetrieb verwendet werden, da bei dieser Einstellung sehr viele Informationen in das Protokoll geschrieben werden. <viewprotocol>detail</viewprotocol> Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 22 von 38

23 global globale Einstellungen global Pflichtfeld Das Element viewprotocol hat keine untergeordneten Elemente Das Element isfoldersvisible Mit diesem Element wird festgelegt, ob Unterordner im Dokumentenbereich angezeigt werden. Ist der Wert auf false festgelegt, sind die Unterordner nur in der Baumstruktur sichtbar. Bei nicht Angabe dieses Elementes ist der Standardwert true. <isfoldersvisible>true</isfoldersvisible> global globale Einstellungen global Pflichtfeld Das Element isfoldersvisible hat keine untergeordneten Elemente Das Element sharepointversion Mit diesem Element wird die benutzte SharePoint Server Version angegeben. Bei dem SharePoint Server 2003 bewirkt diese Angabe, dass die Suchfunktion und das Anzeigen und Nutzen von SharePoint Vorlagen nicht zur Verfügung stehen. Bei nicht Angabe dieses Elementes wird die SharePoint Server Version 2010 benutzt. Mögliche Angaben sind: 2003, 2007, 2010 (Enterprise und Foundation) und 2013 (Foundation). <sharepointversion>2010</sharepointversion> global globale Einstellungen global Pflichtfeld Das Element sharepointversion hat keine untergeordneten Elemente Das Element iswaitpageactive Mit diesem Element wird festgelegt, ob während eines Prozesses (z.b. Hochladen, Laden oder Löschen von Dokumenten) ein Wartebildschirm angezeigt wird. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 23 von 38

24 Bei nicht Angabe dieses Elementes ist die Standardwert false. <iswaitpageactive>true</iswaitpageactive> global globale Einstellungen global Pflichtfeld Das Element iswaitpageactive hat keine untergeordneten Elemente Das Element maxsearchcount Mit diesem Element wird die maximale Anzahl der möglichen gefundenen Dokumente bei einer Suche festgelegt. Wird dieses Element nicht angegeben, werden maximal 500 Dokumente bei einer Suche angezeigt. Beim SharePoint Foundation 2013 ist eine maximale Anzahl von 500 Dokumenten möglich. <maxsearchcount>500</maxsearchcount> global globale Einstellungen global Pflichtfeld Das Element maxsearchcount hat keine untergeordneten Elemente Das Element isopensharepointavailable Mit diesem Element wird eine Möglichkeit den Benutzern gegeben, den aktuell geöffneten Datensatz im SharePoint Server zu öffnen. Soll diese Funktion nicht zur Verfügung stehen, wird der Wert auf false festgelegt und der Eintrag ist nicht unter weitere Aktionen sichtbar. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 24 von 38

25 <isopensharepointavailable>true</isopensharepointavailable> global globale Einstellungen global Pflichtfeld Das Element isopensharepointavailable hat keine untergeordneten Elemente Das Element foldertreeviewwidth Mit diesem Element können Sie festlegen, welche Breite der TreeView Bereich einnimmt. Der Wert wird in Pixeln angegeben. Wenn Sie dieses Element nicht angeben, wird ein Standardwert von 200 (Pixeln) festgelegt. <foldertreeviewwidth>200</foldertreeviewwidth> global globale Einstellungen global Pflichtfeld Das Element foldertreeviewwidth hat keine untergeordneten Elemente Das Element isopeninwindowsexploreravailable Mit diesem Element wird dem Benutzer die Möglichkeit gegeben, den geöffneten Datensatz im Windows Explorer zu öffnen. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 25 von 38

26 Wird dieses Element nicht angeben, wird der Standardwert auf false gesetzt und der Eintrag Öffnen im Windows-Explorer ist nicht im Menü zur Verfügung. <isopeninwindowsexploreravailable>true</isopeninwindowsexploreravailable> global globale Einstellungen global Pflichtfeld Das Element isopeninwindowsexploreravailable hat keine untergeordneten Elemente Das Element isshowdocumentpropertyavailable Mit diesem Element gibt es die Möglichkeit detaillierte Informationen (alle Meta Daten) eines ausgewählten Dokumentes anzeigen zu lassen. Ist diese Eigenschaft auf true gestellt, erscheint im Menü weitere Aktionen der Eintrag Dokumenteneigenschaften anzeigen, wie im folgenden Bild zu sehen: Wird dieses Element nicht angeben, wird der Standardwert auf false gesetzt und der Eintrag ist nicht unter dem Menü weitere Aktionen sichtbar. <isshowdocumentpropertyavailable>true</isshowdocumentpropertyavailable> Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 26 von 38

27 global globale Einstellungen global Pflichtfeld Das Element isshowdocumentpropertyavailable hat keine untergeordneten Elemente Das Element windowsexplorerurl Dieses Element steht im Zusammenhang mit dem Element isshowdocumentpropertyavailable. Über das Element windowsexplorerurl wird die URL angegeben, um den jeweiligen Datensatz im SharePoint Server öffnen zu können. Dafür ist der Name des SharePoint Servers ohne die Angabe eines Protokolls anzugeben. Für dieses Element wird kein Standardwert festgelegt. <windowsexplorerurl>servername </windowsexplorerurl> global globale Einstellungen global Pflichtfeld Das Element windowsexplorerurl hat keine untergeordneten Elemente Das Element sharepointserver Über dieses Element wird festgelegt, welcher SharePoint Server verwendet wird. Diese Angabe ist nur für SharePoint Server 2010 nötig. Diese Einstellung ist wichtig, damit der richtige SharePoint Suchservice angesprochen wird und eine erfolgreiche Suche möglich ist. Mögliche Angaben sind foundation oder enterprise. Wenn Sie dieses Element nicht angeben, wird der Standardwert auf foundation festgelegt. <sharepointserver>foundation</sharepointserver> global globale Einstellungen global Pflichtfeld Das Element sharepointserver hat keine untergeordneten Elemente Das Element zeitmessung Mit dem Element zeitmessung ist es möglich, beim Abrufen, Hochladen und bei der Suche von Dokumenten, die Dauer des jeweiligen Prozesses zu messen. Nach jedem Prozess erscheint ein Informationsfenster mit den Zeitangaben der einzelnen Schritte. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 27 von 38

28 Wenn Sie dieses Element nicht angeben, wird der Standardwert auf false festgelegt. <zeitmessung>true</zeitmessung> Das Element entities Das Element entities definiert die Entitäten, in denen die SharePoint Schnittstelle ausgeführt wird. <entities></entities> Das Element entities ist ein Pflicht-Element und kann nur einmal hinterlegt werden. configuration Root-Element (Wurzelelement) configuration Pflichtfeld entity Definition der Entitäten entity Pflichtfeld Das Element entity Mit dem Element entity wird die entsprechende Entität definiert. <entity name= displayfieldname= /> <entity name= displayfieldname= idfieldname= ></entity> Das Element entity ist ein Pflicht-Element und kann mehrfach hinterlegt werden. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 28 von 38

29 entities Definition der Entitäten entities Pflichtfeld Attribute Eigenschaftsname Beschreibung Typ Verwendung name Schemaname der Entität string Pflichtfeld idfieldname Primäre Keyfeld der Entität, bei Account: accountid string optional nur nötig, wenn im TreeView angezeigt werden soll displayfieldna Attributenamen zum Anzeigen im TreeView string Pflichtfeld me sitemapentities im TreeView zusätzlich anzuzeigende Entitäten.. SiteMapEntities optional pluralnames Beschriftung für jede Sprache pluralnames Pflichtfeld Das Element sitemapentities Mit dem Element sitemapentities werden die verknüpften Entitäten angegeben, die in der Baumstruktur (TreeView) zusätzlich zum jeweiligen Datensatz angezeigt werden. Für jede zusätzliche Entität ist es notwendig ein Unterelement sitemapentity anzugeben. < sitemapentities></ sitemapentities> entity Entity Pflichtfeld sitemapentity im TreeView zusätzlich anzuzeigende Entität sitemapentity Pflichtfeld Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 29 von 38

30 Das Element sitemapentity Mit diesem Element wird ein Eintrag in der Baumstruktur festgelegt. Diese anzuzeigende Entität muss zum einen einen Eintrag entity besitzen und muss mit dem Datensatz über ein LookUp Feld verknüpft sein. <sitemapentity name='contact' reffieldname='parentcustomerid' /> Beispiel: <entity name='account' idfieldname='accountid' displayfieldname='name'> <sitemapentities> <sitemapentity name='quote' reffieldname='customerid' /> </sitemapentities> </entity> 'customerid' ist das LookUp-Feld im Angebotsformular zur Firma Bei dieser Konfiguration muss es wie oben erwähnt eine Element entity mit name= quote geben. <entity name='quote' idfieldname = 'quoteid' displayfieldname='name'> <pluralnames> <pluralname LCID='1031' name='angebote' /> <pluralname LCID='1033' name='quotes' /> </pluralnames> </entity> Benutzerdefinierte Beziehungen lassen sich dabei genauso abbilden wir Standardbeziehungen. sitemapentities Spaltenbeschriftung sitemapentities Pflichtfeld Attribute Eigenschaftsname Beschreibung Typ Verwendung reffieldname Schemaname des Lookup Feldes im Datensatz string Pflichtfeld name Schemaname der Entität z.b. contact string Pflichtfeld Das Element sitemapentity hat keine untergeordneten Elemente. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 30 von 38

31 Das Element pluralnames Mit diesem Element können Sie für jedes definierte entity Element Pluralnamen für die jeweilige Sprache definieren. Diese Namen werden dann zur Anzeige der jeweiligen Entität im TreeView genutzt. <pluralnames> </pluralnames> entity entsprechend definierte Entität Entity Pflichtfeld pluralname Beschriftung für jede Sprache pluralname Pflichtfeld Das Element pluralname Über dieses Element legen Sie pro Sprache einen Eintrag fest, mit welchem Text in der jeweiligen Sprache die Entität angezeigt wird. <pluralname LCID='1031' name='angebote' /> Beispiel: <pluralnames> <pluralname LCID='1031' name='firmen' /> <pluralname LCID='1033' name='accounts' /> </pluralnames> pluralnames Hauptelement zur Beschriftung pluralnames Pflichtfeld Attribute Eigenschaftsname Beschreibung Typ Verwendung LCID Sprachcode z.b: 1031 string Pflichtfeld name Titel für die Entität string Pflichtfeld Das Element pluralname hat keine untergeordneten Elemente. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 31 von 38

32 4 Rechte und Browsereinstellungen Als Empfehlung zur Rechtevergabe auf dem SharePoint Server empfehlen wir die im Active Directory definierte Benutzerrolle Reporting Group zu nutzen. Diese Gruppe sollte das Mitwirkende Recht auf jeder Webseite haben, da in dieser Benutzerrolle alle CRM User enthalten sind. Im SharePoint Ordner ist für jeden User sind jeweils die entsprechenden Rechte zu setzen. Zu den vertrauenswürdigen Seiten muss der Sharepoint-Server hinzugefügt werden. 5 Deinstallation Zur Deinstallation der SharePoint Schnittstelle sind folgende Schritte durchzuführen: 5.1 Entfernen der Navigationseinträge in allen Entitäten Das Entfernen der Navigationseinträge in den entsprechenden Entitäten erfolgt gegengleich denen in Absatz Einbinden der CRM SharePoint Schnittstelle in die Formulare beschriebenen Schritten. Dazu wird im Hauptformular (Beispiel: Angebot) über den Button Navigation in der Menüzeile die Formularnavigation aktiviert, das Element wird markiert und mit dem Butten Entfernen in der Menüzeile gelöscht. Der Vorgang wird durch drücken des Buttons Veröffentlichen in der Menüzeile abgeschlossen. 5.2 Löschen der Konfigurationsdatensätze zur CRM SharePoint Schnittstelle In der Navigationsleiste des Microsoft Dynamics CRM, über Einstellungen erreicht man die Navigationsschaltfläche Konfiguration. Die beiden dort hinterlegten Datensätze (Configuration, LicenceKey) werden markiert und gelöscht. Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 32 von 38

33 5.3 Löschen der Lösung Über die Navigationsleiste des Microsoft Dynamics CRM wird über die Navigationsschaltfläche Lösungen, die Ansicht aller Lösungen aufgerufen. Die Lösung der CRM SharePoint Schnittstelle wird markiert und mit dem Button Löschen in der Menüzeile entfernt. 5.4 Entfernen der ClientAccessPolicy XML Zuletzt muss noch die ClientAccessPolicy XML entfernt werden. Dazu muss im IIS (InternetInformationService) mit der rechten Maustaste die SharePoint Webseite geöffnet die ClientAccessPolicy XML markiert und mit dem Button Entfernen gelöscht werden. Die CRM SharePoint Schnittstelle ist jetzt vollständig im CRM System entfernt. Sollten Sie weitere Fragen zur Konfiguration der SharePoint Schnittstelle für Microsoft Dynamics CRM 2011 haben oder einen weiterführenden Support benötigen, so zögern Sie bitte nicht uns zu kontaktieren. Wurzener Straße Dahlen / Sa. Tel.: +49 (34361) Fax: +49 (34361) Mail: sales@donaubauer.com Web: Informationen zum Angebots-Konfigurator für Microsoft Dynamics CRM: Vorstand: Andreas Donaubauer Aufsichtsratsvorsitzende: Andrea Striegler Amtsgericht Leipzig HRB Ust.-ID: DE Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 33 von 38

34 Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 34 von 38

35 Anlage 1 CRM SharePoint Schnittstelle Handbuch zur Installation und Konfiguration Schnittstellenversion: Dokumentenversion: vom 04. März 2015 <configuration> <global> <sharepointurl> <sitecollection>/</sitecollection> <defaultcolumns sortcolumn='name'> <column name='name' width='250'> <titles > <title LCID='1031' name='name' /> <title LCID='1033' name='name' /> </titles> </column> </defaultcolumns> </global> <entities> <entity name='account' displayfieldname='name'/> <pluralnames> <pluralname LCID='1031' name='firmen' /> <pluralname LCID='1033' name='accounts' /> </pluralnames> </entities> </configuration> Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 35 von 38

36 Anlage 2 CRM SharePoint Schnittstelle Handbuch zur Installation und Konfiguration Schnittstellenversion: Dokumentenversion: vom 03. September 2015 <configuration> <global> <sharepointurl> <sitecollection>/crm</sitecollection> <sharepointlcid>1031</sharepointlcid> <viewprotocol>true</viewprotocol> <isfoldersvisible>true</isfoldersvisible> <sharepointversion>2010</sharepointversion> <iswaitpageactive>true</iswaitpageactive> <isopensharepointavailable>true</isopensharepointavailable> <foldertreeviewwidth>200</foldertreeviewwidth> <maxsearchcount>500</maxsearchcount> <isopeninwindowsexploreravailable>true</isopeninwindowsexploreravailable> <isshowdocumentpropertyavailable>true</isshowdocumentpropertyavailable> <windowsexplorerurl>sharepointserver</windowsexplorerurl> <sharepointserver>foundation</sharepointserver> <defaultcolumns sortcolumn='name'> <column name='name' width='250'> <titles > <title LCID='1031' name='name' /> <title LCID='1033' name='name' /> </titles> </column> <column name='lastmodified' width='250'> <titles > <title LCID='1031' name='letzte Aenderung' /> <title LCID='1033' name='lastmodified' /> </titles> </column> <column name='typecontent' width='130'> <titles > <title LCID='1031' name='typ' /> <title LCID='1033' name='typ' /> </titles> </column> <column name='size' width='100'> <titles > <title LCID='1031' name='groesse' /> <title LCID='1033' name='size' /> </titles> </column> </defaultcolumns> </global> Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 36 von 38

37 <entities> <entity name='account' idfieldname='accountid' displayfieldname='name'> <pluralnames> <pluralname LCID='1031' name='firmen' /> <pluralname LCID='1033' name='accounts' /> </pluralnames> <sitemapentities> <sitemapentity name='quote' reffieldname='customerid' /> <sitemapentity name='opportunity' reffieldname='customerid' /> <sitemapentity name='salesorder' reffieldname='customerid' /> <sitemapentity name='invoice' reffieldname='customerid' /> <sitemapentity name='incident' reffieldname='customerid' /> </sitemapentities> </entity> <entity name='quote' idfieldname = 'quoteid' displayfieldname='name'> <pluralnames> <pluralname LCID='1031' name='angebote' /> <pluralname LCID='1033' name='quotes' /> </pluralnames> </entity> <entity name='opportunity' idfieldname='opportunityid' displayfieldname='name' > <pluralnames> <pluralname LCID='1031' name='projekte' /> <pluralname LCID='1033' name='opportunity' /> </pluralnames> </entity> <entity name='salesorder' idfieldname='salesorderid' displayfieldname='name'> <pluralnames> <pluralname LCID='1031' name='auftraege' /> <pluralname LCID='1033' name='salesorder' /> </pluralnames> </entity> <entity name='incident' idfieldname='incidentid' displayfieldname='title'> <pluralnames> <pluralname LCID='1031' name='anfragen' /> <pluralname LCID='1033' name='incidents' /> </pluralnames> </entity> <entity name='invoice' idfieldname='invoiceid' displayfieldname='name'> <pluralnames> <pluralname LCID='1031' name='rechnungen' /> <pluralname LCID='1033' name='invoices' /> </pluralnames> </entity> <entity name='contact' idfieldname = 'contactid' displayfieldname='lastname'> <pluralnames> <pluralname LCID='1031' name='kontakte' /> <pluralname LCID='1033' name='contacts' /> </pluralnames> </entity> </entities> </configuration> Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 37 von 38

38 Anlage 3 SharePoint Schnittstelle für Microsoft Dynamics CRM 2011 Handbuch zur Installation und Konfiguration Schnittstellenversion: Dokumentenversion: 3.4 vom <?xml version="1.0" encoding="utf-8"?> <access-policy> <cross-domain-access> <policy> <allow-from http-request-headers="*"> <domain uri="*"/> </allow-from> <grant-to> <resource path="/" include-subpaths="true"/> </grant-to> </policy> </cross-domain-access> </access-policy> Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.4.7; Stand 04. März 2015 Seite 38 von 38