CRM SharePoint Schnittstelle€¦ · CRM SharePoint Schnittstelle Handbuch zur Konfiguration und...

CRM SharePoint Schnittstelle

Handbuch zur Konfiguration und Installation der

CRM SharePoint Schnittstelle

Schnittstellenversion: 5.5

DONAUBAUER AKTIENGESELLSCHAFT

______________________________________________________________________________________________

Konfigurationshandbuch der CRM SharePoint Schnittstelle Version 5.5 Stand 06.05.2016……………………………………………………..Seite 2 von 39

Inhalt

1 Vorwort ............................................................................................................................................... 4

2 Installation ......................................................................................................................................... 5

2.1 Voraussetzungen ................................................................................................................................ 5 2.2 Importieren der Lösung ...................................................................................................................... 5 2.3 Die Lizenzierung .................................................................................................................................. 8

Automatisierte Lizenzanforderung ..................................................................................................... 8 Lizenzanforderung ohne Internetverbindung ................................................................................... 10

2.4 ClientAccessPolicy ............................................................................................................................. 11 2.5 MIME Types ...................................................................................................................................... 12 2.6 Clientseitige Browserkonfiguration .................................................................................................. 12

3 Konfiguration-Anleitung ................................................................................................................. 14

3.1 Ablaufverfolgung............................................................................................................................... 14 3.2 Einbinden der CRM SharePoint Schnittstelle in die Formulare ........................................................ 14 3.3 Erstellen der Konfigurationsdatensätze............................................................................................ 15 3.4 Die Konfigurationseinstellungen ....................................................................................................... 16

Grundeinstellungen .......................................................................................................................... 16 3.5 Die Konfigurations XML .................................................................................................................... 17

Das Element „configuration“ ............................................................................................................ 18 Das Element „global“ ........................................................................................................................ 18 Das Element „defaultColumns“ ........................................................................................................ 19 Das Element „column“ ...................................................................................................................... 20 Das Element „titles“ .......................................................................................................................... 20 Das Element „title“ ........................................................................................................................... 21 Das Element „sharepointLCID“ ......................................................................................................... 21 Das Element „viewProtocol“ ............................................................................................................. 22 Das Element „isFoldersVisible“ ......................................................................................................... 22

Das Element „sharepointVersion“ .................................................................................................... 23 Das Element „isWaitPageActive“ ...................................................................................................... 23 Das Element „maxSearchCount“ ...................................................................................................... 24 Das Element „isOpenSharepointAvailable“ ...................................................................................... 24 Das Element „folderTreeViewWidth“ ............................................................................................... 25 Das Element „isOpenInWindowsExplorerAvailable“ ........................................................................ 25 Das Element „isShowDocumentPropertyAvailable“ ......................................................................... 26 Das Element „windowsExplorerUrl“ ................................................................................................. 27 Das Element „sharepointServer“ ...................................................................................................... 27 Das Element „zeitMessung“.............................................................................................................. 27 Das Element „showHiddenFiles“ ...................................................................................................... 28 Das Element „entities“ ...................................................................................................................... 29 Das Element „entity“ ........................................................................................................................ 29 Das Element „siteMapEntities“ ......................................................................................................... 30 Das Element „siteMapEntity“ ........................................................................................................... 30 Das Element „pluralNames“ ............................................................................................................. 31 Das Element „pluralName“ ............................................................................................................... 31

4 Rechte .............................................................................................................................................. 33


______________________________________________________________________________________________


5 Deinstallation ................................................................................................................................... 34


______________________________________________________________________________________________


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 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 CRM SharePoint Schnittstelle handelt es sich um ein Addon für Microsoft Dynamics CRM 2011, 2013, 2015.und CRM 2016 Auf den folgenden Seiten finden Sie eine ausführliche Konfigurationsanleitung.


______________________________________________________________________________________________


2 Installation

2.1 Voraussetzungen

