Publikowanie notatnika jako narzędzia internetowego

Aplikacja ArcGIS Notebooks umożliwia publikowanie notatników jako narzędzi internetowych. Administratorzy i autorzy notatników z uprawnieniem Publikowanie narzędzi internetowych mogą publikować posiadane notatniki jako narzędzia internetowe. Gdy notatnik jest publikowany jako narzędzie internetowe, zostaje utworzona usługa asynchronicznego geoprzetwarzania, która jest rejestrowana jako narzędzie internetowe. Między notatnikiem a narzędziem internetowym istnieje relacja jeden do jednego, co oznacza, że można opublikować tylko jedno narzędzie internetowe na jeden notatnik. Narzędzia internetowe mogą być wykorzystywane przez dowolną aplikację kliencką, która pracuje z asynchronicznymi usługami geoprzetwarzania zgodnymi ze specyfikacją REST.

Publikowanie notatnika jako narzędzia internetowego jest obsługiwane dla notatników ze środowiska wykonawczego w wersji 8.0 lub nowszej. Aby sprawdzić informacje o środowisku wykonawczym notatnika, kliknij przycisk Informacje na górnej wstążce edytora notatników lub na karcie Ustawienia na stronie szczegółów elementu notatnika. Aby dowiedzieć się więcej na temat środowisk wykonawczych notatników, przejdź do sekcji Wyświetlanie dostępnych bibliotek języka Python.

Edytor notatników pozwala skonfigurować parametry wejściowe i wynikowe dla notatnika. Parametry wejściowe odpowiadają zmiennym wejściowym w notatniku, które mają zostać uzewnętrznione dla danych wejściowych użytkownika, gdy notatnik jest uruchomiony jako narzędzie internetowe. Parametry wynikowe reprezentują zmienne wynikowe w notatniku, które mają zostać zwrócone jako dane wynikowe narzędzia internetowego. Po zarejestrowaniu co najmniej jednej zmiennej wejściowej lub wynikowej i opublikowaniu notatnika parametry stają się dostępne jako parametry wejściowe lub wynikowe dla odpowiedniego narzędzia internetowego.

Notatka:

Przy publikowaniu notatnika jako narzędzia internetowego nie jest wymagane zdefiniowanie parametrów wejściowych lub wynikowych. Na przykład notatniki, które wykonują zadania z predefiniowanymi danymi wejściowymi i wynikowymi, takimi jak warstwy obiektowe przywoływane za pomocą itemId, mogą nie wymagać parametrów wejściowych ani wynikowych.

Notatka:

Jako parametry wejściowe lub wynikowe są obsługiwane następujące typy danych: ciąg znakowy (String), liczba długa (Long), liczba o podwójnej precyzji (Double), wartość logiczna (Boolean), zestaw obiektów, zestaw rekordów, data (Date), jednostka liniowa, warstwa danych rastrowych i plik. Więcej informacji zawiera temat Typy danych usług geoprzetwarzania w dokumentacji interfejsu ArcGIS REST API.

Po uruchomieniu narzędzia internetowego program ArcGIS Notebooks wykonuje zautomatyzowane uruchomienie notatnika, otwierając nowy kontener i uruchamiając notatnik bez interakcji z użytkownikiem. Użytkownicy z uprawnieniem do uruchamiania narzędzi internetowych i użytkownicy, którym udostępniono narzędzie internetowe, mogą uzyskać do niego dostęp i je uruchamiać. Oprócz wymaganego uprawnienia do uruchamiania narzędzi internetowych wymagane są wszelkie inne uprawnienia potrzebne do uruchomienia notatnika. Zapoznaj się z tematem Typy użytkowników, role i uprawnienia, aby dowiedzieć się więcej o uprawnieniach.

Notatka:

W przypadku utworzenia notatnika do udostępnienia jako narzędzia internetowego, jeśli notatnik odwołuje się do pliku z katalogu obszaru roboczego jako do danych wejściowych, te pliki nie będą dostępne dla innych osób, którym udostępniono notatnik lub narzędzie internetowe. Jeśli masz plik, który ma być przywoływany jako dane wejściowe w notatniku, możesz odwołać się do niego przez udostępniony element w zasobach ArcGIS.

Notatka:

