Kurzer Überblick über das Erstellen und Freigeben von Web-Werkzeugen

Die Erstellung eines Web-Werkzeugs beinhaltet sowohl einen Erstellungs- als auch einen Freigabeprozess. Der Erstellungsprozess beginnt mit der Erstellung eines Modell- oder Python-Skriptwerkzeugs in ArcGIS Pro. Nachdem Sie das Werkzeug erstellt und erfolgreich ausgeführt haben, können Sie es im ArcGIS Enterprise-Portal als Web-Werkzeug freigeben. Bei der Erstellung und Freigabe müssen bestimmte Daten, Werkzeugparamater und Freigabeberechtigungen berücksichtigt werden. Einige dieser Überlegungen werden im folgenden Beispiel und in relevanten Abschnitten dieses Themas erläutert. Der folgende Workflow beschreibt den Gesamtprozess:

  1. Erstellen Sie ein Skript oder Modell mit Werkzeugen aus der Toolbox, um Ihren Workflow zu konstruieren.
  2. Sammeln Sie die für das Werkzeug erforderlichen Datasets, und stellen Sie sie in einer Geodatabase zur Verfügung, oder fügen Sie sie der Karte in Ihrem Projekt hinzu.
  3. Führen Sie das Werkzeug aus, um einen erfolgreichen Eintrag im Geoverarbeitungsverlauf zu erstellen.
  4. Legen Sie bei Bedarf die Symbolisierung von Ausgabe-Datasets in Ihrer Karte fest.
  5. Geben Sie das Verlaufselement als Web-Werkzeug frei. Wenn Sie das Web-Werkzeug freigeben, können Sie Werkzeugeigenschaften für das Werkzeug und den Service festlegen.

Beispiel: Überprüfen der Auswirkungen auf den geplanten Bau einer Pipeline auf die Bevölkerung

Das folgende Modellwerkzeug ist eine Sammlung von Werkzeugen, mit deren Hilfe überprüft werden kann, wie viele Menschen von einem Pipeline-Leck betroffen sein könnten. Mit dem Workflow werden Schnittpunkte zwischen der Pipeline und dem Fluss gesucht und eine Verfolgung flussabwärts durchgeführt, um zu ermitteln, wie viele Menschen betroffen sein könnten. Dieses Modell wird mit Projektdaten und -parametern eingerichtet und als Web-Werkzeug veröffentlicht, wobei ein Analyst oder die allgemeine Öffentlichkeit die Route der geplanten Pipeline ändern kann, um etwaige Auswirkungen eines Leck auf die Bevölkerung flussabwärts zu ermitteln. Die Ergebnisse der Web-Werkzeuge zeigen den Punkt an, an dem die Pipeline den Fluss kreuzt, und die Zusammenfassung der von den Auswirkungen betroffenen Bevölkerung.

Modell zum Ausführen von Analysen der Auswirkungen einer Pipeline auf die betroffene Bevölkerung

Werkzeugdesign

Alle nützlichen Werkzeuge verfügen über Ein- und Ausgabeparameter. Mit diesen Werkzeugen können bei jeder Ausführung des Werkzeugs verschiedene Werte ausgeführt werden. Im Gegenzug erzeugt das Werkzeug verschiedene Analysen. Neben Eingabe- und Ausgabeparametern verfügen Werkzeuge im Allgemeinen über Projektdaten und Zwischendaten. Dies sind Datasets, über die die Person, die das Werkzeug ausführt, im Allgemeinen keine Kontrolle hat. In einem Modell sind die Eingabeparameter mit einem P markiert. Wird das Modell als Werkzeug ausgeführt, ist jede Eingabe mit einem P im Werkzeugdialogfeld verfügbar, um einen Wert festzulegen, der beim Ausführen des Werkzeugs verwendet werden soll. Über das Pipeline-Modell kann der Benutzer bei der Verfolgung flussabwärts den Pipeline-Pfad und eine Entfernung zum Puffer festlegen. Bei Verwendung dieses Werkzeugs werden der Pipeline-Standort und die Puffergröße geändert, um die letztendliche Anzahl der von der Pipeline betroffenen Personen anzuzeigen. Die Schnittpunkte der Pipeline und die Verfolgungslinie in diesem Beispiel sind Zwischen-Datasets, die während der Ausführung vom Modellwerkzeug erzeugt werden. Diese Zwischen-Datasets werden weder von der Person benötigt, die das Werkzeug ausführt, noch werden sie als Ergebnis zurückgegeben. Wenn dieses Modell freigegeben wird, legt der zugrunde liegende Geoverarbeitungsservice, auf dem das Web-Werkzeug basiert, fest, wo die Zwischendaten gespeichert werden, und bereinigt sie letztlich, falls sie nicht mehr benötigt werden.

Eingabeparameter des Modellwerkzeugs

