Création d'actions de données HTTP

Vous pouvez utiliser une action de données d'API HTTP dans un classeur de sorte que, lorsque vous sélectionnez une colonne, la valeur est envoyée à une API HTTP, qui renvoie une réponse.

Pour pouvoir créer une action de données d'API HTTP, vous devez configurer le domaine auquel vous essayez de vous connecter en tant que domaine sécurisé. Reportez-vous à Inscription de domaines sécurisés.

  1. Sur la page d'accueil, positionnez le curseur de la souris sur un classeur, cliquez sur Actions, puis sélectionnez Ouvrir.
  2. Cliquez sur Menu dans le classeur, puis sélectionnez Actions de données.
  3. Cliquez sur Ajouter une action et saisissez le nom de la nouvelle action de données d'API HTTP. Par exemple, saisissez Exemple d'API HTTP.
  4. Cliquez sur le champ Type et sélectionnez API HTTP.
  5. Cliquez sur le champ Ancrer à et sélectionnez les colonnes auxquelles vous voulez appliquer l'action de données d'API HTTP. Ne sélectionnez ni des colonnes d'indicateur ni des colonnes masquées. Si vous n'indiquez pas de valeur pour le champ Ancrer à, l'action de données s'applique à tous les éléments de données des visualisations.
  6. Dans la liste Méthode HTTP, sélectionnez une méthode.
  7. Entrez l'URL pour l'API REST qui commence par HTTP ou HTTPS, et incluez éventuellement des jetons de remplacement.
  8. Si vous avez sélectionné la méthode POST :
    • Lorsque vous sélectionnez Données de formulaire comme valeur pour Type de charge utile, entrez chaque paramètre sur une ligne distincte.
    • Lorsque vous sélectionnez Données brutes comme valeur pour Type de charge utile, entrez les données brutes.
  9. Saisissez un en-tête HTTP personnalisé si vous voulez ajouter ou remplacer l'en-tête HTTP pour l'adapter à l'API qui vous sert d'interface.
  10. Cliquez sur Prend en charge la sélection multiple pour définir la valeur.
    • Activé : l'action de données peut être appelée lorsque des points de données sont sélectionnés.
    • Désactivé : l'action de données ne peut être appelée que lorsqu'un seul point de données est sélectionné.

      Ce paramètre est particulièrement utile lorsque la sélection de plusieurs points de données peut entraîner une erreur (par exemple, avec des API REST tierces).

  11. Cliquez sur OK pour enregistrer.
  12. Cliquez sur un point de données dans la visualisation.

    Par exemple, vous pouvez sélectionner "Livres" dans une colonne Catégorie de jeton pour afficher une API REST donnée.

  13. Cliquez avec le bouton droit de la souris et sélectionnez Exemple d'API HTTP pour afficher le résultat.

    Les points de données sélectionnés déterminent les valeurs à transmettre aux jetons d'URL.

    Un message de réussite ou d'échec apparaît pour confirmer que l'API REST a été appelée en utilisant la valeur sélectionnée.