Integration von Microsoft Dynamics CRM

Durch Integration mit Microsoft Dynamics CRM können Sie Leads, Verkaufschancen und Fälle überwachen und verwalten, ohne sich erneut anmelden zu müssen. Zum Aktivieren der Microsoft Dynamics CRM-Integration führen Sie folgende Schritte aus. Überprüfen Sie die Voraussetzungen, registrieren Sie die neue Anwendung, rufen Sie den Schlüsselwert ab und delegieren Sie Berechtigungen.

Hinweis:

Es stehen zwei Microsoft Dynamics-Integrationsvorlagen zur Verfügung. Wir empfehlen für die meisten Anwendungsfälle die Verwendung der neueren HTTP-Integration, da diese mehr Möglichkeiten zum Konfigurieren der zwischengespeicherten Datenstruktur bietet. Die Microsoft Dynamics-Vorlage bildet die Grundlage für die HTTP-Integration von MS Dynamics. Ausführliche Informationen zu den verfügbaren Mikroapps in jeder Integration finden Sie unter Verwenden von Microsoft Dynamics-Mikroapps.

Eine Liste aller vorkonfigurierten Microsoft Dynamics-CRM-Mikroapps finden Sie unter Verwenden von Microsoft Dynamics CRM-Mikroapps.

Prüfung der Voraussetzungen

Erstellen Sie ein dediziertes Office 365-Konto, um die Integration zu konfigurieren. Nachdem Sie diesen Vorgang abgeschlossen haben, wird die vorhandene Überwachungsprotokollierung beibehalten, einschließlich aller Aktionen, die mit Citrix Mikroapps ausgeführt werden.

Nach dem Einrichten dieser Integration in MS Dynamics CRM benötigen Sie folgende Angaben, um die Integration in Citrix Workspace-Mikroapps hinzuzufügen:

• Anmelde-URL zur Autorisierung
• Anwendungs(client)-ID
• Wert des geheimen Schlüssels
• Details zu gültigem Microsoft Dynamics CRM-Konto

Folgende Voraussetzungen müssen erfüllt sein:

• Wenn sich Ihr interner Workspace-Server hinter einer Firewall befindet, müssen Sie den Zugriff auf den Hostnamen www.dynamics.com über Port 443 zulassen, damit Workspace eine Verbindung mit der MS Dynamics CRM-Cloud herstellen kann.

• Autorisierungs-URL zur Anmeldung (von Citrix bereitgestellt). Konfigurieren Sie in Citrix Gateway die Unterstützung für Single Sign-On für MS Dynamics, damit Benutzer sich nur einmal anmelden und ihre Anmeldeinformationen nicht erneut eingeben müssen. Weitere Hinweise zum Konfigurieren von SSO finden Sie unter Citrix Gateway Service.

• Ein dediziertes Office 365-Konto, mit dem Sie die MS Dynamics CRM-Integration konfigurieren. Dieses dedizierte Konto muss volle Datenzugriffsrechte in MS Dynamics CRM haben (Systemadministrator). Weitere Informationen finden Sie unter Benutzer in Dynamics 365 for Customer Engagement-Apps erstellen und Sicherheitsrollen zuweisen.

Registrieren der Anwendung und Hinzufügen von Rückruf-URLs

Registrieren Sie Ihre neue Anwendung, fügen Sie Rückruf-URLs hinzu und erfassen Sie die Anwendungs-ID.

1. Melden Sie sich an unter https://portal.azure.com.
2. Wählen Sie Azure Active Directory > App-Registrierungen > Neue Registrierung.
3. Geben Sie einen Namen für die Anwendung ein und wählen Sie die Unterstützten Kontotypen gemäß den Vorgaben Ihrer Organisation. Wählen Sie Entscheidungshilfe, um weitere Informationen zu dieser Option zu erhalten.

4. Fügen Sie Ihrer Instanzkonfiguration eine benutzerdefinierte URL hinzu, um Zugriff auf private Daten zu gewähren und OAuth-authentifizierte Benutzeraktionen zu aktivieren. Wählen Sie unter Umleitungs-URI (optional) die Option Web und geben Sie die folgenden zwei Rückruf-URLs und die Basis-URL für Ihre Instanz von MS Dynamics ein. Dies ist dieselbe URL, die Sie beim Einrichten der Integration in der Mikroapps-UI eingeben. Der erste Callback in der Liste ändert sich nicht. Der zweite Callback hängt von der Zielanwendung ab und ist beim Erstellen der Integration in Ihrer URL-Adressleiste zu finden. Der Abschnitt {yourmicroappserverurl} setzt sich zusammen aus dem Mandanten, der Region und der Umgebung: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com:

   • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
   • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
   • Die Basis-URL ist der gleichbleibende Teil der Webadresse, die Sie für diese Integration verwenden. Beispiel: https://app.{yoursaasapp}.com
