Lernprogramm: Veröffentlichen und Verwenden eines WPS-Service

Komplexität: EinsteigerDatenanforderung: Eigene Daten verwenden Ziel: Veröffentlichen Sie einen WPS-Service mit ArcGIS for Server, und verwenden Sie ihn in einem Webbrowser.

Das Open Geospatial Consortium, Inc. (OGC) ist eine internationale Spezifikation zur Bereitstellung und Durchführung räumlicher Verarbeitungsprozesse im Web. Wenn ein Geoverarbeitungsservice mit WPS-Funktionen veröffentlicht wird, können die Daten mit jedem Client aufgerufen werden, der WPS unterstützt. Wenn Sie WPS noch nicht kennen und gern mehr darüber erfahren möchten, lesen Sie unter WPS-Services nach.

Dieses Lernprogramm führt Sie durch den Prozess des Veröffentlichens eines Geoverarbeitungsservice in ArcGIS Server, der mit WPS-Clients aufgerufen werden kann. Zu diesem Zweck müssen Sie ein Werkzeug in ArcGIS Desktop vorbereiten, das Werkzeug ausführen, wobei ein erfolgreiches Ergebnis erzielt werden muss, und anschließend das Ergebnis der Geoverarbeitung mit aktivierter WPS-Funktion veröffentlichen.

Vor dem Start dieses Lernprogramms

In ArcGIS Server ab Version 10.8.1 können Sie ein Web-Werkzeug oder einen Geoverarbeitungsservice aus ArcGIS Pro oder ArcGIS Desktop veröffentlichen. Wenn Sie ArcGIS Server 10.8 oder eine ältere Version haben, können Sie einen WPS-fähiges Geoverarbeitungsservice aus ArcGIS Desktop veröffentlichen:

• Weitere Informationen über die Konfiguration Ihrer ArcGIS Server-Site finden Sie unter Konfigurieren einer Bereitstellung mit einem einzelnen Computer.
• Informationen zum Bereitstellen der von der GIS-Ressource referenzierten Daten für den Server finden Sie unter Bereitstellen der Daten für ArcGIS Server.

Veröffentlichen eines WPS-Service aus ArcGIS Pro

Veröffentlichen Sie vor der Konfiguration eines WPS-Service Ihre Analyse in ArcGIS Server. Wenn es sich um einen verbundenen Server handelt, veröffentlichen Sie Ihre Analyse als Web-Werkzeug. Wenn Ihr Server eine Bereitstellung auf einem einzelnen Computer ist, veröffentlichen Sie die Analyse als Geoverarbeitungsservice. Informationen zum Veröffentlichen als Web-Werkzeug finden Sie unter Kurzer Überblick über das Erstellen und Freigeben von Web-Werkzeugen. Informationen zum Veröffentlichen als Geoverarbeitungsservice finden Sie unter Kurzer Überblick über das Erstellen und Freigeben von Geoverarbeitungsservices. Nachdem Sie ein Web-Werkzeug oder einen Geoverarbeitungsservice veröffentlicht haben, führen Sie die folgenden Schritte aus, um einen WPS-Service zu konfigurieren:

1. Anmelden bei ArcGIS Server Manager
2. Suchen Sie auf der Registerkarte Services den Link Ihres veröffentlichten Service, und klicken Sie darauf.
3. Aktivieren Sie auf der Registerkarte Funktionen das Kontrollkästchen WPS.

   Nach der Aktivierung der Option WPS sehen Sie die Eigenschaften des WPS-Service. Sie können unter anderem folgende Eigenschaften konfigurieren: Name, Kurzbeschreibung und Titel.

Veröffentlichen eines WPS-Service in ArcGIS Desktop

Im Gegensatz zur Veröffentlichung mit ArcGIS Pro können Sie Analysen über eine Serververbindung nur als Web-Werkzeug oder Geoverarbeitungsservice veröffentlichen. Sie können einen WPS-Service allerdings auch während der Veröffentlichung konfigurieren und nicht nur nach der Veröffentlichung in ArcGIS Server Manager. Die Schritte zur Veröffentlichung werden nachfolgend im Detail beschrieben:

Vorbereiten des Geoverarbeitungswerkzeugs in ArcGIS Desktop

Ein Geoverarbeitungsservice umfasst einen oder mehrere Tasks. Ein Task akzeptiert Parameter und gibt Ergebnisse zurück und ist insofern einem Geoverarbeitungswerkzeug ähnlich. Mit diesem Begriff bezeichnen ArcGIS Server-Clients Routinen, die Aufgaben auf einem Server durchführen und Ergebnisse zurückgeben. Sie können z. B. ein Geoverarbeitungswerkzeug erstellen, das Abflussgebiete abhängig von den Landnutzungs- und Höhendaten eingrenzt. Dieses Werkzeug kann anschließend mit aktivierter WPS-Funktion veröffentlicht und in einer WPS-kompatiblen Anwendung im Internet als Task verwendet werden.