Jeśli w edytorze notatników nie widzisz opcji Parametry lub Publikuj, to albo nie masz uprawnienia Publikowanie narzędzi internetowych, albo nie jesteś właścicielem notatnika. W nowo utworzonym notatniku opcje Parametry i Publikuj nie są wyświetlane, dopóki notatnik nie zostanie zapisany.

Konfigurowanie parametrów wejściowych

Parametry wejściowe reprezentują zmienne wejściowe w notatniku, które są obsługiwane na zewnątrz, gdy notatnik jest uruchamiany jako narzędzie internetowe. Na panelu Parametry w edytorze notatników można skonfigurować i dodać parametry wejściowe jako zmienne do notatnika.

1. W edytorze notatników kliknij opcję Parametry.
2. Kliknij przycisk Dodaj.
3. Wybierz dane wejściowe dla wartości Kierunek.
4. Wprowadź nazwę w polu Nazwa zmiennej.

   Notatka:

   Ta wartość musi być zgodna z nazwą zmiennej znajdującej się w kodzie notatnika lub skonfigurowanej już w notatniku.

5. Wprowadź nazwę w polu Nazwa wyświetlana dla parametru narzędzia internetowego.
6. W menu rozwijanym Typ danych wybierz typ danych parametru wejściowego.
7. W polu Typ parametru wybierz opcję Wymagany lub Opcjonalny.
8. Opcjonalnie, jeśli typem danych parametrów wejściowych jest Ciąg znakowy, Długie lub Podwójnej precyzji, skonfiguruj listę wyboru, wprowadzając wartości w sekcji Lista wyboru (opcjonalna).

   Po skonfigurowaniu listy wyboru użytkownik narzędzia internetowego musi wybrać wartość z menu rozwijanego podczas uruchamiania narzędzia. Jeśli na przykład użytkownik otworzy narzędzie w przeglądarce map Map Viewer, może dokonać wyboru z menu rozwijanego skonfigurowanych wartości parametrów.

9. Wprowadź wartość w polu Wartość domyślna dla parametru wejściowego. Składnię wartości domyślnych obsługiwanych typów danych zawiera temat Typy danych usług geoprzetwarzania.
10. W polu Opis wprowadź opis parametru wejściowego.
11. Kliknij przycisk Zapisz, aby zapisać parametr wejściowy.
12. Aby dodać więcej parametrów wejściowych, powtórz czynności od 1 do 9.
13. Po dodaniu wszystkich parametrów wejściowych wybierz komórkę w notatniku, do której będą wstawione parametry i kliknij opcję Wstaw jako zmienne.
14. Kliknij przycisk Zapisz, aby zapisać notatnik.

Konfigurowanie parametrów wynikowych

Dane wynikowe notatnika opublikowanego jako narzędzie internetowe można skonfigurować, ustawiając parametry wynikowe w okienku Parametry w edytorze notatników.

1. W edytorze notatników kliknij opcję Parametry.
2. Kliknij przycisk Dodaj.
3. Wybierz dane wynikowe parametru Kierunek.
4. Wprowadź nazwę w polu Nazwa zmiennej.

   Notatka:

   Ta wartość musi być zgodna z nazwą zmiennej znajdującej się w kodzie notatnika lub skonfigurowanej już w notatniku.

5. Wprowadź nazwę w polu Nazwa wyświetlana dla parametru narzędzia internetowego.
6. W menu rozwijanym Typ danych wybierz typ danych parametru wynikowego.
7. W polu Typ parametru wybierz opcję Wymagany lub Opcjonalny.
8. Wprowadź wartość w polu Wartość domyślna dla parametru wynikowego. Składnię wartości domyślnych obsługiwanych typów danych zawiera temat Typy danych usług geoprzetwarzania.
9. W polu Opis wpisz opis parametru wynikowego.
10. Kliknij przycisk Zapisz, aby zapisać parametr wynikowy.
11. Wybierz komórkę w notatniku. Kliknij przycisk Dodaj, aby dodać fragment kodu w języku Python do zapisania danych wynikowych dla narzędzia internetowego.

    Zalecane jest wybranie komórki u dołu notatnika, poniżej komórek, w których są tworzone dane wynikowe.

12. Sprawdź dodany fragment kodu pod kątem zgodności nazw zmiennych wynikowych z danymi wynikowymi zdefiniowanymi w notatniku i wprowadź ewentualne dodatkowe korekty w tym fragmencie kodu.
13. Powtórz czynności od 1 do 11 dla każdego dodatkowego parametru wynikowego.
14. Kliknij przycisk Zapisz, aby zapisać notatnik.

