Einstellungen für Web-Werkzeuge und Geoverarbeitungsservices

Anhand der Einstellungen der Eigenschaften, die Sie beim Freigeben eines Werkzeugs als Web-Werkzeug oder Geoverarbeitungsservice auswählen, wird festgelegt, wie sie von Client-Anwendungen verwendet werden. Die gängigsten und am häufigsten geänderten Werkzeugparameter können während der Freigabe festgelegt werden. Weniger gängige Einstellungen können in ArcGIS Server Manager geändert werden, nachdem das Werkzeug freigegeben wurde. Einige erweiterte Einstellungen können nur in der REST-API von ArcGIS Server Administrator festgelegt werden.

Einstellungen

In den nachfolgenden Unterabschnitten werden die verfügbaren Einstellungen für das Freigeben eines Web-Werkzeugs oder eines Geoverarbeitungsservice beschrieben.

Allgemein

Die folgenden allgemeinen Parametereinstellungen sind verfügbar:

Parameter	Beschreibung
Name	Der Name des Web-Werkzeugs oder des Geoverarbeitungsservice zur Freigabe für das Portal. Dieser Name muss im Portal eindeutig sein und darf keine Leerstellen oder Sonderzeichen enthalten. Dieser Parameter wird aus den Metadaten des Werkzeugs übernommen.
Zusammenfassung	Die Zusammenfassung und Tags, mit deren Hilfe das Dokument beschrieben und das Web-Werkzeug durchsuchbar gemacht wird. Diese Parameter werden aus den Metadaten des Werkzeugs übernommen. Sie können das Dropdown-Menü Tags verwenden, um vorhandene Tags auszuwählen. Das Limit liegt bei maximal 128 Tags.
Tags
Kategorie	Die Kategorie des Web-Werkzeugelements. Diese Einstellung ist nicht für Geoverarbeitungsservices verfügbar, die auf einem eigenständigen ArcGIS Server veröffentlicht werden.
Version	Die Version von ArcGIS Enterprise oder von ArcGIS Server, für die das Werkzeug freigegeben wird. Dieser Parameter ist nur beim Speichern einer Offline-Service-Definition für ein Web-Werkzeug aktiviert.
Daten	Gibt an, welche Aktionen mit den Daten durchgeführt werden. Nicht-URL-Daten: Legt fest, ob die Daten auf den Server kopiert werden (und zu statischen Daten werden) oder weiterhin vom Web-Werkzeug referenziert werden. Um die Option Registrierte Daten referenzieren verwenden zu können, muss ein übereinstimmender Eintrag im Server-Data-Store für die Daten eingerichtet werden. Wenn die Daten nicht vom Server-Data-Store eingerichtet werden, werden sie während der Veröffentlichung kopiert. Dies gilt nur bei der Veröffentlichung als Web-Werkzeug oder beim Speichern als verbundene Service-Definition. Wenn Sie die Option Referenzdaten verwenden und das Ergebnis als Offline-Service-Definition speichern, stellen Sie sicher, dass alle Daten des Parameters referenziert werden können, da es keine Alternative zum Kopieren der Daten gibt, wenn die Daten nicht vom Data Store des Servers eingerichtet werden. URL-Daten: Legt fest, ob die Daten während der Veröffentlichung als URL-Daten erhalten bleiben oder in einen anderen Datentyp konvertiert werden. Diese Option wird in ArcGIS Pro 3.2 oder höher bereitgestellt. URL-Daten beziehen sich auf die URL von verschiedenen Arten von Web-Layern oder Services. Es können nur Feature-Layer, Feature-Services und Feature-Sublayer von Web-Image-Layern konfiguriert werden. Wenn das Kontrollkästchen Feature-Layer konvertieren aktiviert ist, wird der Feature-Layer oder -Service der Parameter- oder Projektdaten während der Veröffentlichung in eine Feature-Class konvertiert Ist das Kontrollkästchen deaktiviert, wird die URL des Features-Layers beibehalten. Es ist keine Option zum Konvertieren der URL von Web-Image-Layern verfügbar, weil eine URL während der Veröffentlichung immer beibehalten wird. Diese Option ist standardmäßig aktiviert. Weitere Informationen zum Kopieren, Referenzieren und Verwenden von URL-Daten
Position	Gibt an, wo das Web-Werkzeugelement oder der Geoverarbeitungsservice erstellt wird. Für Web-Werkzeugelemente, die in ArcGIS Enterpriseveröffentlicht werden, gibt es folgende Optionen: Ordner: Wählen Sie einen Portal-Ordner aus, oder erstellen Sie einen Portal-Ordner, in dem das Web-Werkzeugelement erstellt wird. Als Standardeinstellung wird das Stammverzeichnis des Portals verwendet. Server und Ordner: In Bezug auf den Server müssen Web-Werkzeuge für ein Portal mit mindestens einem Verbundserver freigegeben werden. Wenn das Portal über mehrere Verbundserver verfügt, geben Sie den Server an, auf dem das Web-Werkzeug veröffentlicht wird. Was den Ordner anbelangt, so können Sie entweder einen vorhandenen Ordner auswählen oder auf der ArcGIS Server-Site einen Ordner erstellen. Standardmäßig wird das Stammverzeichnis der ArcGIS Server-Site verwendet. Für Geoverarbeitungsservices, die auf eigenständigen ArcGIS Server-Sites veröffentlicht werden, ist folgende Option verfügbar: Ordner: Wählen Sie einen Serverordner aus, oder erstellen Sie einen Ordner, in dem das Geoverarbeitungsservice-Element erstellt wird. Standardmäßig wird das Stammverzeichnis des Servers verwendet.
Freigeben für	Nur für Web-Werkzeuge verfügbar, die in ArcGIS Enterprise veröffentlicht wurden. Gibt an, für wen und welche Gruppen das Web-Werkzeug freigegeben wird. Ein Web-Werkzeug wird immer unter Eigene Inhalte freigegeben. Durch die Freigabe eines Web-Werkzeugs für alle wird das Element öffentlich; jeder Benutzer, der die Portal-Website besucht, kann es finden und verwenden, und Gruppenbesitzer können es ihren Gruppeninhalten hinzufügen. Durch die Freigabe eines Web-Werkzeugs für ArcGIS Enterprise wird das Web-Werkzeug für alle Mitglieder des Portals freigegeben, die Zugriff auf ein Element haben. Sie können es für jede Gruppe freigeben, der Sie angehören.

