Richten Sie die Microsoft Dynamics 365 for Finance and Operations-Spoke ein

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 7 Minuten Lesedauer
  • Integrieren Sie die Instanz ServiceNow und Microsoft Dynamics 365 for Finance and Operations, indem Sie in Microsoft Azure eine anwenderdefinierte OAuth-Anwendung erstellen, um ServiceNow -Anforderungen zu authentifizieren.

    Vorbereitungen

    • Fordern Sie ein IntegrationHub -Abonnement an.
    • Aktivieren Sie die Microsoft Dynamics 365 for Finance and Operations-Spoke.
    • Erforderliche Rolle: admin
    Hinweis:
    Stellen Sie nach der Konfiguration des Alias für Verbindungen und Anmeldeinformationen sicher, dass Sie die neuesten Metadaten aus der Microsoft Dynamics 365 Finance and Operations-Anwendung abrufen.

    Registrieren Sie Microsoft Dynamics 365 for Finance and Operations als OAuth-Anbieter

    Registrieren Sie Microsoft Dynamics 365 for Finance and Operations als OAuth-Anbieter, damit die Instanz ServiceNow OAuth 2.0-Token anfordern kann.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierung.
    2. Öffnen Sie für den Datensatz für Microsoft D365 FIN and Ops Spoke OAuth.
    3. Füllen Sie diese Werte im Formular aus.
      Tabelle : 1. Anwendungsregistrierungen-Formular
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Datensatzes. Geben Sie beispielsweise Folgendes ein: Microsoft Dynamics 365 for Finance and Operations OAuth
      Client-ID Während Microsoft Dynamics 365 for Finance and Operationserstellte Client-ID -Anwendungskonfiguration.
      Geheimer Clientschlüssel Geheimer Clientschlüssel, der während der Konfiguration der Anwendung Microsoft Dynamics 365 for Finance and Operations erstellt wurde.
      Autorisierungs-URL OAuth-Autorisierungscode-Endpunkt. Geben Sie Folgendes ein: https://login.microsoftonline.com/<AzureTenantID> /oauth2/v2.0/authorize
      Token-URL OAuth-Servertoken-Endpunkt. Geben Sie Folgendes ein: https://login.microsoftonline.com/<AzureTenantID> /oauth2/v2.0/token
      Token-Sperr-URL OAuth-Servertoken-Rücknahme-Endpunkt.
      Umleitungs-URL OAuth-Callback-Endpunkt in diesem Format: https://<instance> .service-now.com/oauth_redirect.do
      OAuth-API-Skript Skript zum Anpassen der Anforderung und Antwort. Wählen Sie .
      Logo-URL URL, die ein Bild enthält, das als Anwendungslogo verwendet werden soll.
      Standardgewährungstyp Zum Erstellen des Tokens verwendeter Gewährungstyp. Wählen Sie Client-Anmeldeinformationen aus.
      Lebensdauer von Aktualisierungstoken Zeit in Sekunden, die das Aktualisierungstoken gültig ist. Die Standardzeit beträgt 8.640.000 Sekunden.
      PKCE erforderlich Option, damit öffentliche Clients für eine Autorisierung PKCE obligatorisch machen können.
      Hinweis:
      Sie können den Autorisierungscode nur dann als Standardgewährungstyp verwenden, wenn PKCE aktiviert ist.
      Anwendung Anwendungsbereich, der diesen Datensatz enthält.
      Zugänglich von Anwendungsbereich, von dem aus auf diese Registrierung zugegriffen werden kann.
      Aktiv Option zur aktiven Verwendung der Anwendungsregistrierung.
      Gegenseitige Authentifizierung aktivieren Option zur Verwendung der gegenseitigen Authentifizierung für Tokenanforderung und -sperrung. Für diese Option muss ein Profil für gegenseitige Authentifizierung angegeben werden.
    4. Klicken Sie mit der rechten Maustaste auf den Formularheader und wählen Sie Speichern aus.

    Erstellen Sie einen Verbindungsdatensatz für Microsoft Dynamics 365 for Finance and Operations

    Erstellen Sie einen Verbindungsdatensatz für Microsoft Dynamics 365 for Finance and Operations. Die Aliasse für Verbindungen und Anmeldeinformationen der Microsoft Dynamics 365 for Finance and Operations-Spoke verwenden diese Verbindungen, um Aktionen in Microsoft Dynamics 365 for Finance and Operationsauszuführen.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationen.
    2. Öffnen Sie den Aliasdatensatz für MicrosoftD365FinAndOps.
    3. Klicken Sie auf der Registerkarte Verbindungen auf Neu.
    4. Füllen Sie diese Felder im Formular aus.
      Tabelle : 2. Verbindungsformular
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Datensatzes. Beispiel: Microsoft Dynamics 365 for Finance and Operations-Verbindung.
      Anmeldeinformationen Für Microsoft Dynamics 365 for Finance and Operations erstellter Anmeldeinformationsdatensatz. Suchen und wählen Sie MicrosoftD365FinAndOps.Credentialaus.
      Verbindungsalias Alias-Datensatz, der dieser Verbindung zugeordnet ist. Geben Sie sn_ms_fin_ops_spk.MicrosoftD365FinAndOps ein
      Verbindungs-URL Basis-URL zum Herstellen einer Verbindung mit Microsoft Dynamics 365 for Finance and Operations. Eingabe: https://<instance_ID> .cloudax.dynamics.com/
      Aktiv Option zur aktiven Verwendung des Verbindungsdatensatzes.
      Domäne Domäne, in der die Aktion ausgeführt wird.
    5. Klicken Sie auf Absenden.

    Ruft Metadaten aus Microsoft Dynamics 365 Finance and Operations ab

    Rufen Sie die Metadaten aus Microsoft Dynamics 365 Finance and Operations ab, und speichern Sie sie in Ihrer ServiceNow-Instanz. Dynamische Aktionen erfordern die neuesten Metadaten aus Microsoft Dynamics 365 Finance and Operations.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Microsoft D365 FinOps-Metadaten > Microsoft D365 FinOps-Metadateninhalte.
    2. Klicken Sie auf Metadaten abrufen/aktualisieren.
    3. Wählen Sie den Alias aus, um aktualisierte Metadaten aus der Anwendung Microsoft Dynamics 365 Finance and Operations abzurufen, und klicken Sie auf OK.
      Hinweis:
      Stellen Sie sicher, dass Sie die neuesten Metadaten abrufen, wenn sich in der Anwendung Microsoft Dynamics 365 Finance and Operations Änderungen ergeben.

    Richten Sie einen bidirektionalen Webhook für die Microsoft Dynamics 365 for Finance and Operations-Spoke ein

    Konfigurieren Sie einen Webhook, um die Microsoft Dynamics 365 for Finance and Operations-Spoke mit der Rückruf-URL ServiceNow zu abonnieren.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Microsoft D365 FnO-Spoke > FnO-Webhook-Registrierungen.
    2. Klicken Sie auf Neu.
    3. Füllen Sie die Felder des Formulars aus.
      Feld Beschreibung
      Name Eindeutiger Name für die Webhook-Registrierung Beispiel: Microsoft Dynamics 365 for Finance and Operations-Webhook.
      Beschreibung Optionale Beschreibung für den Webhook.
      Rückruf-URL generieren Option zum Generieren einer Rückruf-URL, die zum Registrieren des Webhooks im Microsoft Dynamics 365 Finance and Operations-Portal verwendet wird.
      Neues Geheimnis generieren Option zum Generieren eines geheimen Schlüssels für den Microsoft Dynamics 365 Finance and Operations-Webhook
      Hinweis:

      Wenn Sie ein neues Geheimnis generieren, stellen Sie sicher, dass Sie die Rückruf-URL auch nach dem Generieren des Geheimnisses generieren.

      Zeichnen Sie die Rückruf-URL für die Registrierung der App im Azure-Portal auf.

    Passen Sie den bidirektionalen Webhook in der Microsoft Dynamics 365 Finance and Operations-Spoke an

    Erstellen Sie eine Webhook-Weiterleitungsrichtlinie und einen Subflow gemäß Ihren Anforderungen in der Microsoft Dynamics 365 Finance and Operations-Spoke.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Flow Designer > Designer.
    2. Klicken Sie auf Subflows.
    3. Erstellen Sie eine Kopie des erforderlichen Subflows.
    4. Passen Sie den erforderlichen Subflow an Ihre Anforderungen an, und veröffentlichen Sie ihn.
    5. Navigieren zu Microsoft D365 FnO-Spoke > FnO-WebHook-Weiterleitungsrichtlinien.
    6. Klicken Sie auf Neu.
    7. Füllen Sie die Felder des Formulars aus.
      Tabelle : 3. Formular „Entscheidung“
      Feld Beschreibung
      Bezeichnung Eindeutige Bezeichnung zur Identifizierung der Weiterleitungsrichtlinie.
      Standardantwort Option zum Angeben, ob dies die Standardantwort ist. Die Standardantwort ist anwendbar, wenn die Bedingungen nicht erfüllt sind.
      1. Klicken Sie auf das Suchsymbol.
      2. Wählen Sie den gewünschten Subflow aus der Liste Dokument: aus.
        Hinweis:
        Stellen Sie sicher, dass der TabellennameFlow [sys_hub_flow] lautet.
      Bedingung Bedingungen, die erfüllt werden müssen, wenn die erforderlichen Ereignisse in Microsoft Dynamics 365 Finance and Operations auftreten. Informationen zu den unterstützten Feldern finden Sie unter Microsoft Dynamics 365 for Finance and Operations-Spoke.
      Antwort Subflow, der ausgelöst werden muss, wenn die angegebenen Bedingungen erfüllt sind.
    8. Klicken Sie auf Absenden.
      Hinweis:
      Diese Weiterleitungsrichtlinien werden in den Entscheidungstabellen gespeichert. Benutzer werden davor gewarnt, Daten in diesen Tabellen direkt zu aktualisieren oder zu ändern.

    Ergebnisse

    Weiterleitungsrichtlinie und Subflow werden erstellt.

    Registrieren Sie eine App im Microsoft Azure-Portal für die Microsoft Dynamics 365 Finance and Operations-Spoke

    Registrieren Sie Ihre ServiceNow-Instanz im Microsoft Azure-Portal, um die Microsoft Dynamics 365 Finance and Operations-Spoke zu verwenden.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Melden Sie sich beim Azure-Portal an.
    2. Navigieren Sie zu App-Registrierungen, und registrieren Sie eine App für den Webhook.
    3. Erstellt einen Key Vault über das Azure-Portal.
      Weitere Informationen hierzu finden Sie unter Key Vault mit dem Azure-Portal erstellen.
    4. Navigieren Sie zu Zugriffsrichtlinien.
    5. Erstellen Sie eine Zugriffsrichtlinie.
    6. Wählen Sie Abrufen unter Geheimnisberechtigungen aus, und klicken Sie auf Weiter.
    7. Suchen Sie auf der Registerkarte Prinzipal nach dem Namen der zuvor registrierten App, und klicken Sie auf Weiter.
    8. Klicken Sie auf der Registerkarte Anwendung (optional) auf Weiter.
    9. Klicken Sie auf der Registerkarte Überprüfen + erstellen auf Erstellen.
    10. Navigieren Sie zum Abschnitt „ Geheimnisse “.
    11. Klicken Sie auf „+ Generieren/Importieren“.
    12. Geben Sie auf der Seite Geheimnis erstellen einen Namen ein, und geben Sie die Rückruf-URL an, die von Ihrer ServiceNow-Instanz generiert wurde.
    13. Klicken Sie auf Erstellen.
    14. Melden Sie sich bei Ihrem Microsoft Dynamics 365 Finance and Operations-Portal an.
    15. Navigieren zu Systemadministration > Geschäftsereignisse > Geschäftsereigniskatalog.
    16. Navigieren Sie zur Registerkarte Endpunkte, und klicken Sie auf Neu.
    17. Wählen Sie in der Ansicht Standard den Endpunkttyp HTTPS aus, und klicken Sie auf Weiter.
    18. Tragen Sie die Details in das Formular ein.
      Endpunktname Name des Endpunkts.
      Endpunkttyp Typ des Endpunkts.
      Key Vault Für die Anwendung erstellter Schlüssel Tresor.
      ID der Azure Active Directory-Anwendung Objekt-ID der Anwendung.
      Azure-Anwendungsgeheimnis Für die Anwendung erstelltes Geheimnis
      DNS-Name des Schlüssel Tresors Tresor-URI der Anwendung.
      Geheimer Name des Key Tresors Name des Key Vault-Geheimnisses.
    19. Klicken Sie auf OK.
      Hinweis:
      Stellen Sie sicher, dass die Key Vault-Zugriffsrichtlinie für die Anwendung erstellt wird. Die Zugriffsrichtlinie sollte der Anwendungsregistrierung den Zugriff auf Geheimnisse aus dem Schlüssel Tresor ermöglichen.
    20. Navigieren Sie zur Registerkarte Business Events und suchen Sie nach einer Kategorie.
      Beispiel: Bestellungen.
    21. Wählen Sie die gewünschte Kategorie aus der Liste aus, und klicken Sie auf Aktivieren.
    22. Wählen Sie im Abschnitt Neues Geschäftsereignis konfigurieren die juristische Person und den Endpunktnamen aus.
    23. Klicken Sie auf OK.
      Hinweis:
      Stellen Sie sicher, dass diese API-Berechtigungen für die Anwendung aktiviert sind.
      • Greifen Sie auf den anwenderdefinierten Dynamics AX-Service zu
      • Greifen Sie auf Dynamics AX-Daten zu
      • Greifen Sie als Organisationsbenutzer auf Dynamics AX Online zu

    Ergebnisse

    Der Webhook ist registriert und kann getestet werden.