Microsoft Dynamics Application Scope

UiPath.MicrosoftDynamics.Activities.MicrosoftDynamicsScopeActivity

Die Dynamics 365-Aktivitäten verwenden das OAuth-Protokoll mit dem Common Data Service , um eine authentifizierte Verbindung zwischen UiPath und Ihrer Dynamics 365-Anwendung herzustellen. Diese Verbindung autorisiert einen Roboter, die Web-APIs aufzurufen und auf Ressourcen in Ihrem Namen zuzugreifen.

Um die Authentifizierung zu aktivieren, verwenden Sie das Azure Active Directory (AAD), um Ihre Dynamics 365-Anwendung in Ihrem Kontomandanten zu registrieren. Beim Registrieren Ihrer Anwendung wird eine Anwendungs-(Client-)ID generiert, die zusammen mit anderen Bezeichnern verwendet wird, um einen authentifizierten Zugriff auf Ihre Instanz herzustellen. Weitere Informationen finden Sie in der Setup -Anleitung, bevor Sie Ihr erstes Automatisierungsprojekt erstellen.

Nachdem Sie Ihre Anwendungsregistrierung abgeschlossen haben, wählen Sie den Authentifizierungstyp aus, den Sie verwenden möchten (AuthenticationType) und geben Ihre Anwendungs-ID (Client) (ClientId), Dynamics 365-Anwendungsendpunkt (EndpointUrl), Verzeichnis-ID (Mandant) (TenantId) und . ein abhängig vom ausgewählten Authentifizierungstyp Ihr geheimer Clientschlüssel (ClientSecret).

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Schließen Sie die Einrichtungsschritte ab.

2. Fügen Sie eine Aktivität hinzu, wenn Ihr Authentifizierungstyp ClientCredentialsist, andernfalls ist dies Nicht zutreffend.

   • Weitere Informationen finden Sie unter Anmeldeinformationsverwaltung in diesem Handbuch.
3. Fügen Sie Ihrem Projekt die Aktivität „ Microsoft Dynamics Application Scope “ hinzu.
4. Geben Sie Werte für die Eingabeeigenschaften der Verbindung ein.
5. Erstellen und geben Sie eine MicrosoftDynamicsConnection -Variable für die Poperty- Ausgabe ein.

   • Sie können diese Variable bei nachfolgenden Verwendungen der Aktivität Microsoft Dynamics Application Scope verwenden.

     
     

     

     
     

Im Textkörper der Aktivität

Um Ihr Projekt zu erstellen und den Objektassistenten in anderen Aktivitäten zu aktivieren, müssen Sie den Verbindungsassistenten verwenden, indem Sie auf die Schaltfläche Konfigurieren klicken.

Weitere Informationen zum Verbindungs-Assistenten finden Sie auf der Seite Businessaktivitäts-Frameworks .

Hinweis: Durch das Konfigurieren der Felder im Verbindungsassistenten werden die Eigenschaften des Microsoft Dynamics-Anwendungsbereichs nicht ausgefüllt. Der Assistent stellt nur während der Entwurfszeit eine Verbindung mit Ihrer Microsoft Dynamics 365-Anwendung her; Aktivieren der Objektassistenten in den anderen Microsoft Dynamics 365-Aktivitäten.

Eigenschaften

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Dieses Feld unterstützt nur Strings- oder String-Variablen.

Verbindung (Connection)

• AuthenticationType – Der Authentifizierungstyp, den Sie verwenden möchten, um eine Verbindung mit Ihrer Dynamics 365-Anwendung herzustellen. Wählen Sie ein Element aus der Dropdownliste aus. Es gibt zwei Optionen:

  • PasswordCredentials – Wenn diese Option ausgewählt ist, erfolgt die Authentifizierung über eine Benutzeraufforderung (entsprechend der Option, die Sie in der Eigenschaft Aufforderung auswählen), um das Kennwort für ihr Dynamics 365-Konto einzugeben. Diese Option ist nur für die beaufsichtigte Automatisierung vorgesehen.
  • ClientAnmeldeinformationen – Wenn diese Option ausgewählt ist, erfolgt die Authentifizierung über ein ClientGeheimnis. Diese Option ist sowohl für die Attended- als auch für die Unattended-Automatisierung möglich. Weitere Informationen zu Client-Anmeldeinformationen finden Sie unter Verwenden von Client-Geheimnissen und -Zertifikaten in der Microsoft-Dokumentation.
• ClientId - Die automatisch generierte Anwendungs-ID (Client), die Ihrer registrierten Anwendung zugewiesen ist. Dieses Feld unterstützt nur String Variablen.
  • Die ClientID wird generiert, wenn Sie Ihre Anwendung mit Azure Active Directory (AAD) registrieren. Weitere Informationen finden Sie im Abschnitt Registrieren Ihrer Anwendung der Einrichtungsanleitung .
  • Wenn Ihr Wert des Authentifizierungstyps ClientCredentials ist, wird die ClientIDdem ClientGeheimnis zugeordnet. Aufgrund dieser Beziehung wird empfohlen, eine String -Variable für diese Eigenschaft zu erstellen, wie im Abschnitt „ Create Credential Asset “ der Einrichtungsanleitung beschrieben.
  • Um Ihre String -Variable für diese Eigenschaft zu erstellen und einzugeben, verwenden Sie eine Aktivität, um Ihr Anmeldeinformations-Asset auszugeben (siehe Beispiel unten).
