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 biblioteki fragmentów kodu notatnika w twoich zasobach, 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.
- Kliknij przycisk Utwórz.
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 każdej bibliotece, której udostępnianie jest skonfigurowane na ustawienie Dziedzicz.
- Dodaj fragment kodu.
- 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:
W przypadku notatników korzystających ze środowiska wykonawczego w wersji 7.0 lub wcześniejszej skopiuj i wklej kod z komórki notatnika, zamiast bezpośrednio 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 i klikając opcję Edytuj.
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ę Dodaj 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.
- Odpytaj dzienniki portalu i zapisz jako plik CSV (tylko oprogramowanie ArcGIS Enterprise).
- Zaloguj się do 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 roboczych.
- Utwórz geobazę plikową z pustą klasą obiektów.
- Utwórz folder w katalogu przestrzeni roboczych.
- Pobierz element pliku z portalu do katalogu przestrzeni roboczych.
- Wyświetl listę zestawów danych.
- Wyświetl listę plików.
- Usuń geobazę plikową w katalogu przestrzeni roboczych.
- Usuń folder w katalogu przestrzeni roboczych.
- 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 roboczych.
- 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ą.