Lernprogramm: Veröffentlichen eines WPS-Services
In diesem Thema
- Vor dem Start dieses Lernprogramms
- Vorbereiten des Geoverarbeitungswerkzeugs in
ArcGIS for Desktop - Ausführen des Werkzeugs
- Veröffentlichen des Ergebnisses
- Verwenden des WPS-Service
- Ausführen eines WPS-Service-Prozesses
Die Web Processing Service-(WPS-)Spezifikation des 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 for Server, der mit WPS-Clients aufgerufen werden kann. Zu diesem Zweck müssen Sie ein Werkzeug in ArcGIS for 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
Wenn Sie ArcGIS for Server gerade installiert haben, müssen Sie noch einige vorbereitende Schritte ausführen, bevor Sie eine Verbindung mit dem Server in ArcMap herstellen und Services veröffentlichen können.
- Ausführliche Informationen zum Konfigurieren der ArcGIS-Server-Site finden Sie in diesem Hilfesystem unter Erste Schritte nach der Installation.
- Informationen zum Bereitstellen der von der GIS-Ressource referenzierten Daten für den Server finden Sie im Thema Bereitstellen der Daten für ArcGIS-Server.
Vorbereiten des Geoverarbeitungswerkzeugs in ArcGIS for Desktop
Ein Geoverarbeitungsservice umfasst einen oder mehrere Tasks. Ein Task akzeptiert Parameter und gibt Ergebnisse zurück und ist insofern nichts anderes als ein Geoverarbeitungswerkzeug. Mit diesem Begriff bezeichnen ArcGIS for 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. Wenn Sie mit der Erstellung eines Geoverarbeitungswerkzeugs fertig sind, gehen Sie zum nächsten Abschnitt über.
Ausführen des Werkzeugs
Bevor Sie die Veröffentlichung durchführen können, müssen Sie das Werkzeug ausführen und im Fenster Ergebnisse ein erfolgreiches Geoverarbeitungsergebnis erzielen. Führen Sie hierzu die folgenden Schritte aus:
- Doppelklicken Sie im Kataloginhaltsverzeichnis auf das Geoverarbeitungswerkzeug.
- Geben Sie die geeigneten Variablen ein, und klicken Sie auf OK.
Wenn das Werkzeug erfolgreich ausgeführt wird, wird das Fenster Ergebnisse angezeigt.
Veröffentlichen des Ergebnisses
Wenn im Fenster Ergebnisse ein erfolgreiches Geoverarbeitungsergebnis angezeigt wird, können Sie das Geoverarbeitungswerkzeug 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.
- Klicken Sie mit der rechten Maustaste auf das Geoverarbeitungsergebnis, und wählen Sie Freigeben als > Geoverarbeitungsservice aus.
- Wählen Sie im Fenster Als Service freigeben die Option Service veröffentlichen aus. Klicken Sie auf Weiter.
- Klicken Sie im Dialogfeld Service veröffentlichen auf Verbindung mit ArcGIS-Server herstellen
, um eine neue Verbindung mit dem Server herzustellen. - Wählen Sie im Fenster ArcGIS Server hinzufügen die Option GIS-Services veröffentlichen aus. Klicken Sie auf Weiter.
- Geben Sie für die Server-URL die URL der ArcGIS-Server-Site ein, zu der Sie eine Verbindung herstellen möchten. Zum Beispiel: http://gisserver.domain.com:6080/arcgis.
- 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.
- Wenn der Serveradministrator Sicherheit für die Site aktiviert hat, geben Sie Ihren Benutzernamen und Ihr Kennwort ein. Klicken Sie auf Fertig stellen.
- Geben Sie im Fenster Service veröffentlichen optional 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 neuen Ordner mit dem Service. Klicken Sie auf Fortfahren.
- Der Service-Editor wird angezeigt. 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.
- Die Geoverarbeitung ist standardmäßig aktiviert. Wählen Sie WPS aus.
- 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.
- Wenn Sie einen WPS-Service mit vom System generierten Capabilities-Dateien konfigurieren möchten, 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.
- Um einen WPS-Service zur Verwendung externer Capabilities-Dateien zu konfigurieren, 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 Prefix 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. Informationen dazu, wie Sie die Services optimal für die Bereitstellung konfigurieren, finden Sie unter Optimieren und Konfigurieren von Services.
- 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.
- Klicken Sie auf 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. - Beheben Sie alle Fehler
im Fenster Vorbereiten. Sie können das Ergebnis erst anschließend 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 Order 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. Eine vollständige Anleitung zum Registrieren eines Ordners oder einer Geodatabase auf der ArcGIS-Server-Site finden Sie unter Registrieren von Daten bei ArcGIS-Server mit ArcGIS for Desktop.
- Klicken Sie im Service-Editor optional auf Vorschau
. So können Sie sich besser vorstellen, wie das Werkzeug-Dialogfeld aussieht, wenn es im Web angesehen wird. - Nachdem Sie die Fehler im Geoverarbeitungs-Modell behoben haben, klicken Sie auf Veröffentlichen
.
Verwenden des 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:
- Öffnen Sie einen Webbrowser.
- 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.
URL-Beispiel: http://gisserver.domain.com:6080/arcgis/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.
URL-Beispiel: http://gisserver.domain.com:6080/arcgis/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-/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 finden Sie ein Beispiel für eine Ausführen-Anforderung:
<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 Standards and Interoperability von Esri erhalten Sie zudem Informationen zur Unterstützung der OGC-Services in ArcGIS.