I webhook forniscono ad altre applicazioni informazioni basate sugli eventi, consegnate come richiesta HTTPS che può essere utilizzata per creare flussi di lavoro automatizzati e integrativi. Alcuni concetti chiave nei flussi di lavoro degli webhook in ArcGIS Enterprise vengono descritti dettagliatamente nelle seguenti sezioni.
Attivazione evento
Le attivazioni evento specificano le operazioni API che invocheranno il webhook. Sia i webhook dell'organizzazione che quelli dei feature service supportano una gamma di attivazioni evento che possono essere utilizzate. Ad esempio, è possibile configurare il webhook dell'organizzazione per essere attivato quando viene aggiornato uno specifico gruppo, oppure è possibile scegliere di attivare un webhook feature service quando viene aggiornata la definizione di un feature service. I webhook dei servizi di geoprocessing, tuttavia, non utilizzano un elenco di attivazioni evento che gli utenti possono utilizzare. Invece, i webhook dei servizi di geoprocessing restituiscono carichi ogni volta che un processo di servizio di geoprocessing viene completato. Per ulteriori informazioni sull'elenco delle attivazioni evento supportate dagli webhook dell'organizzazione e dei feature service, consultare l'argomento Attivazioni evento.
Carico utile
Quando un utente esegue un'operazione specificata in un'attivazione evento, il webhook consegnerà le informazioni dell'evento, dette anche carico utile, all'URL di carico specificato. Le informazioni dell'evento per ciascun tipo di webhook vengono consegnate in schemi JSON simili, contenenti le informazioni dell'evento e il momento in cui si è verificato, anche se la struttura e le proprietà del carico utile restituite per i webhook dell'organizzazione e del servizio variano a seconda del tipo di webhook. Per ulteriori informazioni sui carichi utili per ciascun tipo di webhook, consultare Carichi utili.
URL payload
Quando un webhook viene invocato, il carico utile viene consegnato a un URL specifico, spesso fornito dal ricevitore webhook. L'URL del carico utile viene fornito durante la configurazione di un webhook e viene verificato durante la creazione per assicurare che il ricevitore sia raggiungibile da ArcGIS Enterprise con una richiesta HTTPS POST.
Ricevitori
I carichi utili vengono consegnati ai ricevitori webhook, i quali recuperano il carico utile e comunicano che l'evento si è verificato agli amministratori o ai membri dell'organizzazione. I ricevitori webhook devono essere configurati per comunicare tramite una connessione HTTPS per ricevere i carichi utili ed essere raggiungivili da ArcGIS Enterprise. Esistono alcune opzioni sopportate per i destinatari, ad esempio ricevitori di web service di terze parti (Microsoft Power Automate, Zapier e IFFT), web service personalizzati, ArcGIS Notebook Server e ArcGIS Workflow Manager. Per esempi che illustrano come creare web service personalizzati o iniziare a usare i ricevitori di terze parti, consulta Repository di webhook. Per ulteriori informazioni sulla creazione di webhook Notebook Server eWorkflow Manager, consulta Flussi di lavoro automatici con ArcGIS Notebooks e Creare lavori con webhook rispettivamente.