Modules Salesforce
Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent Salesforce et le connecter à plusieurs applications et services tiers.
Pour obtenir une vidéo d’introduction au connecteur Salesforce, voir :
Pour obtenir des instructions sur la création d’un scénario, consultez les articles sous Créer des scénarios : index d’article.
Pour plus d’informations sur les modules, consultez les articles sous Modules : index des articles.
NOTE- Toutes les éditions de Salesforce ne disposent pas d’un accès à l’API. Pour plus d’informations, voir les informations sur les éditions Salesforce avec un accès à l’API sur le site de la communauté Salesforce.
- Pour plus d’informations sur les erreurs spécifiques renvoyées par l’API Salesforce, voir la documentation sur l’API Salesforce. Vous pouvez également vérifier le statut de l’API Salesforce pour toutes les pannes de service possibles.
Conditions d’accès
Développez pour afficher les exigences d’accès aux fonctionnalités de cet article.
Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :
| Package Adobe Workfront | Tous |
| Licence Adobe Workfront |
Nouveau : Standard Ou En cours : Travail ou version ultérieure |
| Licence Adobe Workfront Fusion ** |
Actuel : aucune exigence de licence Workfront Fusion Ou Hérité : Workfront Fusion pour l’automatisation et l’intégration du travail |
| Produit |
Nouveau :
Ou Actuel : votre entreprise doit acheter Adobe Workfront Fusion. |
Pour plus d’informations sur les informations contenues dans ce tableau, voir Conditions d’accès requises dans la documentation.
Pour plus d’informations sur les licences Adobe Workfront Fusion, voir Licences Adobe Workfront Fusion.
Conditions préalables
Pour utiliser les modules Salesforce, vous devez disposer d’un compte Salesforce.
Informations sur l’API Salesforce
Le connecteur Salesforce utilise les éléments suivants :
| URL de base | {{connection.instanceUrl}} |
| Version de l’API | v62.0 |
| Balise API | v1.15.14 |
À propos de la recherche d’objets Salesforce
Lors de la recherche d’objets, vous pouvez saisir des termes de recherche individuels ou créer une requête plus complexe à l’aide de caractères génériques et d’opérateurs :
- Utilisez le caractère joker astérisque (*) pour remplacer zéro ou plusieurs caractères. Par exemple, une recherche de Ca* renvoie des éléments qui commencent par Ca.
- Utilisez un caractère joker point d’interrogation (?) pour remplacer un seul caractère. Par exemple, une recherche de Jo?n renvoie des éléments avec le terme John ou Joan mais pas Jon.
- Utilisez l’opérateur guillemets (" ") pour trouver une correspondance exacte. Par exemple : "réunion de lundi"
Pour plus d’informations sur les possibilités de recherche, voir la documentation Salesforce destinée à l’équipe de développement sur SOQL et SOSL.
Créer une connexion à Salesforce
Pour créer une connexion pour vos modules Salesforce, procédez comme suit :
-
Dans un module Salesforce, cliquez sur Ajouter en regard de la zone Connexion.
-
Remplissez les champs suivants :
Connection nameSaisissez un nom pour la nouvelle connexion.EnvironmentIndiquez si vous vous connectez à un environnement de production ou hors production.TypeIndiquez si vous vous connectez à un compte de service ou à un compte personnel.Client IDSaisissez votre identifiant client Salesforce.Client SecretSaisissez votre secret client Salesforce.SandboxActivez cette option s’il s’agit d’un environnement Sandbox.API VersionSaisissez la version de l’API Salesforce que vous souhaitez utiliser. La version par défaut est 62.0. -
Cliquez sur Continuer pour enregistrer la connexion et revenir au module.
Modules Salesforce et leurs champs
Déclencheurs
Surveiller un champ
Ce module de déclenchement lance un scénario lorsqu’un champ est mis à jour dans Salesforce.
Surveiller des enregistrements
Ce module de déclenchement exécute un scénario lorsqu’un enregistrement d’un objet est créé ou mis à jour. Le module renvoie tous les champs standard associés à l’enregistrement ou aux enregistrements, ainsi que les champs et valeurs personnalisés auxquels la connexion a accès. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Surveiller des messages sortants
Ce module de déclenchement exécute un scénario lorsqu’une personne envoie un message. Le module renvoie tous les champs standard associés à l’enregistrement ou aux enregistrements, ainsi que les champs et valeurs personnalisés auxquels la connexion a accès. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Ce module nécessite une configuration supplémentaire. Un flux doit être configuré pour les messages sortants.
- Pour obtenir des instructions sur les flux dans Salesforce, voir Automatiser les tâches avec des flux dans la documentation de Salesforce.
- Pour plus d’informations sur la configuration d’un message sortant dans Salesforce, voir Envoyer un message sortant à partir de votre flux déclenché par enregistrementdans la documentation de Salesforce
Lorsque vous configurez ce module, les champs suivants s’affichent.
Sélectionnez le webhook que vous souhaitez utiliser pour surveiller les messages sortants. Pour ajouter un webhook, cliquez sur Add et saisissez le nom et la connexion du webhook.
Pour savoir comment connecter votre compte Salesforce à Workfront Fusion, voir Créer une connexion à Adobe Workfront Fusion - Instructions de base.
Actions
Créer un enregistrement
Ce module d’action crée un nouvel enregistrement dans un objet.
Le module vous permet de sélectionner les champs de l’objet disponibles dans le module. Cela réduit le nombre de champs à parcourir lors de la configuration du module.
Le module renvoie l’identifiant de l’enregistrement et de tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion a accès. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Sélectionnez les champs que vous souhaitez que le module configure lors de la création du nouvel enregistrement. Les champs obligatoires figurent en tête de liste.
Les champs sélectionnés s’ouvrent sous ce champ. Vous pouvez maintenant saisir des valeurs dans ces champs.
Appel API personnalisé
Ce module d’action vous permet d’effectuer un appel personnalisé et authentifié à l’API Salesforce. De cette façon, vous pouvez créer une automatisation du flux de données qui ne peut pas être réalisée par les autres modules Salesforce.
Le module renvoie les éléments suivants :
-
Code d’état (nombre) : indique la réussite ou l’échec de votre requête HTTP. Ce sont des codes standard que vous pouvez consulter sur Internet.
-
En-têtes (objet) : contexte plus détaillé pour le code de réponse/d’état qui ne se rapporte pas au corps de sortie. Tous les en-têtes qui apparaissent dans un en-tête de réponse ne sont pas des en-têtes de réponse. Certains peuvent donc ne pas vous être utiles.
Les en-têtes de réponse dépendent de la requête HTTP que vous avez choisie lors de la configuration du module.
-
Corps (objet) : selon la requête HTTP que vous avez choisie lors de la configuration du module, vous pouvez recevoir des données en retour. Ces données, telles que les données d’une requête GET, sont contenues dans cet objet.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Saisissez un chemin relatif à <Instance URL>/services/data/v62.0/.
Pour obtenir la liste des points d’entrée disponibles, reportez-vous à la section Guide pour l’équipe de développement de l’API REST Salesforce.
{"Content-type":"application/json"}. Workfront Fusion ajoute les en-têtes d’autorisation pour vous.{"name":"something-urgent"}Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard.
Note :
Lorsque vous utilisez des instructions conditionnelles telles que if dans votre JSON, mettez les guillemets à l’extérieur de l’instruction conditionnelle.
Exemple : l’appel API suivant renvoie la liste des utilisateurs et utilisatrices de votre compte Salesforce :
-
URL :
query -
Méthode : GET
-
Chaîne de requête :
-
Clé :
q -
Valeur :
SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10
Les correspondances de la recherche se trouvent dans la sortie du module sous Bundle > Corps > Enregistrements.
Dans notre exemple, 6 utilisateurs ou utilisatrices ont été renvoyés :
Supprimer un enregistrement
Ce module d’action supprime un enregistrement existant dans un objet.
Vous indiquez l’ID de l’enregistrement.
Le module renvoie l’ID de l’enregistrement et tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Saisissez ou mappez l’identifiant Salesforce unique de l’enregistrement que vous souhaitez que le module supprime.
Pour obtenir l’identifiant, ouvrez l’objet Salesforce dans votre navigateur et copiez le texte à la fin de l’URL après la dernière barre oblique (/). Par exemple : https://eu5.salesforce.com/<object ID>
Télécharger la pièce jointe/le document
Ce module d’action permet de télécharger un document ou une pièce jointe à partir d’un enregistrement.
Indiquez l’ID de l’enregistrement et le type de téléchargement souhaité.
Le module renvoie l’ID de la pièce jointe ou du document et tous les champs associés, ainsi que tous les champs et valeurs personnalisés auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Indiquez le type de fichier que vous souhaitez télécharger à partir de Salesforce.
- Attachment
- Document
- ContentDocument (Il s’agit d’un document qui a été chargé dans une bibliothèque de Saleforce CRM Content ou Salesforce Files).
ID /
Attachment ID /
ContentDocument ID
Saisissez ou mappez l’ID Salesforce unique de l’enregistrement que le module doit télécharger.
Pour obtenir l’ID, ouvrez l’objet Salesforce dans votre navigateur et copiez le texte à la fin de l’URL après la dernière barre oblique (/). Par exemple : https://eu5.salesforce.com/<object ID>
Lire un enregistrement
Ce module d’action lit les données d’un seul objet dans Salesforce.
Vous indiquez l’ID de l’enregistrement.
Le module renvoie l’identifiant de l’enregistrement et de tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion a accès. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Saisissez ou mappez l’identifiant Salesforce unique de l’enregistrement que vous souhaitez que le module lise.
Pour obtenir l’identifiant, ouvrez l’objet Salesforce dans votre navigateur et copiez le texte à la fin de l’URL après la dernière barre oblique (/). Par exemple : https://eu5.salesforce.com/<object ID>
Mettre à jour un enregistrement
Ce module d’action modifie un enregistrement dans un objet.
Le module vous permet de sélectionner les champs de l’objet disponibles dans le module. Cela réduit le nombre de champs à parcourir lors de la configuration du module.
Le module renvoie l’ID de l’enregistrement et tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Sélectionnez les champs que vous souhaitez que le module configure lors de la création du nouvel enregistrement. Les champs obligatoires figurent en tête de liste.
Les champs sélectionnés s’ouvrent sous ce champ. Vous pouvez maintenant saisir des valeurs dans ces champs.
Charger la pièce jointe/le document
Ce module d’action charge un fichier et le joint à un enregistrement spécifié, ou charge un document.
Le module renvoie l’ID de la pièce jointe ou du document et tous les champs associés, ainsi que tous les champs et valeurs personnalisés auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Charger fichier
Ce module d’action charge un seul fichier dans Salesforce.
Si vous utilisez la liaison de documents, sélectionnez les autorisations pour le fichier.
-
Autorisation Observateur
L’utilisateur peut afficher le fichier.
-
Autorisation Collaborateur
L’utilisateur peut afficher et modifier le fichier.
-
Autorisations déduites
Les autorisations sont basées sur les autorisations de l’utilisateur sur l’enregistrement associé, comme une bibliothèque.
Si vous utilisez la liaison de documents, saisissez ou mappez la visibilité du document.
-
AllUsers
Disponible pour tous les utilisateurs disposant d’autorisations
-
InternalUsers
Disponible pour les utilisateurs internes disposant d’autorisations.
-
SharedUsers
Disponible pour les utilisateurs et utilisatrices qui peuvent voir le flux sur lequel le fichier est publié.
Recherches
Rechercher
Ce module d’action permet de récupérer tous les enregistrements répondant à un critère donné.
Recherche avec requête
Ce module de recherche permet de rechercher les enregistrements d’un objet dans Salesforce qui correspondent à la requête de recherche que vous avez spécifiée. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.
Lorsque vous configurez ce module, les champs suivants s’affichent.
Sélectionnez le type de recherche que vous souhaitez que le module effectue :
-
Simple
-
Using SOSL (Salesforce Object Search Language)
-
Using SOQL (Salesforce Object Query Language)
Saisissez la requête par laquelle vous souhaitez effectuer la recherche.
Pour plus d’informations sur SOSL, consultez la section Salesforce Object Search Language (SOSL) dans la documentation Salesforce.
Pour plus d’informations sur SOQL, consultez la section Salesforce Object Query Language (SOQL) dans la documentation Salesforce.
Note : la valeur du paramètre RETURNING influence la sortie du module. Si vous utilisez LIMIT, Fusion ignorera les paramètres du champ Maximal count of records. Si vous ne définissez aucune limite, Fusion insérera la valeur LIMIT = Maximal count of records.