Démarrage rapide : Enregistrements

Vue d'ensemble (Overview)

L'objectif de ce guide est de vous aider à créer un exemple de travail qui utilise les activités Microsoft Dynamics 365 suivantes :

• Insert Record
• Rechercher les enregistrements
• Obtenir l'enregistrement
• Delete Record

Cet exemple pratique vous permet de vérifier rapidement la connexion à votre application Microsoft Dynamics 365 et de vous familiariser avec les types de données d'entrée/sortie de l'activité.

Une fois les étapes de ce guide terminées, vous disposerez d'une séquence d'automatisation qui effectuera les opérations suivantes :

1. Établit une connexion à votre application Microsoft Dynamics 365 (Obtenir les informations d’identification et Étendue d'application Microsoft Dynamics).
2. Insère un nouvel enregistrement de compte ( Insérer un enregistrement (Insert Record)).
3. Recherche l'enregistrement de compte inséré ( Rechercher des enregistrements (Search Records) ).
4. Met à jour le champ de site Web de l'enregistrement de compte ( Mettre à jour l'enregistrement (Update Record) ).
5. Vérifie que l'enregistrement de compte a été mis à jour avec succès ( Obtenir l'enregistrement (Get Record) ).

6. Supprime l'enregistrement de compte inséré ( Supprimer l'enregistrement (Delete Record) ).

   Remarque : bien qu'il puisse exister des moyens plus efficaces d'obtenir le même résultat, l'objectif de cette séquence est de démontrer toutes les activités d'enregistrement.

Prérequis

Avant de commencer :

1. Suivez les étapes d' installation de Microsoft Dynamics 365.

