In ArcGIS Notebooks können Sie vorgefertigten, wiederverwendbaren Code, sog. Codeausschnitte, durchsuchen, erstellen und in ein Notebook einfügen.
Erstellen eines Codeausschnitts
Sie können einen Codeausschnitt in Ihrem Notebook erstellen. Die von Ihnen erstellten Ausschnitte können im selben Notebook oder in anderen Notebooks verwendet werden. Von Ihnen erstellte Codeausschnitte werden in den Elementen der Notebook-Codeausschnitt-Bibliothek gespeichert, mit denen Sie Ihre Ausschnitte organisieren und die Sie freigeben können.
Um einen Codeausschnitt zu erstellen, müssen Sie zunächst eine Notebook-Codeausschnitt-Bibliothek erstellen, in der Sie Ihre Ausschnitte speichern. Eine Codeausschnitt-Bibliothek kann bis zu 100 Ausschnitte enthalten.
Erstellen einer Notebook-Codeausschnitt-Bibliothek
Führen Sie zum Erstellen einer Codeausschnitt-Bibliothek die folgenden Schritte aus:
- Öffnen Sie ein Notebook.
- Klicken Sie auf dem Menüband oben im Notebook-Editor auf Codeausschnitte.
- Klicken Sie auf die Schaltfläche Hinzufügen
, und wählen Sie die Option Bibliothekselement erstellen aus. - Geben Sie einen Titel und eine Zusammenfassung für die Bibliothek ein, und fügen Sie optional Tags für die in der Bibliothek gespeicherten Codeausschnitte hinzu.
- Sie können auch unter Ordner einen Speicherort auswählen, in dem Ihre Bibliothek mit Codeausschnitten gespeichert werden soll.
- Klicken Sie auf Erstellen.
Wenn Sie eine Codeausschnitt-Bibliothek erstellen, wird sie wie jedes andere Element in Ihrer Organisation gespeichert. Sie können die Codeausschnitt-Bibliotheken verwalten, indem Sie auf die Schaltfläche Weitere Optionen 
im Bereich Codeausschnitte und dann auf Bibliothekselemente verwalten klicken. Im Fenster Codeausschnitt-Bibliothekselemente verwalten können Sie eine neue Codeausschnitt-Bibliothek erstellen. Für jede Codeausschnitt-Bibliothek können Sie die Elementseite freigeben, bearbeiten und anzeigen. Außerdem können Sie eine Bibliothek als veraltet markieren.
Hinzufügen eines Codeausschnitts
Nach dem Erstellen einer Bibliothek können Sie ihr Codeausschnitte hinzufügen. Gehen Sie wie folgt vor, um einen Codeausschnitt hinzuzufügen:
- Öffnen Sie ein Notebook.
- Klicken Sie auf dem Menüband oben im Notebook-Editor auf Codeausschnitte.
- Klicken Sie auf die Schaltfläche Hinzufügen , und wählen Sie die Option Codeausschnitt hinzufügen aus.
- Geben Sie einen Titel für den Codeausschnitt ein, wählen Sie die Bibliothek aus, zu der Sie ihn hinzufügen möchten, und geben Sie eine Beschreibung ein.
Die Dropdown-Liste Codeausschnitt-Bibliothekselement auswählen zeigt die Bibliotheken an, denen Sie Ihren Ausschnitt hinzufügen können. Die Liste zeigt auch die Anzahl der Ausschnitte in dieser Bibliothek an.
- Klicken Sie auf Speichern.
Sie können Änderungen an den Codeausschnitten vornehmen, indem Sie auf die Schaltfläche Weitere Optionen für den jeweiligen Ausschnitt klicken. Das Dropdown-Menü Weitere Optionen enthält Optionen, mit denen Sie einen Ausschnitt bearbeiten, als veraltet einstufen und löschen können.
Einfügen eines Codeausschnitts
Führen Sie im Bereich Codeausschnitte die folgenden Schritte aus, um einen Codeausschnitt einzufügen:
- Öffnen Sie ein Notebook.
- Klicken Sie auf dem Menüband oben im Notebook-Editor auf Codeausschnitte.
- Navigieren Sie zu der Codeausschnitt-Bibliothek, die den Codeausschnitt enthält, den Sie einfügen möchten.
- Klicken Sie auf Details anzeigen für den Ausschnitt, um eine Vorschau des Codes anzuzeigen.
- Wenn Sie den geeigneten Codeausschnitt gefunden haben, können Sie auf die Schaltfläche Hinzufügen im Bereich "Codeausschnitte" oder auf In Notebook einfügen im Bereich mit der Code-Vorschau klicken, um den Codeausschnitt als neue Zelle in das Notebook einzufügen.
Nachfolgend finden Sie ein Beispiel für einen Codeausschnitt, den Sie einem Notebook hinzufügen können:
# 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)Codeausschnitte von Esri
Alle verfügbaren Codeausschnitte werden von Esri kuratiert. Anhand dieser kuratierten Codeausschnitte können Sie häufig auszuführende GIS-Workflows in Notebooks implementieren. Die Codeausschnitte sind als Python-Funktionen konzipiert, die in das Notebook eingefügt und darüber aufgerufen werden können. Es besteht ebenfalls die Möglichkeit, einen Codeausschnitt zu bearbeiten, nachdem er einem Notebook hinzugefügt wurde.
Nachfolgend aufgeführt sind verfügbare Codeausschnitte, die einem Notebook hinzugefügt werden können:
- GIS-Verwaltung: Codeausschnitte, mit denen häufige GIS-Verwaltungsaufgaben ausgeführt werden.
Hinweis:
Für viele der Codeausschnitte ist eine Administratorverbindung erforderlich.
- Verbleibende Credits prüfen (nur ArcGIS Online)
- Credits für einen bestimmten Benutzer prüfen (nur ArcGIS Online)
- Die Basis-Service-URL eines Layer-Elements abrufen
- Fehlgeschlagene Notebook-Tasks abfragen
- Portal-Protokolle abfragen und als CSV speichern (nur ArcGIS Enterprise)
- Beim Portal für ArcPy anmelden
- Content-Management: Codeausschnitte, mit denen Sie Inhalte in Ihrem GIS und Dateien im Workspace-Verzeichnis des Notebooks verwalten können
- Geodatabase in Workspace-Verzeichnis kopieren
- File-Geodatabase mit leerer Feature-Class erstellen
- Ordner in Workspace-Verzeichnis erstellen
- Dateielement aus Portal in Workspace-Verzeichnis herunterladen
- Datasets auflisten
- Dateien auflisten
- File-Geodatabase aus Workspace-Verzeichnis entfernen
- Ordner aus Workspace-Verzeichnis entfernen
- Datei in Workspace-Verzeichnis entzippen
- Data Science und Analyse: Codeausschnitte, die mithilfe der ArcGIS API for Python- und ArcPy-Bibliotheken sowie anderer Python-Bibliotheken in Ihre Data-Science- und Analyse-Workflows implementiert werden können.
Hinweis:
Nutzen Sie zum Ausführen von Codeausschnitten, die ArcPy erfordern, die Advanced-Notebook-Runtime. Weitere Informationen zu Notebook-Runtimes finden Sie unter Festlegen der Runtime eines Notebooks.
- Feature-Class in Feature-Layer konvertieren
- Feature-Class in räumlich aktivierten Datenrahmen konvertieren
- Feature-Layer in räumlich aktivierten Datenrahmen konvertieren
- Räumlich aktivierten Datenrahmen in Feature-Class konvertieren
- Bild aus URL anzeigen
- Bild aus Workspace-Verzeichnis anzeigen
- Fehlende Werte ausfüllen
- Felder in einer Feature-Class auflisten
- Felder in einem Layer auflisten
- Layer in einem Element auflisten
- Räumlich aktivierten Datenrahmen schnell plotten
- Räumlich aktivierten Datenrahmen mit Klassengrenzen-Renderer plotten
- Räumlich aktivierten Datenrahmen mit einfachem Renderer plotten
- Räumlich aktivierten Datenrahmen mit Einzelwert-Renderer plotten
- Räumlich aktivierten Datenrahmen als Feature-Layer veröffentlichen