Anhand der Parametereinstellungen, die Sie beim Freigeben eines Werkzeugs als Web-Werkzeug 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. Die erweiterten Einstellungen müssen nur für wenige Web-Werkzeuge (Geoverarbeitungsservices) geändert werden.
Einstellungen
In den nachfolgenden Unterabschnitten werden die Einstellungen beschrieben, die Sie beim Freigeben eines Web-Werkzeugs verwenden können.
Allgemein
Die folgenden allgemeinen Parametereinstellungen sind verfügbar:
Parameter | Beschreibung |
---|---|
Name | Der Name des Web-Werkzeugs, das für Ihr Portal freigegeben wird. Dieser Name muss in Ihrem 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. Für die Freigabe in einem ArcGIS Enterprise-Portal der Version 10.9 oder früher sind eine Zusammenfassung und Tags erforderlich. Sie können maximal 128 Tags verwenden. |
Tags | |
Version | Die Version von ArcGIS Enterprise oder ArcGIS Server, in der die Freigabe erfolgt. Dieser Parameter ist nur beim Speichern einer Offline-Service-Definition für ein Web-Werkzeug oder einen Geoverarbeitungsservice aktiviert. |
Daten | Gibt an, welche Aktionen mit den Daten durchgeführt werden:
Weitere Informationen zum Kopieren, Referenzieren und Verwenden von URL-Daten |
Ortsangaben | Gibt an, wo das Web-Werkzeugelement erstellt wird:
|
Freigeben für | 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 Ihres Portals freigegeben, die Zugriff auf ein Element haben. Sie können es für jede Gruppe freigeben, der sie derzeit angehören. |
Konfiguration
Die folgenden Konfigurationsparametereinstellungen sind verfügbar:
Parameter | Beschreibung |
---|---|
Hochladen | Legt fest, ob ein Client eine Datei auf Ihren 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 Ihren 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 festgelegt 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. |
Ausgabe im Kartenbild-Layer anzeigen | Beim Veröffentlichen eines Web-Werkzeugs 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. Nachfolgend finden Sie einige Gründe für die Verwendung von Ausgabe im Kartenbild-Layer anzeigen:
Hinweis:Ein Ausgabe-Kartenbild kann nur dann verwendet werden, wenn das Web-Werkzeug auf Asynchron eingestellt ist. Dieser Parameter wird nicht unterstützt, wenn ein Web-Werkzeug in Kubernetes veröffentlicht wird. |
Meldungs-Level | Sie können wie nachfolgend beschrieben Meldungen verschiedener Ebenen an den Client zurückgeben, der das Web-Werkzeug ausgeführt hat:
Vorsicht:Alle Meldungen, unabhängig von der Ebene, können Dataset-Pfade und -Namen enthalten, was ein Sicherheitsrisiko darstellen kann. Die Info-Ebene ist am ausführlichsten und enthält Verweise auf Dataset-Pfade und -Namen. Im Allgemeinen sollten Sie während der Entwicklung Meldungen zurückgeben, sie aber in der Produktionsphase deaktivieren. |
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 Sie keine Features zurückgeben möchten, setzen Sie diesen Wert auf 0 (Null). In der Regel setzen Sie diesen Wert nur dann auf Null, wenn Sie Ausgabe im Kartenbild-Layer anzeigen verwenden. |
Mit Ausnahme der Zusammenfassung und Tags können die zuvor erwähnten Parametereinstellungen in ArcGIS Server Manager geändert werden, nachdem das Web-Werkzeug freigegeben wurde. Diese Beschreibungsinformationen können auf der Elementseite des Web-Werkzeugs in Ihrem Portal aktualisiert und freigegeben werden.
Inhalt
Die folgenden Einstellungen lassen sich beim Veröffentlichen eines Web-Werkzeugs ändern.
Werkzeug hinzufügen
Um einem vorhandenen Web-Werkzeug 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. Beides kann hier ohne Auswirkungen auf die ursprünglichen Metadaten des Werkzeugs geändert werden. |
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 eines Parameters.
|
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. Sie müssen das Werkzeug mit den Features des angegebenen Geometrietyps erneut ausführen und das durch den Vorgang erzeugte Ergebnis freigeben. |
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 Ausgabeparameter, der angibt, ob die Ausgabe bei Verwendung des Web-Werkzeugs als Feature-Service gespeichert werden kann (aktiviert). Dieser Parameter wird nur unterstützt, wenn die Veröffentlichung als Web-Werkzeug im asynchronen Modus durchgeführt wird. Für die sonstige Konfiguration ist er nicht verfügbar. Diese Option ist standardmäßig aktiviert. |
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. Die zuvor erwähnten Konfigurationseinstellungen können nach der Veröffentlichung des Service auch 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 | Das 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. |
Pooling
Die folgenden Parametereinstellungen für das Pooling sind verfügbar:
Parameter | Beschreibung |
---|---|
Anzahl der Instanzen | Die minimale und maximale Anzahl von Instanzen des Service. Die Standardwerte sind 1 (Minimum) und 2 (Maximum). Durch die Festlegung eines Minimalwertes von 0 werden die Systemressourcen reduziert; eine Instanz wird bei Client-Anforderung gestartet. |
Die maximale Zeit, die ein Client einen Service verwenden kann | 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 diese Zeit reduzieren, um sicherzustellen, dass ein Client die Services nicht missbräuchlich verwendet. |
Die maximale Zeit, die ein Client auf einen Service wartet | 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 dieses Timeout eintritt, bevor eine Instanz verfügbar wird, schlägt der Task fehl. Der Standard ist 60 Sekunden (1 Minute). |
Die maximale Zeit, die eine Leerlaufinstanz ausgeführt wird | 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. |
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. |