Veröffentlichen eines Notebooks als Web-Werkzeug

Mit ArcGIS Notebooks können Sie Notebooks als Web-Werkzeuge veröffentlichen. Administratoren und Notebook-Autoren mit der Berechtigung Web-Werkzeuge veröffentlichen können Notebooks, deren Besitzer sie sind, als Web-Werkzeuge veröffentlichen. Beim Veröffentlichen eines Notebooks als Web-Werkzeug wird ein asynchroner Geoverarbeitungsservice erstellt und als Web-Werkzeug registriert. Zwischen dem Notebook und dem Web-Werkzeug besteht eine Eins-zu-Eins-Beziehung. Dies bedeutet, dass pro Notebook nur ein Web-Werkzeug veröffentlicht werden kann. Web-Werkzeuge können von jeder Client-Anwendung verwendet werden, die mit asynchronen RESTful-Geoverarbeitungsservices ausgeführt werden kann.

Das Veröffentlichen von Notebooks als Web-Werkzeug wird für Notebooks unterstützt, die Runtime-Version 8.0 oder höher nutzen. Zum Überprüfen der Runtime-Informationen eines Notebooks klicken Sie auf die Schaltfläche Info, die sich im oberen Menüband des Notebook-Editors sowie auf der Registerkarte Einstellungen auf der Elementdetailseite des Notebooks befindet. Weitere Informationen zu Notebook-Runtimes finden Sie unter Anzeigen von verfügbaren Python-Bibliotheken.

Im Notebook-Editor können Sie die Eingabe- und Ausgabeparameter für ein Notebook konfigurieren. Die Eingabeparameter entsprechen den Eingabevariablen in einem Notebook, die Sie für Benutzereingaben externalisieren möchten, wenn das Notebook als Web-Werkzeug ausgeführt wird. Die Ausgabeparameter stellen die Ausgabevariablen in einem Notebook dar, die als Ausgaben des Web-Werkzeugs zurückgegeben werden sollen. Wenn Sie eine oder mehrere Eingabe- oder Ausgabevariablen registrieren und ein Notebook veröffentlichen, werden die Parameter als Eingabe- bzw. Ausgabeparameter für das entsprechende Web-Werkzeug verfügbar.

Hinweis:

Beim Veröffentlichen eines Notebooks als Web-Werkzeug müssen keine Eingabe- oder Ausgabeparameter definiert werden. Beispielsweise erfordern Notebooks, die Tasks mit vordefinierten Eingaben und Ausgaben ausführen, z. B. von itemId referenzierte Feature-Layer, möglicherweise keine Eingabe- oder Ausgabeparameter.

Hinweis:

Für Eingabe- oder Ausgabeparameter werden die folgenden Datentypen unterstützt: "Zeichenfolge", "Long", "Double", "Boolesch", "Feature-Set", "Datensatz", "Datum", "Lineare Einheit", "Raster-Daten-Layer" und "Datei". Weitere Informationen finden Sie unter Geoprocessing services data types in der Dokumentation zur ArcGIS REST API.

Beim Ausführen eines Web-Werkzeugs veranlasst ArcGIS Notebooks eine automatisierte Ausführung, indem ein neuer Container geöffnet und das Notebook ohne Benutzereingriff ausgeführt wird. Benutzer mit der Berechtigung "Web-Werkzeuge ausführen", für die das Web-Werkzeug freigegeben wurde, können auf das Web-Werkzeug zugreifen und es ausführen. Neben der erforderlichen Berechtigung "Web-Werkzeuge ausführen" sind auch alle anderen für die Ausführung des Notebooks notwendigen Berechtigungen erforderlich. Weitere Informationen zu Berechtigungen finden Sie im Thema Benutzertypen, Rollen und Berechtigungen.

Hinweis:

Wenn Sie ein Notebook erstellen, das als Web-Werkzeug freigegeben werden soll, und dieses eine Datei aus Ihrem Workspace-Verzeichnis als Eingabedaten referenziert, können andere Personen, für die das Notebook oder Web-Werkzeug freigegeben wird, nicht auf die Dateien zugreifen. Wenn eine Datei als Eingabedaten im Notebook referenziert werden muss, können Sie sie über ein freigegebenes Element in Ihren ArcGIS-Inhalten referenzieren.

Hinweis:

Wenn die Option Parameter oder Veröffentlichen nicht im Notebook-Editor angezeigt wird, verfügen Sie nicht über die Berechtigung Web-Werkzeuge veröffentlichen, oder Sie sind nicht der Besitzer des Notebooks. In einem neu veröffentlichten Notebook werden die Optionen Parameter und Veröffentlichen erst angezeigt, nachdem das Notebook gespeichert wurde.

