Suivez votre progression
Accueil Trailhead
Accueil Trailhead

Présentation de l’intégration Apex

Remarque

Remarque

Attention Trailblazer !

Salesforce offre deux types d’interface utilisateur pour ordinateur de bureau : Lightning Experience et Salesforce Classic. Ce module est conçu pour Salesforce Classic.

Pour savoir comment basculer entre les interfaces et activer Lightning Experience, entre autres, suivez le module Concepts de base de Lightning Experience ici sur Trailhead.

Objectifs de formation

Après avoir terminé ce module, vous pourrez :
  • Décrire les différences entre les appels de service Web et les appels HTTP.
  • Autoriser un site externe via les paramètres des sites distants.

Émettre des appels vers des services externes depuis Apex

Un appel Apex vous permet d’intégrer étroitement votre code Apex à un service externe. Dans le cadre d’un appel, cet appel est émis vers un service Web externe ou une requête HTTP est envoyée depuis le code Apex, puis la réponse est reçue.

Deux types d’appel Apex existent.

  • Les appels de service Web émis vers des services Web SOAP utilisent du XML et nécessitent généralement un document WSDL pour la génération du code.
  • Les appels HTTP émis vers des services reposent généralement sur du REST avec JSON.

Ces deux types d’appel sont similaires dans la mesure où ils envoient tous deux une requête à un service puis reçoivent une réponse. Mais tandis que les appels WSDL s’appliquent aux services Web SOAP, les appels HTTP peuvent être utilisés avec un service HTTP, qu’il soit SOAP ou REST.

Donc vous vous demandez probablement maintenant : « Lequel devrais-je utiliser ? » Utilisez un service HTTP dès que cela est possible. Il est généralement plus facile d’interagir avec ces services qui exigent beaucoup moins de code et utilisent du JSON facile à lire. Tous ceux qui sont « dans le coup » sont passés aux services REST ces dernières années, mais cela ne veut pas dire pour autant que les services Web SOAP sont mauvais. Ils ont toujours été là (depuis l’avènement d’Internet) et sont couramment utilisés pour les applications professionnelles. Et ils ne sont pas près de disparaître. Vous utiliserez probablement surtout le SOAP lorsque vous intégrerez votre contenu à des applications héritées ou pour les transactions exigeant un format d’échange formel ou des opérations à état. Dans ce module, nous aborderons le SOAP mais passerons la plupart du temps sur le REST.

Autoriser les adresses de points de terminaison

Chez Salesforce, nous adorons la sécurité ! Donc, chaque fois que vous émettez un appel vers un site externe, nous voulons nous assurer qu’il est autorisé. Nous ne pouvons pas disposer d’un code appelant bon gré mal gré n’importe quel point de terminaison sans approbation préalable. Avant de commencer à travailler avec les appels, mettez à jour la liste de sites approuvés de votre organisation sur la page Paramètres des sites distants.

Nous utiliserons les points de terminaison suivants dans ce module, alors allez-y, ajoutez-les dès maintenant. Si vous avez oublié d’ajouter un point de terminaison, vous pouvez me faire confiance, vous obtiendrez un rappel lorsque vous essaierez d’exécuter votre code. Nous créerons des appels pour les sites suivants :

  • https://th-apex-http-callout.herokuapp.com
  • https://th-apex-soap-service.herokuapp.com

Autorisez ces deux URL de point de terminaison en suivant les étapes ci-dessous :

  1. Dans Configuration, entrez Paramètres des sites distants dans la zone Recherche rapide, puis cliquez sur Paramètres des sites distants.
  2. Cliquez sur Nouveau site distant.
  3. Entrez animals_http comme nom de site distant.
  4. Entrez https://th-apex-http-callout.herokuapp.com comme URL de site distant. Cette URL autorise tous les sous-dossiers du point de terminaison, comme https://th-apex-http-callout.herokuapp.com/chemin1 et https://th-apex-http-callout.herokuapp.com/chemin2.
  5. Pour la description, entrez Service animalier Trailhead : HTTP.
  6. Cliquez sur Enregistrer et nouveau.
  7. Entrez animals_soap comme nom du deuxième site distant.
  8. Entrez https://th-apex-soap-service.herokuapp.com comme URL de site distant.
  9. Pour la description, entrez Service animalier Trailhead : SOAP.
  10. Cliquez sur Enregistrer.