Der Data Download Service stellt Benutzern die Ausgabe von einem Workspace als herunterladbare zip-Datei zur Verfügung. Normalerweise ermöglicht der Dienst Benutzern die Angabe der Daten-Layer, des Formats und des Koordinatensystems für den Download.
Dieser Dienst wird über eine URL oder ein Formular angefordert. Beispiel:
http://<host>/fmedatadownload/<repository>/<workspace>.fmw?<parameters>
Es wird eine Webseite mit einem Link zu einer zip-Datei geöffnet, die die Ergebnisse der Workspace-Umsetzung enthält. Außerdem kann eine E-Mail mit einem Link zur zip-Datei gesendet werden.
Der Download wird aus folgenden Gründen als zip-Datei (komprimiertes Archiv) zurückgegeben:
- Das Ergebnis besteht aus einer Reihe von Ausgabedatensätzen (nicht nur ein Datensatz).
- Ordnerbasierte Datensätze bestehen nicht aus einer einzelnen Datei; das ESRI Shape-Format enthält beispielsweise Dateien mit der Erweiterung .shp, .shx, .dbf und einigen anderen.
- Auch dateibasierte Datensätze können aus mehreren Dateien bestehen; ein GML-Datensatz enthält beispielsweise sowohl eine GML-Datei als auch eine XSD-Datei (XML Schema-Definition).
Hinweis Die zip-Datei aus Workspaces, die mehrere Datensätze in ein Fanout-Verzeichnis schreiben, besteht aus mehreren Ordnern, die die einzelnen Datensätze enthalten. Diese Ordner befinden sich in einem einzigen Ordner, dessen Name auf dem Ziel-Fanout-Verzeichnis basiert.
FME Flow kann auch Ausgaben bereitstellen, die nicht gezippt sind, indem er den Data Streaming-Dienst verwendet.
Der Data Upload Service arbeitet in Verbindung mit den Services Data Download, Data Streaming und Job Submitter, um Dateien hochzuladen.
Voraussetzungen
Dieser Dienst funktioniert mit jedem Workspace, der einzelne oder mehrere Dateien schreibt. Es werden keine offengelegten Parameter benötigt. Es ist nicht möglich, einen Daten-Download in einem Workspace auszuführen, dessen Ziel ein Datenbankformat ist.
Hinweis Möglicherweise möchten Sie einige Parameter in Ihrem Workspace offenlegen, um die Umsetzung über die URL oder Formularanforderung zu steuern. Beispielsweise sind zu lesende Featuretypen, das Koordinatensystem für die Ausgabe und das Format (generischer Writer) üblicherweise offengelegte Parameter, wenn Sie diesen Dienst verwenden.
Service-spezifische Anfrageparameter
|
Name |
Wert |
Beschreibung |
|---|---|---|
|
opt_responseformat |
xml | json |
Die Sprache der Antwort. Der Text muss aus Kleinbuchstaben bestehen. |
| opt_geturl | Die URL zu einem Datensatz | Die URL des Quelldatensatzes, die von der Transformation verwendet wird. |
| opt_showresult | true | false | Gibt an, ob die XML / JSON-Antworten das Ergebnis der FME-Umsetzung enthalten. Der Standardwert ist "true", wenn dieser Parameter nicht vorhanden ist. |
| opt_servicemode | sync | async | schedule |
Schaltet zwischen synchronem und asynchronem Modus des Dienstes um. Wenn Jobs asynchron (async) übermittelt werden, wird die Antwort auf Erfolg oder Fehler der Übermittlung sofort zurückgegeben. Bei Einstellung auf synchron (sync) wird die Antwort erst nach Abschluss des Jobs zurückgegeben. Oder plant eine Anfrage zum Herunterladen von Daten so ein, dass sie zu einer bestimmten Startzeit ausgeführt wird (nur einmalig). Wenn ein Ablaufplan angegeben ist, finden Sie unten weitere Parameter. |
| opt_requesteremail | durch Kommas getrennte E-Mail-Adressen | Adressen, an die die Benachrichtigungs-E-Mail gesendet wird. |
Benachrichtigungs-Direktiven
Dieser Service unterstützt Benachrichtigungs-Direktiven.
Beispiel
Festlegen des Notification Service-Themas zum Benachrichtigen, wenn ein Job erfolgreich ist bzw. fehlschlägt:
http://localhost/fmedatadownload/Samples/austinApartments.fmw?&nm_jobsuccess_topic=DATADOWNLOAD_ASYNC_JOB_SUCCESS&nm_jobfailure_topic=DATADOWNLOAD_ASYNC_JOB_FAILURE
Ablaufplan für eine Anfrage zum Herunterladen von Daten
Mit opt_servicemode=schedule können Sie eine Anfrage zum Herunterladen von Daten so planen, dass sie einmalig zu einer bestimmten Startzeit ausgeführt wird. Die folgenden zusätzlichen Parameter sind erforderlich:
| Name | Wert | Beschreibung |
|---|---|---|
| trigger | runonce | Gibt an, dass der Job einmal ausgeführt werden soll. Nur runonce wird unterstützt. |
| start | <yyyy-MM-dd HH:mm:ss> | Datum und Uhrzeit für die Ausführung des Jobs. Wenn Datum und Uhrzeit vor der aktuellen Uhrzeit liegen, wird der Job sofort ausgeführt. |
| category | <category _name> | Der Name der allgemeinen Kategorie oder Gruppe, zu der der Auftrag gehört. |
| name | <schedule name> | Der Name des Auftrags. Namen müssen innerhalb einer Kategorie eindeutig sein. Nachdem ein Auftrag, der einmal ausgeführt werden soll, beendet ist, wird er automatisch entfernt. |
| description | <description> | Die Beschreibung des Auftrags. |
Verwenden von Remote-Daten in einer Anfrage
Verwenden von Daten aus dem HTTP-POST-Body als Reader-Datensatz
Dieser Web Service kann Daten empfangen und den Quelldatensatz via HTTP POST überschreiben. Der Inhalt im POST-Request-Body wird in einer temporären Datei gespeichert, die als Reader-Datensatz des Workspaces verwendet wird. Wenn sich im Workspace mehrere Reader befinden, müssen Sie angeben, welcher Reader die temporäre Datei verwenden soll. Sie geben Ihre Wahl beim Publizieren des Workspaces an, indem Sie die Service-Registrierung bearbeiten.
Verwenden von Daten aus HTTP GET als Reader-Datensatz
Dieser Web Service kann Daten empfangen und den Reader-Datensatz via HTTP GET überschreiben. Der Datensatz sollte als URL angegeben und vom Parameter 'opt_geturl' an den Dienst übergeben werden. Es werden sowohl HTTP- als auch FTP-URLs unterstützt. Wenn sich im Workspace mehrere Reader befinden, müssen Sie angeben, welcher Reader die temporäre Datei verwenden soll. Sie geben Ihre Wahl beim Publizieren des Workspaces an, indem Sie die Service-Registrierung bearbeiten.
Hier ist zum Beispiel eine Serviceanfrage, die einen entfernten KMZ-Datensatz verwendet:
http://<host>/fmedatadownload/Test/Viewer.fmw?opt_geturl=http://data.vancouver.ca/download/kml/elementary_school_boundaries.kmz
Antwortelemente
Wenn das Antwortformat als XML oder JSON angegeben ist, kann eine Antwort die in der folgenden Tabelle gezeigten Elemente enthalten.
|
Element |
Kind-Elemente |
Wert |
Beschreibung |
|---|---|---|---|
|
statusInfo |
message |
message string |
service failure message |
|
status |
success | failure |
Dienststatus |
|
|
mode |
sync | async |
Dienstmodus |
|
|
fmeTransformationResult |
fmeServerResponse |
FME Flow-Antworteigenschaft |
FME Flow-Antwort |
|
fmeEngineResponse |
FME Engine response properties |
FME Engine Antwort |
|
|
|
none |
Email addresses |
E-Mail-Adressen der Antragsteller |
|
url |
none |
URL string |
URL zum Herunterladen des Ergebnisdatensatzes (ZIP) |
|
jobID |
none |
job ID |
Die aktuelle Jobkennung |
Aktivieren von E-Mail-Benachrichtigungen
Der Data Download Service kann E-Mail-Nachrichten senden, um Sie zu benachrichtigen, wenn ein Job erfolgreich oder nicht erfolgreich abgeschlossen wurde. Wenn ein Job erfolgreich abgeschlossen wurde, enthält die E-Mail einen anklickbaren Link oder eine zip-Datei zum Herunterladen der Daten.
Weitere Informationen finden Sie unter Konfigurieren von FME Flow zum Senden von E-Mail-Benachrichtigungen.