Publikowanie narzędzia internetowego

Notatnik można opublikować jako narzędzie internetowe na panelu Publikowanie w edytorze notatników.

1. Zapisz notatnik, aby została opublikowana najnowsza kopia notatnika.
2. Uruchom ręcznie interaktywnie komórki notatnika, aby upewnić się, że nie występują żadne błędy.

Notatka:

Pomiń komórki zawierające fragmenty kodu dla parametrów wynikowych, ponieważ one nie są uruchamiane w trybie interaktywnym.
3. Na wstążce edytora notatników kliknij opcję Publikuj.
4. Wprowadź tytuł i opis narzędzia internetowego w polach Tytuł i Opis na panelu Publikowanie.
5. Podaj liczbę w polu Maksymalny czas wykorzystania.

   Jest to liczba minut, przez które narzędzie internetowe może kontynuować działanie, zanim system je anuluje. Minimalny dozwolony limit czasu wynosi 100 minut.

6. Zweryfikuj parametry wejściowe i wynikowe.
7. Kliknij opcję Publikuj, aby opublikować notatnik jako narzędzie internetowe.
8. Po pomyślnym opublikowaniu narzędzia internetowego kliknij opcję Wyświetl szczegóły, aby wyświetlić stronę szczegółów elementu dla narzędzia internetowego.
9. Kliknij opcję Udostępnij, aby otworzyć okno Udostępnij.
   1. Wybierz opcję Instytucja, aby udostępnić narzędzie internetowe wszystkim użytkownikom w instytucji.
   2. Kliknij opcję Edytuj udostępnianie grupie, aby udostępnić narzędzie internetowe określonym grupom.
   3. Wybierz grupy, którym chcesz udostępnić ten element.
   4. Kliknij przycisk OK.
   5. Kliknij przycisk Zapisz.

Udostępnianie narzędzia internetowego

Aby udostępnić lub zaktualizować ustawienia udostępniania istniejącego narzędzia internetowego notatnika instytucji lub określonym grupom w instytucji, wykonaj poniższe czynności.

Notatka:

Aby użytkownicy, którym udostępniane jest narzędzie internetowe, mogli uruchomić to udostępnione narzędzie, muszą mieć uprawnienie Uruchamianie narzędzi internetowych oraz wszelkie dodatkowe uprawnienia niezbędne do uruchomienia notatnika.

Narzędzi internetowych notatnika nie można udostępnić publicznie. Nawet jeśli masz uprawnienia do publicznego udostępniania danych, opcja udostępniania narzędzi internetowych notatnika Wszystkim (publicznie) nie jest dostępna.

1. Sprawdź, czy jesteś użytkownikiem zalogowanym w usłudze ArcGIS Online i masz wystarczające uprawnienia do udostępniania zasobów w instytucji.
2. Kliknij element Zasoby.
3. Zaznacz pole obok tytułu narzędzia internetowego, które chcesz udostępnić.
4. Kliknij polecenie Udostępnij.
   1. Wybierz opcję Instytucja, aby udostępnić narzędzie internetowe wszystkim użytkownikom w instytucji.
   2. Kliknij opcję Edytuj udostępnianie grupie, aby udostępnić narzędzie internetowe określonym grupom.
   3. Wybierz grupy, którym chcesz udostępnić ten element.
   4. Kliknij przycisk OK.
   5. Kliknij przycisk Zapisz.

Zastąp narzędzie internetowe

Zastąpienie narzędzia internetowego spowoduje zaktualizowanie narzędzia internetowego pod kątem korzystania z najnowszej migawki tego notatnika. Możesz zastąpić narzędzie internetowe notatnika w okienku Publikuj w edytorze notatnika.

1. Jeśli istniejący parametr wejściowy lub wyjściowy wymaga aktualizacji, wykonaj czynności opisane w sekcji Edytowanie istniejącego parametru wejściowego lub wyjściowego w tym temacie.
2. Jeśli dodajesz nowe parametry wejściowe lub wyjściowe, wykonaj czynności opisane w sekcjach Konfigurowanie parametrów wejściowych lub Konfigurowanie parametrów wyjściowych w tym temacie.
3. Kliknij przycisk Zapisz, aby zapewnić opublikowanie najnowszej kopii notatnika.
4. Ręcznie uruchom każdą komórkę w notatniku, aby upewnić się, że nie występują żadne błędy.

   Notatka:

   Nie uruchamiaj komórek zawierających fragmenty kodu dla parametrów wyjściowych, ponieważ nie będą one działać w trybie interaktywnym.

