Microsoft Dynamics Application Scope

UiPath.MicrosoftDynamics.Activities.MicrosoftDynamicsScopeActivity

Les activités Dynamics 365 utilisent le protocole OAuth avec Data Service 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 (AAD) pour enregistrer votre application Dynamics 365 dans votre compte locataire. L'enregistrement de votre application génère un ID d'application (client) qui est utilisé avec d'autres identifiants pour établir un accès authentifié à votre instance. Pour plus d'informations et avant de créer votre premier projet d'automatisation, consultez le Guide de configuration .

Après avoir terminé l'enregistrement de votre application, sélectionnez le type d'authentification que vous souhaitez utiliser (AuthenticationType) et entrez votre ID d'application (client) (ClientId), le point de terminaison de l'application Dynamics 365 (EndpointUrl), l'ID de répertoire (locataire) (TenantId) et selon le type d'authentification que vous sélectionnez, votre clé secrète client (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 TypeAuthentification est « InformationsClientClient » ( ClientCredentials), sinon, la valeur est N/A.

   • Pour plus d'informations, consultez la section Gestion des informations d'identification dans ce guide.
3. Ajoutez l’activité Étendue de l’application Microsoft Dynamics à votre projet.
4. Entrez des valeurs pour les propriétés d'entrée de connexion .
5. Créez et entrez une nouvelle variable MicrosoftDynamicsConnection pour la fenêtre contextuelle Sortie (Output).

   • Vous pouvez utiliser cette variable dans des utilisations ultérieures de l'activité Étendue de l'application Microsoft Dynamics .

     
     

     

     
     

Dans le corps de l’activité

Pour créer votre projet et activer l' Assistant Objet dans d'autres activités, vous devez utiliser l' Assistant Connexion en cliquant sur le bouton Configurer (Configure).

Pour en savoir plus sur l' Assistant de connexion ( Connection Wizard), consultez la page Infrastructures d'activités métier .

Remarque : la configuration des champs dans l' Assistant de connexion ne renseigne pas les propriétés Étendue de l'application Microsoft Dynamics . L'Assistant établit une connexion à votre application Microsoft Dynamics 365 pendant la conception uniquement ; l'activation des Assistants d'objet dans les autres activités Microsoft Dynamics 365.

Propriétés

Commun

• NomAffichage (DisplayName) : nom affiché de l'activité. Ce champ prend uniquement en charge les variables Strings et String.

Connexion (Connection)

• TypeAuthentification : le type d'authentification que vous souhaitez utiliser pour vous connecter à votre application Dynamics 365. Sélectionnez un élément dans la liste déroulante. Il existe deux options :

  • Informations d'identification du mot depasse : si cette option est sélectionnée, l'authentification s'effectue via une invite de l'utilisateur (selon l'option que vous sélectionnez dans la propriété Invite ) pour saisir le mot de passe de son compte Dynamics 365. Cette option est uniquement destinée à l'automatisation assistée.
  • IdentifiantsClient : si cette option est sélectionnée, l'authentification s'effectue via une clé secrèteClient. Cette option est destinée à l’automatisation assistée et non assistée. 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.
• IDClient : l'ID d'application (client) généré automatiquement et attribué à votre application enregistrée. Ce champ ne prend en charge que String variables.
  • ClientId est généré lorsque vous enregistrez votre application à l'aide d'Azure Active Directory (AAD). Pour plus d'informations, consultez la section Enregistrer votre application du Guide de configuration .
  • Si votre valeur TypeAuthentification est "ClientCredentials", ClientId est associé à 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 saisir votre variable String pour cette propriété, utilisez une activité pour générer votre actif d'informations d'identification (voir l' exemple ci-dessous).
• ClientSecret : le mot de passe (associé au nom d' utilisateur) de votre instance ServiceNow. Saisissez une variable SecureString .
  • La CléSecrèteClient peut être générée lorsque vous enregistrez votre application à l'aide d'Azure Active Directory (AAD). Pour plus d'informations, consultez la section Créer une clé secrète client ( Create client secret ) 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 actif d'informations d'identification (voir l' exemple ci-dessous).
• EndpointUrl : l'URL de l'instance CRM à laquelle vous souhaitez vous connecter. Ce champ prend en charge uniquement les variables Strings ou String .

• Prompt (Invite) : spécifie le comportement de l'invite de mot de passe pour l'authentification PasswordCredentials . Sélectionnez un élément dans la liste déroulante. Il existe trois options :

  • Auto : l'invite ne s'affiche que lorsque des informations d'identification sont nécessaires.
  • SelectAccount (SelectAccount) : l'invite oblige l'utilisateur à sélectionner un compte, puis à saisir ses informations d'identification (utilisées lorsqu'il existe plusieurs comptes).
  • Toujours (Always) : l'invite s'affiche chaque fois que l'activité est exécutée (même lorsqu'un jeton se trouve dans le cache).
• TenantId : l’ID d’annuaire (locataire) attribué à votre locataire Azure Active Directory (ADD). Ce champ prend en charge uniquement les variables Strings ou String .

Connexion existante

• ExistingMicrosoftDynamicsConnection : enregistrement de connexion d'une activité Microsoft Dynamics Application Scope parente que vous pouvez utiliser au lieu d'établir une nouvelle connexion. Saisissez une variable MicrosoftDynamicsConnection .
  • La variable MicrosoftDynamicsConnection doit provenir d'une activité Étendue d'application Microsoft Dynamics précédemment exécutée (parent) qui dispose toujours d'une connexion active.
  • Si vous ne parvenez pas à établir une connexion à l'aide de cette propriété, essayez de réexécuter votre activité Microsoft Dynamics Application Scope parente.

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 : lorsque cette option est sélectionnée, les réponses d'erreur d'API sont signalées dans BusinessActivityExecutionException par toutes les activités enfants qui utilisent cette étendue d'application. Lorsqu'elle est décochée, l'activité enfant renseigne le message d'erreur d'API dans la propriété de sortie ResponseStatus et l'exécution du workflow se poursuit. Vérifiez la propriété ResponseStatus pour confirmer la réussite de l'exécution.

Sortie

• ConnexionMicrosoft Dynamics - Un enregistrement de votre connexion établie que vous pouvez utiliser dans d'autres activités de l'activité Étendue de l'application Microsoft Dynamics ( Microsoft Dynamics Application Scope ) qui sont incluses dans cette activité d'étendue. Saisissez une variable MicrosoftDynamicsConnection . Vous pouvez transmettre cette variable à une activité d'étendue dans un workflow qui provient 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.
  • Lorsque les workflows s'exécutent, l'activité d'étendue parente transmet la variableMicrosoftDynamicsConnection à la propriété ExistingMicrosoftDynamicsConnection dans les deuxième et troisième workflows (voir l'image ci-dessous).
    
    

    

    
    

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.