Konfiguration

Die folgenden Parametereinstellungen sind auf der Registerkarte Service-Funktionen und Parameter konfigurieren verfügbar:

Parameter	Beschreibung
Hochladen	Legt fest, ob ein Client eine Datei auf den Server hochladen kann, die als Eingabe für das Web-Werkzeug verwendet werden kann. Die Upload-Operation wird normalerweise von Web-Clients verwendet, die eine Möglichkeit brauchen, eine Datei zur Verarbeitung an den Server zu senden. Die Upload-Operation gibt nach dem Hochladen eine eindeutige ID für die Datei zurück, welche die Web-App an das Web-Werkzeug weiterleiten kann. Diese Option ist standardmäßig deaktiviert. Wenn Sie Uploads in den Service zulassen, kann dies ein Sicherheitsrisiko darstellen. Aktivieren Sie diese Option nur bei Bedarf.
Ausführungsmodus	Gibt an, wie der Client (die Anwendung, die das Web-Werkzeug verwendet) mit dem Web-Werkzeug interagiert und die Ausgabe erhält. Wenn ein Web-Werkzeug auf Synchron eingestellt ist, wartet der Client, bis der Task beendet ist. In der Regel wird ein synchroner Service schnell ausgeführt (innerhalb weniger Sekunden). Ist die Einstellung Asynchron festgelegt, dauert die Ausführung des Service in der Regel länger, und der Client muss den Server regelmäßig überprüfen, um festzustellen, ob der Service beendet ist, sowie nach dessen Beendigung das Ergebnis abrufen. Für eine Web-App, die einen asynchronen Service verwendet, muss Logik implementiert werden, um den Status zu überprüfen und nach Beendigung der Ausführung das Ergebnis zu verarbeiten. Die Standardeinstellung ist Asynchron.
Ausgabe im Kartenbild-Layer anzeigen	Beim Veröffentlichen eines Web-Werkzeugs oder eines Geoverarbeitungsservice können Sie die Ausgabe als Kartenbild anzeigen. Das Kartenbild wird auf dem Server erstellt und als Bild (eine .tiff-Datei mit Angaben zum Style) zurück an den Client übermittelt. Symbolisierung, Beschriftung, Transparenz und andere Eigenschaften des Kartenbildes sind mit dem Ausgabe-Layer aus der ArcGIS Pro-Sitzung bei der ursprünglichen Veröffentlichung identisch. Berücksichtigen Sie bei der Verwendung dieses Parameters Folgendes: Wenn das Werkzeug eine große Anzahl von Features ausgibt, die der Client symbolisieren und darstellen muss, ist es schneller für den Client, eine Karte zu empfangen. Zur zweckmäßigen Datenverteilung sollten Sie dem Client keine Features senden, sondern nur ein Kartenbild. Das Ergebnis des Werkzeugs ist ein nicht übertragbares Dataset wie z. B. ein Netzwerk oder eine Topologie. Die einzige Möglichkeit, eine Ausgabe an den Client zu senden, ist über ein Kartenbild. Hinweis: Ein Ausgabe-Kartenbild kann nur dann verwendet werden, wenn der Parameter Ausführungsmodus des Web-Werkzeugs auf Asynchron festgelegt ist. Dieser Parameter wird nicht unterstützt, wenn ein Web-Werkzeug in Kubernetes veröffentlicht wird. Diese Option ist standardmäßig deaktiviert.
Meldungs-Level	Geben Sie Meldungen der folgenden Ebenen an den Client zurück, der das Web-Werkzeug ausgeführt hat. Folgende Optionen sind verfügbar: Keine: Es werden keine Geoverarbeitungsmeldungen an den Client zurückgegeben, außer ob der Vorgang erfolgreich war oder fehlgeschlagen ist. Dies ist die Standardeinstellung. Fehler: Es werden nur Werkzeugmeldungen an den Client zurückgegeben, die einen Fehler erzeugen. Warnung: Es werden alle Werkzeugfehler und Warnmeldungen an den Client zurückgegeben. Info: Es werden alle Werkzeugmeldungen des Vorgangs an den Client zurückgegeben. Vorsicht: Alle Meldungen, unabhängig von der Ebene, können Dataset-Pfade und -Namen enthalten, was ein Sicherheitsrisiko darstellen kann. Die Ebene Info enthält die meisten Details und Verweise auf Dataset-Pfade und -Namen. Im Allgemeinen sollten in Entwicklungs- und Testumgebungen Meldungen auf der Ebene Info oder Warnung zurückgegeben werden und in Produktionsumgebungen die Ebenen Keine oder Fehler verwendet werden. Der Standardwert ist Keine.
Maximale Anzahl der zurückgegebenen Datensätze	Die maximale Anzahl von Ergebnissen, die der Service an einen Client zurückgeben kann. Wenn Sie für diesen Wert eine große Zahl festlegen, kann der GIS-Server zahlreiche einzelne Datensätze oder Features verarbeiten, die an den Client gesendet werden. Wenn keine Features zurückgeben werden sollen, setzen Sie diesen Wert auf 0 (Null). Diese Eigenschaft hat keine Auswirkung, wenn der Parameter Optionalen Parameter für Ausgabe-Feature-Service hinzufügen aktiviert ist. Der Standardwert ist 1000.

