Daten-Upload-Dienst

Sie können Quelldaten oder andere dateibasierte Ressourcen hochladen fürFME FlowworkspaceS.

ImFME FlowWeb-Benutzeroberfläche, Datei-Upload ist für alle verfügbarworkspace mit einem veröffentlichten Parameter, der eine Datei darstellt, die vomworkspace. Weitere Informationen finden Sie unterHochladen von Datendateien.

NotizBeim Arbeiten mit ZIP-Dateien empfehlen wir die Verwendung moderner ZIP-Dienstprogramme, die Unicode-Dateinamen unterstützen. Wenn die Dateinamen nicht in Unicode vorliegen, können Sie die DEFAULT_ZIP_CODEPAGE angebenWebanwendungseigenschaft.

Sobald die Daten hochgeladen sind, können Benutzer die hochgeladenen Daten für dieworkspace zu verwenden.

Haltbarkeit hochgeladener Dateien

Standardmäßig werden Dateien einen Tag nach dem Hochladen gelöscht. Um dies zu ändern, aktualisieren Sie die Aufgabe „Delete_DataUpload_Files“ auf der Seite „Systembereinigung“ der Web-Benutzeroberfläche. Weitere Informationen finden Sie unterAufräumenFME Flow Protokolle und andere Dateien.

Anforderungselemente

Unterstützte Anforderungsmethoden

Für die Interaktion mit dem Datenuploaddienst stehen die folgenden Methoden zur Verfügung. Die unterstützten Methoden zum Senden von Dateien sind PUT und POST. Zum Durchsuchen bereits hochgeladener Dateien wird die HTTP-GET-Methode unterstützt.

Es wird nur flüchtiger Speicher unterstützt und alle Anfragen müssen mit einemFME Flowworkspace.

Anfrage	Anforderungsbeschreibung	HTTP-Methode	Ziel-URI
Hochladen einer einzelnen Datei	Laden Sie eine Datei mit der HTTP-PUT-Methode hoch.	SETZEN	http://host[:port]/fmedataupload/<Repository>/<Arbeitsbereich>/<Dateiname>
Laden Sie eine einzelne Datei oder mehrere Dateien hoch	Laden Sie eine einzelne Datei oder mehrere Dateien mithilfe einer einfachen Formularübermittlung hoch, die HTTP POST verwendet.	POST	http://host[:port]/fmedataupload/<Repository>/<Arbeitsbereich>
Hochgeladene Dateien durchsuchen	Rufen Sie eine Liste aller hochgeladenen Dateien für eine Sitzung ab, indem Sie eine GET-Anfrage stellen, entweder an dieselbe URI, die ursprünglich zum Hochladen der Dateien verwendet wurde, oder, im Fall von Archiven, indem Sie eine Archivdatei und/oder einen Dateipfad innerhalb des Archivs anhängen, um eine Auflistung der dort vorhandenen Dateien zu erhalten. Verwenden Sie die optionale Pfadkomponente am Ende, um den Inhalt eines Unterordners innerhalb einer Archivdatei anzuzeigen. Um nur den Stamminhalt der Archivdatei zu melden, lassen Sie den optionalen Pfad weg.	ERHALTEN	http://host[:port]/fmedataupload/<Repository>/<Arbeitsbereich>/<Archivdateiname>/[<Dateiname oder Pfad im Archiv>]

Anfrage

Anforderungsbeschreibung

HTTP-Methode

Ziel-URI

Hochladen einer einzelnen Datei

Laden Sie eine Datei mit der HTTP-PUT-Methode hoch.

SETZEN

http://host[:port]/fmedataupload/<Repository>/<Arbeitsbereich>/<Dateiname>

Laden Sie eine einzelne Datei oder mehrere Dateien hoch

Laden Sie eine einzelne Datei oder mehrere Dateien mithilfe einer einfachen Formularübermittlung hoch, die HTTP POST verwendet.

POST

http://host[:port]/fmedataupload/<Repository>/<Arbeitsbereich>

Hochgeladene Dateien durchsuchen

