Elementy webhook wysyłają informacje, gdy występują pewne zdarzenia, które wpływają na usługę. W usłudze ArcGIS Online można tworzyć elementy webhook dla usług obiektowych, które zapełniają hostowane warstwy obiektowe, hostowane widoki warstw obiektowych i hostowane tabele, a także definiować zdarzenia powodujące wywołanie elementów webhook.
Element musi mieć włączone ustawienie edycji Śledź zmiany danych (dodanie, aktualizację, usunięcie obiektów) przed utworzeniem dla niego elementu webhook lub uzyskaniem możliwości zarządzania tym elementem.
Tworzenie elementu webhook
Możesz utworzyć element webhook dla hostowanej warstwy obiektowej, widoku hostowanej warstwy obiektowej lub hostowanej tabeli, aby korzystać z wyzwalaczy i komunikatów, które mogą powiadamiać lub wspierać automatyzację zadań dla tych elementów.
Infrastruktura do obsługi elementów webhook jest konfigurowana poza ArcGIS. Informacje na temat elementów, które należy skonfigurować przed utworzeniem elementu webhook oraz na temat uprawnień wymaganych do zarządzania elementami webhook podano w sekcji Elementy webhook w ArcGIS Online.
Aby utworzyć element webhook hostowanej warstwy obiektowej, widoku hostowanej warstwy obiektowej lub hostowanej tabeli, wykonaj następujące czynności:
- Zaloguj się do instytucji.
- Otwórz stronę elementu hostowanej warstwy obiektowej, widoku lub tabeli.
- Kliknij kartę Ustawienia.
- Przewiń do sekcji Elementy webhook i kliknij Utwórz element webhook.
Jeśli przycisk Utwórz element webhook jest nieaktywny, warstwa może nie mieć włączonej opcji Śledź zmiany danych (dodanie, aktualizację, usunięcie obiektów).
W przypadku widoków opcja Śledź zmiany danych (dodanie, aktualizację, usunięcie obiektów) musi być włączona w źródłowej hostowanej warstwie obiektowej.
- Podaj nazwę elementu webhook.
- Rozwiń menu Zdarzenia i zaznacz wszystkie pola wyboru zdarzeń, które mają wyzwalać element webhook.
- W polu tekstowym Adres URL odbiornika elementu webhook podaj adres URL odbiornika elementu webhook.
Odbiornik musi już istnieć i być skonfigurowany do komunikacji za pomocą bezpiecznego połączenia HTTPS.
- Aby zapewnić wyższy poziom bezpieczeństwa, można opcjonalnie podać klucz tajny.
Przed podaniem klucza tajnego do elementu webhook należy skonfigurować go w odbiorniku elementu webhook.
- Podaj nazwę elementu webhook.
Element webhook pojawia się na liście elementów webhook tego elementu.
Zarządzanie elementami webhook
Elementami webhook można zarządzać na karcie Ustawienia na stronie elementu.
Właściciele elementów mogą również uzyskać dostęp do wszystkich posiadanych przez siebie elementów webhook i zarządzać nimi w sekcji Moje ustawienia.
Wskazówka:
Administratorzy instytucji mają dostęp do wszystkich elementów webhook w instytucji i mogą nimi zarządzać w karcie Instytucja > Ustawienia > Elementy webhook. Więcej informacji można znaleźć w sekcji Zarządzanie elementami webhook w całej instytucji.
Zarządzanie elementem webhook powiązanym z hostowaną warstwą obiektową, widokiem hostowanej warstwy obiektowej lub hostowaną tabelą obejmuje następujące czynności:
- Dezaktywacja lub aktywacja elementu webhook – jeśli element webhook jest w stanie nieaktywnym, nie uruchamia się, gdy wystąpią zdefiniowane dla niego zdarzenia wyzwalające. Możesz tymczasowo wyłączyć wszystkie elementy webhook w warstwie podczas wykonywania automatycznych aktualizacji, aby uniknąć zapełnienia skrzynki odbiorczej wiadomościami. Możesz też tymczasowo wyłączyć jeden element webhook, który uruchamia się dla wszystkich możliwych zdarzeń i pozostawić aktywny inny element webhook, który uruchamia się po zadziałaniu jednego wyzwalacza, aby tymczasowo skupić się na tym jednym zdarzeniu.
- Edytowanie elementu webhook – możesz zmieniać ustawienia danego elementu webhook. Możesz na przykład dodać klucz tajny lub zmienić wyzwalacze zdarzeń, które powodują uruchomienie webhooka.
- Usuwanie elementu webhook – jeśli nie jest już potrzebny, możesz go usunąć.
Notatka:
Elementy webhook są natychmiast usuwane. Nie są one przenoszone do kosza.
Zarządzanie elementami webhook na stronie elementu
Aby zarządzać elementem webhook na stronie elementu hostowanej warstwy obiektowej, widoku hostowanej warstwy obiektowej lub hostowanej tabeli, z którą jest on związany, wykonaj następujące czynności:
- Zaloguj się do instytucji.
- Otwórz stronę elementu hostowanej warstwy obiektowej, widoku lub tabeli.
- Kliknij kartę Ustawienia i przewiń do sekcji elementów webhook.
Są tutaj wymienione wszystkie elementy webhook powiązane z tym elementem.
- Wykonaj jedno z następujących zadań zarządzania:
- Aby dezaktywować element webhook, ustaw przycisk przełącznika obok jego nazwy w pozycji wyłączonej.
- Aby aktywować element webhook, ustaw przycisk przełącznika obok jego nazwy w pozycji włączonej.
- Aby edytować ustawienia elementu webhook, kliknij przycisk Opcje
obok jego nazwy, a następnie kliknij Edytuj. Zmień nazwę, zdarzenia, adres URL odbiornika elementu webhook lub klucz tajny i kliknij Aktualizuj element webhook. - Aby usunąć element webhook, kliknij przycisk Opcje obok jego nazwy, a następnie kliknij Usuń. Kliknij Usuń, aby potwierdzić.
Zarządzanie elementami webhook w sekcji Moje ustawienia
Aby zarządzać elementami webhook w sekcji Moje ustawienia, wykonaj następujące czynności:
- Zaloguj się do instytucji.
- Kliknij swoją nazwę członka u góry witryny i kliknij opcję Moje ustawienia.
- Kliknij kartę Elementy webhook.
- Wykonaj jedno z następujących zadań zarządzania:
- Aby dezaktywować element webhook, ustaw przycisk przełącznika obok jego nazwy w pozycji wyłączonej.
- Aby aktywować element webhook, ustaw przycisk przełącznika obok jego nazwy w pozycji włączonej.
- Aby edytować ustawienia elementu webhook, kliknij przycisk Opcje obok jego nazwy, a następnie kliknij Edytuj. Zmień nazwę, zdarzenia, adres URL odbiornika elementu webhook lub klucz tajny i kliknij Aktualizuj element webhook.
- Aby usunąć element webhook, kliknij przycisk Opcje obok jego nazwy, a następnie kliknij Usuń. Kliknij Usuń, aby potwierdzić.