Die folgenden Parametereinstellungen sind auf der Registerkarte Pooling konfigurieren verfügbar: Weitere Überlegungen zum Festlegen dieser Einstellungen finden Sie unter Optimieren und Konfigurieren von Services.

Parameter	Beschreibung
Anzahl der Instanzen	Die minimale und maximale Anzahl von Geoverarbeitungsservice-Instanzen, die auf jedem Servercomputer für ArcGIS Enterprise oder dem Pod gp-server-sync für ArcGIS Enterprise on Kubernetes gleichzeitig ausgeführt werden können.
Service-Timeouts - Maximale Verwendungszeit	Die maximale Zeit in Sekunden, die ein Service verwendet werden kann. Sie müssen ggf. den Standardwert von 600 Sekunden (10 Minuten) für länger dauernde Geoverarbeitungs-Tasks erhöhen. Alternativ können Sie die Zeit reduzieren, um sicherzustellen, dass ein Client die Services nicht missbräuchlich verwendet.
Service-Timeouts - Maximale Wartezeit	Die maximale Zeit in Sekunden, die ein Client auf eine Verbindung mit einer Instanz wartet, bevor ein Timeout erfolgt. Wenn alle Instanzen mit der Verarbeitung von Anforderungen ausgelastet sind, werden nachfolgende Anforderungen in eine Warteschlange gestellt. Wenn die Wartezeit verstreicht, bevor eine Instanz verfügbar wird, schlägt der Task fehl. Der Standard ist 60 Sekunden (1 Minute).
Service-Timeouts - Maximale Leerlaufzeit	Die maximale Zeit in Sekunden, die eine Instanz aktiv bleibt, bevor eine Poolverkleinerung erfolgt. Instanzen oberhalb der Mindestanzahl von Instanzen, die nicht verwendet wurden, werden heruntergefahren, sobald die maximale Leerlaufzeit abgelaufen ist.

