Exemple d'utilisation du package Salesforce et d'une variable d'enregistrement

Créez un robot capable d'interroger les objets Salesforce et d'écrire les données dans un fichier CSV. Le robot fait également appel à une variable d'enregistrement pour récupérer les données des enregistrements individuels extraits de Salesforce.

Prérequis

  • Créez une application connectée dans Salesforce si vous n'en avez pas déjà une.
  • Ce robot utilise la méthode de connexion OAuth de la Control Room. Créez une connexion OAuth de la Control Room avant de commencer à créer le robot. Pour plus d'informations, consultez action Authentification Salesforce.
  • Configurez des échantillons de données sur les opportunités et les comptes dans Salesforce. Si vous ne disposez pas d'échantillons de données, vous pouvez importer dans Salesforce les données des fichiers CSV suivants :
Supposons que l'équipe commerciale d'Acme Solutions Pvt Ltd décide d'automatiser le processus d'obtention de tous les enregistrements d'opportunités dont le statut est défini sur Prospection et de les affecter ensuite aux représentants commerciaux à des fins de suivi. L'équipe crée un robot qui effectue les tâches suivantes :
  • Il récupère toutes les opportunités ayant le statut Prospection de l'objet Opportunité dans Salesforce.
  • Il récupère le nom de compte de l'objet Compte à l'aide de l'identifiant du compte de chaque enregistrement d'opportunité.
  • Il utilise un enregistrement pour capturer des données à partir d'enregistrements d'opportunités individuels.
  • Il sauvegarde les enregistrements dans un fichier CSV, qu'il est possible de traiter ultérieurement en vue d'affecter les représentants commerciaux.
Dans cet exemple de robot, nous utilisons les packages Salesforce, Enregistrement, Boucle et Données de tableau, ainsi que les variables d'enregistrement, pour vous expliquer comment effectuer les tâches d'automatisation suivantes :
  • Interroger un objet Salesforce à l'aide de l'action Exécuter SOQL de Salesforce.
  • Obtenir un enregistrement individuel à partir d'un objet Salesforce à l'aide de l'action Obtenir l'enregistrement de Salesforce.
  • Mettre à jour les variables d'enregistrement et les réinitialiser.
  • Insérer des enregistrements dans une variable de tableau de données.
  • Écrire un tableau de données dans un fichier CSV.