Konfigurieren von Eingabeparametern

Eingabeparameter stellen Eingabevariablen in einem Notebook dar, die externalisiert werden, wenn ein Notebook als Web-Werkzeug ausgeführt wird. Im Bereich Parameter des Notebook-Editors können Sie Eingabeparameter konfigurieren und dem Notebook als Variablen hinzufügen.

1. Klicken Sie im Notebook-Editor auf Parameter.
2. Klicken Sie auf Hinzufügen.
3. Wählen Sie Eingaben für Richtung aus.
4. Geben Sie für Variablenname einen Namen ein.

   Hinweis:

   Dieser muss mit einem Variablennamen im Notebook-Code oder einem bereits im Notebook konfigurierten Variablennamen übereinstimmen.

5. Geben Sie in Anzeigename einen Anzeigenamen für den Web-Werkzeug-Parameter ein.
6. Wählen Sie im Dropdown-Menü Datentyp einen Datentyp für den Eingabeparameter aus.
7. Wählen Sie für Parametertyp den Wert Erforderlich oder Optional aus.
8. Wenn der Datentyp der Eingabeparameter String, Long oder Double lautet, können Sie optional die Auswahlliste konfigurieren, indem Sie unter Auswahlliste (optional) Werte eingeben.

   Wenn eine Auswahlliste konfiguriert ist, muss der Benutzer beim Ausführen des Web-Werkzeugs einen Wert aus einem Dropdown-Menü auswählen. Wird das Werkzeug zum Beispiel in Map Viewer geöffnet, kann der Benutzer aus einem Dropdown-Menü mit konfigurierten Parameterwerten auswählen.

9. Geben Sie einen Wert als Standardwert für den Eingabeparameter ein. Informationen zur Syntax der Standardwerte für unterstützte Datentypen finden Sie unter Geoprocessing services data types.
10. Geben Sie unter Beschreibung eine Beschreibung des Eingabeparameters ein.
11. Klicken Sie auf Speichern, um den Eingabeparameter zu speichern.
12. Um weitere Eingabeparameter hinzuzufügen, wiederholen Sie die Schritte 1 bis 9.
13. Nachdem Sie alle Eingabeparameter hinzugefügt haben, wählen Sie im Notebook eine Zelle aus, in die die Parameter eingefügt werden sollen, und klicken Sie auf Als Variablen einfügen.
14. Klicken Sie auf Speichern, um das Notebook zu speichern.

Konfigurieren von Ausgabeparametern

Sie können die Ausgabe für ein als Web-Werkzeug veröffentlichtes Notebook durch Konfigurieren der Ausgabeparameter im Bereich Parameter des Notebook-Editors konfigurieren.

1. Klicken Sie im Notebook-Editor auf Parameter.
2. Klicken Sie auf Hinzufügen.
3. Wählen Sie für den Parameter Richtung "Ausgabe" aus.
4. Geben Sie für Variablenname einen Namen ein.

   Hinweis:

   Dieser muss mit einem Variablennamen im Notebook-Code oder einem bereits im Notebook konfigurierten Variablennamen übereinstimmen.

5. Geben Sie in Anzeigename einen Anzeigenamen für den Web-Werkzeug-Parameter ein.
6. Wählen Sie im Dropdown-Menü Datentyp einen Datentyp für den Ausgabeparameter aus.
7. Wählen Sie für Parametertyp den Wert Erforderlich oder Optional aus.
8. Geben Sie einen Wert als Standardwert für den Ausgabeparameter ein. Informationen zur Syntax der Standardwerte für unterstützte Datentypen finden Sie unter Geoprocessing services data types.
9. Geben Sie unter Beschreibung eine Beschreibung des Ausgabeparameters ein.
10. Klicken Sie auf Speichern, um den Ausgabeparameter zu speichern.
11. Wählen Sie eine Zelle im Notebook aus. Klicken Sie auf die Schaltfläche Hinzufügen, um den Python-Codeausschnitt zum Schreiben der Ausgabe für das Web-Werkzeug hinzuzufügen.

    Es wird empfohlen, eine Zelle im unteren Bereich des Notebooks unter den Zellen auszuwählen, in denen die Ausgaben erstellt werden.

12. Überprüfen Sie den hinzugefügten Codeausschnitt, um sicherzustellen, dass die Ausgabevariablennamen mit der im Notebook definierten Ausgabe übereinstimmen, und nehmen Sie weitere Anpassungen des Codeausschnitts vor.
13. Wiederholen Sie für alle zusätzlichen Ausgabeparameter die Schritte 1 bis 11.
14. Klicken Sie auf Speichern, um das Notebook zu speichern.

Veröffentlichen eines Web-Werkzeugs