Mit Ausnahme der Zusammenfassung und Tags können die oben beschriebene n Parametereinstellungen in ArcGIS Server Manager geändert werden, nachdem das Web-Werkzeug freigegeben wurde. Diese Beschreibungsinformationen können auf der Elementseite des Web-Werkzeugs im Portal aktualisiert und freigegeben werden.

Inhalt

Die unten beschriebenen Einstellungen können nur zum Zeitpunkt der Veröffentlichung eines Web-Werkzeugs oder eines Geoverarbeitungsservice geändert werden.

Werkzeug hinzufügen

Um einem vorhandenen Web-Werkzeug oder Geoverarbeitungsservice Werkzeuge aus dem Geoverarbeitungsverlauf hinzufügen, klicken Sie auf der Registerkarte Inhalt auf die Schaltfläche Werkzeug hinzufügen . Um Werkzeuge zu entfernen, klicken Sie auf den Namen des Werkzeugs und wählen Entfernen aus.

Konfigurieren von Werkzeugeigenschaften

Zum Konfigurieren der Werkzeugeigenschaften klicken Sie neben dem Werkzeugnamen auf die Schaltfläche "Bearbeiten" .

Eigenschaft	Beschreibung
Name	Der Name des Werkzeugs. Der Standardname basiert auf den Metadaten des Werkzeugs.
Beschreibung	Die Beschreibung des Werkzeugs. Die Beschreibung wird nicht aus den Metadaten des Werkzeugs übernommen. Wenn keine Beschreibung vorhanden ist, stellen Sie eine Beschreibung bereit. Diese bleibt bei jeder Freigabe aus dem Verlauf erhalten.

Die folgenden Eigenschaften können für jeden Parameter konfiguriert werden:

Eigenschaft	Beschreibung
Name	Name und Beschreibung des Parameters. Beide Eigenschaften werden vom Namen und von der Beschreibung des Parameters aus den Werkzeug-Metadaten übernommen. Die Änderung dieser Eigenschaften hat keine Auswirkungen auf die ursprünglichen Metadaten des Werkzeugs.
Beschreibung
Typ	Der Parametertyp definiert, ob der Client einen Wert angeben muss, damit das Werkzeug erfolgreich ausgeführt wird. Auf der Registerkarte Inhalt können nur optionale Parameter in erforderliche Parameter geändert werden. Um einen erforderlichen Parameter in einen optionalen Parameter zu ändern, schließen Sie den Bereich "Freigabe", bearbeiten Sie die Eigenschaften des Werkzeugs und führen Sie das Werkzeug erneut aus, um ein neues Ergebnis zu erstellen.
Datentyp als Verbund beibehalten	Diese Eigenschaft ist nur verfügbar, wenn der Parameter ein Verbund-Datentyp ist. Sie gibt an, ob der Parameter als Verbund-Datentyp veröffentlicht wird (aktiviert). Diese Option ist standardmäßig deaktiviert.
Eingabemodus	Gibt an, wie Clients Features in den Task eingeben. Informationen zu Design und Verwendung von GUI finden Sie unter Eingabemodus. Benutzerdefinierter Wert: Der Client stellt einen Wert für den Parameter bereit. Auswahlliste: Es wird eine Liste mit Zeichenfolgen (die Auswahlliste) bereitgestellt, und der Client muss eine oder mehrere Zeichenfolgen aus der Liste auswählen. Je nach Datentyp der Eingabe können die Zeichenfolgen die Namen der Layer oder einfache Schlüsselwortoptionen sein. Konstanter Wert: Der Wert, den Sie für den Parameter angegeben haben, als das Ergebnis erstellt wurde, wird verwendet. Da der Wert konstant ist, kann er vom Client nicht geändert werden; daher wird es kein Task-Parameter, wenn der Service veröffentlicht wird. Gemischter Modus: Benutzerdefiniert und Auswahlliste: Nur verfügbar für Verbund- oder Wertetabellen-Parameter. Sie können den Eingabemodus für jeden Datentyp im Verbund oder jeden Datentyp für jede Spalte in der Wertetabelle konfigurieren. Wenn ein Datentyp die Auswahlliste nicht unterstützt, steht nur die Option Benutzerdefinierter Wert für die Konfiguration zur Verfügung.
Datentyp in Zeichenfolge konvertieren	Diese Eigenschaft gilt nur für den Datentyp "Flächeneinheit". Sie gibt an, ob die Flächeneinheit in den Zeichenfolgendatentyp konvertiert wird (aktiviert) oder als Flächeneinheit veröffentlicht wird (deaktiviert). Diese Option ist standardmäßig deaktiviert.
Standardwert entfernen	Ab ArcGIS Pro 3.3 wird der beim Ausführen des Werkzeugs verwendete Standardwert während des Veröffentlichungsprozesses entfernt, wenn diese Option aktiviert ist. Diese Option ist standardmäßig deaktiviert.
Standardwert	Der Standardwert des Werkzeugs wird durch den Parameterwert bestimmt, der beim Ausführen des Werkzeugs angegeben wird. Um den Standardwert eines Parameters hinzuzufügen oder zu ändern, führen Sie das Werkzeug mit dem entsprechenden Parameter erneut aus.
Nur Standard-Layer verwenden	Diese Eigenschaft gilt nur für den Auswahllisten-Eingabemodus. Mit ihr wird angegeben, ob nur die beim Ausführen des Werkzeugs verwendeten Optionen in der Listenansicht unter diesem Kontrollkästchen angezeigt werden (aktiviert). Diese Option ist standardmäßig deaktiviert.
Geometrie-Typ	Diese Eigenschaft gilt nur für Features. Der Geometrietyp stammt von den Eingabe- und Ausgabe-Features, die zum Erstellen des Ergebnisses verwendet werden. Er kann auf der Registerkarte Inhalt nicht geändert werden. Führen Sie das Werkzeug mit den Features des angegebenen Geometrietyps erneut aus, und geben Sie das durch diesen Vorgang erstellte Ergebnis frei.
Schema	Diese Eigenschaft gilt nur für Features und Tabellen. Das Schema ist eine Liste mit Feldern (Attributen), die vom Client bereitgestellt werden müssen, wenn er die Features als Eingabe für das Werkzeug erstellt. Diese Liste von Feldern ist dieselbe wie bei dem Layer oder Dataset, die als Eingabe oder Ausgabe für das Werkzeug verwendet wurde, welches das Ergebnis erzeugt hat.