• ClientSecret – Das Kennwort (verbunden mit dem Benutzernamen) für Ihre ServiceNow-Instanz. Geben Sie eine SecureString -Variable ein.
  • Das ClientGeheimnis kann generiert werden, wenn Sie Ihre Anwendung mit Azure Active Directory (AAD) registrieren. Weitere Informationen finden Sie im Abschnitt Erstellen eines geheimen Clientschlüssels der Setup -Anleitung.
  • Informationen zum Erstellen einer SecureString -Variablen finden Sie im Abschnitt Create Credential Asset der Einrichtungsanleitung.
  • Um Ihre Variable SecureString einzugeben, verwenden Sie eine Aktivität, die Ihr Anmeldeinformationsasset ausgibt (siehe Beispiel unten).
• EndpointUrl – Die URL der CRM-Instanz, mit der Sie eine Verbindung herstellen möchten. Dieses Feld unterstützt nur Strings - oder String -Variablen.

• Eingabeaufforderung – Gibt das Verhalten der Kennworteingabe für die PasswordCredentials- Authentifizierung an. Wählen Sie ein Element aus der Dropdownliste aus. Es gibt drei Optionen:

  • Automatisch – Die Eingabeaufforderung wird nur angezeigt, wenn Anmeldeinformationen erforderlich sind.
  • SelectAccount (SelectAccount) – Bei der Eingabeaufforderung muss ein Benutzer ein Konto auswählen und dann seine Anmeldeinformationen eingeben (wird verwendet, wenn mehrere Konten vorhanden sind).
  • Immer – Die Eingabeaufforderung wird jedes Mal angezeigt, wenn die Aktivität ausgeführt wird (auch wenn sich ein Token im Cache befindet).
• TenantId – Die Verzeichnis-ID (Mandant), die Ihrem Azure Active Directory-Mandanten (ADD) zugewiesen ist. Dieses Feld unterstützt nur Strings - oder String -Variablen.

Bestehende Verbindung (Existing Connection)

• ExistingMicrosoftDynamicsConnection (ExistingMicrosoftDynamicsConnection) – Ein Verbindungsdatensatz aus einer übergeordneten Microsoft Dynamics Application Scope -Aktivität, den Sie verwenden können, anstatt eine neue Verbindung herzustellen. Geben Sie eine MicrosoftDynamicsConnection -Variable ein.
  • Die Variable MicrosoftDynamicsConnection muss aus einer zuvor ausgeführten Microsoft Dynamics Application Scope -Aktivität (übergeordnet) stammen, die noch über eine aktive Verbindung verfügt.
  • Wenn Sie mit dieser Eigenschaft keine Verbindung herstellen können, versuchen Sie, Ihre übergeordnete Microsoft Dynamics-Anwendungs-Scope -Aktivität erneut auszuführen.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Optionen

• ReportApiErrorAsException – Wenn diese Option ausgewählt ist, werden API-Fehlerantworten in BusinessActivityExecutionException von allen untergeordneten Aktivitäten gemeldet, die diesen Anwendungsbereich verwenden. Wenn diese Option deaktiviert ist, füllt die untergeordnete Aktivität die API-Fehlermeldung in der Ausgabeeigenschaft ResponseStatus aus und die Workflowausführung wird fortgesetzt. Überprüfen Sie die Eigenschaft ResponseStatus, um die erfolgreiche Ausführung zu bestätigen.

Ausgabe

• MicrosoftDynamicsConnection – Ein Datensatz Ihrer hergestellten Verbindung, den Sie in anderen Microsoft Dynamics Application Scope -Aktivitäten verwenden können, die in dieser Scope-Aktivität enthalten sind. Geben Sie eine MicrosoftDynamicsConnection -Variable ein. Sie können diese Variable an eine Scope-Aktivität in einem Workflow übergeben, die sich innerhalb der übergeordneten Scope-Aktivität befindet.
  • Sie können beispielsweise drei Workflows haben. Die erste enthält die übergeordnete Scope-Aktivität, die die Verbindung mit Ihrer registrierten Anwendung (d. h. dem übergeordneten Workflow) herstellt. Der zweite Workflow erstellt einen neuen Kontaktdatensatz und der dritte einen neuen Accountdatensatz. beide sind in der übergeordneten Scope-Aktivität enthalten.
  • Wenn die Workflows ausgeführt werden, übergibt die übergeordnete Scope-Aktivität die VariableMicrosoftDynamicsConnection an die ExistingMicrosoftDynamicsConnection -Eigenschaft im zweiten und dritten Workflow (siehe Abbildung unten).
    
    

    

    
    

Beispiel

Die folgende Abbildung zeigt ein Beispiel für die Aktivitätsabhängigkeitsbeziehung und Eingabe-/Ausgabe-Eigenschaftswerte.