FME Flow:2025,0

Daten-Download-Dienst

Der Datendownloaddienst stellt den Benutzern die Ausgabe einerworkspace als herunterladbare Zip-Datei. Normalerweise ermöglicht der Dienst den Benutzern, die Datenebenen, das Format und das Koordinatensystem für den Download anzugeben.

Die Anforderung dieses Dienstes erfolgt über eine URL oder ein Formular. Zum Beispiel:

http://<Host>/fmedatadownload/ <Repository> / <Arbeitsbereich>.fmw?<Parameter>

Es öffnet sich eine Webseite mit einem Link zu einer Zip-Datei mit den Ergebnissen derworkspace Übersetzung. Zusätzlich kann eine E-Mail mit einem Link zur ZIP-Datei versendet werden.

Der Download wird aus folgenden Gründen als ZIP-Datei (komprimiertes Archiv) zurückgegeben:

  • Das Ergebnis ist eine Reihe von Ausgabedatensätzen (nicht nur ein Datensatz).
  • Ordnerbasierte Datensätze bestehen nicht aus einer einzelnen Datei. Das ESRI Shape-Format verfügt beispielsweise über Dateien mit der Erweiterung .shp, .shx, .dbf und einigen anderen.
  • Sogar dateibasierte Datensätze können aus mehr als einer Datei bestehen. Beispielsweise enthält ein GML-Datensatz sowohl eine GML-Datei als auch eine XSD-Datei (XML Schema Definition).
NotizDie Zip-Datei vonworkspaces, die mehrere Datensätze in ein Fanout-Verzeichnis schreiben, besteht aus mehreren Ordnern, die die einzelnen Datensätze enthalten. Diese Ordner sind in einem einzigen Ordner enthalten, dessen Name auf dem Ziel-Fanout-Verzeichnis basiert.

FME FlowSie können auch eine Ausgabe erstellen, die nicht komprimiert ist, indem Sie denDatenstreaming Service.

DerDaten-Upload-Dienst arbeitet in Verbindung mit dem Datendownload, Datenstreaming undJob-Einreicher Dienste zum Hochladen von Dateien.

Anforderungen

Dieser Dienst funktioniert mit jedemworkspace das einzelne oder mehrere Dateien schreibt. Es sind keine veröffentlichten Parameter erforderlich. Es ist nicht möglich, einen Datendownload auf einemworkspace dessen Ziel ein Datenbankformat ist.

NotizMöglicherweise möchten Sie einige Parameter aus Ihremworkspace um die Übersetzung aus der URL oder Formularanforderung zu steuern. Beispielsweise sind zu lesende Feature-Typen, Ausgabe-Koordinatensystem und Format (generischer Writer) häufig veröffentlichte Parameter bei der Verwendung dieses Dienstes.

Servicespezifische Anforderungsparameter

Name

Wert

Beschreibung

opt_responseformat

XML | JSON
Standard: xml

Die Sprache der Antwort. Der Text muss vollständig in Kleinbuchstaben geschrieben sein.

opt_geturl Die URL zu einem Datensatz Die URL des Quelldatensatzes, der für die Transformation verwendet werden soll
opt_showresult wahr | falsch Ob die XML/JSON-Antworten das FME-Transformationsergebnis enthalten. Der Standardwert ist „true“, wenn dieser Parameter nicht vorhanden ist.
opt_servicemode synchronisieren | asynchron | planen

Schaltet zwischen dem synchronen und asynchronen Modus des Dienstes um. Wenn Jobs asynchron (async) übermittelt werden, wird die Antwort über den Erfolg oder Misserfolg der Übermittlung sofort zurückgegeben. Wenn die Einstellung auf „synchron“ (sync) eingestellt ist, wird die Antwort erst zurückgegeben, wenn der Auftrag abgeschlossen ist.

Oder plant eine Datendownloadanforderung so, dass sie zu einer angegebenen Startzeit ausgeführt wird (nur einmalig). Wenn ein Zeitplan angegeben ist, finden Sie unten weitere Parameter.

opt_requesteremail durch Kommas getrennte E-Mail-Adressen Adressen, an die die Benachrichtigungs-E-Mail-Nachrichten gesendet werden.