Auf dem Server muss ein Microsoft Dynamics CRM System (Mindesvoraussetzung: Microsoft Dynamics CRM 2011 RollUp 8) mit aktuellem Rollup 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 SharePoint-Schnittstelle das Browser-Plug-In Microsoft Silverlight erforderlich. Dieses steht unter http://www.microsoft.com/getsilverlight zur Verfügung. Weiterhin ist ein installierter SharePoint Server in der Version 2010 und 2013 (Foundation oder Enterprise) erforderlich. Dieser wird bei einem weiteren notwendigen Schritt, der Konfiguration CRM-SharePoint-Integration, angegeben um die Konnektivität der Schnittstelle herzustellen. (siehe auch http://msdn.microsoft.com/de-de/library/gg334768.aspx)

2.2 Importieren der Lösung

Die Lösung der Schnittstelle steht zum Download auf der Webseite http://www.donaubauer.com/de/#!SharePointInterface&slide2 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.

http://www.microsoft.com/getsilverlighthttp://msdn.microsoft.com/de-de/library/gg334768.aspxhttp://msdn.microsoft.com/de-de/library/gg334768.aspxhttp://www.donaubauer.com/de/#!SharePointInterface&slide2


______________________________________________________________________________________________


Es öffnet sich der Installationsassistent, der durch den gesamten Importvorgang führt:

Durch das Betätigen des Buttons „Durchsuchen“, wird der Ablageort der Solution gesucht und diese geöffnet.

Über den Button „Weiter“ gelangt man zum nächsten Fenster und wählt den markierten Absatz aus, bevor man mit dem Button „Importieren“ den Import der Lösung auslöst.

Bevor die Lösung importiert wird, erhält man noch

entsprechenden Informationen zur importierten Lösung und


______________________________________________________________________________________________


im nachfolgenden Fenster ist hier zwingend der Haken in das Feld zur Aktivierung aller Prozesse und Lösungen zu setzen und der Vorgang durch Betätigen des Buttons „Weiter“ abzuschließen.

Jetzt wird die Solution 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 Sie können den Vorgang mit dem Button „Schließen“ beenden. 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.

Im CRM System unter der Entität „Lösungen“ erscheint der Eintrag mit dem Namen „crmsharepointinterface“ (Anzeigename: SharePoint-Schnittstelle).


______________________________________________________________________________________________


2.3 Die Lizenzierung

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.

Automatisierte Lizenzanforderung

Im Abschnitt „Lizenz“ wird der Button „Lizenz anfordern“ gedrückt.


______________________________________________________________________________________________


Es ist erforderlich, dass zur automatisierten Lizenzanforderung eine E-Mail Adresse hinterlegt wird. Weiterhin muss den Vertragsbedingungen zugestimmt werden, bevor man mit dem Button „Weiter“ die Lizenz anfordert

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 E-Mail kopiert und an die E-Mail-Adresse [email protected] gesandt werden. Die manuell erzeugte Lizenz wird an die Absender-E-Mail gesandt.

Den Lizenzschlüssel wird zeitnah per E-Mail übersandt und muss in das CRM-System importiert werden. Dies erfolgt in der Lösung der CRM SharePoint Schnittstelle über den Menüpunkt Lizenz. Die Lizenz wird in das Feld „Lizenzschlüssel“ hineinkopiert (1) und mit dem Button „Lizenz importieren“ (2) der Vorgang abgeschlossen.

mailto:[email protected]


______________________________________________________________________________________________


2.4 ClientAccessPolicy

Damit das Silverlight Zugriff auf den SharePoint Server hat, ist es notwendig eine Richtliniendatei (ClientAccessPolicy.xml) im Root Verzeichnis der SharePoint Webseite (keine Dokumentenbibliothek oder Liste) zu hinterlegen. Das Beispiel einer ClientAccessPolicy XML ist der Dokumentation als Anlage 2 beigefügt. Um den Speicherort der Richtliniendatei zu ermitteln, gehen Sie im IIS (InternetInformationService) mit der rechten Maustaste auf die SharePoint Webseite und wählen “Explorer öffnen” aus.

In dem geöffneten Explorer Fenster wird die ClientAccessPolicy.xml abgespeichert


______________________________________________________________________________________________


2.5 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.

2.6 Clientseitige Browserkonfiguration

