Les API ont pour objectif de faire communiquer 2 systèmes entre eux. Au cours de cette session, je vous donnerais les bonnes pratiques pour mettre en place un appel API sans code, au travers d’un flow

1. Comment exploiter
facilement une API
avec les Flows
Théâtre 4 - Trailblazer
13h00-13h30

2. Déclarations Conditionnelles
Déclaration conforme à la directive « Safe Harbor » contenue dans la loi américaine intitulée « Private Securities Litigation Reform Act » de 1995 :
Cette présentation est susceptible de comporter des déclarations conditionnelles, qui impliquent nécessairement une certaine prise de risque, des incertitudes et des
hypothèses. Si l'une de ces incertitudes se concrétise ou si certaines hypothèses se révèlent incorrectes, les résultats de Salesforce, Inc. pourraient être sensiblement
différents de ceux explicitement ou implicitement avancés par nos déclarations conditionnelles. Toutes les déclarations ne portant pas sur des faits historiques peuvent
être considérées comme conditionnelles, y compris les projections de disponibilité des produits ou des services, d'augmentation du nombre d'abonnés, de bénéfices, de
chiffre d'affaires ou autre valeur financière, toute déclaration concernant les stratégies ou les plans de gestion des opérations à venir, toute opinion personnelle, toute
déclaration concernant les services ou les développements technologiques nouveaux, planifiés ou mis à niveau, ainsi que les contrats clients et l'utilisation de nos
services.
Les incertitudes et les risques susmentionnés concernent, sans s'y limiter, les risques associés au développement et à la fourniture de nouvelles fonctionnalités pour
notre service, aux nouveaux produits et services, à notre nouveau modèle commercial, nos pertes d'exploitation antérieures, les éventuelles fluctuations de nos résultats
d'exploitation et de notre taux de croissance, les interruptions ou les retards de notre système d'hébergement, les failles des mesures de sécurité, l'issue des litiges, les
risques associés aux fusions et acquisitions réelles et éventuelles, la jeunesse du marché dans lequel nous évoluons, notre historique relativement limité, notre capacité
à développer, fidéliser et motiver notre personnel et à gérer notre croissance, les nouvelles éditions de notre service, ainsi que le déploiement réussi chez les clients,
notre expérience limitée en matière de revente de produits tiers, et l'utilisation et les ventes à de grands comptes. Vous trouverez plus d'informations sur les facteurs
pouvant influencer les résultats financiers de Salesforce, Inc. dans notre rapport annuel (formulaire 10-K) pour l'exercice fiscal le plus récent et dans notre rapport
trimestriel (formulaire 10-Q) pour le trimestre fiscal le plus récent. Ce rapport et d'autres documents contenant d'importantes informations sont accessibles sur notre site
web dans la partie Informations Investisseurs, section Documents pour la Commission des opérations de bourse (SEC).
Certains services ou fonctions qui ne sont pas encore commercialisés et sont mentionnés ici ou dans d'autres présentations, communiqués de presse ou déclarations
publiques, ne sont pas encore disponibles et ne seront peut-être pas livrés à temps, voire pas livrés du tout. Les clients qui achètent nos services doivent prendre leur
décision sur la base des fonctions actuellement disponibles. Salesforce, Inc. n'est pas tenu et n'a pas l'intention de mettre à jour ces déclarations conditionnelles.

3. Thierry TROUIN
Architect Salesforce chez Orange Business
13 ans d’expérience sur Salesforce
10 Certifications Salesforce + 3 chez les partenaires
Group Leader sur le Toulouse Salesforce User Group
Instructeur certifié sur la formation Administrateur (avec
ISDI)
Salesforce MVP depuis 2021
Co-Organisateur du French Touch Dreamin
Speaker sur les évènements Salesforce

4. Partagez votre avis !
Rendez-vous dans l’app
Salesforce Events
Découvrez la suite des sessions

5. Agenda
1. Définition 4. Configuration
2. Use Case 5. Conclusion
3. Outils & Fonctionnalités 6. Questions/Réponses

6. Définition

7. Définition
API = Application Programming Interface
C’est une interface logicielle
qui permet de « connecter » un logiciel ou un service
à un autre logiciel ou service
afin d'échanger des données et des fonctionnalités.
API
Requête
Requête
Réponse Réponse
Client / Application
Base de données

8. Use Case

9. Use Case
Quelques exemples d’utilisation des API
Météo du jour
ou
de la semaine
liste des
jours fériés
de l’année
en cours
Mettre à jour
automatiquement
un taux change
liste des
communes
d’un département
Bulletin officiel
des annonces
civiles et
commerciales

10. Use Case
Notre entreprise a besoin de connaître les jours fériés en France métropolitaine sur l’année 2024.

11. Use Case
Comment
peut-on
y répondre ?
Notre entreprise a besoin de connaitre les jours fériés en France métropolitaine sur l’année 2024.

12. Use Case
Comment
peut-on
y répondre ?
Le site « https://api.gouv.fr »
nous offre une API gratuite
listant les jours fériés.
Notre entreprise a besoin de connaitre les jours fériés en France métropolitaine sur l’année 2024.

13. Outils &
Fonctionnalités

14. Outils & Fonctionnalités
Outils :
https://swagger.io
https://api.gouv.fr/documentation/jours-feries
https://www.salesforce.com

15. Outils & Fonctionnalités
Outils :
Fonctionnalités Salesforce :
https://swagger.io
https://api.gouv.fr/documentation/jours-feries
https://www.salesforce.com
Named
Credentials
Flows
(screen)
External
Services
Remote
Site Settings