Im Thema Erstellen von Geoverarbeitungs-Tasks mit ModelBuilder finden Sie Informationen dazu, welche Elemente beim Erstellen des Geoverarbeitungswerkzeugs berücksichtigt werden sollten.

Ausführen des Werkzeugs

Bevor Sie das Werkzeug veröffentlichen können, müssen Sie es zunächst ausführen und im Fenster Ergebnisse ein erfolgreiches Geoverarbeitungsergebnis erzielen. Führen Sie dazu die folgenden Schritte aus:

1. Doppelklicken Sie im Inhaltsverzeichnis für den Katalog auf das Geoverarbeitungswerkzeug.
2. Geben Sie die entsprechenden Parameterwerte ein, und klicken Sie auf OK, um das Werkzeug auszuführen.

   Wenn das Werkzeug erfolgreich ausgeführt wird, wird das Fenster Ergebnisse angezeigt.

Veröffentlichen des Ergebnisses

Nach der erfolgreichen Ausführung des Geoverarbeitungswerkzeugs können Sie es als Geoverarbeitungsservice veröffentlichen. Während dieses Prozesses aktivieren Sie die WPS-Funktion, wodurch der Geoverarbeitungsservice (und weitere Tasks) kompatibel mit der WPS-Spezifikation von OGC gemacht wird.

1. Klicken Sie mit der rechten Maustaste auf das Geoverarbeitungsergebnis, und wählen Sie Freigeben als > Geoverarbeitungsservice aus.
2. Wählen Sie im Fenster Als Service freigeben die Option Service veröffentlichen aus. Klicken Sie auf Weiter.
3. Aktivieren Sie im Dialogfeld Service veröffentlichen das Kontrollkästchen Verbindung mit ArcGIS Server herstellen, um eine Verbindung mit dem Server herzustellen.
4. Wählen Sie im Fenster ArcGIS-Server hinzufügen die Option GIS-Services veröffentlichen aus. Klicken Sie auf Weiter.
5. Geben Sie als Server-URL die URL der ArcGIS Server-Site an, mit der Sie sich verbinden möchten, zum Beispiel http://gisserver.domain.com:6080/arcgis.
6. Wählen Sie in der Dropdown-Liste Server-Typ die Option ArcGIS Server aus.

   Während der Veröffentlichung wird eine Service-Definitionsdatei erstellt und vorübergehend auf der lokalen Festplatte gespeichert. Wenn der Veröffentlichungsprozess abgeschlossen ist, wird die Service-Definitionsdatei hochgeladen und die lokale Datei gelöscht. Übernehmen Sie für den Zweck dieses Lernprogramms den Standard-Staging-Ordner, und fahren Sie fort.

7. Geben Sie Ihren Benutzernamen und das Kennwort ein. Klicken Sie auf Fertig.
8. Geben Sie im Fenster Service veröffentlichen einen neuen Namen für den Service ein. Der Name darf nicht mehr als 120 Zeichen lang sein und darf nur alphanumerische Zeichen und Unterstriche enthalten. Klicken Sie auf Weiter.

   Services werden standardmäßig im Stammordner (Stammverzeichnis) von ArcGIS Server veröffentlicht. Services können in Unterordnern des Stammverzeichnisses organisiert werden.

   Wählen Sie den Ordner aus, in dem Sie den Service veröffentlichen möchten, oder erstellen Sie einen Ordner mit dem Service. Klicken Sie auf Fortfahren.