Ausgabeparameter spielen eine ebenso wichtige Rolle wie Eingabeparameter für alle erfolgreichen Werkzeuge. Der Ausgabeparameter ermöglicht dem Werkzeug die Rückgabe eines Ergebnisses an die Person, die das Werkzeug ausführt. In ArcGIS Pro spielen Ausgabeparameter eine wichtige Rolle, da diese Datasets der Karte automatisch hinzugefügt werden. Ein Werkzeug ohne Ausgabeparameter erstellt eine Ausgabe, zeigt diese Informationen jedoch nicht notwendigerweise an. Web-Werkzeuge funktionieren mehr oder weniger genauso; ein oder mehrere Ausgabeparameter sind erforderlich, um das Ergebnis an den Endbenutzer zurückzugeben. Im Pipeline-Modell sind zwei Ausgabeparameter vorhanden: die Bevölkerung betroffener Gebiete, die die Pufferstandorte flussabwärts anzeigen und die Summentabelle der Bevölkerung mit der Zusammenfassung der insgesamt betroffenen Bevölkerung. Beachten Sie, dass es sich bei der Bevölkerung der betroffenen Gebiete sowohl um Zwischen- als auch um Ausgabedaten handelt. Dieser Parameter ist ein Zwischenparameter, da er für das Werkzeug Summenstatistik erforderlich ist, jedoch als Modellparameter definiert wurde (P) und dieses Ergebnis an den Client zurücksendet, wenn das Werkzeug erfolgreich beendet wird.

Ausgabeparameter des Modellwerkzeugs
Tipp:

Beim Erstellen von Skriptwerkzeugen Skript werden dieselben Grundsätze der Eingabe- und Ausgabeparameter von Werkzeugen, Projektdaten und Zwischendaten angewendet.

Dokumentieren des Werkzeugs

Es ist wichtig, eine gute Dokumentation das Web-Werkzeug bereitzustellen, wenn das Werkzeug von einem breiten Publikum gefunden, verstanden und genutzt werden soll. Eine gute Dokumentation beginnt mit dem ursprünglichen Werkzeug. Sie können denselben Metadatentyp für Ihr Modell- oder Skriptwerkzeug bereitstellen wie ein Systemwerkzeug.

Weitere Informationen zum Dokumentieren von Werkzeugen

Ausführen des Werkzeugs

Nachdem das Werkzeug erstellt wurde, muss es erfolgreich ausgeführt werden. Durch die Ausführung des Werkzeugs wird ein Eintrag im Geoverarbeitungsverlauf erstellt. Eine fehlgeschlagene Werkzeugausführung kann nicht freigegeben werden.

Hinweis:

Bei der Ausführung eines Modells in ModelBuilder wird kein Eintrag im Geoverarbeitungsverlauf erstellt. Modellwerkzeuge müssen im Bereich Geoverarbeitung als Werkzeug ausgeführt werden.

Freigeben von Web-Werkzeugen

Um das Web-Werkzeug freizugeben, wählen Sie Analyse > Verlauf aus, um den Bereich Verlauf zu öffnen. Zum Freigeben klicken Sie mit der rechten Maustaste auf das Element, das freigegeben werden soll, und wählen Freigeben als aus. Zum Freigeben als neues Web-Werkzeug wählen Sie Web-Werkzeug freigeben aus, um den Bereich Als Web-Werkzeug freigeben zu öffnen. Zum Überschreiben eines vorhandenen Werkzeugs wählen Sie Web-Werkzeug überschreiben aus, um einen Bereich mit allen vorhandenen Web-Werkzeugen, die in Eigene Inhalte veröffentlicht wurden, zu öffnen.

Bereich "Web-Werkzeug überschreiben"

Vergewissern Sie sich, dass Sie das richtige Werkzeug zum Überschreiben ausgewählt haben, und wählen Sie OK aus, um den Bereich Web-Werkzeug überschreiben zu öffnen. Die Prozesse vorab veröffentlichter Konfigurationen für Web-Werkzeuge sind für Web-Werkzeug freigeben und Web-Werkzeug überschreiben identisch, wie unten dargestellt.

Sie können auch zu Freigeben > Web-Werkzeug navigieren, um entweder Web-Werkzeug freigeben oder Web-Werkzeug überschreiben auszuwählen. Wenn Sie die Option Web-Werkzeug freigeben auswählen, dann wählen Sie in einem Werkzeugfreigabebereich mit allen erfolgreich ausgeführten Elementen ein Element aus.

Bereich "Werkzeug zum Freigeben auswählen"

Wenn Sie die Option Web-Werkzeug überschreiben auswählen, dann wählen Sie im Bereich mit allen vorhandenen Web-Werkzeugen, die Sie in Eigene Inhalte veröffentlicht haben, ein Element aus, das überschrieben werden soll. Wählen Sie dann im Bereich mit allen erfolgreich ausgeführten Elementen ein Element aus, mit dem überschrieben werden soll. Beim Auswählen in Analyse > Verlauf müssen die Schritte zum Überschreiben in diesem Workflow in umgekehrter Reihenfolge ausgeführt werden.

Festlegen der Eigenschaften von Web-Werkzeugen

