Microsoft Dynamics Application Scope

UiPath.MicrosoftDynamics.Activities.MicrosoftDynamicsScopeActivity

Die Dynamics 365-Aktivitäten verwenden das OAuth mit dem Common Data Service Protokoll, um eine authentifizierte Verbindung zwischen UiPath und Ihrer Dynamics 365-Anwendung herzustellen. Diese Verbindung autorisiert einen Roboter, die Web-APIs aufzurufen und in Ihrem Namen auf Ressourcen 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 den authentifizierten Zugriff auf Ihre Instanz herzustellen. Weitere Informationen und bevor Sie Ihr erstes Automatisierungsprojekt erstellen finden Sie in der Einrichtungsanleitung .

After completing your application registration, you select the type of authentication that you want to use (AuthenticationType) and enter your Application (client) ID (ClientId), Dynamics 365 application endpoint (EndpointUrl), Directory (tenant) ID (TenantId), and depending on the authentication type that you select, your client secret (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 ClientAnmeldeinformationen ist, andernfalls ist dies Nicht zutreffend.
   • Weitere Informationen finden Sie unter Anmeldeinformationsverwaltung in diesem Handbuch.
3. Add the Microsoft Dynamics Application Scope activity to your project.
4. Geben Sie Werte für die Eigenschaften der Verbindungseingabe ein.
5. Erstellen und geben Sie eine MicrosoftDynamicsConnection -Variable für die Ausgabevariablen ein.

   • You can use this variable in subsequent uses of the Microsoft Dynamics Application Scope activity.

     

Im Textkörper der Aktivität

To build your project and enable the Object Wizard in other activities, you must use the Connection Wizard by clicking the Configure button.

Weitere Informationen zum Verbindungsassistenten finden Sie auf der Seite Frameworks für Geschäftsaktivitäten .

Hinweis:

Configuring the fields in the Connection Wizard does not populate the Microsoft Dynamics Application Scope properties. The wizard establishes a connection to your Microsoft Dynamics 365 application during design time only; enabling the Object Wizards in the other Microsoft Dynamics 365 activities.

Eigenschaften

Allgemein

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

Verbindung (Connection)

• AuthenticationType - The type of authentication that you want to use to connect to your Dynamics 365 application. Select an item from the drop-down list. There are two options:
  • PasswordCredentials - If selected, authentication is done via a user prompt (according to the option that you select in the Prompt property) to enter the password to their Dynamics 365 account. This option is for attended automation only.
  • ClientAnmeldeinformationen – Wenn diese Option ausgewählt ist, erfolgt die Authentifizierung über ein ClientGeheimnis. Diese Option gilt sowohl für die beaufsichtigte als auch für die unbeaufsichtigte Automatisierung. Weitere Informationen zu Client-Anmeldeinformationen finden Sie unter Verwenden von Client-Geheimnissen und -Zertifikaten in der Microsoft-Dokumentation.
• ClientId - The auto-generated, Application (client) ID assigned to your registered application. This field supports only String variables.
  • Die ClientID wird generiert, wenn Sie Ihre Anwendung mit Azure Active Directory (AAD) registrieren. Weitere Informationen finden Sie im Abschnitt Registrieren Ihrer Anwendung im Setup- Handbuch.
  • Wenn Ihr Authentifizierungstyp- Wert ClientAnmeldeinformationen ist, ist die ClientID dem ClientGeheimnis zugeordnet. Aufgrund dieser Beziehung wird empfohlen, dass Sie eine String -Variable für diese Eigenschaft erstellen, indem Sie dem Abschnitt Anmeldeinformations-Asset erstellen der Setup- Anleitung folgen.
  • Um Ihre String -Variable für diese Eigenschaft zu erstellen und einzugeben, verwenden Sie eine Aktivität zur Ausgabe Ihres Anmeldeinformations-Assets (siehe Beispiel unten).
• ClientSecret - The password (associated with the Username) to your ServiceNow instance. Enter a SecureString variable.
  • Das ClientGeheimnis kann generiert werden, wenn Sie Ihre Anwendung mit Azure Active Directory (AAD) registrieren. Weitere Informationen finden Sie im Abschnitt Erstellen von geheimen Clientschlüsseln der Setup- Anleitung.
  • Informationen zum Erstellen einer SecureString -Variablen finden Sie im Abschnitt Asset erstellen der Setup -Anleitung.
  • Um Ihre SecureString -Variable einzugeben, verwenden Sie eine Aktivität, die Ihr Anmeldeinformations-Asset ausgibt (siehe Beispiel unten).
• EndpointUrl - The URL of the CRM instance that you want to connect to. This field supports only Strings or String variables.
• Prompt - Specifies the password prompt behavior for the PasswordCredentials authentication. Select an item from the drop-down list. There are three options:
  • Auto - The prompt only appears when credentials are necessary.
  • SelectAccount - The prompt requires a user to select an account and then enter their credentials (used when there are multiple accounts).
  • Always - The prompt appears each time the activity is run (even when there is a token in the cache).
• TenantId - The Directory (tenant) ID assigned to your Azure Active Directory (ADD) tenant. This field supports only Strings or String variables.

Bestehende Verbindung (Existing Connection)

• ExistingMicrosoftDynamicsConnection - A connection record from a parent Microsoft Dynamics Application Scope activity that you can use instead of establishing a new connection. Enter a MicrosoftDynamicsConnection variable.
  • The MicrosoftDynamicsConnection variable must be from a previously run Microsoft Dynamics Application Scope activity (parent) that still has an active connection.
  • If you're unable to establish a connection using this property, try re-running your parent Microsoft Dynamics Application Scope activity.

Sonstiges

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

Optionen

• ReportApiErrorAsException - When selected, API error responses are reported in BusinessActivityExecutionException by all child activities that use this application scope. When cleared, the child activity populates the API error message in the ResponseStatus output property and workflow execution continues. Check the ResponseStatus property to confirm successful execution.

Ausgabe

• MicrosoftDynamicsVerbindung – 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, der 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.

  • When the workflows run, the parent scope activity passes theMicrosoftDynamicsConnection variable to the ExistingMicrosoftDynamicsConnection property in the second and third workflows (see image below).

    

Beispiel

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