数据上传服务

用户可以为FME服务器工作空间上载源数据或基于文件的基于文件。

在FME服务器Web用户界面， File Upload可用于任何带有已发布参数的工作空间，该参数表示工作空间使用的文件。有关更多信息，请参见上传数据文件．

注意:当使用.zip文件时，我们建议使用支持Unicode文件名的现代zip实用程序。如果文件名不是Unicode格式，可以指定DEFAULT_ZIP_CODEPAGEweb应用程序属性．

上传数据后，用户可以选择要使用的工作区的上传数据。上传的文件存储在可访问的私有位置，可访问FME服务器，但不是用户。

上传文件的保质期

默认情况下，上传后1天删除文件。要更改，请更新Web用户界面的系统清理页面上的任务DELETE_DATAUPLOAD_FILE。有关更多信息，请参见清理FME服务器日志和其他文件．

请求元素

支持请求方法

本节描述可用于与Data Upload服务交互的各种方法。支持发送文件的方法是PUT和POST。HTTP GET方法支持浏览已经上传的文件。

请记住，只支持易失性存储，并且所有请求必须与FME Server工作区相关联。

请求	请求描述	HTTP方法	目标URI.
上传单个文件	通过HTTP PUT方式上传文件。	把	http：// host [：port] / fmedataupload / / /
上传单个文件或多个文件	您可以使用使用HTTP帖子的简单表单提交上传单个文件或多个文件	帖子	http://host[:港口]/ fmedataupload / <库> / <工作区>
浏览上传的文件	您可以通过使GET请求为最初用于上载文件的同一URI来获取会话的所有上传的文件列表，或者在存档的情况下，请追溯到此存档文件和/或文件路径存档在那里的文件列表。 您可以使用末尾的可选路径组件来显示归档文件中子文件夹的内容。若要只报告归档文件的根内容，请忽略可选路径部分。 例如，请求URI /fMedataupload/samples/austinwfs.fmw/myfile.zip/pictures/ 显示名为myfile.zip的存档文件的图片子文件夹中包含的所有文件的清单。	得到	http://host[:port]/fmedataupload////[]

服务特定请求参数

的名字	价值	描述
opt_fullpath.	真|假 默认值：假	当启用时，服务响应包括FME引擎可以使用的每个文件的物理或绝对路径。
opt_extractarchive 此参数在HTTP GET中不可用，因为提取归档文件是一个操作而不是一个状态标志。	真|假 默认值：假	当启用时，该服务提取上传的zip文件并返回zip文件中的文件内容。 在这种情况下，文件名是相对于ZIP文件容器的逻辑路径。 例如，名为roads的SHAPE文件。在roads.zip文件中的SHP被返回为roads.zip/roads.shp。
opt_responseformat	xml | json 默认值：XML.	定义响应的语言。文本必须全部为小写。
opt_pathlevel	-1 | 0 | n 默认值：1	此参数指示深度递归次数才能显示文件和文件夹信息。 值-1的值表示完全递归，如此深。 值0表示根本不返回任何信息。 任何其他正数表示递归级别的数量。例如，值1将仅请求请求路径中的文件;也就是说，只有所请求路径的儿童而不是后代。

保存会话状态

Java EE允许您显式地指定请求URL的会话ID。此规范确保在cookies不能正常工作或不可用时为会话保留正确的会话状态。只需在请求URI的路径部分后面立即添加以下参数:

; jsessionid =

响应元素

元素	子元素	价值	描述
statusInfo	地位	成功|失败	服务状态
文件、文件夹存档	的名字	字符串	上传的文件的名称
	大小	长整数	上传文件的大小(以字节为单位)。size元素不适用于文件夹，并且在文件夹元素下不存在。
	路径	字符串	文件的绝对路径或物理路径(由FME引擎使用)
会话	没有一个	字符串	一个会话标识符，它总是作为HTTP cookie包含在每个数据上传响应中，也包含在响应的主体中。

注意:总是会有一个带有空name属性的文件夹节点。此文件夹节点是目录的占位符，该目录包含由当前用户会话、工作区名称和存储库名称定义的作用域的上载文件。这个占位符可以在以后请求完整路径时使用，以检索您范围内所有上传文件的父目录的完整路径。

如果opt_extrayAchive设置为false，则以下方案结果：

• 如果请求的路径检查了zip或归档文件的内容，则会产生一个错误响应。
• 如果请求的路径有效，但opt_pathlevel是2或更高，则暗示1的路径级别。