数据上传服务
您可以为FME Server工作区上传源数据或其他基于文件的资源。
在FME服务器中Web用户界面,文件上传可用于任何带有已发布参数的工作空间,该参数表示该工作空间所使用的文件。有关更多信息,请参见上传数据文件.
注意:在处理.zip文件时,我们建议使用支持Unicode文件名的现代zip实用程序。如果文件名不是Unicode格式,可以指定DEFAULT_ZIP_CODEPAGEweb应用程序属性.
上传数据之后,用户可以选择上传的数据供工作区使用。
上传文件的保质期
默认情况下,文件在上传后一天被删除。如需更改,请在Web用户界面的“系统清理”页面更新任务“Delete_DataUpload_Files”。有关更多信息,请参见清理FME服务器日志和其他文件.
请求元素
支持请求方法
以下方法可用于与Data Upload服务交互。发送文件所支持的方法是PUT和POST。对于已经上传的文件,支持HTTP GET方法。
只支持易失性存储,并且所有请求必须与FME服务器工作区关联。
请求 |
请求描述 |
HTTP方法 |
目标URI |
---|---|---|---|
上传单个文件 |
使用HTTP PUT方式上传文件。 |
把 |
http://host[:港口]/ fmedataupload / <库> / <工作区> / <文件名> |
上传单个文件或多个文件 |
使用使用HTTP POST的简单表单提交上传单个文件或多个文件。 |
帖子 |
http://host[:港口]/ fmedataupload / <库> / <工作区> |
浏览上传的文件 |
通过发出一个Get请求,获得一个会话中所有上传文件的列表,可以是最初用于上传文件的同一个URI,或者(对于存档来说),在此基础上附加存档文件和/或存档文件中的文件路径,以获得文件列表。 在结尾处使用可选的path组件来显示存档文件中子文件夹的内容。为了只报告存档文件的根目录,省略可选路径。 |
得到 |
http://host[:port]/fmedataupload/ |
请求参数
的名字 |
价值 |
描述 |
---|---|---|
opt_fullpath |
真|假 |
当启用时,服务响应包括FME引擎可以使用的每个文件的物理或绝对路径。 |
opt_namespace | <价值> | 如果指定,上传文件将被放在名为<的文件夹中。价值>。如果未指定,则将上传文件放在以上传文件名称命名的文件夹中用户. 注意:如果应用程序使用单个令牌为了连接到FME服务器,我们建议指定一个会话标识符、随机数或GUID来区分不同的上传,并防止多个用户将文件名冲突的文件上传到相同的存储库/工作区位置。 |
opt_extractarchive 此参数在HTTP GET中不可用,因为提取存档是一种操作,而不是状态标志。 |
真|假 |
启用时,该服务提取上传的zip文件并返回zip文件中的文件内容。 如果为false,并且请求的路径检查zip或归档文件的内容,则会产生错误响应。 如果为false,并且请求的路径有效,但是opt_pathlevel为2或更高,则路径级别为1。 |
opt_responseformat |
xml | json |
定义响应的语言。文本必须全部为小写。 |
opt_pathlevel |
-1 | 0 | n |
指定显示文件和文件夹信息的递归深度的级别。 |
响应的元素
元素 |
子元素 |
价值 |
描述 |
---|---|---|---|
statusInfo |
状态 |
成功|失败 |
服务状态。 |
文件、文件夹存档 |
的名字 |
字符串 |
上传的文件的名称。 |
大小 |
长整数 |
上传文件的大小(以字节为单位)。size元素不适用于文件夹,并且在文件夹元素下面没有。 |
|
路径 |
字符串 |
文件的绝对路径或物理路径(由FME引擎使用)。 |
|
会话 |
没有一个 |
字符串 |
一个会话标识符,它总是作为HTTP cookie包含在每个数据上传响应中,也包含在响应体中。如果指定,该值为opt_namespace请求参数的值,或者上传用户的名称。 |