Skip To Content

Podstawowe pojęcia dotyczące elementów webhook

Element webhook udostępnia innym aplikacjom informacje sterowane zdarzeniami, które są dostarczane jako żądanie HTTPS. Za pomocą tej funkcjonalności można tworzyć zautomatyzowane i sprzyjające integracji procedury wykonywania zadań. Niektóre z kluczowych pojęć w procedurach wykonywania zadań elementów webhook ArcGIS Enterprise opisano bardziej szczegółowo w kolejnych sekcjach.

Wyzwalacz zdarzenia

Wyzwalacz zdarzenia określa operacje interfejsu API, które będą wywoływać element webhook. Elementy webhook instytucji i usług obiektowych obsługują różne wyzwalacze zdarzeń, które można subskrybować. Na przykład można ustawić wyzwalanie elementu webhook instytucji po zaktualizowaniu określonej grupy, a w przypadku elementu webhook usługi obiektowej można wybrać wyzwalanie tego elementu po zaktualizowaniu definicji usługi obiektowej. Jednak w przypadku elementów webhook usług geoprzetwarzania nie jest używana lista wyzwalaczy zdarzeń, które użytkownicy mogą subskrybować. Zamiast tego elementy webhook usług geoprzetwarzania zwracają ładunki po ukończeniu zadania geoprzetwarzania. Aby uzyskać więcej informacji na temat listy obsługiwanych wyzwalaczy zdarzeń dla elementów webhook instytucji i usług obiektowych, zapoznaj się z tematem Wyzwalacze zdarzeń.

Ładunek

W przypadku wykonania przez użytkownika operacji, która została określona jako wyzwalacz zdarzenia, element webhook dostarczy informacje o zdarzeniu, zwane również ładunkiem, na określony adres URL ładunku. Informacje o zdarzeniu dla każdego typu elementu webhook są dostarczane w podobnym schemacie JSON, który zawiera informacje o zdarzeniu i czasie wystąpienia zdarzenia. Jednak struktura ładunku i właściwości zwracane dla elementów webhook instytucji i usług różnią się w zależności od typu elementu webhook. Aby dowiedzieć się więcej o ładunkach dla poszczególnych typów elementów webhook, zapoznaj się z tematem Ładunki.

Adres URL ładunku

Po wywołaniu elementu webhook ładunek jest dostarczany na określony adres URL, często przekazany przez odbiornik elementu webhook. Adres URL ładunku jest podawany podczas konfigurowania elementu webhook i jest sprawdzany podczas tworzenia, aby upewnić się, że oprogramowanie ArcGIS Enterprise może się komunikować z odbiornikiem za pomocą żądania HTTPS POST.

Odbiorniki

Ładunki są dostarczane do odbiorników elementów webhook, które odbierają ładunek i informują administratorów lub członków instytucji, że zdarzenie miało miejsce. Odbiorniki elementów webhook muszą być skonfigurowane pod kątem komunikowania się przez połączenie HTTPS, aby mogły odbierać ładunki i aby oprogramowanie ArcGIS Enterprise mogło się z nimi komunikować. Istnieje kilka opcji obsługiwanych dla odbiorników, takich jak odbiorniki usług internetowych innych producentów (Microsoft Power Automate, Zapier i IFFT), niestandardowe usługi internetowe, ArcGIS Notebook Server i ArcGIS Workflow Manager. Aby zapoznać się z przykładami tworzenia niestandardowych usług internetowych lub aby rozpocząć korzystanie z odbiorników innych producentów, zapoznaj się z tematem Repozytorium elementów webhook. Aby dowiedzieć się więcej o tworzeniu elementów webhook Workflow Manager i Notebook Server, zapoznaj się z tematami Tworzenie zadań za pomocą elementów webhook i Automatyzacja procedur wykonywania zadań za pomocą notatników ArcGIS.