Melderichtlinien

Dieser Dienst unterstütztMelderichtlinien.

Planen einer Datendownloadanforderung

Verwendenopt_servicemode=Zeitplankönnen Sie eine Datendownloadanforderung so planen, dass sie einmalig zu einer angegebenen Startzeit ausgeführt wird. Folgende zusätzliche Parameter sind erforderlich:

Name Wert Beschreibung
auslösen einmal laufen Gibt an, dass die einmalige Ausführung des Auftrags geplant ist. Nureinmal laufenwird unterstützt.
Start <jjjj-MM-tt HH:mm:ss> das Datum/die Uhrzeit zur Ausführung des Auftrags. Wenn das Datum/die Uhrzeit vor der aktuellen Uhrzeit liegt, wird der Job sofort ausgeführt.
Kategorie <Kategoriename> Der Name der allgemeinen Kategorie oder Gruppe, zu der die Aufgabe gehört.
Name <Zeitplanname> Der Name der Aufgabe. Namen müssen innerhalb einer Kategorie eindeutig sein. Nachdem eine zur einmaligen Ausführung geplante Aufgabe abgeschlossen ist, wird sie automatisch entfernt.
Beschreibung <Beschreibung> Die Beschreibung der Aufgabe.

Verwenden von Remotedaten während einer Anforderung

Verwenden von Daten aus dem HTTP-POST-Text als Reader-Datensatz

Dieser Webdienst kann Daten empfangen und den Quelldatensatz über HTTP POST überschreiben. Der Inhalt des POST-Anforderungstexts wird in einer temporären Datei gespeichert, die als Reader-Datensatz desworkspace. Wenn mehr als ein Leser imworkspace, dann müssen Sie angeben, welcher Reader die temporäre Datei verwenden soll. Sie geben Ihre Wahl bei der Veröffentlichung derworkspace durch Bearbeiten der Serviceregistrierung.

Daten aus HTTP GET als Reader-Dataset verwenden

Dieser Webdienst kann Daten empfangen und den Reader-Datensatz über HTTP GET überschreiben. Der Datensatz sollte als URL angegeben und mit dem Parameter „opt_geturl“ an den Dienst übergeben werden. Es werden sowohl HTTP- als auch FTP-URLs unterstützt. Wenn mehr als ein Leser imworkspace, dann müssen Sie angeben, welcher Reader die temporäre Datei verwenden soll. Sie geben Ihre Wahl bei der Veröffentlichung derworkspace durch Bearbeiten der Serviceregistrierung.

Hier ist beispielsweise eine Serviceanfrage, die einen Remote-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 Dienstantwort die in der folgenden Tabelle gezeigten Elemente enthalten:

Element

Untergeordnete Elemente

Wert

Beschreibung

Statusinfo

Nachricht

Nachrichtenzeichenfolge

Dienstfehlermeldung

Status

Erfolg | Misserfolg

Dienststatus

Modus

synchron | asynchron

Servicemodus

fmeTransformationsergebnis

fmeServerResponse

FME FlowAntworteigenschaften

FME FlowAntwort

fmeEngineResponse

Antworteigenschaften der FME Engine

FME Engine-Antwort

E-Mail

keiner

E-Mail-Adressen

E-Mail-Adressen der Antragsteller

URL

keiner

URL-Zeichenfolge

URL zum Herunterladen des Ergebnisdatensatzes (ZIP)

Job-ID

keiner

Auftrags-ID

Die aktuelle Jobkennung

Aktivieren von E-Mail-Benachrichtigungen

Der Datendownloaddienst kann Ihnen E-Mail-Nachrichten senden, um Sie zu benachrichtigen, wenn ein Auftrag erfolgreich oder nicht erfolgreich abgeschlossen wurde. Wenn ein Auftrag erfolgreich abgeschlossen wurde, enthält die E-Mail einen anklickbaren Link oder eine ZIP-Datei zum Herunterladen der Daten.

Weitere Informationen finden Sie unterKonfigurierenFME Flow zum Senden von E-Mail-Benachrichtigungen.

Siehe auch