Procédure

  1. Créez un robot.
    1. Dans le panneau de gauche, cliquez sur Automatisation. La liste des robots et des formulaires disponibles s'affiche.
    2. Cliquez sur Créer un nouveau > Robot de tâches.
    3. Dans Nom, saisissez Get Sales Opportunities.
    4. Cliquez sur Créer et modifier.
  2. Authentifiez-vous auprès de Salesforce. Dans le cadre de ce tutoriel, le type d'authentification utilisé est Connexion OAuth de la Control Room. Les instructions relatives à la configuration d'une connexion OAuth ne rentrent pas dans le cadre de ce tutoriel. Si vous ne maîtrisez pas la configuration des connexions OAuth, suivez les instructions de cette page ou utilisez le type d'authentification OAuth 2 - Infos d'identification client et fournissez l'identifiant du client, le secret du client, le nom d'utilisateur Salesforce et le mot de passe dans l'action Authentification Salesforce
    1. Dans le panneau Actions, recherchez l'action Salesforce > Authentification et ajoutez-la à l'Éditeur de robots.
    2. Dans Type d'authentification, sélectionnez Connexion OAuth de la Control Room.
    3. Cliquez sur Choisir et sélectionnez la connexion OAuth que vous avez configurée avec les détails suivants :
      • Type de fournisseur : Salesforce
      • Nom de la connexion : la connexion que vous avez établie.
      • Type de jeton : Partagé.
    4. Dans le champ Version API, saisissez le numéro de version de l'API correspondant à l'application connectée à Salesforce. Par exemple, 50.0.
    5. Conservez la valeur Default dans le champ Nom de session.
    6. Dans Variables mappées, cliquez sur Ajouter le mappage des variables, puis mappez la clé IntanceUrl sur une variable de chaîne nommée InstanceUrl.
  3. Pour vérifier l'existence d'erreurs d'authentification avant d'exécuter d'autres tâches, utilisez les actions Essayer et Capturer.
    1. Dans le panneau Actions, recherchez l'action Gestionnaire d'erreur > Essayer et ajoutez-la à l'Éditeur de robots.
    2. Cliquez sur l'icône du bloc Capturer.
    3. Dans Exception, sélectionnez Gestionnaire d'erreur.
    4. Dans Attribuer le message d'exception à, cliquez sur (x) et créez une variable de chaîne nommée ErrorMessage.
    5. Ajoutez l'action Zone de message dans le bloc Capturer.
    6. Dans Entrer le message à afficher, sélectionnez la variable ErrorMessage et enregistrez les modifications.
  4. Interrogez l'objet d'opportunité Salesforce pour récupérer les enregistrements d'opportunités ayant le statut Prospection.
    1. Dans le panneau Actions, recherchez l'action Salesforce > Exécuter SOQL et ajoutez-la au bloc Essayer.
    2. Dans le champ Requête SOQL à exécuter, saisissez la requête suivante. 
      SELECT Id, Name, AccountId, Amount, CloseDate, StageName, NextStep FROM Opportunity WHERE StageName = 'Prospecting'
    3. Dans Inclure les enregistrements supprimés, cliquez sur Non.
    4. Assurez-vous que la valeur Default est définie dans le champ Nom de session.
    5. Dans Enregistrer le résultat dans une variable, cliquez sur (x) et créez une variable de liste nommée list_records_prospecting.
    6. Enregistrez les modifications.
  5. Parcourez la liste des enregistrements d'opportunités récupérés.
    1. Dans le panneau Actions, recherchez l'action Boucle > Boucle après l'action Exécuter SOQL et ajoutez-la au bloc Essayer.
    2. Dans le champ Itérateur, sélectionnez Pour chaque élément de la liste.
    3. Dans la liste, sélectionnez la variable list_records_prospecting.
    4. Dans Attribuer la valeur actuelle à la variable, cliquez sur (x) pour créer une variable nommée dict_record_opportunity associée au type N'importe lequel.
      Voici un exemple d'enregistrement stocké sous la forme d'un dictionnaire. Le robot récupère uniquement les valeurs des champs Nom, Nom du compte, Montant, Date de clôture, Nom de l'étape et Étape suivante et ne tient pas compte du reste.
      {attributes,com.automationanywhere.botcommand.data.impl.DictionaryValue@5d804b9c},{Id,0065j00001Q2ISAAA3},{Name,Opportunity #1},{AccountId,0015j00001BU2hnAAD},{Amount,2000.0},{CloseDate,2023-10-05},{StageName,Prospecting},{NextStep,Call to Discuss}
    5. Enregistrez les modifications.
  6. Avant de récupérer les valeurs de chaque champ dans un enregistrement, créez deux variables d'enregistrement : une pour stocker les valeurs de chaque enregistrement d'opportunité et une autre pour réinitialiser la première variable d'enregistrement à la fin de chaque itération.
    1. Dans le panneau Variables, cliquez sur Créer la variable.
    2. Dans le champ Type, sélectionnez Enregistrement.
    3. Dans Nom, saisissez out_record_prospecting.
    4. Cliquez sur Créer.
    5. Répétez les étapes a à d pour créer une autre variable d'enregistrement avec les détails suivants :
      Type : Record
      Nom : record_empty
  7. Mettez à jour la variable enregistrement avec le nom de l'opportunité de l'enregistrement actuel.
    1. Dans le panneau Actions, recherchez l'action Enregistrement > Ajouter une colonne et ajoutez-la à l'action Boucle.
    2. Dans le champ Variable d'enregistrement source, sélectionnez out_record_prospecting.
    3. Dans le champ Type de colonne, sélectionnez Chaîne, puis, dans le champ Valeur, saisissez $dict_record_opportunity{Name}$.
    4. Cliquez sur index spécifique et saisissez 0.
    5. Dans Variable d'enregistrement de destination, sélectionnez out_record_prospecting.
    6. Enregistrez les modifications.
  8. Les enregistrements d'opportunités récupérés auprès de Salesforce contiennent uniquement les identifiants des comptes, et non les noms de ces comptes. Récupérez le nom du compte à l'aide de l'identifiant du compte pour chaque enregistrement.
    1. Dans le panneau Actions, recherchez l'action Salesforce > Obtenir l'enregistrement et ajoutez-la à l'action Boucle.
    2. Dans le champ Nom de l'objet, saisissez Account.
    3. Sélectionnez Identifiant d'enregistrement et saisissez $dict_record_opportunity{AccountId}$.
    4. Dans Champs et données, sélectionnez Liste et cliquez sur Ajouter.
    5. Dans Type, sélectionnez Chaîne.
    6. Dans Valeur à 0, saisissez Name.
    7. Assurez-vous que Default est défini comme nom de session Salesforce.
    8. Dans Variables mappées, cliquez sur Ajouter le mappage des variables pour mapper la clé Name sur une variable de chaîne AccountName. L'appel Get record récupère le nom du compte à l'aide du nom de clé et le stocke dans la variable AccountName.
    9. Enregistrez les modifications.
  9. Ajoutez une nouvelle colonne et mettez à jour la variable d'enregistrement avec le nom du compte.
    1. Dans le panneau Actions, recherchez l'action Enregistrement > Ajouter une colonne et ajoutez-la à l'action Boucle.
    2. Dans le champ Variable d'enregistrement source, sélectionnez out_record_prospecting.
    3. Dans le champ Type de colonne, sélectionnez Chaîne, puis, dans le champ Valeur, saisissez $AccountName$.
    4. Cliquez sur index spécifique et saisissez 1.
    5. Dans Variable d'enregistrement de destination, sélectionnez out_record_prospecting.
    6. Enregistrez les modifications.
  10. Ajoutez une nouvelle colonne et mettez à jour la variable d'enregistrement avec le montant.
    1. Dans le panneau Actions, recherchez l'action Enregistrement > Ajouter une colonne et ajoutez-la à l'action Boucle.
    2. Dans le champ Variable d'enregistrement source, sélectionnez out_record_prospecting.
    3. Dans le champ Type de colonne, sélectionnez Chiffre, puis, dans le champ Valeur, saisissez $dict_record_opportunity{Amount}$.
    4. Cliquez sur index spécifique et saisissez 2.
    5. Dans Variable d'enregistrement de destination, sélectionnez out_record_prospecting.
    6. Enregistrez les modifications.
  11. Mettez à jour la variable d'enregistrement avec la date de clôture, le nom de l'étape et l'étape suivante.
    1. Ajoutez l'action Ajouter une colonne à l'action Boucle et saisissez les informations suivantes :
      Champ Valeur
      Variable d'enregistrement source out_record_prospecting
      Type de colonne String
      Valeur $dict_record_opportunity{CloseDate}$
      index spécifique 3
    2. Ajoutez l'action Ajouter une colonne à l'action Boucle et saisissez les informations suivantes :
      Champ Valeur
      Variable d'enregistrement source out_record_prospecting
      Type de colonne String
      Valeur $dict_record_opportunity{StageName}$
      index spécifique 4
    3. Ajoutez l'action Ajouter une colonne à l'action Boucle et saisissez les informations suivantes :
      Champ Valeur
      Variable d'enregistrement source out_record_prospecting
      Type de colonne String
      Valeur $dict_record_opportunity{NextStep}$
      index spécifique 5
    4. Enregistrez les modifications.
  12. Insérez l'enregistrement dans une variable de tableau de données.
    1. Pour garder une trace des itérations et l'utiliser comme numéro d'index de ligne, créez une variable Chiffre nommée counter et définissez la valeur par défaut sur 0.
    2. Dans le panneau Actions, recherchez l'action Données de tableau > Insérer une ligne et ajoutez-la à l'action Boucle.
    3. Dans Nom des données de tableau, cliquez sur (x) et créez une variable de tableau nommée table_records.
    4. Cliquez sur index spécifique et saisissez $counter$.
    5. Dans Nom d'enregistrement de ligne, sélectionnez out_record_prospecting.
    6. Enregistrez les modifications.
  13. Incrémentez la variable counter de 1.
    1. Dans le panneau Actions, recherchez l'action Chiffre > Incrémenter et ajoutez-la à l'action Boucle.
    2. Dans le champ Entrer un nombre, saisissez $counter$.
    3. Dans le champ Entrer une valeur d'incrément, saisissez 1.
    4. Dans le champ Attribuer la sortie à une variable, sélectionnez compteur.
    5. Enregistrez les modifications.
  14. Réinitialisez la variable d'enregistrement out_record_prospecting avant la prochaine itération.
    1. Dans le panneau Actions, recherchez l'action Enregistrement > Attribuer et ajoutez-la à l'action Boucle.
    2. Dans Sélectionner la variable d'enregistrement source, sélectionnez record_empty.
    3. Dans Sélectionner la variable d'enregistrement source, cliquez sur Enregistrement et sélectionnez out_record_prospecting. Dans la mesure où la variable record_empty n'a pas de valeur, la variable out_record_prospecting est réinitialisée.
    4. Enregistrez les modifications.
  15. Écrivez les enregistrements d'opportunités récupérés dans un fichier CSV.
    1. Dans le panneau Actions, recherchez l'action Données de tableau > Écrire dans le fichier et ajoutez-la à l'action Boucle.
    2. Dans Nom du tableau de données, sélectionnez table_records.
    3. Dans Saisir le nom de fichier, indiquez le chemin d'accès au fichier CSV. Par exemple, C:\bots\opportunities.csv.
    4. Sélectionnez Créer les dossiers/fichiers s'ils n'existent pas.
    5. Cliquez sur Écraser un fichier existant.
    6. Enregistrez les modifications et exécutez le robot.