Microsoft Dynamics Application Scope

UiPath.MicrosoftDynamics.Activities.MicrosoftDynamicsScopeActivity

Les activités Dynamics 365 utilisent l' OAuth avec le protocole Data Service commun pour établir une connexion authentifiée entre UiPath et votre application Dynamics 365. Cette connexion autorise un Robot à appeler les API Web et à accéder aux ressources en votre nom.

Pour activer l'authentification, vous utilisez Azure Active Directory pour enregistrer votre application Dynamics 365 dans votre locataire de compte. L’enregistrement de votre application génère un ID d’application qui est utilisé avec d’autres identifiants pour établir l’accès authentifié à votre instance. Pour plus d'informations et avant de créer votre premier projet d'automatisation, consultez le Guide de Configuration (Setsp ).

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).

Mode de fonctionnement

Les étapes et le diagramme de séquence de messages suivants illustrent le fonctionnement de l'activité, depuis la conception (c'est-à-dire les dépendances d'activité et les propriétés d'entrée/sortie) jusqu'à l'exécution.

1. Terminez les étapes de Configuration .
2. Ajoutez une activité si votre TypeAuthentification est défini sur InformationsIdentificationClient, sinon, il s'agit de N/A.
   • Pour plus d'informations, consultez la section Gestion des informations d'identification dans ce guide.
3. Add the Microsoft Dynamics Application Scope activity to your project.
4. Saisissez des valeurs pour les propriétés d'entrée de la connexion .
5. Créez et entrez une variable MicrosoftDynamicsConnection pour la variété de sortie.

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

     

Dans le corps de l’activité

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

Pour en savoir plus sur l' assistant de connexion, consultez la page Infrastructures d'activité métier .

Remarque :

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.

Propriétés

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité. Ce champ ne prend en charge que les variables Strings ou String.

Connexion (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.
  • IdentifiantsClient : si cette option est sélectionnée, l'authentification est effectuée via une CléSecrèteClient. Cette option est applicable aux automatisations assistées et non assistées. Pour plus d'informations sur les informations d'identification du client, consultez Utiliser les clés secrètes et les certificats du client dans la documentation Microsoft.
• ClientId - The auto-generated, Application (client) ID assigned to your registered application. This field supports only String variables.
  • L' IDClient est généré lorsque vous enregistrez votre application à l'aide d'Azure Active Directory. Pour plus d’informations, consultez la section Enregistrer votre application du guide Configuration .
  • Si la valeur de TypeAuthentification est définie sur InformationsIdentificationClient, l' IDClient est associé à la valeur CléSecrèteClient. En raison de cette relation, il est recommandé de créer une variable String pour cette propriété en suivant la section Créer une ressource d’informations d’identification du guide de configuration .
  • Pour créer et entrer votre variable String pour cette propriété, utilisez une activité pour générer votre ressource d’informations d’identification (voir l’exemple ci-dessous).
• ClientSecret - The password (associated with the Username) to your ServiceNow instance. Enter a SecureString variable.
  • La valeur CléSecrèteClient peut être générée lorsque vous enregistrez votre application à l'aide d'Azure Active Directory. Pour plus d’informations, consultez la section Créer une clé secrète de client du guide de configuration .
  • Pour créer une variable SecureString , consultez la section Créer une ressource d'informations d'identification du guide de configuration .
  • Pour saisir votre variable SecureString , utilisez une activité qui génère votre ressource d'informations d'identification (voir l'exemple ci-dessous).
• 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.

Connexion existante

• 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.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Options

• 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.

Sortie

• MicrosoftDynamicsConnection : un enregistrement de votre connexion établie que vous pouvez utiliser dans d'autres activités Microsoft Dynamics Application Scope incluses dans cette activité d'étendue. Saisissez une MicrosoftDynamicsConnection variable. Vous pouvez transmettre cette variable à une activité d'étendue dans un workflow qui se situe à l'intérieur de l'activité d'étendue parente.

  • Par exemple, vous pouvez avoir 3 workflows. La première comprend l'activité d'étendue parente qui établit la connexion à votre application enregistrée (c'est-à-dire le workflow parent). Le deuxième workflow crée un nouvel enregistrement de contact et le troisième crée un nouvel enregistrement de compte ; les deux sont inclus dans l’activité d’étendue parent.

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

    

Exemple

L'image suivante montre un exemple de la relation de dépendance d'activité et des valeurs de propriété d'entrée/sortie.