Data Upload Service

Sie können Quelldaten oder andere dateibasierte Ressourcen für FME Flow-Workspaces hochladen.

In der FME Flow-Web-Benutzeroberfläche ist der Datei-Upload für jeden Workspace mit einem offengelegten Parameter verfügbar, der eine vom Workspace verwendete Datei repräsentiert. Für weitere Informationen, siehe Hochladen von Daten-Dateien.

Hinweis Bei der Arbeit mit zip-Dateien wird die Verwendung moderner zip-Dienstprogramme, die Unicode-Dateinamen unterstützen, empfohlen. Wenn Dateinamen nicht in Unicode vorliegen, können Sie die Webanwendungs-Eigenschaft DEFAULT_ZIP_CODEPAGE angeben.

Nachdem die Daten hochgeladen wurden, können Benutzer die hochgeladenen Daten für den zu verwendenden Workspace auswählen.

Haltbarkeit der hochgeladenen Dateien

Standardmäßig werden Dateien einen Tag nach dem Hochladen gelöscht. Um dies zu ändern, aktualisieren Sie auf der Seite "Systembereinigung" der Web-Benutzeroberfläche den Auftrag "Delete_DataUpload_Files". Weitere Informationen finden Sie unter Bereinigen von FME Flow-Protokolldateien und anderen Dateien.

Anfrageelemente

Unterstützte Anfragemethoden

Die folgenden Methoden stehen für die Interaktion mit dem Data Upload Service zur Verfügung. Die zum Senden von Dateien unterstützten Methoden sind PUT und POST. Die HTTP GET-Methode wird für das Durchsuchen von Dateien unterstützt, die bereits hochgeladen wurden.

Es wird nur flüchtiger Speicher unterstützt, und alle Anfragen müssen einem FME Flow-Workspace zugeordnet sein.

Anfrage	Anfrage-Beschreibung	HTTP-Methode	Ziel-URI
Hochladen einer einzelnen Datei	Hochladen einer Datei mit der HTTP-Methode PUT.	PUT	http://host[:port]/fmedataupload/<repository>/<workspace>/<filename>
Hochladen einer einzelnen Datei oder mehrerer Dateien	Hochladen einer einzelnen oder mehrerer Dateien mit einer einfachen Formularübermittlung, die HTTP POST verwendet	POST	http://host[:port]/fmedataupload/<repository>/<workspace>
Durchsuchen hochgeladener Dateien	Holen Sie sich eine Liste aller hochgeladenen Dateien für eine Sitzung, indem Sie eine GET-Anfrage stellen, entweder an die gleiche URI, mit der die Dateien ursprünglich hochgeladen wurden, oder, im Falle von Archiven, an diese eine Archivdatei und/oder einen Dateipfad innerhalb des Archivs anhängen, um eine Liste der Dateien dort zu erhalten. Verwenden Sie die optionale Pfadkomponente am Ende, um den Inhalt eines Unterordners in einer Archivdatei anzuzeigen. Lassen Sie den optionalen Pfad aus, um nur den Stamminhalt der Archivdatei zu melden.	GET	http://host[:port]/fmedataupload/<repository>/<workspace>/<archive file name>/[<filename or path within archive>]

Anfrage

Anfrage-Beschreibung

HTTP-Methode

Ziel-URI

Hochladen einer einzelnen Datei

Hochladen einer Datei mit der HTTP-Methode PUT.

PUT

http://host[:port]/fmedataupload/<repository>/<workspace>/<filename>

Hochladen einer einzelnen Datei oder mehrerer Dateien

Hochladen einer einzelnen oder mehrerer Dateien mit einer einfachen Formularübermittlung, die HTTP POST verwendet

POST

http://host[:port]/fmedataupload/<repository>/<workspace>

Durchsuchen hochgeladener Dateien

