Wprowadzone w produkcie ArcGIS Enterprise 11.0 oprogramowanie ArcGIS Notebook Server pozwala przeglądać i wstawiać do notatnika wcześniej napisane kawałki kodu wielokrotnego użytku nazywane fragmentami kodu.
Tworzenie fragmentu kodu
Fragment kodu można utworzyć z poziomu notatnika. Utworzone fragmenty kodu mogą być używane w tym samym notatniku lub w innych notatnikach. Tworzone fragmenty kodu są przechowywane w elementach bibliotek fragmentów kodu notatnika, które służą do porządkowania fragmentów kodu i mogą być udostępniane.
Aby utworzyć fragment kodu, musisz najpierw utworzyć bibliotekę fragmentów kodu, w której będziesz przechowywać swoje fragmenty. Biblioteka fragmentów kodu może zawierać maksymalnie 100 fragmentów.
Tworzenie biblioteki fragmentów kodu notatnika
Aby utworzyć bibliotekę fragmentów kodu, wykonaj następujące czynności:
- Na górnej wstążce edytora notatników kliknij opcję Fragmenty kodu.
- Kliknij przycisk Dodaj i wybierz opcję Utwórz element biblioteki.
- Wprowadź tytuł oraz podsumowanie biblioteki, a opcjonalnie dodaj znaczniki reprezentujące fragmenty kodu przechowywane w bibliotece.
- Opcjonalnie w sekcji Moje zasoby wybierz folder, w którym chcesz zapisać bibliotekę fragmentów kodu.
- Kliknij przycisk Utwórz.
Gdy tworzysz bibliotekę fragmentów kodu, zostaje ona zapisana w Twojej instytucji, tak jak każdy inny element. Możesz zarządzać bibliotekami fragmentów kodu, klikając przycisk Więcej opcji w panelu Fragmenty kodu i klikając opcję Zarządzaj elementami biblioteki. W oknie Zarządzaj elementami biblioteki fragmentów kodu można utworzyć nową bibliotekę fragmentów kodu, a w przypadku każdej biblioteki fragmentów kodu można ją udostępniać i edytować, wyświetlać jej stronę szczegółów elementu oraz oznaczać ją jako przestarzałą.
Dodanie fragment kodu
Po utworzeniu biblioteki możesz dodać do niej fragmenty kodu. Aby dodać fragment kodu, wykonaj następujące czynności:
- Na górnej wstążce edytora notatników kliknij opcję Fragmenty kodu.
- Kliknij przycisk Dodaj i wybierz opcję Dodaj fragment kodu.
- Wprowadź tytuł fragmentu kodu, wybierz bibliotekę, do której chcesz go dodać i wprowadź opis.
Na liście rozwijanej Wybierz element biblioteki fragmentów kodu wyświetlane są biblioteki, do których można dodać fragment kodu. Na tej liście widoczna jest także liczba fragmentów kodu w tej bibliotece.
- Dodaj kod dla fragmentu, wykonując jedną z następujących czynności:
- Jeśli notatnik korzysta ze środowiska wykonawczego w wersji 8.0 lub nowszej, wybierz komórkę, którą chcesz dodać jako fragment kodu i kliknij opcję Kopiuj z aktywnej komórki.
- Jeśli notatnik korzysta ze środowiska wykonawczego w wersji 7.0 lub wcześniejszej, wprowadź fragment kodu.
Notatka:
Skopiuj i wklej kod z komórki notatnika, zamiast bezpośredniego wpisywać kod, aby uniknąć wcięć lub innych błędów składniowych.
- Kliknij przycisk Zapisz.
Zmiany we fragmentach kodu można wprowadzać, klikając przycisk Więcej opcji dla fragmentu kodu. Menu rozwijane Więcej opcji umożliwia edytowanie, wycofywanie i usuwanie ekstraktów.
Wstawianie fragmentu kodu
Aby wstawić fragment kodu, wykonaj na panelu Fragmenty kodu następujące czynności:
- Na górnej wstążce edytora notatników kliknij opcję Fragmenty kodu.
- Przejdź do biblioteki fragmentów kodu zawierającej fragment, który chcesz wstawić.
- Kliknij opcję Wyświetl szczegóły dla fragmentu kodu, aby zobaczyć jego podgląd.
- Po znalezieniu fragmentu kodu do wstawienia kliknij przycisk Dodaj w panelu fragmentów kodu lub opcję Wstaw do notatnika w panelu podglądu kodu, aby wstawić fragment kodu do notatnika jako nową komórkę.
Poniżej znajduje się przykład fragmentu kodu dodanego do notatnika:
# curated code snippet inserted from the Code snippets pane
from arcgis.gis import GIS
def check_org_credits_agol(gis: GIS):
if "admin" in gis.__dict__:
credits = gis.admin.credits.credits
print(f"This ArcGIS Online organization has {credits} credits.")
else:
print("Please connect to the ArcGIS Online organization as an administrator to check credits.")
# create a GIS instance to pass to the code snippet function
gis_agol = GIS("https://www.arcgis.com/", "<admin_username>")
# call the code snippet function with your GIS instance
check_org_credits_agol(gis_agol)
Fragmenty kodu Esri
Wszystkie dostępne fragmenty kodu są obsługiwane przez Esri. Te obsługiwane fragmenty kodu umożliwiają implementowanie w notatnikach typowych procedur wykonywania zadań GIS. Fragmenty kodu są napisane w postaci funkcji w języku Python, które można wstawić do notatnika i w nim wywoływać. Fragment kodu można również edytować po dodaniu do notatnika.
Notatka:
W wersji 11.0 nazwy i opisy obsługiwanych fragmentów kodu są dostępne tylko w języku angielskim.
Poniżej znajdują się dostępne fragmenty kodu, które można wstawić do notatnika:
- Administrowanie systemem GIS — fragmenty kodu, które wykonują typowe zadania administrowania systemem GIS.
Notatka:
Wiele z tych fragmentów kodu wymaga połączenia administratora.
- Sprawdź pozostałe kredyty (tylko usługa ArcGIS Online).
- Sprawdź kredyty konkretnego użytkownika (tylko usługa ArcGIS Online).
- Uzyskaj podstawowy adres URL usługi elementu warstwy
- Wykonywanie zapytań dotyczących nieudanych zadań notatnika
- Odpytaj dzienniki portalu i zapisz jako plik CSV (tylko oprogramowanie ArcGIS Enterprise)
- Zaloguj się w portalu dla ArcPy
- Zarządzanie zasobami — fragmenty kodu, które pomagają w zarządzaniu zasobami w systemie GIS i plikami w katalogu przestrzeni roboczych notatników.
- Skopiuj geobazę w katalogu przestrzeni roboczej
- Utwórz geobazę plikową z pustą klasą obiektów
- Utwórz folder w katalogu przestrzeni roboczej
- Pobierz element pliku z portalu do katalogu przestrzeni roboczej
- Wyświetlanie listy zestawów danych
- Wyświetlanie listy plików
- Usuń geobazę plikową w katalogu przestrzeni roboczej
- Usuń folder w katalogu przestrzeni roboczej
- Rozpakuj plik w katalogu przestrzeni roboczych
- Analizy i naukowa analiza danych — fragmenty kodu, które można zaimplementować w procedurach wykonywania zadań analizy i naukowej analizy danych, wykorzystujące ArcGIS API for Python, ArcPy i inne biblioteki języka Python.
Notatka:
Użyj zaawansowanego środowiska wykonawczego notatników, aby uruchomić fragmenty kodu wymagające pakietu ArcPy. Więcej informacji na temat środowisk wykonawczych notatników zawiera sekcja Podawanie środowiska wykonawczego notatnika.
- Przekształć klasę obiektów w warstwę obiektową
- Przekształć klasę obiektów w ramkę danych przestrzennych
- Przekształć warstwę obiektową w ramkę danych przestrzennych
- Przekształć ramkę danych przestrzennych w klasę obiektów
- Wyświetl obraz z adresu URL
- Wyświetl obraz z katalogu przestrzeni roboczej
- Wypełnij brakujące wartości
- Wyświetl listę pól w klasie obiektów
- Wyświetl listę pól w warstwie
- Wyświetl listę warstw w elemencie
- Wykreśl ramkę danych przestrzennych (szybki start)
- Wykreśl ramkę danych przestrzennych za pomocą modułu renderowania granic klas
- Wykreśl ramkę danych przestrzennych za pomocą prostego modułu renderowania
- Wykreśl ramkę danych przestrzennych za pomocą modułu renderowania wartości unikalnych
- Publikuj ramkę danych przestrzennych jako warstwę obiektową