Modules Salesforce
Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent Salesforce et les connecter à plusieurs applications et services tiers.
Pour une vidéo d’introduction au connecteur Salesforce, voir :
Si vous avez besoin d’instructions sur la création d’un scénario, voir Créer un scénario dans Adobe Workfront Fusion.
Pour plus d’informations sur les modules, consultez Modules dans Adobe Workfront Fusion.
- Toutes les éditions de Salesforce n’ont pas accès à l’API. Pour plus d’informations, consultez les informations sur les éditions Salesforce avec 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, consultez la documentation de l’API Salesforce. Vous pouvez également vérifier l’état de l’API Salesforce pour toute interruption de service possible.
Conditions d’accès
Pour utiliser les fonctionnalités décrites dans cet article, vous devez disposer des éléments suivants :
Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez vote administrateur ou administratrice Workfront.
Pour plus d’informations sur les licences Adobe Workfront Fusion, consultez les Adobe Workfront Fusion licences.
Conditions préalables
Pour utiliser des modules Salesforce, vous devez disposer d’un compte Salesforce.
À propos de la recherche d’objets Salesforce
Lors de la recherche d’objets, vous pouvez saisir des mots 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 générique astérisque (*) comme substitut à zéro ou plusieurs caractères. Par exemple, une recherche de Ca* trouve des éléments qui commencent par Ca
- Utiliser un caractère générique de point d’interrogation (?) comme substitut à un seul caractère. Par exemple, une recherche sur Jo?n recherche des éléments avec le terme John ou Joan mais pas Jon.
- Utilisez l’opérateur de guillemets ("") pour trouver une correspondance exacte avec l’expression. Par exemple : "réunion du lundi"
Pour plus d’informations sur les possibilités de recherche, consultez la documentation destinée aux développeurs Salesforce sur SOQL et SOSL.
Modules Salesforce et leurs champs
Déclencheurs
Surveiller les 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 mapper ces informations dans les modules suivants du scénario.
Lors de la configuration de ce module, les champs suivants s’affichent.
Regarder les 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 mapper ces informations dans les modules suivants du scénario.
Ce module nécessite une configuration supplémentaire :
-
Accédez à la page de configuration Salesforce.
Pour accéder à la page de configuration, recherchez et cliquez sur le bouton intitulé "Setup" dans le coin supérieur droit du compte Salesforce. Sur la page de configuration de Salesforce, recherchez la barre "Recherche/recherche rapide" sur la gauche. Recherchez "Règles de workflow".
-
Cliquez sur Règles de workflow.
-
Sur la page Règles de workflow qui s’affiche, cliquez sur Nouvelle règle et sélectionnez le type d’objet auquel la règle s’appliquera (par exemple "Opportunity" si vous surveillez les mises à jour des enregistrements d’opportunité).
-
Cliquez sur Suivant.
-
Définissez un nom de règle, des critères d’évaluation et des critères de règle, puis cliquez sur Enregistrer et Suivant.
-
Cliquez sur Terminé.
-
Dans la règle Workflow nouvellement créée, cliquez sur Modifier.
-
Dans la liste déroulante Ajouter une action de workflow , sélectionnez Nouveau message sortant.
-
Indiquez le nom, la description, l’URL du point d’entrée et les champs que vous souhaitez inclure dans le nouveau message sortant, puis cliquez sur Enregistrer.
Le champ URL du point d’entrée contient l’URL fournie sur le Salesforce Workfront Fusion.
-
Configurez un scénario commençant par l’événement Message sortant.
-
Cliquez sur l’icône </> en bas à droite et copiez l’URL fournie.
-
Revenez à la page Règles de workflow, recherchez la règle nouvellement créée, puis cliquez sur Activer.
Lors de la configuration de ce module, les champs suivants s’affichent.
Afficher un champ
Ce module de déclenchement lance un scénario lorsqu’un champ est mis à jour dans Salesforce.
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 que vous devez 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 mapper ces informations dans les modules suivants du scénario.
Lors de la configuration de ce module, les champs suivants s’affichent.
Lire un enregistrement
Ce module d’action lit les données d’un seul objet dans Salesforce.
Vous spécifiez l’identifiant 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 mapper ces informations dans les modules suivants du scénario.
Lors de la configuration de ce module, les champs suivants s’affichent.
Supprimer un enregistrement
Ce module d’action supprime un enregistrement existant dans un objet.
Vous spécifiez l’identifiant 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 mapper ces informations dans les modules suivants du scénario.
Lors de la configuration de ce module, les champs suivants s’affichent.
Appel API personnalisé
Ce module d’action vous permet d’effectuer un appel authentifié personnalisé à l’API Salesforce. Ainsi, 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.
Lors de la configuration de ce module, les champs suivants s’affichent.
Sélectionnez la méthode de requête HTTP dont vous avez besoin pour configurer l’appel API. Pour plus d’informations, voir Méthodes de requête HTTP dans Adobe Workfront Fusion.
Saisissez un chemin relatif à <Instance URL>/services/data/v46.0/.
Pour obtenir la liste des points de terminaison disponibles, reportez-vous au Guide du développeur de l’API REST Salesforce.
{"Content-type":"application/json"}. Workfront Fusion ajoute les en-têtes d’autorisation à votre place.{"name":"something-urgent"}Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard.
Remarque :
lors de l’utilisation d’instructions conditionnelles telles que if dans votre JSON, placez les guillemets en dehors de l’instruction conditionnelle.
-
URL :
query -
Méthode : GET
-
Chaîne de requête :
-
Clé :
q -
Valeur :
SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10
Télécharger la pièce jointe/le document
Ce module d’action télécharge un fichier et l’associe à un enregistrement que vous spécifiez ou charge un document.
Le module renvoie l’identifiant de la pièce jointe ou du document et de tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion a accès. Vous pouvez mapper ces informations dans les modules suivants du scénario.
Lors de la configuration de ce module, les champs suivants s’affichent.
Télécharger la pièce jointe/le document
Ce module d’action télécharge un document ou une pièce jointe à partir d’un enregistrement.
Vous indiquez l’identifiant de l’enregistrement et le type de téléchargement souhaité.
Le module renvoie l’identifiant de la pièce jointe ou du document et de tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion a accès. Vous pouvez mapper ces informations dans les modules suivants du scénario.
Lors de la configuration de ce module, les champs suivants s’affichent.
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 que vous devez 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 mapper ces informations dans les modules suivants du scénario.
Lors de la configuration de ce module, les champs suivants s’affichent.
Recherches
Recherche avec requête
Ce module de recherche recherche recherche des enregistrements dans un objet de Salesforce correspondant à la requête de recherche que vous spécifiez. Vous pouvez mapper ces informations dans les modules suivants du scénario.
Lors de la configuration de ce module, les champs suivants s’affichent.
Rechercher
Ce module d'action récupère tous les enregistrements répondant à un critère donné.