5. Kopieren Sie die Anwendungs(client)-ID, um sie zu verwenden, wenn Sie die Integration zu Citrix Workspace-Mikroapps hinzufügen. Kopieren Sie auch den Anwendungs-ID-URI und speichern Sie ihn, falls Sie Ihn später benötigen.

Aktivieren delegierter Berechtigungen

Bei delegierten Berechtigungen kann die App als angemeldeter Benutzer fungieren, um Aufrufe an die Zielressource zu tätigen.

1. Wählen Sie in der Ansicht der registrierten App API-Berechtigungen und dann +Berechtigung hinzufügen.
2. Wählen Sie die Dynamics CRM-Kachel und dann unter Art der benötigten Berechtigungen für die Anwendung: die Kachel Delegierte Berechtigungen.
3. Aktivieren Sie das Kontrollkästchen für die hinzuzufügenden Berechtigungen, insbesondere user_impersonation, und klicken Sie unten auf Berechtigungen hinzufügen.

Generieren eines geheimen Schlüssels

Generieren Sie eine geheime Zeichenfolge, die zum Identitätsnachweis der Anwendung beim Anfordern eines Tokens verwendet wird.

1. Wählen Sie Zertifikate und Geheimnisse. Wählen Sie + Neues Clientgeheimnis.
2. Geben Sie eine Beschreibung für das Clientgeheimnis ein.
3. Wählen Sie unter Ablauf: die Option Nie. Wählen Sie Hinzufügen aus.
4. Kopieren und speichern Sie den Wert für das erstellte Clientgeheimnis. Er wird nach dem Verlassen dieser Seite nicht erneut angezeigt.

Filtern von Abfragen

Die meisten Microsoft Dynamics CRM-Entitäten unterstützen die Filterung. Der Parameter $filter kann zu allen Endpunkten hinzugefügt werden. Weitere Informationen finden Sie in der Web API-Referenz für Microsoft Dynamics CRM-Abfragen.

Beispiele:

Only active appointments:
//api/data/v9.0/appointments$filter(statecode eq 0 or statecode eq 3)

Only incidents from last 1 month:
//api/data/v9.0/incidents$filter Microsoft.Dynamics.CRM.LastXMonths(PropertyName='modifiedon',PropertyValue=1)

Hinzufügen der Microsoft Dynamics-Integration zu Citrix Workspace-Mikroapps

Fügen Sie die HTTP-basierte Microsoft Dynamics-Integration zu Citrix Workspace-Mikroapps hinzu, um eine Verbindung zu Ihrer Anwendung herzustellen. Dadurch werden vorkonfigurierte Mikroapps mit Benachrichtigungen und Aktionen bereitgestellt, die in Ihrem Workspace sofort einsatzbereit sind.

Führen Sie folgende Schritte aus, um die Microsoft Dynamics-HTTP-Integration einzurichten. Die Authentifizierungsoptionen sind vorausgewählt. Stellen Sie sicher, dass diese Optionen ausgewählt sind, wenn Sie den Vorgang abschließen. Wir empfehlen für die meisten Anwendungsfälle diese neuere HTTP-Integration. Die HTTP-Integration bietet mehr Möglichkeiten zum Konfigurieren der zwischengespeicherten Datenstruktur.

Führen Sie folgende Schritte aus:

1. Wählen Sie auf der Seite Mikroappintegrationen die Optionen Neue Integration hinzufügen und Neue Integration aus Citrix-Vorlagen hinzufügen.
2. Wählen Sie die Microsoft Dynamics-Kachel.
3. Geben Sie einen Integrationsnamen ein.
4. Geben Sie Connectorparameter ein.
   • Geben Sie die Basis-URL der Instanz ein. Dies ist die Domäne für Ihre MS Dynamics-Umgebung und der gleichbleibende Teil Ihrer Webadresse, die Sie für diese Integration verwenden.
   • Wählen Sie ein Symbol für die Integration aus der Symbolbibliothek aus, oder belassen Sie das Standardsymbol für MS Dynamics.
   • Aktivieren Sie die Umschaltfläche On-Premises-Instanz, wenn Sie eine On-Premises-Verbindung erstellen. Weitere Informationen finden Sie unter On-Premises-Instanz.

   

