Les webhooks envoient des informations lorsque certains événements affectant un service ont lieu. Dans ArcGIS Online, vous pouvez créer des webhooks pour les services d’entités qui alimentent les couches d’entités hébergées, les vues de couches d’entités hébergées et les tables hébergées, et définir les événements entraînant l’appel des webhooks.
Le paramètre de mise à jour Keep track of changes to the data (add, update, delete features) (Conserver un suivi des modifications des données [ajout, mise à jour et suppression d’entités]) doit être activé pour l’élément avant de créer ou de gérer un webhook à son intention.
Créer un webhook
Vous pouvez créer un webhook pour une couche d’entités hébergée, une vue de couche d’entités hébergée ou une table hébergée afin d’utiliser des déclencheurs et d’envoyer des messages notifiant ou prenant en charge l’automatisation des tâches pour ces éléments.
L’infrastructure de prise en charge des webhooks est configurée en dehors d’ArcGIS. Pour savoir ce que vous devez configurer avant de créer un webhook et connaître les privilèges requis pour créer les webhooks, consultez Webhooks dans ArcGIS Online.
Afin de créer un webhook pour une couche d’entités hébergée, une vue de couche d’entités hébergée ou une table hébergée, procédez comme suit :
- Connectez-vous à l’organisation.
- Ouvrez la page des éléments de la vue, table ou couche d’entités hébergée.
- Cliquez sur l’onglet Settings (Paramètres).
- Faites défiler la page jusqu’à la section Webhooks, puis cliquez sur Create webhook (Créer un webhook).
Si le bouton Create webhook (Créer un webhook) est désactivé, il se peut que l’option Keep track of changes to the data (add, update, delete features) [Conserver un suivi des modifications des données (ajout, mise à jour et suppression d’entités)] ne soit pas sélectionnée pour la couche.
Pour les vues, l’option Keep track of changes to the data (add, update, delete features) [Conserver un suivi des modifications des données (ajout, mise à jour et suppression d’entités)] doit être sélectionnée pour la couche d’entités hébergée source.
- Donnez un nom au webhook.
- Développez le menu Events (Événements) et cochez toutes les cases d’événements pour lesquels déclencher un webhook.
- Dans la zone de texte Webhook receiver URL (URL de récepteur webhook), indiquez l’URL du récepteur webhook.
Le récepteur webhook doit déjà exister et être configuré de façon à communiquer via une connexion HTTPS sécurisée.
- Vous pouvez également fournir une clé secrète pour renforcer la sécurité.
Vous devez configurer la clé secrète sur le récepteur webhook avant de l’indiquer au webhook.
- Donnez un nom au webhook.
Le webhook apparaît dans la liste des webhooks pour cet élément.
Gérer les webhooks
Vous pouvez gérer les webhooks depuis l’onglet Settings (Paramètres) de la page des éléments.
Les propriétaires d’élément peuvent également accéder à tous les webhooks qu’ils possèdent et les gérer depuis My settings (Mes paramètres).
Conseil :
Les administrateurs de l’organisation ont accès à tous les webhooks dans l’organisation et peuvent les gérer depuis l’onglet Organization (Organisation) > Settings (Paramètres) > Webhooks. Reportez-vous à la rubrique Gérer les webhooks dans l’organisation pour plus d’informations.
La gestion d’un webhook associé à une couche d’entités hébergée, une vue de couche d’entités hébergée ou une table hébergée inclut les étapes suivantes :
- Désactiver ou activer le webhook : lorsqu’un webhook est inactif, il ne démarre pas lorsque les événements déclencheurs définis pour lui se produisent. Vous pouvez désactiver temporairement tous les webhooks d’une couche pendant que vous réalisez des mises à jour automatiques afin d’éviter de saturer votre boîte de réception. Vous pouvez également désactiver temporairement un webhook qui démarre pour tous les événements possibles et laisser un autre webhook actif qui démarre sur un seul déclencheur afin de vous concentrer temporairement sur l’événement en question.
- Modifier le webhook : vous pouvez modifier les paramètres du webhook. Vous pouvez par exemple ajouter une clé secrète ou modifier les déclencheurs d’événements qui entraînent le démarrage du webhook.
- Supprimer le webhook : si un webhook n’est plus requis, vous pouvez le supprimer.
Remarque :
Les webhooks sont immédiatement supprimés. Ils ne sont pas déplacés dans la corbeille.
Gérer un webhook depuis la page des éléments
Pour gérer un webhook depuis la page des éléments de la couche d’entités hébergée, de la vue de couche d’entités hébergée ou de la table hébergée à laquelle il est associé, procédez comme suit :
- Connectez-vous à l’organisation.
- Ouvrez la page des éléments de la vue, table ou couche d’entités hébergée.
- Cliquez sur l’onglet Settings (Paramètres) et faites défiler la page jusqu’à la section Webhooks.
Tous les webhooks associés à cet élément sont répertoriés dans cette section.
- Effectuez l’une des opérations de gestion suivantes :
- Pour désactiver le webhook, désactivez le bouton bascule en regard de son nom.
- Pour activer le webhook, activez le bouton bascule en regard de son nom.
- Pour modifier les paramètres d’un webhook, cliquez sur le bouton Options
en regard de son nom et sur Edit (Modifier). Modifiez le nom, les événements, l’URL de récepteur webhook ou la clé secrète du webhook, puis cliquez sur Update webhook (Mettre à jour le webhook). - Pour supprimer un webhook, cliquez sur le bouton Options en regard de son nom et sur Delete (Supprimer). À l’invite de confirmation, cliquez sur Delete (Supprimer).
Gérer un webhook depuis My settings (Mes paramètres)
Pour gérer les webhooks depuis My settings (Mes paramètres), procédez comme suit :
- Connectez-vous à l’organisation.
- Cliquez sur votre nom de membre en haut du site et sur My settings (Mes paramètres).
- Cliquez sur l’onglet Webhooks.
- Effectuez l’une des opérations de gestion suivantes :
- Pour désactiver le webhook, désactivez le bouton bascule en regard de son nom.
- Pour activer le webhook, activez le bouton bascule en regard de son nom.
- Pour modifier les paramètres d’un webhook, cliquez sur le bouton Options en regard de son nom et sur Edit (Modifier). Modifiez le nom, les événements, l’URL de récepteur webhook ou la clé secrète du webhook, puis cliquez sur Update webhook (Mettre à jour le webhook).
- Pour supprimer un webhook, cliquez sur le bouton Options en regard de son nom et sur Delete (Supprimer). À l’invite de confirmation, cliquez sur Delete (Supprimer).
Vous avez un commentaire à formuler concernant cette rubrique ?