Die Ausgabe des Werkzeugs zur Verschmutzungsbewertung sind Features und eine Tabelle. Die von diesem Werkzeug erzeugte und zurückgegebene Datenmenge ist eingeschränkt, sodass das Web-Werkzeug als asynchroner Service ohne Ergebniskartenservice eingerichtet wird. Die Anzahl von maximal 1000 Datensätzen als Standardeinstellung ist ausreichend. Mit der Meldungsebene Fehler wird sichergestellt, dass nur solche Meldungen zurückgegeben werden, die sich auf einen möglichen Fehler des Werkzeugs beziehen. Bei erfolgreicher Ausführung des Web-Werkzeugs werden keine normalen Verarbeitungsmeldungen an den Endbenutzer zurückgegeben.

Konfigurationsoptionen für Web-Werkzeuge

Ein Web-Werkzeug ist immer unter Eigene Inhalte verfügbar. Sie können das Werkzeug für Ihre Organisation, für alle Benutzer oder für ausgewählte Gruppen freigeben. Das Werkzeug zur Verschmutzungsbewertung ist ein Werkzeug, das für die Freigabe für bestimmte Projektbeteiligte in der Organisation geeignet ist, die Pipeline-Analysen durchführen müssen. Durch Auswahl der entsprechenden Gruppen können diese Benutzer das Werkzeug schnell finden und verwenden.

Freigabeoptionen für Web-Werkzeuge

Kopieren oder Referenzieren von Daten

Alle Web-Werkzeuge verwenden Daten als Eingabe oder nutzen Projektdaten. Durch die Freigabe des Verschmutzungsbewertungsmodells als Web-Werkzeug werden Daten eines Benutzers akzeptiert und für Projektdaten ausgeführt, die im Modell referenziert werden. An diesem Punkt der Werkzeugfreigabe müssen Sie entscheiden, ob Sie die Daten auf den Server kopieren, indem Sie eine statische Kopie der Daten erstellen, die der Service verwendet, oder ob Sie einen Verweis erstellen, auf den der Service zugreifen kann. In diesem speziellen Workflow enthalten die Projektdaten statische Fluss- und Bevölkerungs-Datasets, d. h. diese Datasets werden selten aktualisiert. In diesem besonderen Fall ist es sinnvoll, die Daten auf den Server zu kopieren. Bei diesem Prozess werden Daten erfasst und (bei Bedarf) in File-Geodatabase-Feature-Classes konvertiert, wobei sie auf dem Server extrahiert und vom Service verwendet werden.

Berücksichtigen Sie, ob die Analysemethode dort, wo der Benutzer keine eigene Pipeline vorgeschlagen hat, leicht abgeändert wurde. Die alternativen Pipeline-Vorschläge wurden durch einen anderen Prozess erzeugt und der Benutzer hat verschiedene Eingaben für das Werkzeug bereitgestellt. In diesem Fall wird die vorgeschlagene Pipeline zu Projektdaten. Demzufolge ist es empfehlenswert, dieses Dataset in einer Enterprise-Geodatabase abzulegen und es vom Werkzeug referenzieren zu lassen. Beim Veröffentlichen legen Sie mit dem ArcGIS Server Data Store eine Referenz zu den Daten fest. Der Veröffentlichungsprozess behält eine Referenz auf die Datenbank bei statt eine statische Kopie zu erstellen. Die Daten können zu einem späteren Zeitpunkt von einem Projektanalyst in der Enterprise-Geodatabase aktualisiert werden und das Web-Werkzeug kann Analysen für den neuesten Pipeline-Vorschlag durchführen.

Datenoptionen für Web-Werkzeuge

Analysieren

Durch das Analysieren Analysieren beim Freigeben eines Web-Werkzeugs wird sichergestellt, dass das Werkzeug erfolgreich für Ihr Portal freigegeben werden kann. Zudem können Warnmeldungen zu Daten angezeigt werden, und Sie können entsprechende Maßnahmen ergreifen, wenn Sie dies für erforderlich halten. Das Werkzeug zur Verschmutzungsbewertung verfügt bereits über einen eingerichteten Data Store und ein dokumentiertes Werkzeug und verwendet unterstützte Werkzeuge, die in einem Web-Werkzeug funktionieren, damit solche Warnungen oder Meldungen nicht angezeigt werden.

Veröffentlichen

Nachdem die Eigenschaften des Web-Werkzeugs festgelegt wurden und Sie alle Analysefehler behoben haben, veröffentlichen Sie das Web-Werkzeug in Ihrem Portal. Je nachdem, wie viele Daten konsolidiert und an den Server gesendet werden müssen, kann dieser Vorgang ein paar Minuten in Anspruch nehmen.

Verwenden des Web-Werkzeugs

Web-Werkzeuge können im Abschnitt Portal des Bereichs Katalog geöffnet werden. Neben der Ausführung des Werkzeugs in ArcGIS Pro kann der Geoverarbeitungsservice Geoverarbeitungsservice, auf dem es basiert, in einem Python-Skript oder einer Webanwendung verwendet werden.

Weitere Informationen zum Suchen und Verwenden von Web-Werkzeugen in ArcGIS Pro