5. Wählen Sie unter Dienstauthentifizierung im Menü Authentifizierungsmethode die Option OAuth 2.0 und geben Sie die Authentifizierungsdetails ein. Die Authentifizierungsoptionen sind vorausgewählt. Stellen Sie sicher, dass diese Optionen ausgewählt sind, wenn Sie den Vorgang abschließen. Generieren Sie über das Sicherheitsprotokoll OAuth 2.0 einen Anforderungs-/Autorisierungstoken zum delegierten Zugriff. Sofern verfügbar, sollten Sie stets OAuth 2.0 zur Dienstauthentifizierung und als Gewährungstyp “Autorisierungscode” verwenden. OAuth 2.0 stellt sicher, dass Ihre Integration höchste Sicherheitsansprüche mit Ihrer konfigurierten Mikroapp erfüllt.

   1. Wählen Sie im Menü Gewährungstyp die Option Autorisierungscode. Dadurch wird ein temporärer Code gewährt, den der Client gegen einen Zugriffstoken tauscht. Der Code wird vom Autorisierungsserver abgerufen, wo Sie die vom Client angeforderten Informationen sehen. Nur dieser Gewährungstyp ermöglicht einen sicheren Benutzeridentitätswechsel. Dadurch wird die Rückruf-URL angezeigt, die Sie bei der Registrierung Ihrer Anwendung verwenden.
   2. Wählen Sie im Menü Tokenautorisierung die Option Anforderungstext.
   3. Die Autorisierungs-URL ist vorausgefüllt. Geben Sie Ihre Autorisierungs-URL ein oder verwenden Sie einfach die allgemein verfügbare URL.
   4. Die Token-URL ist vorausgefüllt. Geben Sie Ihre Token-URL ein oder verwenden Sie einfach die allgemein verfügbare URL.
   5. Geben Sie Ihre Client-ID ein. Die Client-ID ist die Zeichenfolge, die die eindeutigen Angaben des Autorisierungsservers zur Clientregistrierung darstellt. Sie erfassen dies und den geheimen Clientschlüssel beim Konfigurieren des OAuth-Servers. Sie müssen die Rückruf-URL hinzufügen, die Sie auf der Konfigurationsseite der Integration sehen.
   6. Geben Sie Ihren geheimen Clientschlüssel ein. Der geheime Clientschlüssel ist eine eindeutige Zeichenfolge, die beim Einrichten der Zielanwendungsintegration ausgegeben wird.
   7. (Optional) Geben Sie ein Headerpräfix ein, wenn Ihr Bearerpräfix sich vom Standardheader unterscheidet.

   

6. Bei Verwendung von OAuth 2.0 wählen Sie Parameter hinzufügen, um Zugriffstokenparameter einzuschließen. Geben Sie als Name resource und als Wert {yourmsdynamicscrmurl} ein. Dieser Parameter wird vom Autorisierungsserver der Zielanwendung benötigt.

   

7. Aktivieren Sie unter Dienstaktionsauthentifizierung die Umschaltfläche Separate Benutzerauthentifizierung in Aktionen verwenden. Mit der Dienstaktionsauthentifizierung authentifizieren Sie sich auf der Dienstaktionsebene. Die Authentifizierungsoptionen sind vorausgewählt. Stellen Sie sicher, dass diese Optionen ausgewählt sind, wenn Sie den Vorgang abschließen.

   1. Wählen Sie im Menü Authentifizierungsmethode die Option OAuth 2.0 und geben Sie die Authentifizierungsdetails ein.
   2. Wählen Sie im Menü Gewährungstyp die Option Autorisierungscode. Dadurch wird ein temporärer Code gewährt, den der Client gegen einen Zugriffstoken tauscht. Der Code wird vom Autorisierungsserver abgerufen, wo Sie die vom Client angeforderten Informationen sehen. Nur dieser Gewährungstyp ermöglicht einen sicheren Benutzeridentitätswechsel. Dadurch wird die Rückruf-URL angezeigt, die Sie bei der Registrierung Ihrer Anwendung verwenden.
   3. Wählen Sie im Menü Tokenautorisierung die Option Anforderungstext.
   4. Die Autorisierungs-URL ist vorausgefüllt.
   5. Die Token-URL ist vorausgefüllt.
   6. Geben Sie Ihre Client-ID ein. Die Client-ID ist die Zeichenfolge, die die eindeutigen Angaben des Autorisierungsservers zur Clientregistrierung darstellt. Sie erfassen dies und den geheimen Clientschlüssel beim Konfigurieren des OAuth-Servers. Sie müssen die Rückruf-URL hinzufügen, die Sie auf der Konfigurationsseite der Integration sehen.
   7. Geben Sie Ihren geheimen Clientschlüssel ein. Der geheime Clientschlüssel ist eine eindeutige Zeichenfolge, die beim Einrichten der Zielanwendungsintegration ausgegeben wird.
   8. (Optional) Geben Sie ein Headerpräfix ein, wenn Ihr Bearerpräfix sich vom Standardheader unterscheidet.

   

