Créer des actions de données HTTP

Vous pouvez utiliser une action de données d'API HTTP dans un classeur. Ainsi, lorsque vous sélectionnez une colonne, elle envoie la valeur à une API REST qui retourne une réponse.

Vous devez configurer le domaine auquel vous tentez de vous connecter en tant que domaine sécurisé avant de créer une action de données d'API HTTP. Voir Enregistrer des domaines sécurisés.

  1. Dans la page d'accueil, passez le pointeur de la souris sur un classeur, cliquez sur Actions, puis sélectionnez Ouvrir.
  2. Cliquez sur Menu, puis sélectionnez Actions de données.
  3. Cliquez sur Ajouter une action et entrez le nom de la nouvelle action d'API HTTP. Par exemple, entrez HTTP API Example.
  4. Cliquez sur le champ Type et sélectionnez API HTTP.
  5. Cliquez sur le champ Ancrer à et sélectionnez les colonnes auxquelles l'action de données d'API HTTP doit être appliquée. Ne sélectionnez pas des colonnes de mesures ou masquées. Si vous ne spécifiez 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 de l'API REST qui commence par http ou https, et comporte, le cas échéant, des jetons de remplacement.
  8. Si vous avez sélectionné la méthode POST :
    • Lorsque vous sélectionnez la valeur Données de formulaire pour Type de données utiles, entrez chaque paramètre sur une ligne distincte.
    • Lorsque vous sélectionnez la valeur Données brutes pour Type de données utiles, entrez les données brutes.
  9. Entrez un en-tête HTTP personnalisé si vous voulez ajouter ou remplacer l'en-tête HTTP en fonction de l'API qui vous sert d'interface.
  10. Cliquez sur Prend en charge la sélection multiple pour définir la valeur.
    • Activée - L'action de données peut être appelée lorsqu'un ou plusieurs points de données sont sélectionnés.
    • Désactivée - L'action de données peut seulement être appelée 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 certaines API REST de tierce partie).

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

    Par exemple, vous pouvez sélectionner "Books" dans une colonne de catégorie de jeton pour afficher une API REST particulière.

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

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

    Un message de succès ou d'échec s'affiche pour confirmer que l'API REST a bien été appelée à l'aide de la valeur sélectionnée.