À propos du package d’activités Salesforce

Le pack UiPath.Salesforce.Activities vous permet d'automatiser les processus Salesforce. Il peut se connecter à une organisation Salesforce via Salesforce Application Scope et, parallèlement au reste des activités, vous permettre d'effectuer des Actions telles que la manipulation de fichiers, la manipulation d'enregistrements, l'exécution de rapports et l'exécution de commandes SOQL.

Une fois établie, la connexion à l'organisation Salesforce peut être stockée dans un objet IConnectionService et facilement réutilisée dans toutes les activités Scope enfants ultérieures. Les informations d'identification de la connexion sont chiffrées à l'aide de l'API Microsoft .NET Data Protection (DPAPI) et ne sont accessibles que par le même utilisateur et sur la même machine sur laquelle elles ont été saisies.

Prérequis

Un compte Salesforce ainsi qu'une application connectée Salesforce sont tous deux requis pour utiliser les activités Salesforce. Vous pouvez les obtenir auprès de votre administrateur Salesforce.

Les développeurs RPA peuvent également utiliser un compte de développeur Salesforce pour automatiser les processus dans Salesforce.

Objet SalesforceStatus

Toutes les activités qui effectuent la manipulation de données dans Salesforce renvoient un type de données propriétaire, appelé SalesforceStatus. Cet objet contient des détails sur le statut d'exécution de chaque activité en interaction avec Salesforce. L'objet est structuré pour contenir les propriétés suivantes :

• Réussite (Success) : indique si l'action a réussi ou si une erreur a été générée.
• Code d'erreur : si une erreur est générée lors de l'exécution, renvoie le code d'erreur de Salesforce.
• Message : si une erreur est générée lors de l'exécution, renvoie le message d'erreur de Salesforce.

Assistant d'objet Salesforce

Les activités Obtenir l'enregistrement ( Get Record), Insérer l'enregistrement ( Insert Record) et Mettre à jour l'enregistrement ( Update Record ) peuvent être configurées à l'aide de l'assistant Objet Salesforce . Un clic sur le bouton Configurer (Configure) présent dans le corps des activités ouvre cette fenêtre.

Le menu déroulant Objet Salesforce vous permet de sélectionner l'objet avec lequel vous souhaitez interagir, en affichant tous ses détails. Le premier enregistrement de cet objet est également récupéré en tant qu'enregistrement échantillon. La colonne Exemple de valeur (Sample Value) affiche la valeur du champ pour cet enregistrement.

Remarque : lorsqu'un objet Salesforce est sélectionné, la liste des champs est renseignée avec la liste des champs marqués comme obligatoires dans toutes les mises en page de l'objet dans Salesforce. En raison de la limitation des détails de configuration disponibles dans Salesforce, il peut y avoir davantage de champs obligatoires, mais qui ne sont pas ajoutés par défaut. Utilisez Tester avec des exemples de valeurs pour tester l’activité.

En utilisant la zone de texte Ajouter un seul champ (Add Single Field) , vous pouvez ajouter des champs à l'objet sélectionné. Le bouton Ajouter plusieurs champs ( Add Multiple Fields) ouvre une section différente de l'assistant, qui vous permet de choisir plusieurs champs à ajouter à l'objet. Pour ce faire, cochez les cases de tous les champs que vous souhaitez ajouter et cliquez sur Terminé ( Done).

Remarque : dans l'activité Insérer un enregistrement ( Insert Record ), seuls les champs identifiés comme pouvant être créés par l' API Salesforce Lightning sont disponibles. Dans l'activité Mettre à jour l'enregistrement ( Update Record ), seuls les champs identifiés comme pouvant être mis à jour sont disponibles.

Cliquez à nouveau sur Terminé pour enregistrer les modifications que vous avez apportées à l’activité en cours de configuration.

Les activités Insérer un enregistrement ( Insert Record) et Mettre à jour l'enregistrement ( Update Record ) offrent également la possibilité de tester l'opération avec des exemples de valeurs. Pour ce faire, cliquez sur le bouton Tester avec des valeurs d'échantillon (Test with sample values). Cela exécute les opérations avec les valeurs de la colonne Exemple de valeur et signale les réussites ou les erreurs.

Champs d'objet Salesforce et type de données

Dans les activités Obtenir l'enregistrement ( Get Record), Insérer l'enregistrement ( Insert Record) et Mettre à jour l'enregistrement ( Update Record ), toutes les valeurs de champ sont transmises comme String.

Pour les champs avec le type de données Picklist , la chaîne transmise doit être la valeur valide et non le libellé tel qu'il apparaît dans l'application. Utilisez l’activité Format Labels And Values pour configurer correctement la chaîne.

Pour les champs avec le type de données Multiplicklist , la chaîne transmise doit être une liste de valeurs valides séparées par des points-virgules, et non les libellés comme indiqué dans l'application. Utilisez l’activité Format Labels And Values pour configurer correctement la chaîne.

Pour les champs avec le type de données Boolean , la chaîne transmise doit être true ou false. Notez que lorsque Salesforce renvoie ces valeurs dans l'activité Obtenir l'enregistrement ( Get Record ), les valeurs affichées dans la colonne Valeur d'échantillon (Example Value) peuvent être l'une des valeurs suivantes : True, true, Falseou false, selon la façon dont les données ont été saisies à l'origine dans Salesforce.

Pour les champs avec le type de données Date , la chaîne transmise doit être au format YYYY-MM-DD.

Fonctions d'extension Salesforce

Nous avons implémenté deux nouvelles fonctions livrées avec le pack d'activités Salesforce , qui vous aident à mieux automatiser les processus dans Salesforce :

Formater en tant que booléen

UiPath.Salesforce.Utilities.UtilityFunctionExtension

String SalesforceFormatAsBoolean(String Value)

La saisie d'une valeur de type booléen qui n'est pas dans le format pris en charge par Salesforce génère une erreur au moment de l'exécution. La fonction SalesforceFormatAsBoolean vous permet de convertir n'importe quel type de valeur booléenne dans une chaîne au format pris en charge par Salesforce.

Valeurs prises en charge

Pour True, les valeurs suivantes sont convertibles : 1, x, t, true, yes, y.

Pour False, les valeurs suivantes sont convertibles : 0, null, f, false, no, n.

Remarque : toutes les valeurs mentionnées ci-dessus sont insensibles à la casse (ce qui signifie qu'elles sont identifiées, qu'elles soient en majuscules ou non) et sont reconnues à partir de n'importe quel alphabet disponible.

Échapper au terme de recherche

UiPath.Salesforce.Utilities.UtilityFunctionExtension

String SalesforceEscapeSearchTerm(String SearchTerm, Boolean IsLike = true)

Cette fonction échappe aux termes de recherche qui peuvent être utilisés dans la propriété CommandeSOQL de l'activité Exécuter SOQL , comme requis par Salesforce. Pour plus d’informations sur l’échappement de chaîne entre guillemets, cliquez ici.