8. Wählen Sie erneut Parameter hinzufügen, um Zugriffstokenparameter einzuschließen. Geben Sie als Name resource und als Wert {yourmsdynamicscrmurl} ein. Dieser Parameter wird vom Autorisierungsserver der Zielanwendung benötigt.

   

9. (Optional) Wenn Sie das Ratenlimit für diese Integration aktivieren möchten, aktivieren Sie die Umschaltfläche Anforderungsratenlimit und definieren die Anzahl der Anforderungen pro Zeitintervall.
10. Übernehmen Sie den Standardwert für Anforderungstimeout.

11. (Optional) Aktivieren Sie die Umschaltfläche Protokollierung, um 24-Stunden-Protokolle für Supportzwecke zu erstellen.

    

12. Wählen Sie dann Speichern.
13. Wählen Sie unter OAuth-Autorisierung die Option Autorisieren, um sich mit Ihrem Dienstkonto anzumelden. Ein Popupfenster mit dem Workday-Anmeldebildschirm wird angezeigt.
    1. Geben Sie Benutzernamen und Kennwort Ihres Dienstkontos ein und wählen Sie Anmelden.
    2. Wählen Sie Akzeptieren.

Die Seite Mikroappintegrationen wird geöffnet und zeigt die hinzugefügte Integration mit zugehörigen Mikroapps an. Sie können nun die erste Datensynchronisierung festlegen und ausführen. Da unter Umständen eine große Datenmenge von Ihrer integrierten Anwendung zur Mikroapps-Plattform übermittelt wird, empfehlen wir, für die erste Datensynchronisierung auf der Seite Tabelle Entitäten zu filtern, um die Synchronisierung zu beschleunigen. Weitere Informationen finden Sie unter Überprüfen erforderlicher Entitäten. Vollständige Informationen zu Synchronisierungsregeln, zeitlich fehlgeschlagenen Synchronisierungen und zu Vetoregeln finden Sie unter Synchronisieren von Daten.

Weitere Informationen zu API-Endpunkten und Tabellenentitäten finden Sie unter MS Dynamics-Connectorspezifikationen.

Verwenden von MS Dynamics CRM-Mikroapps

Vorhandene Anwendungsintegrationen werden mit vorkonfigurierten Mikroapps geliefert. Beginnen Sie mit diesen Mikroapps und passen Sie sie an Ihre Erfordernisse an.

Unsere Integration von Microsoft Dynamics CRM bietet folgende vorkonfigurierte Mikroapps:

Konten: Suchen, Anzeigen und Bearbeiten von Konten.

Termine: Suchen, Anzeigen und Bearbeiten von Terminen.

Fälle: Suchen, Anzeigen und Bearbeiten von Fällen.

Kontakte: Suchen, Anzeigen und Bearbeiten von Kontakten.

Konto erstellen: Erstellen eines Kontos.

Termin erstellen: Erstellen eines Termins.

Fall erstellen: Erstellen eines Falls.

Kontakt erstellen: Erstellen einen Kontakts.

Lead erstellen: Erstellen einen Leads.

Verkaufschance erstellen: Erstellen einer Verkaufschance.

Telefonanruf erstellen: Erstellen eines Telefonanrufs.

Aufgabe erstellen: Erstellen einer Aufgabe.

Leads: Suchen, Anzeigen und Bearbeiten von Leads.

Verkaufschancen: Suchen, Anzeigen und Bearbeiten von Verkaufschancen.

Telefonanrufe: Suchen, Anzeigen und Bearbeiten von Telefonanrufen.

Aufgaben: Suchen, Anzeigen und Bearbeiten von Aufgaben.