Sie können über den Bereich Veröffentlichen im Notebook-Editor ein Notebook als Web-Werkzeug veröffentlichen.

1. Speichern Sie das Notebook, um sicherzustellen, dass die aktuelle Kopie des Notebooks veröffentlicht wird.
2. Führen Sie die Zellen des Notebooks manuell interaktiv aus, um sicherzustellen, dass keine Fehler vorhanden sind.

Hinweis:

Überspringen Sie Zellen, die Codeausschnitte für Ausgabeparameter enthalten, da sie im interaktiven Modus nicht ausgeführt werden.
3. Klicken Sie auf dem Menüband des Notebook-Editors auf Veröffentlichen.
4. Geben Sie im Bereich Veröffentlichen in den Feldern Titel und Beschreibung einen Titel und eine Beschreibung für das Web-Werkzeug ein.
5. Geben Sie im Feld Maximale Verwendungszeit eine Zahl an.

   Dies entspricht der Anzahl an Minuten, die die Ausführung des Web-Werkzeugs fortgesetzt werden kann, bevor sie vom System abgebrochen wird. Der maximal zulässige Timeout-Wert beträgt 100 Minuten.

6. Überprüfen Sie alle Eingabe- und Ausgabeparameter.
7. Klicken Sie auf Veröffentlichen, um das Notebook als Web-Werkzeug zu veröffentlichen.
8. Nachdem das Web-Werkzeug erfolgreich veröffentlicht wurde, klicken Sie auf Details anzeigen, um die Elementdetailseite für das Web-Werkzeug anzuzeigen.
9. Klicken Sie auf Freigeben, um das Fenster Freigeben zu öffnen.
   1. Wählen Sie Organisation aus, um das Web-Werkzeug für alle Benutzer der Organisation freizugeben.
   2. Klicken Sie auf Gruppenfreigabe bearbeiten, um das Web-Werkzeug für bestimmte Gruppen freizugeben.
   3. Wählen Sie die Gruppen aus, für die eine Freigabe erfolgen soll.
   4. Klicken Sie auf OK.
   5. Klicken Sie auf Speichern.

Freigeben eines Web-Werkzeugs

Führen Sie die folgenden Schritte aus, um die Freigabeeinstellungen für ein vorhandenes Notebook-Web-Werkzeug für die Organisation oder bestimmte Gruppen in der Organisation freizugeben oder zu aktualisieren.

Hinweis:

Benutzer, für die das Web-Werkzeug freigegeben wird, müssen über die Berechtigung "Web-Werkzeuge ausführen" sowie etwaige weitere zum Ausführen des Notebooks erforderliche Berechtigungen verfügen, damit sie das freigegebene Web-Werkzeug ausführen können.

Notebook-Web-Werkzeuge können nicht öffentlich freigegeben werden. Auch wenn Sie die Berechtigung zur öffentlichen Freigabe von Daten besitzen, ist die Option zum Freigeben von Notebook-Web-Werkzeugen für Alle (öffentlich) nicht verfügbar.

1. Überprüfen Sie, ob Sie bei ArcGIS Online angemeldet sind und über ausreichende Berechtigungen zum Freigeben von Inhalten für Ihre Organisation verfügen.
2. Klicken Sie auf Inhalt.
3. Aktivieren Sie das Kontrollkästchen neben dem Titel des Web-Werkzeugs, das Sie freigeben möchten.
4. Klicken Sie auf Freigeben.
   1. Wählen Sie Organisation aus, um das Web-Werkzeug für alle Benutzer der Organisation freizugeben.
   2. Klicken Sie auf Gruppenfreigabe bearbeiten, um das Web-Werkzeug für bestimmte Gruppen freizugeben.
   3. Wählen Sie die Gruppen aus, für die eine Freigabe erfolgen soll.
   4. Klicken Sie auf OK.
   5. Klicken Sie auf Speichern.

Überschreiben eines Web-Werkzeugs

Durch das Überschreiben wird das Web-Werkzeug mit dem neuesten Snapshot des Notebooks aktualisiert. Sie können ein Notebook-Web-Werkzeug im Notebook-Editor im Bereich Veröffentlichen überschreiben.

1. Falls ein vorhandener Eingabe- oder Ausgabeparameter aktualisiert werden muss, führen Sie die Schritte im Abschnitt Bearbeiten eines vorhandenen Eingabe- oder Ausgabeparameters dieses Themas durch.
2. Falls Sie neue Eingabe- oder Ausgabeparameter hinzufügen, führen Sie die Schritte im Abschnitt Konfigurieren von Eingabeparametern bzw. Konfigurieren von Ausgabeparametern dieses Themas durch.
3. Klicken Sie auf Speichern, um sicherzustellen, dass die neueste Version des Notebooks veröffentlicht wird.
4. Führen Sie manuell jede Zelle im Notebook aus, um sicherzustellen, dass keine Fehler vorhanden sind.

   Hinweis:

   Führen Sie keine Zellen aus, die die Codeausschnitte für die Ausgabeparameter enthalten. Sie können nicht im interaktiven Modus ausgeführt werden.

