Einrichten

Einleitung

Um erfolgreich eine Verbindung herzustellen und Anforderungen an die Web-API zu senden, muss die Aktivität Microsoft Dynamics Application Scope die Authentifizierung mit dem OAuth 2.0 -Protokoll abschließen.

Um der Microsoft Dynamics 365 Scope -Aktivität die Möglichkeit zu geben, sich mit OAuth 2.0 zu authentifizieren und die anderen Aktivitäten zu aktivieren, um Anforderungen erfolgreich an die Web-API zu senden, müssen Sie die folgenden Schritte ausführen:

1. Registrieren Sie Ihre Anwendung.
2. Erstellen Sie einen geheimen Clientschlüssel.
3. Anmeldeinformations-Asset erstellen.

4. Erstellen Sie Ihr Projekt.

   
   

   

   
   
   Hinweis:

   Die Microsoft Dynamics 365-Aktivitäten sind vom [Common Data Service] abhängig)(https://docs.microsoft.com/en-us/dynamics365/human-resources/hr-admin-integration-choose-technology#common-data -service-entities). Aufgrund dieser Abhängigkeit unterstützen die Aktivitäten in erster Linie Customer Engagement- Lösungen.

   Derzeit wird Microsoft Dynamics for Finance & Operations nicht unterstützt.

Schritte

1. Registrieren Sie Ihre Anwendung

Befolgen Sie die Common Data Service-spezifischen Anweisungen in der Microsoft-Dokumentation, um eine Anwendungsregistrierung zu erstellen (diese Schritte umfassen das Zuweisen der entsprechenden API-Berechtigungen).

Weitere Informationen zur App-Registrierung für den Common Data Service finden Sie unter Verwenden von OAuth mit Common Data Service in der Microsoft-Dokumentation.

Beachten Sie beim Registrieren Ihrer Anwendung die Werte für die Anwendungs-ID (Client) und die Verzeichnis -ID (Mandant). Sie geben diese in der Aktivität Microsoft Dynamics-Anwendungsumfang ein.

2. Client-Geheimnis erstellen

Hinweis: Dieser Schritt ist nur relevant, wenn Sie ClientAnmeldeinformationen als Authentifizierungstyp in der Aktivität verwenden möchten. Wenn Sie PasswordCredentialsverwenden möchten, können Sie mit dem Erstellen Ihres Projektsfortfahren.

Folgen Sie den Anweisungen in der Microsoft-Dokumentation, um Ihre registrierte Anwendung für die Verbindung als App zu konfigurieren (d. h Verbindung mit einem geheimen Clientschlüssel herstellen). Weitere Informationen zu Clientgeheimnissen finden Sie unter Verwenden von Clientgeheimnissen und -zertifikaten in der Microsoft-Dokumentation.

Zur schnellen Referenz zeigt die folgende Abbildung, wie wir unser Client-Geheimnis für unsere Beispielprojekte erstellt haben.

3. Anwendungsbenutzer erstellen

Melden Sie sich bei Ihrem Microsoft Dynamics 365 Customer Engagement-Konto an. Wechseln Sie zu Einstellungen > Sicherheit > Benutzer > Neuer Benutzer.

Ändern Sie die Ansicht in Anwendungsbenutzer. Geben Sie die Anwendungs-ID aus dem vorherigen Schritt in das Feld Anwendungs-ID ein.

Füllen Sie die anderen Felder aus, z. B. (Vollständiger Name) und (Primäre E-Mail) und speichern Sie dann den Benutzer.

4. Anmeldeinformations-Asset erstellen

Hinweis: Dieser Schritt ist nur relevant, wenn Sie ClientAnmeldeinformationen als Authentifizierungstyp in der Aktivität Microsoft Dynamics Application Scope verwenden möchten. Wenn Sie PasswordCredentialsverwenden möchten, können Sie mit dem Erstellen Ihres Projektsfortfahren.

Die Aktivität Microsoft Dynamics-Anwendungsbereich erfordert eine SecureString -Eingabe für die ClientSecret -Eigenschaft. Um die Variable SecureString einzugeben, wird empfohlen, die Vorschläge und Schritte im Abschnitt dieses Handbuchs zu befolgen.

5. Erstellen Sie Ihr Projekt

1. Erstellen Sie ein neues Automatisierungsprojekt.

   1. Öffnen Sie UiPath Studio.
   2. Klicken Sie unter Neues Projektauf Prozess (dadurch wird das Fenster Neuer leerer Prozess geöffnet).
   3. Geben Sie einen Projektnamen, einen Speicherortund eine Beschreibungein.
   4. Klicken Sie auf Erstellen.

2. Installieren Sie das UiPath.MicrosoftDynamics.Activities -Paket.

   1. Klicken Sie im Menüband Design auf Pakete verwalten (dadurch wird das Fenster Pakete verwalten geöffnet).
   2. Klicken Sie unter Alle Paketeauf Offiziell!
   3. Geben Sie in der Suchleiste Dynamicsein.

   4. Klicken Sie auf, installieren und akzeptieren Sie die Lizenz für UiPath.MicrosoftDynamics.Activities.

      • Weitere Informationen zu Uipath Studio-Paketen finden Sie unter Verwalten von Paketen im Studio-Handbuch.

Alles erledigt!

Nachdem Sie die Einrichtung abgeschlossen haben, können Sie mit dem Hinzufügen der Microsoft Dynamics 365-Aktivitäten zu Ihrem Projekt beginnen.

Nächste Schritte

Für eine praxisorientierte Lernerfahrung und für einen schnellen Einstieg in die Verwendung der Aktivitäten, siehe Schnellstartanleitung . In dieser Anleitung finden Sie Schritt-für-Schritt-Anweisungen, die Ihnen helfen sollen, ein funktionierendes Beispiel für die verschiedenen Aktivitäten zu erstellen, damit Sie die Verbindung mit Ihrer Microsoft Dynamics 365-Instanz überprüfen und sich mit den Eingabe-/Ausgabeeigenschaften vertraut machen können.

Weitere Informationen zu Microsoft Dynamics 365-Aktivitäten (einschließlich Beispieleigenschaftseingaben/-ausgaben) finden Sie auf der Seite Aktivitäten für eine vollständige Aktivitätsliste und Links zu den Aktivitätsdetailseiten.