Configuration

Introduction

Pour établir avec succès une connexion et envoyer des requêtes à l'API Web, l'activité Étendue de l'application Microsoft Dynamics ( Microsoft Dynamics Application Scope ) doit terminer l'authentification à l'aide du protocole OAuth 2.0 .

Pour donner à l'activité Étendue Microsoft Dynamics 365 la possibilité de s'authentifier à l'aide d'OAuth 2.0 et pour permettre aux autres activités d'envoyer avec succès des requêtes à l'API Web, vous devez effectuer les étapes suivantes :

1. Enregistrez votre application.
2. Créer une clé secrète de client.
3. Créer une ressource d’informations d’identification.

4. Créez votre projet.

   
   

   

   
   
   Remarque :

   Les activités Microsoft Dynamics 365 dépendent du [Common Data Service])(https://docs.microsoft.com/en-us/dynamics365/human-resources/hr-admin-integration-choose-technology#common-data -service-entities). En raison de cette dépendance, les activités prennent principalement en charge les solutions Customer Engagement .

   Actuellement, Microsoft Dynamics for Finance & Operations n'est pas pris en charge.

Étapes

1. Enregistrez votre application

Suivez les instructions spécifiques de Common Data Service dans la documentation Microsoft pour créer un enregistrement d'application (ces étapes incluent l'attribution des autorisations API appropriées).

Pour plus d'informations sur l'enregistrement de l'application pour Common Data Service, consultez Utiliser OAuth avec Common Data Service dans la documentation Microsoft.

Lors de l'enregistrement de votre application, prenez note des valeurs ID de l' application (client) et ID de l' annuaire (locataire) ; vous les saisirez dans l'activité Étendue de l'application Microsoft Dynamics .

2. Créer une clé secrète client

Remarque : Cette étape n'est applicable que si vous prévoyez d' utiliser InformationsClientClient comme TypeAuthentification dans l'activité. Si vous prévoyez d'utiliser les Informations d'identification du mot de passe ( PasswordCredentials), vous pouvez passer à Générer votre projet (Build your project).

Suivez les instructions de la documentation Microsoft pour configurer votre application enregistrée afin qu'elle se connecte en tant qu'application (c'est-à-dire se connecter à l'aide d'une clé secrète client). Pour plus d'informations sur les clés secrètes du client, consultez Utiliser les clés secrètes et les certificats client ( Use Client Secrets & Certificates) dans la documentation Microsoft.

Pour référence rapide, l'image ci-dessous montre comment nous avons créé notre clé secrète client pour nos exemples de projets.

3. Créer un utilisateur d'application

Connectez-vous à votre compte Microsoft Dynamics 365 Customer Engagement. Accédez à Paramètres > Sécurité > Utilisateurs (Users) > Nouvel utilisateur (New User).

Modifiez la vue en Utilisateur de l'application. Saisissez l' ID d'application de l'étape précédente dans le champ ID d'application ( Application ID ).

Remplissez les autres champs tels que (Nom complet) et ( E-mail principal), puis enregistrez l'utilisateur.

4. Créer une ressource d'identifiant

Remarque : cette étape n'est applicable que si vous prévoyez d'utiliser InformationsClientCredentials comme TypeAuthentification dans l' activité Microsoft Dynamics Application Scope . Si vous prévoyez d'utiliser les Informations d'identification du mot de passe ( PasswordCredentials), vous pouvez passer à Générer votre projet (Build your project).

L'activité Étendue de l'application Microsoft Dynamics requiert une entrée SecureString pour la propriété SecretClient . Pour saisir la variable SecureString , il est recommandé de suivre les suggestions et les étapes de la section de ce guide.

5. Construisez votre projet

1. Créez un nouveau projet d'automatisation.

   1. Ouvrez UiPath Studio.
   2. Sous Nouveau projet, cliquez sur Traiter (cela ouvre une fenêtre Nouveau processus vide ).
   3. Saisissez un nomde projet , un emplacementet une description.
   4. Cliquez sur Créer (Create).

2. Installez le package UiPath.MicrosoftDynamics.Activities .

   1. Dans le ruban Conception (Design), cliquez sur Gérer les packages ( Manage Packages ) (cela ouvre la fenêtre Gérer les packages ).
   2. Sous Tous les packages, cliquez sur Officiel !
   3. Dans la barre de recherche , entrez Dynamiques.

   4. Cliquez sur, installez et acceptez la licence pour UiPath.MicrosoftDynamics.Activities.

      • Pour plus d'informations sur les packages Uipath Studio, consultez Gestion des packages dans le Guide de Studio.

Vous avez terminé !

Maintenant que vous avez terminé la configuration, vous pouvez commencer à ajouter les activités Microsoft Dynamics 365 à votre projet.

Prochaines étapes

Pour une expérience d'apprentissage pratique et pour commencer rapidement à utiliser les activités, consultez le guide de démarrage rapide . Ce guide fournit des instructions étape par étape pour vous aider à créer un exemple pratique des différentes activités afin que vous puissiez vérifier la connexion à votre instance Microsoft Dynamics 365 et vous familiariser avec les propriétés d'entrée/de sortie.

Pour en savoir plus sur les activités Microsoft Dynamics 365 (y compris des exemples d'entrées/sorties de propriétés), consultez la page Activités (Activities) pour obtenir une liste complète des activités et des liens vers les pages de détails des activités.