Premiers pas avec les services externes
Objectifs de formation
Une fois cette unité terminée, vous pourrez :
- Présenter la fonctionnalité Services externes et les services externes
- Décrire le workflow général d’un service externe
Pourquoi utiliser des services externes ?
Regardez la vidéo d’introduction pour découvrir comment vous pouvez transformer de manière déclarative les spécifications d’API en actions invocables.
Les clients d’aujourd’hui veulent bénéficier d’une expérience fluide, et peu importe si, en coulisses, cela implique l’utilisation de solutions et de services résidant sur une seule plate-forme ou hébergés sur plusieurs plates-formes. C’est l’outil Services externes qui intervient lors de cette interaction entre Salesforce et des services tiers.
L’outil Services externes facilite cet échange en vous permettant de collaborer de façon déclarative (sans passer par du code) avec des services hébergés hors de la plate-forme qui effectuent des calculs ou des actions commerciales utilisables dans votre organisation Salesforce. Quels sont donc les types de services tiers utiles pouvant-être intégrés à une organisation Salesforce ? Voici quelques exemples.
- Un service de notation de crédit pour votre page Détails du compte dans Salesforce
- Un service de vérification de l’admissibilité à des réductions
- Des services de paiement numérique flexibles
- Des services de cartographie avec outils de visualisation
- Des notifications de commande en temps réel dans Slack
- Des solutions d’identification, comme un service de prévention de la fraude
- L’intégration de services de vente au détail omnicanaux indépendants
- Des services Google
- Des services fournis par des institutions nationales et internationales :
- Indice de qualité de l’air (AirNow)
- Services destinés aux citoyens
- Centres de contrôle et de prévention des maladies
- Banque mondiale
Nous reviendrons plus en détail sur l’outil Services externes dans un instant. Mais commençons par examiner quelques exemples qui illustrent son flux de travail et mettent en avant comment il transforme la manière d’intégrer une grande variété de services Web.
Faites automatiquement des nouveaux utilisateurs de votre organisation Salesforce des collaborateurs ayant accès aux applications externes lui étant liées. Supposons que vous souhaitiez que vos utilisateurs aient accès à une application d’informations sur les paies afin qu’ils puissent consulter leurs propres décomptes d’heures et données de paie. Vous enregistrez un service tiers (l’application de paie) et l’outil Services externes convertit le service en actions à utiliser avec Flow Builder. Ensuite, vous créez un flux avec des déclencheurs qui agissent sur les données d’entrée (par exemple, l’ID utilisateur) de votre application de paie. Désormais, chaque fois que vous créez un utilisateur dans Salesforce, un flux lancé automatiquement se déclenche et ajoute l’utilisateur en tant que collaborateur. Ce dernier dispose d’un accès au service de l’application de paie extérieur à Salesforce qui contient son décompte d’heures et son salaire.
Accédez à des services extérieurs à Salesforce pour effectuer une tâche. Supposons que vous souhaitiez vous connecter à un service de crédit qui détermine si un crédit est étendu à un enregistrement de compte stocké dans votre organisation Salesforce. Voici comment il fonctionne. Vous enregistrez votre service externe (le service de validation de crédit). L’outil Services externes convertit le service en actions invocables (voir la définition) à utiliser avec un outil de la plate-forme comme Flow Builder. Ensuite, vous utilisez Flow Builder pour créer un flux qui transforme les actions de ce service tiers en entrées, telles que le montant d’une commande ou des conditions de crédit. Lorsque le flux est exécuté, il met à jour les conditions de crédit pour la commande associée au compte.
Une fois que vous maîtrisez les fondamentaux, vous pouvez utiliser le flux de travail de l’outil Services externes pour exploiter les services extérieurs à Salesforce qui correspondent le mieux à votre modèle commercial, à votre cas d’utilisation et, surtout, à vos clients.
En quoi consiste l’outil Services externes ?
Savez-vous faire la différence entre un service Web externe et l’outil Services externes ? Commençons par quelques définitions.
Services externes : il s’agit d’un produit d’intégration de Salesforce qui permet (1) d’enregistrer un service Web externe que vous soumettez en tant que spécification conforme à OpenAPI le définissant, et (2) d’importer (presque par magie) les opérations de votre service Web externe dans la plate-forme Salesforce (voir les actions invocables) pour les utiliser avec des outils fonctionnant par pointer-cliquer comme Flow Builder. Pour simplifier, il établit de manière déclarative une connexion avec des API REST externes à l’aide des normes OpenAPI.
Service Web externe : également appelé service externe (en minuscules). Il s’agit de tout type de fonction, d’action ou de processus développé et hébergé en dehors de la plate-forme Salesforce. Pour qu’un service Web externe puisse être pris en charge par l’outil Services externes, il doit s’agir d’une API de type REST qui utilise généralement le protocole HTTPS pour naviguer sur le Web. (ne vous inquiétez pas si vous ne savez pas ce qu’est REST).
Spécification d’API : il s’agit d’un fichier contenant le schéma descriptif qui définit ce qu’une API peut faire. L’outil Services externes emploie un format de spécification OpenAPI de type JSON ou YAML. Une spécification d’API est compréhensible à la fois par les utilisateurs et les machines. La spécification permet de définir les règles de base relatives à la dénomination, au classement et au contenu des objets, ainsi que d’assurer des interactions claires avec une API REST. Pour en savoir plus, référez-vous à la spécification OpenAPI.
Actions invocables (dans le contexte de l’outil Services externes) : elles représentent les blocs de construction déclaratifs disponibles dans un nombre croissant d’outils de la plate-forme Salesforce, dont Flow Builder ou Robots Einstein. Les actions invocables aident les administrateurs et les développeurs en leur fournissant un moyen d’implémenter et d’utiliser tout type d’action de manière cohérente. Dans l’écosystème de l’outil Services externes, une fois que vous avez enregistré les opérations de votre service Web externe auprès de ce dernier, vous pouvez accéder aux actions invocables résultantes à partir de l’outil Flow Builder, par exemple.
Flow Builder : outil de type pointer-cliquer destiné à la création de flux.
Flow (Flux) : un flux est la composante de Salesforce Flow qui collecte des données et effectue des actions dans votre organisation Salesforce ou dans un système externe. Salesforce Flow comprend des flux (créés avec Flow Builder) et des processus (créés avec le générateur de processus).
Bien que ces termes (spécification OpenAPI, spécification d’API et schéma) s’adressent aux développeurs, l’outil Services externes participe à combler le fossé entre le codage de services Web et l’automatisation de l’accès à ces derniers.
vue d’ensemble
Il est temps de prendre du recul et d’adopter une vue d’ensemble afin de mieux comprendre les différents éléments interconnectés qui constituent l’outil Services externes. Vous remarquerez toutefois qu’une grande partie du travail que vous devez réaliser pour enregistrer un service Web externe est effectuée de manière déclarative via la page d’enregistrement de l’outil Services externes. Une fois que le service est enregistré, vous pouvez utiliser des outils tels que Flow Builder pour créer un flux avec les actions invocables de votre service Web.
Nous résumons ici l’essentiel du processus. Notez que bien qu’il y ait six étapes, ce sont celles numérotées de 3 à 5 qui ont le plus d’importance en ce qui concerne l’outil Services externes.
- Un fournisseur de services Web externes, tel qu’une banque, héberge son API de type REST. Dans ce contexte, considérez que l’API de type REST est un élément spécifiant un type de contrat entre la banque (le fournisseur) et vous (le consommateur).
- Le fournisseur de services Web (comme dans notre exemple avec le service Web bancaire) ou un développeur (peut-être vous) partage une spécification d’API de type JSON qui décrit l’API.
- Un administrateur ou développeur Salesforce crée de manière déclarative un identifiant nommé dans le but de réaliser l’authentification auprès du point de terminaison du service Web, à l’aide de l’URL de l’API de type REST communiquée par le fournisseur du service Web externe. Le point de terminaison est simplement l’élément qui permet aux ressources des services Web d’interagir avec l’outil Services externes.
- Un administrateur Salesforce enregistre le service Web de manière déclarative et utilise à la fois l’identifiant nommé et la spécification d’API pour réaliser le processus d’enregistrement. L’outil Services externes importe les opérations de la spécification d’API dans votre organisation et les rend disponibles en tant qu’actions invocables.
- Un administrateur Salesforce utilise Flow Builder pour accéder aux actions de flux invocables qui ont été enregistrées à l’étape 4.
- Lors de son exécution, le flux envoie un appel au point de terminaison du service Web. Le service Web renvoie une sortie en fonction de la spécification d’API. Les données sont récupérées, créées, mises à jour ou supprimées par le service Web externe. Salesforce peut capturer ces réponses à partir du service Web externe pour les utiliser avec un outil tel que Flow Builder.
Si un producteur d’API ne vous a pas transmis de spécification, la création d’une spécification d’API à l’étape 2 n’est pas un processus déclaratif. Vous pouvez créer la spécification d’API vous-même (en fonction de vos compétences), faire appel à votre développeur ou utiliser un outil de génération de schéma comme l’éditeur Swagger.
Dans l’unité suivante, nous vous présenterons les tenants et les aboutissants (ou, plus précisément, les entrées et les sorties) des spécifications d’API et vous expliquerons de quoi il s’agit. Une fois que vous disposerez de votre spécification d’API, vous pourrez utiliser les outils déclaratifs déjà présents dans Salesforce pour ajouter à votre organisation les actions commerciales dont vous avez besoin.