5. Kliknij przycisk Publikuj.
6. Kliknij przycisk Zastąp, aby zastąpić narzędzie internetowe.

Usuwanie narzędzia internetowego

Narzędzie internetowe opublikowane na podstawie notatnika można usunąć, usuwając element narzędzia internetowego.

1. Na górnej wstążce edytora notatników kliknij opcję Publikuj.
2. Kliknij opcję Wyświetl szczegóły, aby wyświetlić stronę szczegółów elementu narzędzia internetowego.
3. Kliknij opcję Ustawienia.
4. Kliknij opcję Usuń element i potwierdź, że chcesz usunąć element narzędzia internetowego.

Notatka:

Jeśli element notatnika, na podstawie którego opublikowano narzędzie internetowe, zostanie usunięty, element narzędzia internetowego również zostanie usunięty.

Edycja istniejącego parametru wejściowego lub wynikowego

Na panelu Parametry w edytorze notatników można wprowadzić zmiany w istniejącym parametrze wejściowym lub wynikowym.

Notatka:

Jeśli notatnik został już opublikowany jako narzędzie internetowe, przed wprowadzeniem zmian w parametrach należy włączyć przełącznik Włącz edycję na panelu Parametry. Należy zachować ostrożność podczas wprowadzania zmian w parametrach po opublikowaniu notatnika jako narzędzia internetowego, ponieważ te zmiany mogą popsuć działanie aplikacji internetowych korzystających z tego narzędzia internetowego.

1. Na górnej wstążce edytora notatników kliknij opcję Parametry.
2. Kliknij przycisk opcji znajdujący się obok parametru i kliknij opcję Edytuj.
3. Zaktualizuj parametr i kliknij przycisk Zapisz.
   1. Jeśli został zaktualizowany parametr wejściowy, wyczyść lub usuń ręcznie istniejącą komórkę ze zmiennymi wejściowymi i powtórz czynność wstawiania do notatnika parametrów wejściowych jako zmiennych.
   2. Jeśli został zaktualizowany parametr wynikowy, wyczyść ręcznie fragment kodu odpowiadający zmiennej wynikowej i powtórz czynności dodania do notatnika fragmentu kodu dla parametru wynikowego.
4. Kliknij przycisk Zapisz, aby zapisać notatnik.

Usuwanie istniejącego parametru wejściowego lub wynikowego

Na panelu Parametry można usunąć istniejące parametry wejściowe lub wynikowe.

1. Na górnej wstążce edytora notatników kliknij opcję Parametry.
2. Kliknij przycisk opcji znajdujący się obok parametru i kliknij opcję Usuń.
3. Kliknij opcję Usuń, aby trwale usunąć parametr.
4. Ręcznie wyczyść lub usuń zmienną wejściową lub wynikowy fragment kodu w notatniku.
5. Kliknij przycisk Zapisz, aby zapisać notatnik.

Użyj zasięgu mapy

Gdy narzędzie internetowe jest uruchamiane w przeglądarce map Map Viewer, modyfikacja zasięgu przetwarzania i wynikowego układu współrzędnych są przekazywane do notatnika w postaci zmiennej języka Python o nazwie context razem z innymi parametrami wejściowymi, jak pokazano poniżej.

context = {
    "extent": {
        "ymin": 1759249.9654418486,
        "xmin": 6481923.176042713,
        "ymax": 1795442.256243616,
        "xmax": 6531137.243576055,
        "spatialReference": {"latestWkid": 2229, "wkid": 102645},
    },
    "outSR": {"latestWkid": 4269},
}

Za pomocą zmiennej context można skonfigurować zasięg i wynikowy układ współrzędnych procedur wykonywania zadań analizy przestrzennej w notatniku. Aby przetestować procedury wykonywania zadań analizy przestrzennej przed opublikowaniem notatnika jako narzędzia internetowego, zadeklaruj zmienną context z wartością domyślną.

Gdy wszystko będzie gotowe do opublikowania, wstaw parametry wejściowe jako zmienne po komórce, w której deklarujesz zmienną context.