Damit die CRM SharePoint Schnittstelle alle benötigten Ressourcen ohne Userinteraktion verwenden kann, ist eine clientseitige Konfiguration notwendig, die dem Browser die integrierte Authentifizierung an allen benötigten Systemen erlaubt. Diese Konfiguration unterscheidet grundlegend zwischen einem CRM-Deployment mit integrierter Authentifizierung und einem CRM-Deployment mit anspruchsbasierter Authentifizierung. Grundlegend müssen dabei 3 Adressen im Browser für die integrierte Authentifizierung zugelassen werden:

- der Sharepoint der verwendet wird. - das CRM das verwendet wird. - die URL, über die per TCP 943 die Konfigurationsdatei für Silverlight geladen wird. Dies ist standardmäßig

die gleiche URL über die auf die CRM-Organisation zugriffen wird. Üblicherweise sind folgende URLs sind im Browser in die Lokalen Intranet-Sites aufzunehmen: Bei integrierter Authentifizierung: - die URL, über die CRM aufgerufen wird.


______________________________________________________________________________________________


- die URL, über die Sharepoint aufgerufen wird.

Bei anspruchsbasierter Authentifizierung: - Die URL, über die CRM aufgerufen wird (Hier kann im IE nicht mit der vollständigen URL gearbeitet werden sondern es muss mit Wildcard gearbeitet werden. Wenn die vollständige URL eingetragen wird hat der Internet Explorer Probleme bei der Anmeldung am CRM über die externe ZugriffsURL vom CRM) Die URL, über die Sharepoint aufgerufen wird.


______________________________________________________________________________________________


3 Konfiguration-Anleitung Über die Navigationsleiste des Microsoft Dynamics CRM, die Navigationsschaltfläche „Lösungen“ öffnet mann die Konfigurationsseite der Lösung und kommt über die

3.1 Ablaufverfolgung

Tracing Level: Die Ablaufverfolgung dient zum Erheben detaillierter Daten für die Fehlersuche. Durch die Tracing Level Einstellung kann der Details-Grad reguliert werden. Je höher der Tracing Level desto mehr Informationen werden gesammelt.

3.2 Einbinden der CRM SharePoint Schnittstelle in die Formulare

Richten sie die SharePoint-Schnittstelle wie in der Anleitung in den Voraussetzungen beschrieben ein. Dabei kann entschieden werden unter bei welchen Entitäten die Schnittstelle angezeigt werden kann. Dabei muss innerhalb der Einrichtung bei dem Punkt „Dokumentenverwaltungseinstellung im Bildschirm angegeben werden, welche Entitäten zu nutzen sind.

Sollte die Einrichtung fehlerfrei verlaufen sein, so kann die Schnittstelle unter dem Reiter Dokumente in allen Datensätzen einer konfigurierten Entität erreicht werden.


______________________________________________________________________________________________


3.3 Erstellen der Konfigurationsdatensätze

Um die Konfigurationsdatensätze zu bearbeiten müssen Sie die Lösung der SharePoint-Schnittstelle öffnen und dort in die Konfiguration klicken.

Der „StartLocationRecord“ ist eine Dokument-Locations-Datensatz.und wird durch die Konfiguration angelegt. Im Feld „absolute URL“ steht die der Html-Webresource über die, die Sharepoint-Schnittstelle gestartet wird. https:////WebResources/donau_/SharePointInterface/SharePointInterface.html?Data= Bei Benutzung von mehreren CRM-URLs (z,B, für intern und extern) können weitere „StartLocationRecord“ Datensätze mit entsprechender „absoluter UR“ angelegt werden. Der Name muss die Zeichenfolge „StartLocationRecord“ einhalten. Um diese Funktion nutzen zu können, muss das in der dieser Schnittstelle enthaltene PlugIn Donaubauer.Crm.SharepointInterface.Locations.PlugIn in den FullTrust-Modus umgeschalten werden.


______________________________________________________________________________________________


3.4 Die Konfigurationseinstellungen

Grundeinstellungen

Unter dem Menüpunkt „Einstellungen“ befinden sich die Einstellungsmöglichkeiten zur Schnittstellenanalyse und -Anzeige:

