Verwenden der Validierung

Bei der Verwendung von Geoverarbeitungswerkzeugen in ArcGIS Pro werden möglicherweise Validierungsmeldungen angezeigt oder Sie stellen fest, dass ein Parameter nicht mehr sichtbar ist oder dass sich die Liste der Optionen für bestimmte Parameter ändert. Dieses interaktive Benutzererlebnis ist auch in Web-Werkzeugen und Geoverarbeitungsservices verfügbar, die ab ArcGIS Pro 3.6 bis ArcGIS Enterprise 12.0 unter Verwendung der Validierung veröffentlicht werden.

Im Gegensatz zu den Operationen execute und submitJob, die eine Möglichkeit bieten, alle Eingabeparameter für die Ausführung eines Web-Werkzeugs oder Geoverarbeitungsservice bereitzustellen, können Sie mit der Validierung Ihre Eingaben mehrfach überprüfen und anpassen, bevor Sie ein Web-Werkzeug oder einen Geoverarbeitungsservice mit den Operationen execute oder submitJob ausführen.

Voraussetzungen für die Verwendung der Validierung

Um die Validierung zu verwenden oder um das gewünschte interaktive Verhalten bei der Verwendung eines veröffentlichten Web-Werkzeugs oder Geoverarbeitungsservice zu erhalten, muss das Werkzeug über eine Validierungslogik verfügen und die Validierungsfunktion muss aktiviert sein.

Verwenden von Werkzeugen mit vorhandener Validierungslogik

Zahlreiche Werkzeuge in ArcGIS Pro verfügen über eine Validierungslogik. Wenn beispielsweise eine Feature-Class oder eine Tabelle an einen Eingabeparameter übergeben wird, füllt ein abhängiger Feldparameter automatisch alle Felder aus diesem Layer aus. Ein weiteres Beispiel ist, dass bei der Angabe bestimmter Optionen in einem Parameter andere Parameter sichtbar oder ausgeblendet werden können.

Erstellen von Werkzeugen mit angepasster Validierungslogik

Wenn die Standard-Validierungslogik unzureichend ist, verwenden Sie angepassten Validierungscode mit Python-Skriptwerkzeugen oder einer Python-Toolbox.

Aktivieren der Validierungsfunktion

Um die Validierung bei der Veröffentlichung eines Werkzeugs in ArcGIS Pro zu unterstützen, aktivieren Sie den Parameter Validieren in den Einstellungen des Web-Werkzeugs.

Wenn Sie die Klasse GeoprocessingSharingDraft zur Veröffentlichung in Python verwenden, stellen Sie sicher, dass die Eigenschaft capabilities die Option Validate verwendet.

Verwenden eines kompatiblen Clients

Verwenden Sie ein Web-Werkzeug oder einen Geoverarbeitungsservice von ArcGIS Pro 3.6 oder höher, oder erstellen Sie eine benutzerdefinierte Web-App, um die Validierung zu verwenden.

Verwenden der Validierung in ArcGIS Pro

Um eine Eingabe zu validieren, bevor Sie ein Web-Werkzeug oder einen Geoverarbeitungsservice ausführen, klicken Sie auf die Schaltfläche Validieren links neben der Schaltfläche Ausführen. Abhängig von der Validierungslogik des Werkzeugs haben Sie folgende Möglichkeiten:

  • Ändern der zulässigen Werte eines Parameters.
  • Aktualisieren einer Feldliste basierend auf einem abhängigen Feature oder einer Tabelleneingabe. Diese Option ist auch für frühere Versionen verfügbar.
  • Anpassen von Parametermeldungen.
  • Deaktivieren oder Aktivieren von Parametern.
  • Ändern von Werten für andere Eingabetypen als Feature-, Tabellen- und Raster-Datentypen.

Im Gegensatz zur Ausführung eines lokalen Werkzeugs wird die Validierung für Web-Werkzeuge oder Geoverarbeitungsservices nicht automatisch ausgeführt, wenn Sie nach der Eingabe eines Parameterwerts an eine andere Stelle klicken oder den Fokus Ihrer Maus aufheben.

Verwenden der Validierung mit der ArcGIS REST API

Informationen zum Anpassen einer Web-App unter Verwendung der ArcGIS REST API finden Sie unter der Operation Validate.