Elementy webhook w oprogramowaniu ArcGIS Online

Element webhook to metoda umożliwiająca aplikacji lub usłudze internetowej wysyłanie informacji w czasie zbliżonym do rzeczywistego do innej usługi internetowej. Komunikacja jest uruchamiana przez określone zdarzenie lub zdarzenia, które sam definiujesz. Zamiast wielokrotnie sprawdzać dostępność aktualizacji, system wysyła powiadomienie natychmiast po wystąpieniu zdarzenia wyzwalającego.

W usłudze ArcGIS Online można tworzyć elementy webhook dla hostowanych warstw obiektowych, widoków hostowanych warstw obiektowych oraz hostowanych tabel. Te elementy webhook wysyłają dane do odbiornika elementów webhook na podstawie zdefiniowanych wyzwalaczy zdarzeń. Odbiornik jest skonfigurowany do wykonywania automatycznych działań, takich jak powiadamianie z góry określonej listy odbiorców o zmianach, eksportowanie informacji o zmianach do zewnętrznej aplikacji w celu utworzenia raportu zmian lub uruchamianie skryptów kontroli jakości na edytowanych danych.

Komponenty tego kanału komunikacyjnego są następujące:

• Wyzwalacz zdarzenia — każdy wyzwalacz zdarzenia określa operacje API wykonywane w źródłowej usłudze obiektowej elementu, która wywołuje element webhook. Gdy użytkownik wykona operację określoną jako wyzwalacz zdarzenia, element webhook dostarczy tę informację (jako ładunek) do odbiornika elementu webhook. Wyzwalacze określa się podczas tworzenia elementu webhook. Aby zapoznać się z konkretnymi wyzwalaczami zdarzeń, które można ustawić, zapoznaj się z sekcją Wyzwalacze zdarzeń warstwy obiektowej.
• Ładunek — ładunek zawiera informacje odpowiednie dla zdarzenia wyzwalającego. Informacje na temat zawartości ładunku można znaleźć w sekcji Ładunki elementów webhook warstwy obiektowej.
• Odbiornik elementu webhook — odbiornik elementu webhook przyjmuje dane i wysyła informacje do wcześniej zdefiniowanej listy odbiorców (użytkowników lub aplikacji). Na przykład może wysłać wiadomość e-mail lub SMS powiadamiający użytkownika o wystąpieniu zdarzenia wyzwalającego, wysłać informacje o zdarzeniu wyzwalającym do zewnętrznej bazy danych w celu archiwizacji lub uruchomić skrypt na danych w oparciu o zdarzenie wyzwalające, które miało miejsce.

  Jako odbiorników elementów webhook możesz używać odbiorników usług internetowych innych firm lub niestandardowych usług internetowych. Aby odbierać dane, należy skonfigurować odbiorniki elementów webhook do komunikacji za pośrednictwem połączenia HTTPS, a instytucja ArcGIS Online musi mieć dostęp do odbiorników przed dodaniem elementu webhook do elementu. Dostęp do odbiornika elementu webhook uzyskuje się poprzez adres URL ładunku, który określa się podczas tworzenia elementu webhook.

Odbiornik elementu webhook jest konfigurowany poza usługą ArcGIS Online. Po skonfigurowaniu odbiornika można utworzyć element webhook.

Wymagania

Zanim będzie można utworzyć element webhook hostowanej warstwy obiektowej, widoku lub tabeli, element musi spełniać następujące wymagania:

• Ustawienie Śledź zmiany danych (dodanie, aktualizację, usunięcie obiektów) musi być włączone.
• Element nie może znajdować się w koszu.

Każdy element może mieć maksymalnie 10 elementów webhook.

Tworzenie elementów webhook

Typy członków instytucji, którzy mogą tworzyć i zarządzać elementami webhook dla hostowanych warstw obiektowych, widoków hostowanych warstw obiektowych i hostowanych tabel, są wymienione w poniższej tabeli wraz z informacjami o tym, gdzie mogą oni zarządzać elementami webhook.

Typ członka instytucji	Gdzie można zarządzać elementami webhook
Członkowie o domyślnej roli administratora lub członkowie o niestandardowej roli, która obejmuje zestaw uprawnień administracyjnych do tworzenia i zarządzania elementami webhook.	Instytucja > Ustawienia > Elementy webhook — w tym miejscu administrator instytucji może uzyskać dostęp do wszystkich elementów webhook w instytucji w celu zarządzania nimi. Może on również zdefiniować zaawansowane ustawienia elementów webhook, które mają wpływ na wszystkie elementy webhook w instytucji. Moje ustawienia — ta lokalizacja zapewnia dostęp do wszystkich elementów webhook należących do łączącego się użytkownika. Karta Ustawienia strony elementu hostowanej warstwy obiektowej, widoku lub tabeli — administrator instytucji może tworzyć i zarządzać z tego miejsca elementami webhook określonego elementu.
Właściciele elementu	Moje ustawienia — ta lokalizacja zapewnia dostęp do wszystkich elementów webhook należących do łączącego się użytkownika. Karta Ustawienia strony elementu hostowanej warstwy obiektowej, widoku lub tabeli — właściciel może tworzyć i zarządzać z tego miejsca elementami webhook określonego elementu.
Członkowie grupa udostępnionych aktualizacji, której element został udostępniony.	Karta Ustawienia strony elementu hostowanej warstwy obiektowej, widoku lub tabeli — członek grupy może tworzyć elementy webhook dla określonego elementu i zarządzać nimi.

Postępuj zgodnie z instrukcjami odpowiednimi dla Twojej roli w instytucji, aby utworzyć element webhook:

• Administrator instytucji
• Właściciel elementu lub członek grupy udostępnionych aktualizacji, której element został udostępniony.