Ordner Name mit Guid: Diese Einstellung bestimmt in welcher Form die Ordner auf dem SharePoint Server

angelegt werden. Darstellung mit gesetztem Hacken Bsp: Muster Account_9EBED4A26F9AE411822400155D001B35 Tracing Level: Die Ablaufverfolgung dient zum Erheben detaillierter Daten für die Fehlersuche.

Durch die Tracing Level Einstellung kann der Details-Grad reguliert werden. Je höher der Tracing Level desto mehr Informationen werden gesammelt. Die gesammelten Informationen, werden in einem Datensatz in der Entität „EventLog“ eingetragen.


______________________________________________________________________________________________


3.5 Die Konfigurations XML

Die Verbindung der SharePoint-Schnittstelle zum SharePoint-Server, das Design und die Funktionsweise der Sharpoint-Schnittstelle werden in einer XML-Datei definiert. Diese Definition wird im Feld „Konfigurations XML“ des Formulars „Einstellungen“ hinterlegt. Wird keine Konfigrations XML eingetragen, so wird folgende XML automatisch beim öffnen der Konfgirationsseite als Start XML genutzt. Start XML true false error 2013 1033 true 500 false foundation true 200 false

Die Einstellungen werden größtenteils durch die Einstellung der CRM-internen Schnittstelle erledigt, für weiterführende Anpassungen sind 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.


______________________________________________________________________________________________


Das Element „configuration“

Element „configuration“ beschreibt das Konfigurationsmodell. Syntax:

Übergeordnete Elemente (parent elements)

Das Element „configuration“ hat keine übergeordneten Elemente und präsentiert das Root-Element

Untergeordnete Elemente (child elements)

Elementname Beschreibung Typ Verwendung

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. Syntax: Das Element „global“ ist ein Pflicht-Element und kann nur einmal hinterlegt werden.



configuration Root-Element (Wurzelelement) configuration Pflichtfeld


Elementname Beschreibung Typ Defaultwert

Optionale Felder

defaultColumns Angabe der Standardspalten defaultcolumns 4 Spalten

sharepointLCID Angabe der SharePoint Server Sprache SharePoint LCID 1033

viewProtocol Anzeige der Protokollierung viewprotocol error

isFoldersVisible Anzeige von Unterordnern isfoldersvisible True

sharepointVersion Angabe der SharePoint Server Version sharepointversion 2013

isWaitPageActive Anzeige eines Wartebildschirms isWaitPageActive True

maxSearchCount Maximale Anzahl der Suchergebnisse maxSearchCount 500

sharepointServer Einstellung für die Suche sharepointServer Foundation


______________________________________________________________________________________________


isOpenSharepointAvailable

Öffnen des aktuellen Datensatzes im SharePoint Server zulassen oder nicht

isOpenSharepointAvailable

False

folderTreeViewWidth Angabe der Breite des TreeViews in der Ansicht

folderTreeViewWidth

200

isOpenInWindowsExplorerAvailable

SharePoint Dokumente des Datensatzes im Explorer anzeigen

isOpenInWindowsExplorerAvailable

False

isShowDocumentPropertyAvailable

Dokumentendetails anzeigen isShowDocumentPropertyAvailable

False

windowsExplorerUrl Dokumente im Explorer anzeigen windowsExplorerUrl

zeitMessung Zeitmessung Unterschieldicher Prozesse nutzen

zeitMessung False

showHiddenFiles Legt fest, ob auch versteckte Dokumente, (die mit einem Unterstrich beginnen), angezeigt werden sollen

showHiddenFiles False

Das Element „defaultColumns“

Das Element „defaultColumns“ umfasst die gesamten Spalten, die in der Schnittstelle angezeigt werden und müssen nur gesetzt werden, falls die von der CRM-internen Schnittstelle angezeigten Spalten nicht ausreichend sind. Wenn keine Angabe für dieses Element erfolgt, werden folgende Spalten angezeigt:

Syntax: Mit Angabe einer Sortierspalte: Bei diesem Beispiel werden die Dokumente nach der Spalte „Name“ sortiert. Das Element „defaultColumns“ ist ein Pflicht-Element und kann nur einmal hinterlegt werden.




Attribute

Eigenschaftsname

Eigenschaftsname Eigenschafts-name

Eigenschaftsname

sortColumn sortColumn sortColumn sortColumn



zeitMessung#_Das_Element_showHiddenFiles#_Das_Element_file://///serverchd/chd/CRM/Schnittstellen/SharePoint-Schnittstelle/Handbücher/global%23_Das_Element_


______________________________________________________________________________________________


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

Syntax: Das Element „column“ ist ein Pflicht-Element und kann mehrmals hinterlegt werden.



defaultColumns Standardspalten Angabe DefaultColumns Pflichtfeld

Attribute

Eigenschafts-name

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. Syntax: Das Element „titles“ ist ein Pflicht-Element und kann nur einmal pro „column“ Element hinterlegt werden.

file://///serverchd/chd/CRM/Schnittstellen/SharePoint-Schnittstelle/Handbücher/onload%23_Die_Element_file://///serverchd/chd/CRM/Schnittstellen/SharePoint-Schnittstelle/Handbücher/attributes%23_Das_Element_


______________________________________________________________________________________________




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. Syntax:



titles Spaltenbeschriftung Titles Pflichtfeld

Attribute

Eigenschafts-name


LCID Sprachcode, Bsp: 1031 string Pflichtfeld

name Beschriftung/Titel der Spalte string Pflichtfeld


Das Element „title“ hat keine untergeordneten Elemente.

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. Syntax: 1031





Das Element „sharepointLCID“ hat keine untergeordneten Elemente.

file://///serverchd/chd/CRM/Schnittstellen/SharePoint-Schnittstelle/Handbücher/attributes%23_Das_Element_


______________________________________________________________________________________________


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 „error“ festgelegt und der Menüeintrag „Protokoll anzeigen“ erscheint. Es werden dabei nur die Fehler protokolliert. Syntax: error Wird dieses Element explizit mit dem Wert „false“ angegeben, so sind die Funktionen „Parameter anzeigen“ und „Protokoll anzeigen“ nicht im Menü vorhanden. Bei dem Wert „standard“ erscheint ein Teil des Protokolls unter dem Punkt „Protokoll anzeigen“. Über diese Funktion sind auch alle benutzten Standardwerte der möglichen globalen Einstellungen sichtbar. Syntax: standard 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. Syntax: detail





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“. Syntax: true





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 2013 benutzt. Mögliche Angaben sind: 2007, 2010 (Enterprise und Foundation) und 2013 (Foundation). Syntax: 2010





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.

Bei nicht Angabe dieses Elementes ist die Standardwert „false“.


______________________________________________________________________________________________


Syntax: true





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. Syntax: 500





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.


______________________________________________________________________________________________


Syntax: true





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. Syntax: 200





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.


______________________________________________________________________________________________


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. Syntax: true





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. Syntax: true





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. Syntax: Servername





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. Syntax: foundation





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.


______________________________________________________________________________________________


Wenn Sie dieses Element nicht angeben, wird der Standardwert auf „false“ festgelegt. Syntax: true

Das Element „showHiddenFiles“

Das Element „showHiddenFiles“ definiert, ob auch versteckte Dokumente, (die mit einem Unterstrich beginnen), angezeigt werden sollen. Wenn Sie dieses Element nicht angeben, wird der Standardwert auf „false“ festgelegt. Syntax: true



global globale Einstellungen global Optional


Das Element „showHiddenFiles“ hat keine untergeordneten Elemente.


______________________________________________________________________________________________


Das Element „entities“

Das Element „entities“ definiert die Entitäten, in denen die SharePoint Schnittstelle ausgeführt wird. Syntax: 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. Syntax: Das Element „entity“ ist ein Pflicht-Element und kann mehrfach hinterlegt werden.


______________________________________________________________________________________________




entities Definition der Entitäten entities Pflichtfeld

Attribute

Eigenschafts-name


name Schemaname der Entität string Pflichtfeld