2. Utilisez le Gestionnaire de paquets pour installer le paquet Microsoft.Activities.Extensions (c'est pour l'activité Rechercher des enregistrements ).

   Remarque : ce guide utilise InformationsClientCredentials ( ClientCredentials) comme TypeAuthentification dans l'activité Étendue de l'application Microsoft Dynamics ( Microsoft Dynamics Application Scope ). Si vous préférez utiliser PasswordCredentials, vous pouvez ignorer l'étape 1 (ajouter une activité Get Credential ) et suivre les sous-étapes à puces de l'étape 2 (ajouter l'activité Microsoft Dynamics Application Scope ).

Étapes

Construisez votre projet

1. Ajoutez une activité Obtenir l' identifiant (Get Credential ).
2. Saisissez le nom de l' actif pour l'actif d'identification que vous avez créé (pendant la configuration) pour la clé secrète du client de l'application (par exemple, "MicrosoftDynamics365ClientCredentials").
3. Créez et entrez une variable SecureString pour la propriété Mot de passe (par exemple, clientSecret).
4. Créez et entrez une variable String pour la propriété Nom d'utilisateur (par exemple, clientId).
5. Ajoutez l'activité Étendue de l'application Microsoft Dynamics 365 après l'activité Obtenir l' identifiant (Get Credential ).

6. Cliquez sur le bouton Configurer (cela ouvre l ' Assistant de connexion), sélectionnez votre Type d'authentification, entrez vos informations d'identification et cliquez sur le bouton Tester la connexion ( Test Connection) . Pour plus d'informations sur l'objectif et le comportement de cet assistant, consultez la section .

   • Cette étape est uniquement utilisée à des fins de conception. Pour remplir les propriétés Étendue de l'application Microsoft Dynamics , continuez en suivant les étapes ci-dessous.

7. Dans la propriété TypeAuthentification ( AuthenticationType ), sélectionnez votre type d'authentification préféré.

   • Si vous sélectionnez PasswordCredentials, créez une variable String pour ClientId (par exemple, Name: clientId Default: "56X9aXXX-b5d9-4a90-XXXX-13XX9643XXXX")
8. Dans la propriété IDClient , entrez la variable String que vous avez créée pour l'activité ou la sous-étape Get Credential ci-dessus (par exemple, clientId).
9. Dans la propriété SecretClient (ClientSecret), entrez la variable SecureString que vous avez créée pour l'activité Get Credential (par exemple, clientSecret).
   • Si vous avez sélectionné Identifiants Mot de Passe, laissez la propriété SecretClient (ClientSecret ) vide.
10. Dans la propriété EndpointUrl , créez et entrez une variable String avec l'URL de l'instance CRM à laquelle vous souhaitez vous connecter (par exemple, Name: endpointURL Default: "https://uipath.crm4.dynamics.com/" )
11. Dans la propriété TenantId , créez et entrez une variable String pour l'ID de répertoire (locataire) attribué à votre locataire Azure Active Directory (ADD) (par exemple, Name: tenantId Default: "d8353d2a-b153-4d17-8827-902cXXXXXXX") .

    • Si vous avez sélectionné IdentifiantMotDePasse, sélectionnez votre préférence Invite de mot de passe (options).

      
      

      

      
      

12. Ajoutez l’activité Insert Record à l’intérieur de l’activité Microsoft Dynamics Application Scope .

    1. Cliquez sur le bouton Configurer à l'intérieur de l'activité Insérer un enregistrement (cela ouvre l ' Assistant d'objet).

       1. Dans la liste déroulante Sélectionner une entité ( Select Entity ), sélectionnez Account(Compte).
       2. Dans le champ accountId , créez et saisissez une variable String (par exemple, accountId).
       3. Dans la zone de texte Ajouter un seul champ , entrez le nom et cliquez sur Entrée.
       4. Dans le champ Nom , saisissez un nom de compte (par exemple, "Quickstart_Account").

       5. Cliquez sur le bouton Terminé (Terminé).

          
          

          

          
          
    2. Ajoutez une activité Ajouter au dictionnaire après l’activité Insérer un enregistrement .
    3. Dans la propriété Dictionnaire , créez et entrez une variable Dictionary<String,String> en conséquence : Name: optionrequête, Par défaut: new Dictionary(Of String, String) (vous pouvez utiliser une valeur de nom différente, mais la valeur par défaut est requise).
    4. Dans la propriété Clé (Key), entrez "$filter".

    5. Dans la propriété Valeur , entrez « name eq 'Quickstart_Account' » (Quickstart_Account est le nom du compte que vous avez inséré dans les étapes ci-dessus. Si vous avez entré un nom différent, utilisez plutôt cette valeur).

       • Pour plus d'informations sur les valeurs de requête, consultez les pages de métadonnées de requête et/ou de données de requête dans la documentation Microsoft.
    6. Ajoutez l'activité Rechercher les enregistrements après l'activité Ajouter au dictionnaire .
    7. Dans la propriété Objet , sélectionnez Compte.
    8. Dans la propriété Options de requête , entrez la variable Dictionary<String,String> que vous avez créée ci-dessus (par exemple, optionRequête).
    9. Dans la propriété Result (Result), créez et entrez une variable DataTable (par exemple, searchResults).
       
       

       

       
       

13. Ajoutez une activité Assign après l’activité Search Records .

    1. Dans la propriété À (To), créez et entrez une variable String (par exemple, webURL).

    2. Dans la propriété Valeur , entrez les éléments suivants : searchResults.Rows(0).Item("websiteurl").ToString.

       • Pour plus d'informations sur les noms de colonne de chaque entité, consultez la référence Web API EntityType Reference dans la documentation Microsoft.
    3. Ajoutez une activité If après l’activité Assign .
    4. Créez une variable String avec une valeur par défaut d'une URL (par exemple, Name: website, Default: "www.uipath.com").
    5. Dans la propriété Condition (Condition), entrez ce qui suit : webURL = website.
    6. Dans la zone Instruction Then ( Then ), ajoutez une activité Write Line avec le textesuivant : "Website present".

    7. Dans la zone Instruction Sinon ( Else ), ajoutez l'activité Mettre à jour l'enregistrement ( Update Record ).

       1. Cliquez sur le bouton Configurer (Configure) à l'intérieur de l'activité Mettre à jour l'enregistrement ( Update Record ) (cela ouvre l ' Assistant Objet).

          1. Dans la liste déroulante Sélectionner une entité ( Select Entity ), sélectionnez Account(Compte).
          2. Dans le champ accountId , saisissez la variable String que vous avez créée pour l'activité Insérer un enregistrement (par exemple, accountId).
          3. Dans la zone de texte Ajouter un seul champ , entrez websiteurl et cliquez sur Entrée.
          4. Dans le champ Nom , saisissez la variable String que vous avez créée à l'étape ci-dessus (par exemple, site Web).

          5. Cliquez sur le bouton Terminé (Terminé).

             
             

             

             
             

Tester votre projet

1. Ajoutez l'activité Obtenir l'enregistrement ( Get Record ) après l'activité Mettre à jour l'enregistrement ( Update Record ) (à l'intérieur de la zone d'instruction Sinon ( Else )).

   1. Cliquez sur le bouton Configurer à l'intérieur de l'activité Obtenir l'enregistrement (cela ouvre l ' Assistant d'objet).

      1. Dans la liste déroulante Sélectionner une entité ( Select Entity ), sélectionnez Account(Compte).
      2. Dans le champ accountId , saisissez la variable String que vous avez créée pour l'activité Insérer un enregistrement (par exemple, accountId).
      3. Dans la zone de texte Ajouter un seul champ , entrez websiteurl et cliquez sur Entrée.
      4. Dans le champ URL de site Web, créez et saisissez une variable String (par exemple, websiteVerification).
      5. Cliquez sur le bouton Terminé (Terminé).
   2. Ajoutez une activité If après l’activité Get Record (à l’intérieur de la zone d’instruction Else ).
   3. Dans la propriété Condition (Condition), entrez ce qui suit : website = websiteVerification.
   4. Dans la zone Instruction Then ( Then ), ajoutez une activité Write Line avec le textesuivant : « La mise à jour du site Web a réussi !.
   5. Dans la zone Instruction Then ( Then ), ajoutez une activité Write Line avec le textesuivant : « Échec de la mise à jour du site Web ».

2. Ajoutez l'activité Supprimer l' enregistrement (Delete Record ) en dehors de la première activité Si .

   1. Dans la propriété Objet , sélectionnez Compte.
   2. Dans le champ Id (Id), saisissez la variable String que vous avez créée pour l'activité Insérer un enregistrement (par exemple, accountId).
   3. Dans la propriété MicrosoftDynamicsStatus , créez et entrez une variable ResponseStatus (par exemple, responseStatus).

3. Ajoutez une activité Write Line après l’activité Delete Record .

   1. Dans la propriété Texte , entrez ce qui suit : « Enregistrement supprimé : « +responseStatus.Success.ToString.

4. Cliquez sur Exécuter ( Run ) et vérifiez que la fenêtre Sortie (Output) inclut les valeurs de ligne d'écriture attendues.

   
   

   

   
   

Vous avez terminé !

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.