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 :

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, voir Modules dans Adobe Workfront Fusion.

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

Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :

Adobe Workfront formule*
Pro ou version supérieure
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

Exigences de licence actuelles : aucune exigence de licence Workfront Fusion requise.

Ou

Exigences de licence héritées : Workfront Fusion for Work Automation and Integration

Produit

Conditions requises du produit actuel : si vous disposez de la formule Adobe Workfront Select ou Prime, votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article. Workfront Fusion est inclus dans la formule Workfront Ultimate.

Ou

Exigences liées aux produits hérités : votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article.

Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez votre équipe d’administration Workfront.

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.

À 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.

Modules Salesforce et leurs champs

Déclencheurs

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.

Connection
Pour plus d'informations sur la connexion de votre compte Salesforce à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Type
Sélectionnez le type d’enregistrement Salesforce que le module doit surveiller.
Record Fields
Sélectionnez les champs que le module doit surveiller. Les champs disponibles dépendent du type d’enregistrement.
Maximal count of records.
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.
Watch
Déterminez si vous souhaitez que le scénario ne surveille que les nouveaux enregistrements du type que vous avez sélectionné ou les nouveaux enregistrements du type que vous avez sélectionné, ainsi que toutes les autres modifications apportées aux enregistrements de ce type.

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 :

  1. Accédez à la page de configuration de Salesforce.

    Pour accéder à la page de configuration, recherchez le bouton intitulé « Configuration » dans le coin supérieur droit du compte Salesforce et cliquez dessus. Dans la page de configuration de Salesforce, recherchez la barre de « Recherche rapide/Recherche » située à gauche. Recherchez « Règles de workflow ».

  2. Cliquez sur Règles de workflow.

  3. Dans 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, « Opportunité » si vous surveillez les mises à jour des enregistrements d’opportunité).

  4. Cliquez sur Suivant.

  5. 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.

  6. Cliquez sur Terminé.

  7. Dans la règle de workflow nouvellement créée, cliquez sur Modifier.

  8. Dans la liste déroulante Ajouter une action de workflow, sélectionnez Nouveau message sortant.

  9. 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 indiquée sur le Message sortant Salesforce dans Workfront Fusion.

  10. Configurez un scénario commençant par l’événement Message sortant.

  11. Cliquez sur l’icône </> en bas à droite et copiez l’URL fournie.

  12. Revenez à la page Règles de workflow, recherchez la règle nouvellement créée, puis cliquez sur Activer.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Webhook

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.

Record Type
Sélectionnez le type d’enregistrement Salesforce que le module doit surveiller pour les messages sortants.
Fields
Sélectionnez les champs que le module doit surveiller pour les messages sortants. Les champs disponibles dépendent du type d’enregistrement.

Surveiller un champ

Ce module de déclenchement lance un scénario lorsqu’un champ est mis à jour dans Salesforce.

Connection
Pour plus d'informations sur la connexion de votre compte Salesforce à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Record Type
Sélectionnez le type d’enregistrement qui contient le champ que le module doit surveiller. Vous devez choisir un type d’enregistrement pour lequel Field History est activé dans la configuration de Salesforce. Pour plus d’informations, consultez la section Suivi de l’historique des champs dans la documentation Salesforce.
Field
Sélectionnez les champs que vous souhaitez que le module surveille pour détecter les changements.
Limit
Saisissez ou mappez le nombre maximal de champs que le module doit renvoyer pour chaque cycle d’exécution de scénario.

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’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.

Connection
Pour plus d'informations sur la connexion de votre compte Salesforce à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Record Type
Sélectionnez le type d’enregistrement Salesforce que vous souhaitez que le module crée. Les champs deviennent disponibles en fonction du type d’enregistrement sélectionné dans le champ Record Type. Ces champs reposent sur l’API Salesforce.
Select fields to map

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.

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.

Connection
Pour plus d'informations sur la connexion de votre compte Salesforce à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Record Type
Sélectionnez le type d’enregistrement Salesforce que vous souhaitez que le module [action].read.
Record Fields
Sélectionnez les champs que le module doit lire. Vous devez sélectionner au moins un champ.
ID

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>

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.

Connection
Pour plus d'informations sur la connexion de votre compte Salesforce à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Record Type
Sélectionnez le type d’enregistrement Salesforce que le module doit supprimer.
ID

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>

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.

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.

Connection
Pour plus d'informations sur la connexion de votre compte Salesforce à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
URL

Saisissez un chemin relatif à <Instance URL>/services/data/v46.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.

Method
Headers
Ajoutez les en-têtes de la requête sous la forme d’un objet JSON standard. Par exemple, {"Content-type":"application/json"}. Workfront Fusion ajoute les en-têtes d’autorisation pour vous.
Query String
Ajoutez la requête pour l’appel API sous la forme d’un objet JSON standard. Par exemple : {"name":"something-urgent"}
Body

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.

INFO
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 :

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.

Connection
Pour plus d'informations sur la connexion de votre compte Salesforce à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Type of Upload
Sélectionnez si vous souhaitez que le module charge une pièce jointe ou un document.
ID
Saisissez ou mappez l’ID de l’objet pour lequel vous souhaitez charger une pièce jointe.
Folder
Sélectionnez le dossier contenant le fichier que le module doit charger.
Source File
Sélectionnez un fichier source à partir d’un module précédent ou mappez le nom et les données du fichier source.

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.

Connection
Pour plus d'informations sur la connexion de votre compte Salesforce à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Type of Download

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>

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.

Connection
Pour plus d'informations sur la connexion de votre compte Salesforce à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
ID
Saisissez ou mappez l’ID de l’enregistrement que vous souhaitez mettre à jour.
Record Type
Sélectionnez le type d’enregistrement Salesforce que vous souhaitez que le module mette à jour. Les champs sont disponibles en fonction du type d’enregistrement sélectionné dans le champ Type d’enregistrement. Ces champs sont basés sur l’API Salesforce.
Select fields to map

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.

Recherches

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.

Connection
Pour plus d'informations sur la connexion de votre compte Salesforce à Workfront Fusion, voir Création d'une connexion à Adobe Workfront Fusion - Instructions de base.
Search Type

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)

Type
Si vous avez sélectionné le type Recherche simple, choisissez le type d’enregistrement Salesforce que vous souhaitez que le module recherche.
Query / SOSL Query / SOQL Query

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.

Maximal count of records.
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

Rechercher

Ce module d’action permet de récupérer tous les enregistrements répondant à un critère donné.

Connection
Pour savoir comment connecter votre compte Salesforce à Workfront Fusion, consultez la section Créer une connexion à ​ Adobe Workfront Fusion - Instructions de base
Type
Sélectionnez le type d’objet que vous souhaitez rechercher.
Search criteria
Sélectionnez le champ dans lequel vous souhaitez effectuer une recherche, l’opérateur que vous souhaitez utiliser dans votre requête et la valeur que vous recherchez dans le champ. Vous pouvez relier des requêtes en utilisant AND ou OR.
Outputs
Sélectionnez les champs que vous souhaitez inclure dans la sortie du module.
Result set
Indiquez si vous souhaitez que le module renvoie tous les enregistrements correspondants ou uniquement le premier enregistrement correspondant.
Maximal
Saisissez ou mappez le nombre maximum d’enregistrements que vous souhaitez que le module récupère au cours de chaque cycle d’exécution du scénario.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43