Einrichten der Graph-API-Unterstützung für Dynamics 365 Mail App

In diesem Artikel erfahren Sie, wie Sie die Graph-API-Unterstützung für die Dynamics 365 Mail-App konfigurieren, indem Sie eine benutzerdefinierte Einstellungslösung erstellen. Sie erstellen eine neue Lösung, fügen eine Einstellungsentität hinzu und konfigurieren die erforderlichen Felder zum Speichern Ihrer Graph-API-Anmeldeinformationen. Mit diesem Setup kann die Mail-App sich authentifizieren und mit Microsoft Graph-Diensten kommunizieren.

Voraussetzungen

Bevor Sie beginnen, sollten Sie sicherstellen, dass Folgendes vorhanden ist:

  • Administrativer Zugriff auf Ihre Dynamics 365-Umgebung
  • Eine Azure AD-App-Registrierung mit der App-ID
  • Ihre Azure-Mandanten-ID
  • Geeignete Sicherheitsberechtigungen zum Erstellen von Lösungen und Entitäten.

Erstellen einer Drittanbieter-App-Registrierung im Azure-Mandanten

  1. Melden Sie sich bei Azure portal an.

  2. Wechseln Sie zu App-Registrierungen , und wählen Sie +Neue Registrierung aus, um eine neue App-Registrierung zu erstellen.

  3. Füllen Sie die erforderlichen Felder aus, z. B.:

    • App-Name
    • Unterstützte Konten: nur Konten in diesem Organisationsverzeichnis (nur Mystery Incorporated – einzelner Mandant)
    • Umleitungs-URL - Ersetzen crm_org_domain: SPA - https://<crm_org_domain>/crmmailapp/msalAuth.html

    App-Registrierung

  4. Nachdem Sie die App-Registrierung erstellt haben, wechseln Sie zum Abschnitt "API-Berechtigungen ", und fügen Sie die entsprechenden Berechtigungen für Graph hinzu. Sie müssen diesen Berechtigungen Administratorzustimmung erteilen.

    API-Berechtigungen

  5. Notieren Sie AppId und TenantId für den nächsten Schritt.

D365 Mail App-Einstellungslösung importieren

Führen Sie die folgenden Schritte aus, um die Einstellungsentität manuell zu erstellen:

Erstellen der Dynamics 365 Mail-App-Einstellungslösung

Erstellen Sie eine neue Lösung in Ihrer Dynamics 365-Umgebung, um die Mail-App-Konfigurationseinstellungen zu speichern.

  1. Wechseln Sie zu Ihrer Dynamics 365-Umgebung.
  2. Erstellen Sie eine neue Lösung mit den folgenden Details:
    • Display-Name: Dynamics 365 Mail-App-Einstellungen
    • Name: D365MailAppsettings
    • Fügen Sie einen neuen Herausgeber hinzu, mit dem der Kunde Entitäten mit dem Präfix mailapp erstellen kann.
    • Version: 1.0.0.0

Hinzufügen der Einstellungsentität

Fügen Sie eine benutzerdefinierte Entität hinzu, um die Mail-App-Konfigurationswerte zu speichern.

  1. Fügen Sie in der D365MailAppsettings-Lösung eine neue Entität hinzu.
  2. Legen Sie den Entitätsnamen auf mailapp_setting, Anzeigename auf MailApp-Einstellungen und Pluralname auf "Einstellungen" fest.
  3. Veröffentlichen Sie Ihre Änderungen in Dynamics 365.

Konfigurieren von Entitätsfeldern

Fügen Sie neue Felder in der entität mailapp_setting hinzu.

  • mailapp_name: Speichert den Namen jeder Konfigurationseinstellung.
  • mailapp_settingvalue: Speichert den entsprechenden Wert für jede Einstellung.

Hinzufügen der Graph-API-App-ID zu den Dynamics 365 Mail App-Einstellungen

  1. Um auf die Entität mit der Einstellung zuzugreifen, wechseln Sie zu https://<org_domain>/main.aspx?pagetype=entitylist&etn=mailapp_setting.
  2. Erstellen Sie einen neuen Datensatz in der mailapp_setting Entität mit den folgenden Werten:
    • Name: graph_appid
    • Einstellungswert: Geben Sie die App-ID aus Ihrer Azure AD-App-Registrierung ein.

Hinzufügen der AAD-Mandanten-ID zu den Dynamics 365 Mail-App-Einstellungen

  1. Um auf die Entität mit der Einstellung zuzugreifen, wechseln Sie zu https://<org_domain>/main.aspx?pagetype=entitylist&etn=mailapp_setting.
  2. Erstellen Sie einen neuen Datensatz in der mailapp_setting Entität mit den folgenden Werten:
    • Name: azure_tenantid
    • Einstellungswert: Geben Sie die Azure-Mandanten-ID ein.

Füge Leseberechtigungen für Einstellungen für alle Benutzer hinzu

Erteilen Sie Leseberechtigungen für die Einstellungsentität, damit Benutzer auf die Mail-App-Konfiguration zugreifen können.

  1. Gehen Sie zu Einstellungen>Sicherheit>Sicherheitsrollen.
  2. Suchen Sie nach der Sicherheitsrolle Dynamics 365 App für Outlook-Benutzer.
  3. Wechseln Sie zur Ansicht für benutzerdefinierte Entitäten und suchen Sie nach den MailApp-Einstellungen.
  4. Legen Sie die Leseberechtigung auf Organisationsebene fest.
  5. Änderungen speichern.

Nächste Schritte

Nachdem Sie dieses Setup abgeschlossen haben, kann sich die Dynamics 365 Mail-App mithilfe der Graph-API authentifizieren und im Auftrag Ihrer Benutzer auf Microsoft Graph-Dienste zugreifen.

  • Last updated on