Holen Sie sich eine Liste aller hochgeladenen Dateien für eine Sitzung, indem Sie eine GET-Anfrage stellen, entweder an die gleiche URI, mit der die Dateien ursprünglich hochgeladen wurden, oder, im Falle von Archiven, an diese eine Archivdatei und/oder einen Dateipfad innerhalb des Archivs anhängen, um eine Liste der Dateien dort zu erhalten.

Verwenden Sie die optionale Pfadkomponente am Ende, um den Inhalt eines Unterordners in einer Archivdatei anzuzeigen. Lassen Sie den optionalen Pfad aus, um nur den Stamminhalt der Archivdatei zu melden.

GET

http://host[:port]/fmedataupload/<repository>/<workspace>/<archive file name>/[<filename or path within archive>]

Anfrageparameter

Name	Wert	Beschreibung
opt_fullpath	true \| false Default: false	Wenn aktiviert, enthält die Dienstantwort den physischen oder absoluten Pfad für jede Datei, die die FME Engine verwenden kann.
opt_namespace	<value>	Wenn angegeben, werden Uploads in einem Ordner namens <value> abgelegt. Wenn nicht angegeben, werden Uploads in einem Ordner abgelegt, der nach dem Namen des hochladenden Benutzers benannt ist. Hinweis Wenn eine Anwendung einen einzelnen Token verwendet, um eine Verbindung zu FME Flow herzustellen, empfehlen wir die Angabe einer Sitzungskennung, einer Zufallszahl oder einer GUID, um die einzelnen Uploads zu unterscheiden und zu verhindern, dass mehrere Benutzer Dateien mit widersprüchlichen Dateinamen an den gleichen Speicherort des Repositorys / Workspaces hochladen.
opt_extractarchive Dieser Parameter ist in HTTP GET nicht verfügbar, da das Extrahieren von Archiven eine Operation und kein Status-Flag ist.	true \| false Default: false	Bei Aktivierung extrahiert der Dienst die hochgeladenen zip-Dateien und gibt den Dateiinhalt in den zip-Dateien zurück. In diesem Fall sind die Dateinamen logische Pfade relativ zum Container der zip-Dateien. Beispielsweise wird eine SHAPE-Datei mit dem Namen roads.shp innerhalb einer roads.zip-Datei als roads.zip/roads.shp zurückgegeben. Wenn "false" gesetzt ist und der angeforderte Pfad den Inhalt einer zip- oder Archivdatei überprüft, wird eine Fehlerantwort ausgegeben. Wenn "false" gesetzt ist und der angeforderte Pfad gültig ist, aber opt_pathlevel 2 oder höher ist, wird eine Pfadebene von 1 impliziert.
opt_responseformat	xml \| json Default: xml	Definiert die Sprache der Antwort. Der Text muss aus Kleinbuchstaben bestehen.
opt_pathlevel	-1 \| 0 \| n Default: 1	Gibt die Tiefe der Rekursionsebenen an, um Datei- und Ordnerinformationen anzuzeigen. Ein Wert von -1 gibt die vollständige Rekursion so tief wie möglich an. Ein Wert von 0 bedeutet, dass keine Informationen zurückgegeben werden. Jede andere positive Zahl gibt die Anzahl der Rekursionsebenen an. Ein Wert von 1 fordert beispielsweise nur die Dateien im abgefragten Pfad an, d.h. nur Kinder des abgefragten Pfades und keine Nachkommen.

Antwortelemente

Element	Kind-Elemente	Wert	Beschreibung
statusInfo	status	success \| failure	Dienststatus
file, folder, archive	name	string	Der Name der Datei, die hochgeladen wurde.
	size	long integer	Die Größe der hochgeladenen Datei in Byte. Das Größenelement gilt nicht für Ordner und fehlt unter den Ordnerelementen.
	path	string	Der absolute oder physische Pfad der Datei (der von einer FME Engine verwendet wird).
session	none	string	Eine Sitzungskennung, die immer im Body der Antwort enthalten ist. Der Wert des Anfrageparameters opt_namespace (falls angegeben) oder der Name des hochladenden Benutzers.