9. Der Service-Editor wird geöffnet. Mit dem Service-Editor können Sie auswählen, auf welche Weise Benutzer den Geoverarbeitungsservice verwenden können, und Sie können ganz genau festlegen, wie der Geoverarbeitungsservice auf dem Server veröffentlicht wird. Klicken Sie auf die Registerkarte Funktionen.
10. Die Geoverarbeitung ist standardmäßig aktiviert. Wählen Sie WPS aus.
11. Klicken Sie im linken Service-Editor-Bereich auf WPS. Konfigurieren Sie in diesem Bereich die Eigenschaften des WPS-Service. Mit den WPS-Service-Eigenschaften werden nützliche Informationen über den Service-Herausgeber für den Client bereitgestellt.
    • Im Feld URL wird die URL angezeigt, mit der Clients auf den WPS-Service zugreifen. Die URL sieht folgendermaßen aus: http://gisserver.domain.com:6080/arcgis/services/folder/service/GPServer/WPSServer.

      Hinweis:

      Kopieren und speichern Sie die URL des WPS-Service. Sie benötigen sie auch, um andere Schritte des Lernprogramms auszuführen.

    • Um einen WPS-Service mit vom System generierten Capabilities-Dateien zu konfigurieren, verwenden Sie die Standardoption Service-Eigenschaften unten eingeben. Die Felder Name, Titel und Online-Ressource werden automatisch aufgefüllt und sollten nicht geändert werden. Mit den Feldern in der Liste können Sie zusätzliche Eigenschaften angeben (optional). Weitere Informationen finden Sie unter Verfügbare WPS-Service-Eigenschaften.
    • Wenn Sie einen WPS-Service zur Verwendung externer Capabilities-Dateien konfigurieren möchten, wählen Sie Externe Capabilities-Dateien verwenden aus. Sie müssen bereits eine WPS-Capabilities-Datei erstellt haben, um diese Option nutzen zu können.
    • Namespace und Präfix sind eindeutige Eigenschaften, mit denen Ihre WPS-Prozesse von anderen WPS-Prozessen unterschieden werden. Diese Eigenschaften werden automatisch aufgefüllt und sollten nicht geändert werden.

    Tipp:

    Tipps und Empfehlungen zum Festlegen der Eigenschaften des Geoverarbeitungsservice mit dem Service-Editor finden Sie unter Einstellungen für den Geoverarbeitungsservice: Allgemein. Informationen dazu, wie Sie die Services optimal für die Bereitstellung konfigurieren, finden Sie unter Optimieren und Konfigurieren von Services.

12. Klicken Sie auf die Schaltfläche Analysieren Daraufhin wird das Ergebnis geprüft, um festzustellen, ob es als WPS-Service auf dem Server veröffentlicht werden kann.

    Tipp:

    Um den Anzeigebereich beim Konfigurieren des WPS-Service zu vergrößern, klicken Sie auf die Schaltfläche Ausblenden im oberen Bereich des Service-Editor.

13. Beheben Sie im Fenster Vorbereiten alle Fehler im Abschnitt Fehler . Erst dann können Sie Ihr Ergebnis als WPS-Service veröffentlichen. Sie können die Warnungen und Informationsmeldungen korrigieren, um die Performance und Darstellung des Service zu verbessern. Dieser Vorgang ist jedoch optional. Weitere Informationen zum Beheben dieser Probleme finden Sie unter Analysieren der GIS-Ressource.

    Hinweis:

    Sie können Ordner und Geodatabases für die ArcGIS Server-Site registrieren, um sicherzustellen, dass der Server Ihre Daten erkennt und verwenden kann. Wenn Sie mit den folgenden Schritten fortfahren, werden alle vom Werkzeug referenzierten Daten, die aus einem Ordner oder einer Geodatabase stammen, der bzw. die nicht registriert ist, während der Veröffentlichung auf den Server kopiert. Dies ist eine Vorsichtsmaßnahme, um sicherzustellen, dass der Server auf alle Daten zugreifen kann, die vom Service verwendet werden. Vollständige Anweisungen zum Registrieren eines Ordners oder einer Geodatabase bei der ArcGIS Server-Site finden Sie unter Registrieren von Daten bei ArcGIS Server mit ArcGIS Desktop oder ArcGIS Pro.

14. Klicken Sie im Service-Editor optional auf Vorschau . So erhalten Sie eine Vorschau und können sich besser vorstellen, wie das Werkzeug-Dialogfeld aussieht, wenn es im Web angesehen wird.
15. Nachdem Sie die Fehler im Geoverarbeitungs-Modell behoben haben, klicken Sie auf Veröffentlichen .

Abrufen und Beschreiben eines WPS-Service

Sobald Sie einen WPS-Service veröffentlicht haben, kann dieser in jedem Client verwendet werden, der WPS 1.0.0 unterstützt. Ein Webbrowser ist einer der einfachsten Clients eines WPS-Service. Sie können Informationen über HTTP anfordern, und die Antworten oder Ausnahmen werden durch den Browser zurückgegeben.

Führen Sie diese Schritte aus, um den Zugriff auf WPS-Services über einen Webbrowser zu ermöglichen:

1. Öffnen Sie einen Webbrowser.
2. Führen Sie die Anforderungen GetCapabilities und DescribeProcess wie in den folgenden Abschnitten beschrieben durch.

GetCapabilities