idFieldName Primäre Keyfeld der Entität, bei Account: accountid

nur nötig, wenn im TreeView angezeigt werden soll

string optional

displayFieldName Attributenamen zum Anzeigen im TreeView string Pflichtfeld

lookupFieldName Lookup-Feld der Entität zu einem übergeordneten Datensatz. Wenn dieses Attribut vorhanden ist, werden in dieser Entität die Dokumente aus dem übergeordneten Datensatz angezeigt

string optional


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. Die hier anzuzeigenden Entitäten müssen direkt mit der Hauptentität der Baumstruktur verknüpft sein (es muss eine Beziehung zwischen beiden existieren). Syntax: < siteMapEntities>



entity Entity Pflichtfeld


siteMapEntity im TreeView zusätzlich anzuzeigende Entität siteMapEntity Pflichtfeld

Das Element „siteMapEntity“

Mit diesem Element wir 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. Syntax:

file://///serverchd/chd/CRM/Schnittstellen/SharePoint-Schnittstelle/Handbücher/siteMapEntities%23_Das_Element_


______________________________________________________________________________________________




siteMapEntities Spaltenbeschriftung siteMapEntities Pflichtfeld

Attribute

Eigenschafts-name


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.

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. Syntax:



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. Syntax: Bsp:


______________________________________________________________________________________________




pluralNames Hauptelement zur Beschriftung pluralNames Pflichtfeld

Attribute

Eigenschafts-name


LCID Sprachcode z.B: 1031 string Pflichtfeld

name Titel für die Entität string Pflichtfeld


Das Element „pluralName“ hat keine untergeordneten Elemente.


______________________________________________________________________________________________


4 Rechte 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.


______________________________________________________________________________________________


5 Deinstallation Zur Deinstallation der SharePoint Schnittstelle sind folgende Schritte durchzuführen:

- SharePoint bezogene Eventlogs in der Donaubauer Eventlog Entität löschen - SharePoint bezogene Datensätze in der Donaubauer Konfigurations Entität löschen - Lösung löschen - ClientPolicy XML entfernen


______________________________________________________________________________________________


Sollten Sie weitere Fragen zur Installation und 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 10 04774 Dahlen / Sa. Tel.: +49 (34361) 826-0 Fax: +49 (34361) 826-25 Mail: [email protected] Web: www.donaubauer.com Informationen zum Angebots-Konfigurator für Microsoft Dynamics CRM: www.donaubauer.com Vorstand: Andreas Donaubauer Aufsichtsratsvorsitzende: Andrea Striegler Amtsgericht Leipzig HRB 23063 Ust.-ID: DE814819651

mailto:[email protected]://www.donaubauer.com/http://www.donaubauer.com/


______________________________________________________________________________________________


Anlage 1 SharePoint Schnittstelle für Microsoft Dynamics CRM 2011, CRM 2013, CRM 2015 und CRM 2016 Handbuch zur Installation und Konfiguration Schnittstellenversion: 5.5 Dokumentenversion: 5.5 vom 02.05.2016 http://spf2013 /


______________________________________________________________________________________________


Anlage 2 SharePoint Schnittstelle für Microsoft Dynamics CRM 2011, CRM 2013, CRM 2015 und CRM 2016 Handbuch zur Installation und Konfiguration Schnittstellenversion: 5.5 Dokumentenversion: 5.5 vom 02.05.2016 https://sharepointserver /crm 1031 true true 2010 true true 200 500 true true sharepointserver foundation


______________________________________________________________________________________________



______________________________________________________________________________________________


Anlage 3 SharePoint Schnittstelle für Microsoft Dynamics CRM 2011, CRM 2013, CRM 2015 und CRM 2016 Handbuch zur Installation und Konfiguration Schnittstellenversion: 5.5 Dokumentenversion: 5.5 vom 02.05.2016

CRM SharePoint Schnittstelle€¦ · CRM SharePoint Schnittstelle Handbuch zur Konfiguration und...

Documents

Transcript of CRM SharePoint Schnittstelle€¦ · CRM SharePoint Schnittstelle Handbuch zur Konfiguration und...