Hinzufügen der Legacy-Integration

Befolgen Sie diese Anweisungen, um die Legacy-Integration einzurichten.

Hinzufügen der Legacy-Integration zu Citrix Workspace-Mikroapps

Fügen Sie die Microsoft Dynamics CRM-Integration zu Citrix Workspace-Mikroapps hinzu, um eine Verbindung zu Ihrer Anwendung herzustellen. Dadurch werden vorkonfigurierte Mikroapps mit Benachrichtigungen und Aktionen bereitgestellt, die in Ihrem Workspace sofort einsatzbereit sind.

Führen Sie folgende Schritte aus:

1. Klicken Sie auf der Seite “Übersicht” auf Starten.

   Die Seite “Integrationen verwalten” wird geöffnet.

2. Wählen Sie Neue Integration hinzufügen und Neue Integration aus Citrix-Vorlagen hinzufügen.
3. Wählen Sie die Microsoft Dynamics CRM-Kachel.

4. Geben Sie einen Namen für die Integration ein.

   

5. Geben Sie die Connectorparameter ein, die Sie in den vorherigen Verfahren erfasst haben.
   • Geben Sie Ihre URL ein.
   • Geben Sie Ihre Anwendungs-ID und Ihren Schlüssel ein.
   • Aktivieren Sie OAuth-Autorisierung für Benutzer in Aktionen verwenden, wenn Sie OAuth in Mikroapp-Aktionen benötigen.
   • Wählen Sie Mit MS Dynamics CRM-Konto anmelden, um die OAuth-Autorisierung zu aktivieren. Eine Anmeldeseite wird auf einer neuen Registerkarte geöffnet. Sie werden aufgefordert, einen Kontonamen einzugeben, den Zugriff zu bestätigen und ein Kennwort einzugeben.
6. Wählen Sie Hinzufügen aus.

Die Seite Mikroappintegrationen wird geöffnet und zeigt die hinzugefügte Integration mit zugehörigen Mikroapps an. Hier können Sie eine weitere Integration hinzufügen, vorkonfigurierte Mikroapps einrichten oder eine neue Mikroapp für diese Integration erstellen.

Sie können nun die erste Datensynchronisierung festlegen und ausführen. Da unter Umständen eine große Datenmenge von Ihrer integrierten Anwendung zur Mikroapps-Plattform übermittelt wird, empfehlen wir, für die erste Datensynchronisierung auf der Seite Tabelle Entitäten zu filtern, um die Synchronisierung zu beschleunigen. Weitere Informationen finden Sie unter Überprüfen erforderlicher Entitäten. Vollständige Informationen zu Synchronisierungsregeln, zeitlich fehlgeschlagenen Synchronisierungen und zu Vetoregeln finden Sie unter Synchronisieren von Daten.

Weitere Informationen zu API-Endpunkten und Tabellenentitäten finden Sie unter Microsoft Dynamics-Connectorspezifikationen.

Verwenden von Microsoft Dynamics CRM-Legacy-Mikroapps

Vorhandene Anwendungsintegrationen werden mit vorkonfigurierten Mikroapps geliefert. Beginnen Sie mit diesen Mikroapps und passen Sie sie an Ihre Erfordernisse an.

Unsere Integration von MS Dynamics CRM bietet folgende vorkonfigurierte Mikroapps:

Konten: Suchen, Anzeigen und Bearbeiten von Konten.

Termine: Suchen, Anzeigen und Bearbeiten von Terminen.

Fälle: Suchen, Anzeigen und Bearbeiten von Fällen.

Kontakte: Suchen, Anzeigen und Bearbeiten von Kontakten.

Konto erstellen: Erstellen eines Kontos.

Termin erstellen: Erstellen eines Termins.

Fall erstellen: Erstellen eines Falls.

Kontakt erstellen: Erstellen einen Kontakts.

Lead erstellen: Erstellen einen Leads.

Verkaufschance erstellen: Erstellen einer Verkaufschance.

Telefonanruf erstellen: Erstellen eines Telefonanrufs.

Aufgabe erstellen: Erstellen einer Aufgabe.

Leads: Suchen, Anzeigen und Bearbeiten von Leads.

Verkaufschancen: Suchen, Anzeigen und Bearbeiten von Verkaufschancen.

Telefonanrufe: Suchen, Anzeigen und Bearbeiten von Telefonanrufen.

Aufgaben: Suchen, Anzeigen und Bearbeiten von Aufgaben.