Dynamics 365 CRM
Microsoft Dynamics 365 CRM ist eine Cloud-basierte Geschäftsanwendungsplattform, die Komponenten von Customer Relationship Management (CRM) und Enterprise Resource Planning (ERP) mit Produktivitätsanwendungen und KI-Tools (künstliche Intelligenz) kombiniert.
CRM ist eine Kategorie integrierter, datengesteuerter Lösungen, die Ihre Interaktion und Geschäftstätigkeit mit Kunden verbessert. CRM-Systeme und -Anwendungen sind auf die Verwaltung und Pflege von Kundenbeziehungen, die Nachverfolgung von Aufträgen und Vertrieb und die Bereitstellung nutzbarer Daten ausgelegt – und das alles an einer Stelle.
CRM-Tools vereinfachen die kundenseitigen Geschäftsfunktionen. Sie helfen dem Benutzer bei der Ausführung der folgenden Aufgaben:
• Zentralisierung von Kundeninformationen
• Automatisierung von Marketingaktivitäten
• Bereitstellung von Business Intelligence
• Vereinfachung von Kommunikation
• Nachverfolgung von Verkaufschancen
• Analyse von Daten
• Ermöglichung eines reaktionsfähigen Kundendiensts
Mit dem Dynamics 365 CRM-Konnektor können Sie Lese-, Erstell-, Aktualisierungs- und Löschvorgänge für Entitäten sowie Erstell-, Aktualisierungs- und Löschvorgänge für Zuordnungen ausführen. Sie können Aktionen und Funktionen von Dynamics 365 CRM importieren.
Um die Dynamics 365 CRM-Aktionen zu verwenden, müssen Sie den Konnektor durch Ausführung der Schritte im folgenden Abschnitt autorisieren.
Version der Konnektorveröffentlichung
Der Dynamics 365 CRM-Konnektor wurde in Version 8.4.1 bereitgestellt.
Unterstützte Aktionen
Unterstützte Trigger
Unterstützte Autorisierung
OAuth
 |