Rufen Sie eine Liste aller hochgeladenen Dateien für eine Sitzung ab, indem Sie eine GET-Anfrage stellen, entweder an dieselbe URI, die ursprünglich zum Hochladen der Dateien verwendet wurde, oder, im Fall von Archiven, indem Sie eine Archivdatei und/oder einen Dateipfad innerhalb des Archivs anhängen, um eine Auflistung der dort vorhandenen Dateien zu erhalten.

Verwenden Sie die optionale Pfadkomponente am Ende, um den Inhalt eines Unterordners innerhalb einer Archivdatei anzuzeigen. Um nur den Stamminhalt der Archivdatei zu melden, lassen Sie den optionalen Pfad weg.

ERHALTEN

http://host[:port]/fmedataupload/<Repository>/<Arbeitsbereich>/<Archivdateiname>/[<Dateiname oder Pfad im Archiv>]

Anforderungsparameter

Name	Wert	Beschreibung
opt_vollständigerPfad	wahr \| falsch Standard: false	Wenn aktiviert, enthält die Serviceantwort den physischen oder absoluten Pfad für jede Datei, die die FME-Engine verwenden kann.
opt_namespace	<Wert>	Wenn angegeben, werden Uploads in einem Ordner mit dem Namen <Wert>. Wenn nicht angegeben, werden Uploads in einem Ordner abgelegt, der nach dem Namen des Uploaders benannt ist.Benutzer. NotizWenn eine Anwendung eine einzelneZeichen verbinden mitFME Flowempfehlen wir die Angabe einer Sitzungskennung, einer Zufallszahl oder einer GUID, um einzelne Uploads zu unterscheiden und zu verhindern, dass mehrere Benutzer Dateien mit widersprüchlichen Dateinamen in dasselbe Repository hochladen/workspace Standort.
opt_extractarchive Dieser Parameter ist in HTTP GET nicht verfügbar, da das Extrahieren von Archiven ein Vorgang und kein Statusflag ist.	wahr \| falsch Standard: false	Wenn aktiviert, extrahiert der Dienst hochgeladene ZIP-Dateien und gibt den Dateiinhalt innerhalb der 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 der Wert falsch ist und der angeforderte Pfad den Inhalt einer ZIP- oder Archivdatei überprüft, wird eine Fehlerantwort ausgegeben. Wenn „false“ und der angeforderte Pfad gültig ist, opt_pathlevel jedoch 2 oder höher ist, wird eine Pfadebene von 1 impliziert.
opt_responseformat	XML \| JSON Standard: xml	Definiert die Sprache der Antwort. Der Text muss vollständig in Kleinbuchstaben geschrieben sein.
opt_pathlevel	-1 \| 0 \| n Standardwert: 1	Gibt an, wie viele Rekursionsebenen tief sind, um Datei- und Ordnerinformationen anzuzeigen. Ein Wert von -1 gibt eine vollständige, möglichst tiefe Rekursion an. Ein Wert von 0 bedeutet, dass überhaupt keine Informationen zurückgegeben werden. Jede andere positive Zahl gibt die Anzahl der Rekursionsebenen an. Beispielsweise fordert ein Wert von 1 nur die Dateien im angeforderten Pfad an, also nur untergeordnete Elemente des angeforderten Pfads und keine Nachkommen.

Antwortelemente

Element	Untergeordnete Elemente	Wert	Beschreibung
Statusinfo	Status	Erfolg \| Misserfolg	Der Dienststatus.
Datei, Ordner, Archiv	Name	Schnur	Der Name der hochgeladenen Datei.
	Größe	lange Ganzzahl	Die Größe der hochgeladenen Datei in Bytes. Das Größenelement gilt nicht für Ordner und fehlt unter Ordnerelementen.
	Weg	Schnur	Der absolute oder physische Pfad der Datei (der von einer FME-Engine verwendet wird).
Sitzung	keiner	Schnur	Eine Sitzungskennung, die immer im Hauptteil der Antwort enthalten ist. Der Wert ist der Wert des Anforderungsparameters opt_namespace, sofern angegeben, oder der Name des hochladenden Benutzers.