Demande Web - BÊTA

Utilisez l'étape Demande Web pour récupérer des informations à utiliser dans un bot ou pour piloter des changements dans un système externe. L'étape est exécutée depuis la plateforme Ivanti Neurons, une fois pour chaque périphérique qui passe par cette étape. Elle peut interagir avec des API REST tierces, et est prise en charge pour les API authentifiées et non authentifiées.

Comment configurer l'étape Demande Web

1. Sur la page Créer un bot, ajoutez une étape Demande Web à un bot et ouvrez les paramètres d'étape.
2. Dans la liste déroulante Sélectionner des références d'authentification, choisissez les références voulues si la demande Web nécessite une authentification. Si vous avez besoin de créer de nouvelles références d'authentification, cliquez sur Ajouter des références d'authentification pour ouvrir le magasin de références d'authentification. L'authentification de base par API et par clé API est actuellement prise en charge. Si aucune référence d'authentification n'est requise, gardez le paramètre par défaut Aucune authentification.
3. Sous En-têtes, basculez Afficher les en-têtes générés automatiquement sur Activé si vous souhaitez afficher les en-têtes générés automatiquement. Les en-têtes sont conformes aux exigences de l'API cible. Pour en savoir plus, reportez-vous à la documentation tierce.
   • Clé : Saisissez la clé d'en-tête de la demande Web.
   • Valeur: Saisissez la valeur d'en-tête de la demande Web.
4. Sélectionnez une méthode. Il s'agit de la méthode HTTP qui sera utilisée pour accéder à l'API cible. Les méthodes prises en charge sont : GET, POST, PUT, PATCH et DELETE.
5. Entrez l'adresse de l'API. Cette adresse doit être accessible sur Internet.
   Si vous transmettez des valeurs à partir d'une autre étape ou d'une entrée de bot, et que l'API de destination accepte une charge de traitement JSON, cliquez sur Modifier le corps JSON pour ouvrir l'éditeur JSON. Sélectionnez les valeurs à inclure (l'étape Demande Web doit être connectée à toutes les étapes précédentes pour que les informations puissent être transmises).
   
6. Choisissez le mode de sortie approprié pour refléter la réponse de l'API. Si vous avez choisi la méthode HTTP GET, le mode le plus courant est JSON.
7. Cliquez sur Tester et recevoir une réponse pour lancer un appel immédiat à l'API.
   Si le corps JSON contient des variables issues d'étapes antérieures, vous êtes invité à entrer des exemples de données.
8. Le champ Exemple de réponse est rempli à partir de l'action Tester et recevoir une réponse.
   Une fois que vous avez vérifié la réponse, vous pouvez déterminer si les résultats sont uniques (champs uniques pour chaque poste client) ou s'il s'agit d'une matrice (plusieurs valeurs pour un champ donné pour chaque poste client).
9. Si les résultats sont en matrice, vous devez activer l'option Matrice de mappage.
   Lorsque l'étape est en mode Matrice de mappage, elle affiche le badge « Multiple », ce qui signifie que, pour utiliser les résultats dans la plupart des autres étapes, vous devrez utiliser un bloc « For-each » (Pour chaque) afin d'exécuter le contenu pour chaque résultat.
   • Entrez le chemin de la matrice.
10. Une fois que l'option Matrice de mappage est activée, indiquez les attributs Mappage de champs suivants :
    • Chemin dans la matrice : Le chemin de l'objet dans la réponse JSON. Il peut s'agir du nom seul mais, si l'objet est imbriqué, le chemin doit être indiqué avec la syntaxe à points, par exemple niveau1.niveau2.monchamp
      Exemple de type Unique :
      {"configuration": {startup_events": {"updates": "some value"}}}
      Le chemin des mises à jour est : configuration.startup_events.updates
      Exemple de type Matrice :
      {"users": [{display_info": {"name": "John"}}]}
      Le chemin de la matrice est : utilisateurs
      Le chemin dans la matrice est : display_info.name
    • Type : Doit correspondre au format de la valeur en cours de lecture pour que les filtres/comportements corrects puissent être appliqués dans les étapes futures.
    • Étiquette mappée : Nom convivial du champ qui apparaîtra sur le sélecteur de jetons et les filtres dans les étapes ultérieures.

Une fois les attributs de matrice de mappage sélectionnés, cliquez sur Tester le mappage pour tester les mappages sur l'exemple de réponse, pour garantir que les mappages sont corrects.