5. Klicken Sie auf Freigeben.
6. Klicken Sie auf Überschreiben, um das Web-Werkzeug zu überschreiben.

Löschen eines Web-Werkzeugs

Sie können ein über ein Notebook veröffentlichtes Web-Werkzeug löschen, indem Sie das Web-Werkzeugelement löschen.

1. Klicken Sie dazu auf dem Menüband oben im Notebook-Editor auf Veröffentlichen.
2. Klicken Sie auf Details anzeigen, um die Elementdetailseite für das Web-Werkzeug anzuzeigen.
3. Klicken Sie auf Einstellungen.
4. Klicken Sie auf Element löschen, und bestätigen Sie, dass Sie das Web-Werkzeugelement löschen möchten.

Hinweis:

Wenn das Notebook-Element, aus dem das Web-Werkzeug veröffentlicht wird, gelöscht wird, wird das Web-Werkzeug-Element ebenfalls gelöscht.

Bearbeiten eines vorhandenen Eingabe- oder Ausgabeparameters

Sie können im Bereich Parameter des Notebook-Editors Änderungen an einem vorhandenen Eingabe- oder Ausgabeparameter vornehmen.

Hinweis:

Wenn ein Notebook bereits als Web-Werkzeug veröffentlicht wurde, müssen Sie im Bereich Parameter auf die Umschaltfläche Bearbeitung aktivieren klicken, bevor Sie Änderungen an den Parametern vornehmen können. Gehen Sie umsichtig vor, wenn Sie Parameter ändern, nachdem das Notebook als Web-Werkzeug veröffentlicht wurde, da durch diese Änderungen möglicherweise Web-Apps beschädigt werden, die das Web-Werkzeug verwenden.

1. Klicken Sie dazu auf dem Menüband oben im Notebook-Editor auf Parameter.
2. Klicken Sie auf die Schaltfläche "Optionen" neben dem Parameter, und klicken Sie auf Bearbeiten.
3. Aktualisieren Sie die Parameter, und klicken Sie auf Speichern.
   1. Wenn ein Eingabeparameter aktualisiert wurde, löschen oder entfernen Sie die vorhandene Zelle mit den Eingabevariablen manuell. Wiederholen Sie dann den Schritt zum Einfügen der Eingabeparameter als Variablen in das Notebook.
   2. Wenn ein Ausgabeparameter aktualisiert wurde, löschen Sie den der Ausgabevariablen entsprechenden Codeausschnitt manuell. Wiederholen Sie dann die Schritte zum Hinzufügen des Codeausschnitts für den Ausgabeparameter zum Notebook.
4. Klicken Sie auf Speichern, um das Notebook zu speichern.

Löschen eines vorhandenen Eingabe- oder Ausgabeparameters

Sie können im Bereich Parameter vorhandene Eingabe- oder Ausgabeparameter löschen.

1. Klicken Sie dazu auf dem Menüband oben im Notebook-Editor auf Parameter.
2. Klicken Sie auf die Schaltfläche "Optionen" neben dem Parameter, und klicken Sie auf Löschen.
3. Klicken Sie auf "Löschen", um den Parameter endgültig zu entfernen.
4. Löschen oder entfernen Sie die Eingabevariable oder den Ausgabecodeausschnitt im Notebook manuell.
5. Klicken Sie auf Speichern, um das Notebook zu speichern.

Verwenden der Kartenausdehnung

Wenn Sie ein Web-Werkzeug in Map Viewer ausführen, werden die Verarbeitungsausdehnung und das Ausgabekoordinatensystem im Falle einer Änderung als Python-Variable mit dem Namen context zusammen mit anderen Eingabeparametern an das Notebook übergeben (siehe unten).

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

Mit dem Wert der context-Variablen können Sie die Ausdehnung und das Ausgabekoordinatensystem für die Workflows für räumliche Analysen in Ihrem Notebook festlegen. Um Ihre Workflows für die räumliche Analyse zu testen, bevor Sie das Notebook als Web-Werkzeug veröffentlichen, definieren Sie die context-Variable mit einem Standardwert.

Wenn Sie bereit für die Veröffentlichung sind, fügen Sie die Eingabeparameter als Variablen nach der Zelle ein, in der Sie die context-Variable angeben.