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 de l’application Microsoft Dynamics).
2. Insère un nouvel enregistrement de compte (Insérer un enregistrement).
3. Recherche l'enregistrement de compte inséré (Search Records).
4. Met à jour le champ du site Web de l’enregistrement du compte (Mettre à jour un enregistrement).
5. Vérifie que l’enregistrement du compte a été mis à jour avec succès (Obtenir l’enregistrement).
6. Supprime l'enregistrement de compte inséré (Delete Record).
   Remarque :

   While there may be more efficient ways of achieving the same result, the goal of this sequence is to demonstrate all of the record activities.

Prérequis

Avant de commencer :

1. Suivez les étapes de Configuration de Microsoft Dynamics 365.
2. Utilisez le gestionnaire de paquets pour installer le paquet Microsoft.Activities.Extensions (il s'agit de l'activité Search Records ).
   Remarque :

   Ce guide utilise ClientCredentials comme TypeAuthentification dans l'activité Étendue d'application Microsoft Dynamics . Si vous préférez utiliser PasswordCredentials, vous pouvez ignorer l'étape 1 (ajouter une activité Obtenir l'information d'identification ) et suivre les sous-étapes à puces à l'étape 2 (ajouter l'activité Étendue d'application Microsoft Dynamics ).

Étapes

Construisez votre projet

1. Ajoutez une activité Obtenir l'identifiant .
2. Enter the AssetName for the credential asset you created (during the Setup) for the application Client Secret (e.g., "MicrosoftDynamics365ClientCredentials").
3. Create and enter a SecureString variable for the Password property (e.g., clientSecret).
4. Create and enter a String variable for the Username property (e.g, clientId).
5. Ajoutez l'activité Étendue d'application Microsoft Dynamics 365 après l'activité Obtenir les informations d'identification .
6. Cliquez sur le bouton Configurer (cela ouvre l' assistant de connexion), sélectionnez votre TypeAuthentification, entrez vos informations d'identification et cliquez sur le bouton Tester la connexion . Pour plus d'informations sur l'objectif et le comportement de cet assistant, consultez cette section.
   • This step is for design time purposes only. To populate the Microsoft Dynamics Application Scope properties, continue to complete the steps below.
7. In the AuthenticationType property, select your preferred authentication type.
   • If you select PasswordCredentials, create a String variable for the ClientId (e.g., Name: clientId Default: "56X9aXXX-b5d9-4a90-XXXX-13XX9643XXXX")
8. In the ClientId property, enter the String variable you created for the Get Credential activity or substep above (e.g., clientId).
9. In the ClientSecret property, enter the SecureString variable you created for the Get Credential activity (e.g., clientSecret).
   • If you selected PasswordCredentials leave the ClientSecret property empty.
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. In the TenantId property, create and enter a String variable for the directory (tenant) ID assigned to your Azure Active Directory (ADD) tenant (e.g., Name: tenantId Default: "d8353d2a-b153-4d17-8827-902cXXXXXXX").

    • Si vous avez sélectionné IdentifiantsMotDePasse, sélectionnez votre préférence d’invite de mot de passe (options).

      

12. Ajoutez l’activité Insérer un enregistrement à l’intérieur de l’activité Étendue d’application Microsoft Dynamics .

    1. Click the Configure button inside the Insert Record activity (this opens the Object Wizard).

       1. In the Select Entity drop-down list, select Account.

       2. In the accountId field, create and enter a String variable (e.g., accountId).

       3. In the Add Single Field textbox, enter name and click enter.

       4. In the name field, enter an account name (e.g., "Quickstart_Account").

       5. Click the Done button.

          

    2. Add an Add to dictionary activity after the Insert Record activity.

    3. In the Dictionary property, create and enter a Dictionary<String,String> variable accordingly: Name: queryOption, Default: new Dictionary(Of String, String) (you may use a different Name value, but the Default value is required).

    4. In the Key property, enter "$filter".

    5. In the Value property, enter "name eq 'Quickstart_Account'" (Quickstart_Account is the name of the account you inserted in the steps above. If you entered a different name, use that value instead).

       • Pour plus d'informations sur les valeurs de requête, consultez les pages relatives aux métadonnées de requête et/ou aux données de requête dans la documentation Microsoft.

    6. Ajoutez l’activité Rechercher des enregistrements après l’activité Ajouter au dictionnaire .

    7. In the Object property, select Account.

    8. In the Query Options property, enter the Dictionary<String,String> variable you created above (e.g., queryOption).

    9. In the Result property, create and enter a DataTable variable (e.g., searchResults).

       

13. Add an Assign activity after the Search Records activity.
    1. In the To property, create and enter a String variable (e.g., webURL).
    2. In the Value property, enter the following: searchResults.Rows(0).Item("websiteurl").ToString.
       • Pour plus d'informations sur les noms de colonnes pour chaque entité, consultez le guide de référence du type d'entité de l'API Web dans la documentation Microsoft.
    3. Add an If activty after the Assign activity.
    4. Créez une String variable avec une valeur par défaut d'une URL (par exemple, Nom: site Web, Par défaut: "www.uipath.com").
    5. In the Condition property, enter the following: webURL = website.
    6. In the Then statement box, add a Write Line activity with the following Text: "Website present".
    7. Dans la zone d'instruction Sinon , ajoutez l'activité Mettre à jour l'enregistrement .
       1. Click the Configure button inside the Update Record activity (this opens the Object Wizard).

          1. In the Select Entity drop-down list, select Account.

          2. In the accountId field, enter the String variable you created for the Insert Record activity (e.g., accountId).

          3. In the Add Single Field textbox, enter websiteurl and click enter.

          4. In the name field, enter the String variable you created in the step above (e.g., website).

          5. Click the Done button.

             

Tester votre projet

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

   1. Click the Configure button inside the Get Record activity (this opens the Object Wizard).
      1. In the Select Entity drop-down list, select Account.
      2. In the accountId field, enter the String variable you created for the Insert Record activity (e.g., accountId).
      3. In the Add Single Field textbox, enter websiteurl and click enter.
      4. In the websiteurl field, create and enter a String variable (e.g., websiteVerification).
      5. Click the Done button.
   2. Add an If activity after the Get Record activity (inside the Else statement box).
   3. In the Condition property, enter the following: website = websiteVerification.
   4. In the Then statement box, add a Write Line activity with the following Text: "Website update succeeded!".
   5. In the Then statement box, add a Write Line activity with the following Text: "Website update failed".

2. Ajoutez l'activité Delete Record en dehors de la première activité If .

   1. In the Object property, select Account.
   2. In the Id field, enter the String variable you created for the Insert Record activity (e.g., accountId).
   3. In the MicrosoftDynamicsStatus property, create and enter a ResponseStatus variable (e.g., responseStatus).

3. Add a Write Line activity after the Delete Record activity.

   1. In the Text property, enter the following: "Record deleted: "+responseStatus.Success.ToString.

4. Click Run and verify the Output window includes the expected write line values.

   

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 pour obtenir une liste complète des activités et des liens vers les pages de détails de l'activité.