Die folgenden Konfigurationsparameter gelten für das gesamte Werkzeug:

Parameter	Beschreibung
Optionalen Parameter für Ausgabe-Feature-Service hinzufügen	Ein optionaler Eingabeparameter, der angibt, ob alle Feature-Ausgaben bei Verwendung des Web-Werkzeugs als gehosteter Feature-Service gespeichert werden können. Dieser Parameter wird nur unterstützt, wenn die Veröffentlichung als Web-Werkzeug im asynchronen Ausführungsmodus in ArcGIS Enterprise erfolgt. Für die sonstige Konfiguration ist er nicht verfügbar. Der Parameter ist standardmäßig aktiviert. Weitere Informationen zum Verwenden von Web-Werkzeugen mit einem Ausgabe-Feature-Service
Optionalen Parameter für Ausgabe-Image-Service hinzufügen	Ein optionaler Eingabeparameter, der angibt, ob alle Raster-Ausgaben bei Verwendung des Web-Werkzeugs oder des Geoverarbeitungsservice als Image-Services gespeichert werden können. Weitere Informationen zum Verwenden von Web-Werkzeugen oder Geoverarbeitungsservices mit Ausgabe-Image-Service
Alle Standardwerte entfernen	Ab ArcGIS Pro 3.3 werden alle beim Ausführen des Werkzeugs verwendeten Standardwerte entfernt, und das Kontrollkästchen Standardwert entfernen in der obigen Werkzeugparameterkonfiguration wird automatisch aktiviert, wenn diese Option aktiviert ist. Diese Option ist standardmäßig deaktiviert.

ArcGIS Server Manager-Einstellungen

Die Parametereinstellungen in den nachfolgenden Unterabschnitten können nur in ArcGIS Server Manager geändert werden. Dies gilt allerdings nicht für ArcGIS Enterprise Manager für ArcGIS Enterprise on Kubernetes. Die meisten der oben beschriebenen Konfigurationseinstellungen können auch nach der Veröffentlichung des Service in ArcGIS Server Manager geändert werden.

Hinweis:

Die Änderung einer der folgenden Einstellungen führt zu einem Neustart des Service.

Parameter

Die folgenden Parametereinstellungen sind verfügbar:

Parameter	Beschreibung
Cluster	Der Cluster, in dem der Service ausgeführt wird. Diese Einstellung kann nur geändert werden, wenn ArcGIS Server an einem Cluster beteiligt ist.
Verzeichnisse	Die vom Server verwendeten Verzeichnisse, in denen Dateien beim Ausführen des Werkzeugs gespeichert werden.

Funktionen

Die folgende Parametereinstellung für Funktionen ist verfügbar:

Parameter	Beschreibung
WPS	Aktiviert die WPS-Funktionen für Geoverarbeitungsservices, wodurch andere Clients über OGC-Standardprotokolle eine Verbindung mit Werkzeugen herstellen und diese verwenden können. Weitere Informationen zu WPS

Prozesse

Die folgende Parametereinstellung für Prozesse ist verfügbar:

Parameter	Beschreibung
Recycling	Hiermit wird festgelegt, wie häufig und wann ein Service wiederverwendet wird. Der Standardwert ist alle 24 Stunden, ab Mitternacht beginnend. Geoverarbeitungsservices werden im Gegensatz zu einigen anderen Service-Typen, die mit niedriger oder hoher Isolation ausgeführt werden können, nur mit hoher Isolation ausgeführt.