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:
- 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.
- Wählen Sie optional einen Ordner in Eigene Inhalte aus, in dem die Codeausschnitt-Bibliothek 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 Detailseite 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:
- 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 Ihren 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.
- Gehen Sie wie folgt vor, um den Code für den Ausschnitt hinzuzufügen:
- Wenn das Notebook die Runtime-Version 8.0 oder höher verwendet, markieren Sie die Zelle, die Sie als Codeausschnitt hinzufügen möchten, und klicken Sie auf Aus aktiver Zelle kopieren.
- Wenn das Notebook die Runtime-Version 7.0 oder früher verwendet, geben Sie den Code für den Codeausschnitt ein.
Hinweis:
Kopieren Sie den Code aus der Notebook-Zelle, und fügen Sie ihn ein, anstatt ihn direkt einzugeben, um Einrückungs- oder andere Syntaxfehler zu vermeiden.
- 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:
- 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, der dem Notebook hinzugefügt wird:
# 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)Esri Codeausschnitte
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