I webhook inviano informazioni quando si verificano certi eventi che riguardano un servizio. In ArcGIS Online è possibile creare webhook per i feature service che popolano i feature layer ospitati, le viste di feature layer ospitati e le tabelle ospitate, nonché definire gli eventi che causano l'invocazione dei webhook.
Per poter creare o gestire un webhook per l'elemento, è necessario che l'impostazione di modifica Tieni traccia delle modifiche ai dati (aggiungi, aggiorna, elimina feature) sia abilitata.
Creare un webhook
È possibile creare un webhook per un feature layer ospitato, vista di feature layer ospitato o tabella ospitata per utilizzare attivazioni e messaggi che notificano o supportano l'automazione di attività per questi elementi.
L'infrastruttura a supporto dei webhook è configurata al di fuori di ArcGIS. Per informazioni su cosa è necessario configurare prima di poter creare un webhook e sui privilegi richiesti per creare webhook, vedi Webhook in ArcGIS Online.
Per creare un webhook per un feature layer ospitato, vista di feature layer ospitato o tabella ospitata, attenersi alla seguente procedura:
- Accedi all'organizzazione.
- Apri la pagina dell'elemento del feature layer, della vista o della tabella ospitati.
- Fare clic sulla scheda Impostazioni.
- Scorrere fino alla sezione Webhook e fare clic su Crea webhook.
Se il pulsante Crea webhook è disabilitato, il layer potrebbe non avere abilitata l'opzione Tieni traccia delle modifiche ai dati (aggiungi, aggiorna, elimina feature).
Nel caso delle viste, deve essere abilitata l'opzione Tieni traccia delle modifiche ai dati (aggiungi, aggiorna, elimina feature) nel feature layer ospitato di origine.
- Assegna un nome al webhook.
- Espandi il menu Eventi e seleziona tutte le caselle di controllo degli eventi per cui desideri attivare un webhook.
- Nella casella di testo URL del ricevitore Webhook, inserisci l'URL del ricevitore Webhook.
Il ricevitore webhook deve già esistere ed essere configurato per comunicare tramite una connessione HTTPS sicura.
- Facoltativamente, fornire una chiave segreta per una maggiore sicurezza.
Devi configurare la chiave segreta sul ricevitore webhook prima di fornirla al webhook.
- Assegna un nome al webhook.
Il webhook compare nell'elenco dei webhook per questo elemento.
Gestire webhook
È possibile gestire i webhook dalla scheda Impostazioni della pagina dell'elemento.
I proprietari dell'elemento possono inoltre accedere e gestire tutti i webhook di cui sono proprietari da Le mie impostazioni.
Suggerimento:
Gli amministratori dell'organizzazione hanno accesso e possono gestire tutti i webhook nell'organizzazione dalla scheda Organizzazione > Impostazioni > Webhook. Fare riferimento a Gestire i webhook nell'organizzazione per maggiori informazioni.
La gestione di un webhook associato a un feature layer ospitato, a una vista di feature layer ospitato o a una tabella ospitata include quanto segue:
- Disattiva o attiva il webhook: quando un webhook è inattivo, non si attiva quando si verificano gli eventi scatenanti definiti per esso. Potresti disattivare temporaneamente tutti i webhook su un layer mentre esegui aggiornamenti automatici per evitare di riempire la tua casella di posta con messaggi. Oppure potresti disattivare temporaneamente un webhook che si attiva per tutti gli eventi possibili e lasciare attivo un altro webhook che si attiva su un singolo trigger per consentirti di concentrarti temporaneamente su quell'unico evento.
- Modifica il webhook: puoi modificare le impostazioni del webhook. Ad esempio, puoi aggiungere una chiave segreta o modificare i trigger degli eventi che attivano il webhook.
- Elimina il webhook: se un webhook non è più necessario, puoi eliminarlo.
Nota:
I webhook vengono immediatamente eliminati. Non vengono spostati nel cestino.
Gestire un webhook dalla pagina dell'elemento
Per gesitre un webhook dalla pagina dell'elemento del feature layer ospitato, vista di feature layer ospitato o tabella ospitata a cui è associato, attenersi alla seguenti procedura:
- Accedi all'organizzazione.
- Apri la pagina dell'elemento del feature layer, della vista o della tabella ospitati.
- Fare clic sulla scheda Impostazioni e scorrere fino alla sezione dei webhook.
Tutti i webhook associati a questo elemento sono elencati qui.
- Esegui una delle seguenti operazioni di gestione:
- Per disattivare il webhook, disabilita il pulsante di attivazione/disattivazione accanto al nome del webhook.
- Per attivare il webhook, abilita il pulsante di attivazione/disattivazione accanto al nome del webhook.
- Per modificare le impostazioni di un webhook, fai clic sul pulsante Opzioni
accanto al nome del webhook, quindi fai clic su Modifica. Modifica il nome, gli eventi, l'URL del destinatario del webhook o la chiave segreta per il webhook, quindi fai clic su Aggiorna webhook. - Per eliminare un webhook, fai clic sul pulsante Opzioni accanto al nome del webhook, quindi fai clic su Elimina. Quando viene richiesto di confermare, fai clic su Elimina.
Gestire un webhook da Le mie impostazioni
Per gestire un webhook da Le mie impostazioni, attenersi alla seguente procedura:
- Accedi all'organizzazione.
- Fai clic sul tuo nome utente nella parte superiore del sito, quindi fai clic su Le mie impostazioni.
- Fai clic sulla scheda Webhook.
- Esegui una delle seguenti operazioni di gestione:
- Per disattivare il webhook, disabilita il pulsante di attivazione/disattivazione accanto al nome del webhook.
- Per attivare il webhook, abilita il pulsante di attivazione/disattivazione accanto al nome del webhook.
- Per modificare le impostazioni di un webhook, fai clic sul pulsante Opzioni accanto al nome del webhook, quindi fai clic su Modifica. Modifica il nome, gli eventi, l'URL del destinatario del webhook o la chiave segreta per il webhook, quindi fai clic su Aggiorna webhook.
- Per eliminare un webhook, fai clic sul pulsante Opzioni accanto al nome del webhook, quindi fai clic su Elimina. Quando viene richiesto di confermare, fai clic su Elimina.