Mit dieser Anforderung werden alle Metadaten zurückgegeben und verarbeitet, die über den Service im GML-Format verfügbar sind. Um die GetCapabilities-Operation zu verwenden, kopieren Sie die WPS-Service-URL, fügen Sie sie in die Adressleiste ein, und fügen Sie am Ende der URL ?SERVICE=WPS&VERSION=1.0.0&REQUEST=GetCapabilities hinzu.

Beispiel-URL: https://gisserver.domain.com:6443/arcgis/services/my_wps/GPServer/WPSServer?SERVICE=WPS&VERSION=1.0.0&REQUEST=GetCapabilities

Beispiel-URL: https://gisserver.domain.com/webadaptor//services/my_wps/GPServer/WPSServer?Service=WPS&Version=1.0.0&Request=GetCapabilities

DescribeProcess

Die Antwort auf eine DescribeProcess-Anforderung umfasst ausführliche Informationen zu einem bestimmten Prozessangebot, das im Wesentlichen eine eindeutige Kennung des Prozesses und die Kennung, den Typ und das Schema jedes erforderlichen oder optionalen Eingabe-/Ausgabeparameters für den Prozess beschreibt. Der WPS-Client benötigt diese Informationen, um anschließend Ausführen-Anforderungen auszugeben, damit die eigentliche räumliche Verarbeitung durchgeführt wird. Um die DescribeProcess-Operation zu verwenden, kopieren Sie die WPS-Service-URL, fügen Sie sie in die Adressleiste ein, und fügen Sie am Ende der URL ?SERVICE=WPS&VERSION=1.0.0&REQUEST=DescribeProcess hinzu.

Beispiel-URL: https://gisserver.domain.com:6443/arcgis/services/my_wps/GPServer/WPSServer?SERVICE=WPS&VERSION=1.0.0&REQUEST=DescribeProcess&Identifier=output_feature_layer

Beispiel-URL: https://gisserver.domain.com/webadaptor/services/my_wps/GPServer/WPSServer?Service=WPS&Version=1.0.0&Request=DescribeProcess&Identifier=output_feature_layer

Ausführen eines WPS-Service-Prozesses

Um die räumliche Verarbeitung im Internet durchzuführen, können Sie eine Ausführen-Anforderung über einen WPS-Client an den WPS-Service senden. Eine Ausführen-Anforderung enthält gewöhnlich entweder den Wert oder den Verweis jedes Eingabe- und Ausgabeparameters des WPS-Prozesses und gibt außerdem an, auf welche Weise das Ergebnis des Prozesses an den WPS-Service zurückgesendet werden soll. Die Antwort auf eine Ausführen-Anforderung enthält das eingebettete Ergebnis der räumlichen Verarbeitung. Sie kann so konfiguriert werden, dass sie die Ergebnisse der vor Kurzem durchgeführten Verarbeitungsaufträge zurückgibt.

Ausführungsoperationen werden in der Regel über eine HTTP POST-Anforderung im WPS-Client aufgerufen. Im Folgenden sehen Sie eine Ausführen-Beispielanforderung, die an die Beispiel-URL https://gisserver.domain.com:6443/arcgis/services/my_wps/GPServer/WPSServer oder an eine entsprechende Beispiel-URL: https://gisserver.domain.com/webadaptor/services/my_wps/GPServer/WPSServer?Service=WPS&Version=1.0.0&Request=Execute&Identifier=SampleProcessId gesendet wurde:

<wps:Execute xmlns:wps="http://www.opengis.net/wps/1.0.0" service="WPS" version="1.0.0" language="en-US">
   <ows:Identifier xmlns:ows="http://www.opengis.net/ows/1.1">SampleProcessId</ows:Identifier>
   <wps:DataInputs>
      <wps:Input>
         <ows:Identifier xmlns:ows="http://www.opengis.net/ows/1.1">Input_String</ows:Identifier>
         <wps:Data>
            <wps:LiteralData dataType="xs:string">abcdefg</wps:LiteralData>
         </wps:Data>
      </wps:Input>
   </wps:DataInputs>
   <wps:ResponseForm>
      <wps:ResponseDocument storeExecuteResponse="true" lineage="true" status="false">
         <wps:Output schema="http://www.w3.org/TR/xmlschema-2/#string" asReference="false">
            <ows:Identifier xmlns:ows="http://www.opengis.net/ows/1.1">Output_String</ows:Identifier>
         </wps:Output>
      </wps:ResponseDocument>
   </wps:ResponseForm>
</wps:Execute>

Weitere Informationen zu WPS-Anforderungsoperationen und den entsprechenden Parametern finden Sie unter der OGC WPS 1.0.0-Spezifikation. Auf der Webseite Open Standards von Esri erhalten Sie zudem Informationen zur Unterstützung der OGC-Services in ArcGIS.