Stellen Sie vor dem Hinzufügen einer OAuth-Verbindung sicher, dass Sie die Schritte für Dynamics 365 unter
Konnektor-OAuth-Einstellungen konfigurieren ausführen.
|
Dynamics 365 CRM autorisieren
Für jede Aktion des Dynamics 365 CRM-Konnektors muss eine Dynamics 365 CRM-Autorisierung durchgeführt werden. Gehen Sie wie folgt vor, um den Dynamics 365 CRM-Konnektor zu autorisieren:
1. Wählen Sie im Feld Dynamics 365 CRM autorisieren die Option Neue Dynamics365-Anmeldung hinzufügen aus. Das Fenster "Parameter" wird geöffnet.
2. Geben Sie die folgenden Parameter ein:
◦ Mandanten-ID: Mandanten-ID aus Dynamics 365 CRM. Geben Sie Allgemein ein, wenn Sie keine Mandanten-ID haben.
◦ Ressourcen-URL: Ressourcen-URL aus Dynamics 365 CRM
◦ Set Access: Das Kontrollkästchen "User Impersonation" wird verwendet, um Geschäftslogik (Code) im Namen eines anderen Dynamics 365 CRM-Benutzers auszuführen und so eine gewünschte Funktion oder einen gewünschten Dienst mit der entsprechenden Rolle und objektbasierten Sicherheit dieses imitierten Benutzers bereitzustellen.
3. Klicken Sie auf ZULASSEN.
4. Geben Sie Ihre Anmeldeinformationen ein, und klicken Sie dann auf Sign in.
5. Benennen Sie bei Bedarf die Autorisierungsbeschriftung um, und klicken Sie dann auf HINZUFÜGEN. Eine Autorisierung wird zur Liste hinzugefügt.
| | Klicken Sie auf TESTEN, um die Autorisierung zu validieren. |
Dynamics 365 CRM-Konnektor anpassen
Der folgende Abschnitt enthält detaillierte Anweisungen zum Hochladen von Anpassungsdateien. Stellen Sie sicher, dass ThingWorx Flow Tools auf Ihrem System installiert sind, um die Anpassungsschritte auszuführen. Die ThingWorx Flow Tools werden automatisch zusammen mit Ihrer Installation installiert. Sie benötigen die ThingWorx Administrator-Anmeldung, um diese Aktion ausführen zu können. Weitere Informationen zu den ThingWorx Flow Tools finden Sie unter
Konnektoren bereitstellen.
Sie können den Dynamics 365 CRM-Konnektor auf eine der folgenden Arten anpassen:
• OData-Metadaten aktualisieren – Im Dynamics 365 CRM-Konnektor ist Version 9.0 der OData-Metadaten gepackt. Möglicherweise müssen Sie an einer anderen Version arbeiten, oder Sie haben Ihrer Version Anpassungen hinzugefügt. Diese Datei muss dann aktualisiert werden. Sie können die gepackte Version der Dynamics 365 CRM-Metadatendatei als Referenz herunterladen und Ihre Version oder eine aktualisierte Version in Ihre ThingWorx Flow Instanz hochladen.
• ThingWorx Flow OOTB unterstützt nur einige wenige Entitäten aus dem Dynamics 365 CRM-Modell. Die OOTB-Datei
settings.json enthält nur diese unterstützten Entitäten. Die gepackten OData-Metadaten enthalten jedoch alle Entitäten, Zuordnungen und alle anderen Elemente, die Microsoft unterstützt. Sie können den Konnektor auf zusätzliche Entitäten testen und diese in die Liste der Entitäten, Eigenschaften und zugehörigen Elemente einschließen, die für den Konnektor verfügbar sind, indem Sie die Datei
settings.json aktualisieren. Laden Sie diese dann in Ihre ThingWorx Flow Instanz hoch. Seien Sie vorsichtig, wenn Sie diese Datei bearbeiten, da jeder Syntaxfehler den Konnektor unbrauchbar machen kann. Um zu verstehen, wie diese Datei aktualisiert wird, laden Sie die gepackte Datei herunter, und vergleichen Sie sie mit der geltenden OData-Metadatendatei.
Die folgende Tabelle enthält Informationen zu den Attributen, die Sie im
Dynamics 365 CRM-Konnektor in der Datei settings.json aktualisieren können, um den Dynamics 365 CRM-Konnektor anzupassen:
Attribut | Beschreibung | ||
|---|---|---|---|
DynamicsApiVersion | Gibt die Dynamics 365 CRM API-Version an. Standardmäßig ist diese auf 9.0 festgelegt. | ||
EntitySetDefinitions propertyDefinitions | Definiert die Dynamics 365 CRM-Entitätssätze, die in der ThingWorx Flow Benutzeroberfläche angezeigt werden sollen. Beispiel: Um den Entitätssatz accounts in die Benutzeroberfläche einzuschließen, geben Sie unter dem Attribut EntitySetDefinitions Folgendes an: "name": "accounts", "include": true, "label": "Account", Dabei gibt name den Namen des Dynamics 365 CRM-Entitätssatzes an. Legen Sie für include den Wert true fest, damit der Entitätssatz in der Benutzeroberfläche angezeigt wird. Das Attribut label definiert den Namen des Entitätssatzes, der in der Benutzeroberfläche angezeigt werden soll. Jeder Entitätssatz hat Eigenschaften. Definieren Sie die Eigenschaften eines Entitätssatzes, der in der Benutzeroberfläche unter dem Attribut propertyDefinitions angezeigt werden soll. Sie können die Anzahl der Eigenschaften von beliebigen Entitätssätzen einschränken, die in der Benutzeroberfläche angezeigt werden sollen, indem Sie Arrays für name und label der Eigenschaft bereitstellen. Beispiel: Um die Eigenschaft accountid anzuzeigen, geben Sie unter dem Attribut propertyDefinitions des Attributs accounts EntitySetDefinitions Folgendes an: { "name": "accountid", "label": "Account ID" } Dabei gibt name den Namen der Eigenschaft an. Das Attribut label definiert den Eigenschaftsnamen, der in der Benutzeroberfläche angezeigt werden soll. Wenn Sie alle Eigenschaften eines Entitätssatzes einschließen möchten, legen Sie als Wert für propertyDefinitions ein leeres Array fest, also "propertyDefinitions": [].
| ||
relatedItems | Wenn Sie ein zugehöriges Element hinzufügen, enthalten die zurückgegebenen Entitätssatzdaten die zugehörigen Elemente für diesen bestimmten Entitätssatz. Beispiel: Um die Eigenschaft attachments anzuzeigen, geben Sie unter dem Attribut relatedItems des Attributs accounts EntitySetDefinitions Folgendes an: { "name": "attachments", "label": "Attachments" } Dabei gibt name den Namen des zugehörigen Elements an. Das Attribut label definiert den Namen des zugehörigen Elements, der in der Benutzeroberfläche angezeigt werden soll. Wenn Sie keine zugehörigen Elemente eines Entitätssatzes einschließen möchten, legen Sie als Wert für relatedItems ein leeres Array fest, also relatedItems: []. |
OData-Metadatendatei hochladen
1. Laden Sie Ihre Version der Metadatendatei herunter, indem Sie über Ihre Dynamics 365 CRM-Instanz auf diese Datei zugreifen. Beispiel: https://host.dynamics.com/api/data/v9.0/$metadata. Beachten Sie, dass die Versionsnummer mit der Version Ihrer Instanz übereinstimmen muss.
Alternativ können Sie die mit ThingWorx Flow gepackte Version herunterladen, indem Sie den folgenden Befehl ausführen:
flow-deploy settings file-download -t <ThingWorx Basis-URL> -u <Benutzername des ThingWorx Administrators> -p '<Passwort des ThingWorx Administrators>' -f <Pfad zu XML-Metadatendatei> -s default -c dynamics365 --fileId DynamicsMetadata --contentType application/xml
| | Als Wert des Parameters fileId muss DynamicsMetadata festgelegt sein. |
2. Öffnen Sie die XML-Datei, und stellen Sie sicher, dass Ihre erforderliche Anpassung, falls zutreffend, in der heruntergeladenen XML-Datei vorhanden ist. Bearbeiten Sie die Datei, um Ihre Anpassung hinzuzufügen, falls erforderlich.
3. Führen Sie den folgenden Befehl aus, um die benutzerdefinierte OData-Metadatendatei in Ihre ThingWorx Flow Instanz hochzuladen:
flow-deploy settings file-upload -t <ThingWorx Basis-URL> -u <Benutzername des ThingWorx Administrators> -p '<Passwort des ThingWorx Administrators>' -f <Pfad zu XML-Metadatendatei> -s default -c dynamics365 --fileId DynamicsMetadata --contentType application/xml
| | Als Wert des Parameters fileId muss DynamicsMetadata festgelegt sein. |
Datei settings.json hochladen
1. Führen Sie den folgenden Befehl aus, um die Datei settings.json herunterzuladen, die mit ThingWorx Flow gepackt ist:
flow-deploy settings download -t <ThingWorx_Basis_URL> -u <ThingWorx_Administrator_Benutzername> -p '<ThingWorx_Administrator_Passwort>' -f <Pfad_zur_Datei_mit_Konnektoreinstellungen> -s default -c dynamics365
2. Bearbeiten Sie die Datei settings.json, und stellen Sie sicher, dass sie mit der OData-Metadatendatei kompatibel ist, die Sie verwenden möchten. Nun sind Sie für das Hochladen bereit.
Stellen Sie sicher, dass der Wert DynamicsApiVersion in der Datei settings.json mit der Version in der OData-Metadatendatei übereinstimmt, die Sie zuvor hochgeladen haben.
3. Führen Sie den folgenden Befehl aus, um die Datei settings.json des Dynamics 365 CRM-Konnektors hochzuladen:
flow-deploy settings upload -t <ThingWorx_Basis_URL> -u <ThingWorx_Administrator_Benutzername> -p '<ThingWorx_Administrator_Passwort>' -f <Pfad_zur_Datei_mit_Konnektoreinstellungen> -s default -c dynamics365
Nachdem alle Uploads erfolgreich waren, starten Sie alle ThingWorx Flow Dienste neu. Ihre Anpassung ist jetzt für alle Dynamics 365 CRM-Aktionen sichtbar.