16. Configuration

17. Configuration - Identifier notre API
Accédez à l’URL « https://api.gouv.fr/documentation/jours-feries » afin de
consulter la documentation de l’API
On a choisi
notre API

18. Configuration - Identifier notre API
On obtient l’URL
de notre API
Accédez à l’URL « https://api.gouv.fr/documentation/jours-feries » afin de
consulter la documentation de l’API

19. Configuration - Définir la connexion
Ajouter l’Url « https://calendrier.api.gouv.fr » dans la liste des « Remote Site Settings »
Liste des sites
autorisés depuis
Salesforce

20. Configuration - Définir la connexion
Cliquez sur le bouton « New Legacy » afin de définir la connexion à l’API dans Salesforce

21. Configuration - Définir la connexion
Saisissez le « Nom » et « l’URL » https://calendrier.api.gouv.fr qui correspond à l‘API

22. Configuration - Charger l’API
Cliquez sur le bouton « Add an External Service » afin d’ajouter le schéma de communication de
l’API.

23. Configuration - Charger l’API
Sélectionnez « From API Specification »

24. Configuration - Charger l’API
Saisissez les informations

25. Configuration - Charger l’API
Saisissez les informations
Et on obtient
une erreur
de compatibilité
sur le format

26. Configuration - Charger l’API
Saisissez les informations
le schéma fournit par le site (YAML)
n’est pas compatible avec Salesforce (JSON)
Il faut donc utiliser un outil de conversion (swagger)

27. Configuration - Charger l’API
A partir du site « https://swagger.io/ »

28. Configuration - Charger l’API
● Cliquez sur le menu « File »
● Cliquez sur le menu « Import URL »
● Collez l’URL de notre API « https://calendrier.api.gouv.fr/jours-feries/openapi.yml »

29. Configuration - Charger l’API
● Cliquez sur le menu « File »
● Cliquez sur le menu « Convert and save as JSON »
● Le fichier est automatiquement enregistré sur notre
PC

30. Configuration - Charger l’API
● Sélectionnez « Upload from local »
● Cliquez sur le bouton « Upload Files »

31. Configuration - Charger l’API
● Sélectionnez « Upload from local »
● Cliquez sur le bouton « Upload Files »

32. Configuration - Charger l’API
● Sélectionnez « la » ou « les » opération(s)

33. Configuration - Charger l’API
● Cliquez sur le bouton « Finish » afin d’enregistrer « l’External Service »

34. Configuration - Charger l’API
Bravo, vous avez configuré votre service.

35. Configuration – Création du Screen Flow
Dans la configuration
● Cliquez sur le menu « Flows »
● Cliquez sur le bouton « New Flow »
● Sélectionnez « Screen Flow »

36. Configuration - Création du Screen Flow
Etape 1 :
● Ajoutez un composant Screen
Obtenir
l’année en cours

37. Configuration - Création du Screen Flow
● Ajoutez le composant « Number » afin de saisir l’année
● Cliquez sur « Defaut Value » puis cliquez sur « New Resource »

38. Configuration - Création du Screen Flow
Création d’une ressource pour obtenir l’année en cours par défaut
● Saisissez le nom « ThisYear »
● Sélectionnez le type de donnée « Number » avec zéro décimale
● Utilisez la fonction TODAY() pour récupérer la date du jour
● Utilisez la fonction YEAR() afin de récupérer uniquement l’année de notre date
YEAR( TODAY() )

39. Configuration - Création du Screen Flow
Le 1er formulaire est créé

40. Configuration - Création du Screen Flow
Etape 2 :
● Ajoutez un composant « Action »
Récupération
des jours fériés

41. Configuration - Création du Screen Flow
● Ajoutez une action
● Dans les menus, sélectionnez « JourFeries »
● Cliquez sur « getZoneAndAnnee »
Nom de notre
External Service
Créé juste avant
Nom de
la fonction
de récupération
des jours fériés

42. Configuration - Création du Screen Flow
● Saisissez le « Libellé » de l’action
● Sélectionnez la variable « txtAnnee » correspondant à la zone de texte du 1er formulaire
● Créez une constante « Zone » avec la valeur « metropole »

43. Configuration - Création du Screen Flow
Etape 3 :
● Ajoutez un composant « Screen »
L’écran
du résultat

44. Configuration - Création du Screen Flow
● Ajoutez le composant « Display Text » et nommez-le « txtResultat »
● Dans la zone « Resource Picker »
● Cliquez sur « Outputs from GetJoursFeries »
● Cliquez sur « 200 » (qui correspond à notre résultat)
● Supprimez le point « . » à la fin de la variable
« {!GetJoursFeries.200} »

45. Configuration - Création du Screen Flow
Enregistrez le flow et cliquez sur le bouton « Debug » pour tester le résultat

46. Configuration - Création du Screen Flow
Le 1er écran
nous affiche
l’année en cours
Le 2ème écran
nous affiche
le résultat

47. Conclusion

48. Conclusion
Etapes Action Commentaires
Etape 1 Identifier notre API https://api.gouv.fr/documentation/jours-feries
Etape 2 Définir la connexion dans Salesforce Remote site + Named Credential
Etape 3 Charger l’API dans Salesforce External Services (+ swagger)
Etape 4 Créer le Screen Flow Flow

49. Partagez votre avis !
Rendez-vous dans l’app
Salesforce Events
Découvrez la suite des sessions

50. Posez toutes vos
questions, et connectez
avec nous!
“Meet the Speaker Booth”

51. Merci!