数据上传服务
您可以为FME Server工作区上传源数据或其他基于文件的资源。
在FME服务器Web用户界面,文件上传可用于任何带有已发布参数的工作空间,该参数表示工作空间使用的文件。有关更多信息,请参见上传数据文件.
注意:当使用.zip文件时,我们建议使用支持Unicode文件名的现代zip实用程序。如果文件名不是Unicode格式,可以指定DEFAULT_ZIP_CODEPAGEweb应用程序属性.
上传数据之后,用户可以选择工作区要使用的上传数据。
上传文件的保质期
默认情况下,文件上传一天后会被删除。若要更改,请在Web用户界面的“系统清理”页面上更新任务Delete_DataUpload_Files。有关更多信息,请参见清理FME服务器日志和其他文件.
请求元素
支持请求方法
以下方法可用于与Data Upload服务进行交互。支持发送文件的方法是PUT和POST。HTTP GET方法支持浏览已经上传的文件。
只支持易失性存储,并且所有请求必须与FME Server工作区相关联。
请求 |
请求描述 |
HTTP方法 |
目标URI |
---|---|---|---|
上传单个文件 |
使用HTTP PUT方式上传文件。 |
把 |
http://host[:港口]/ fmedataupload / <库> / <工作区> / <文件名> |
上传单个文件或多个文件 |
使用使用HTTP POST的简单表单提交上传单个文件或多个文件。 |
帖子 |
http://host[:港口]/ fmedataupload / <库> / <工作区> |
浏览上传的文件 |
通过向用于上传文件的相同URI发出Get请求,获得会话中所有上传文件的列表;如果是归档文件,则在此基础上追加一个归档文件和/或归档文件中的文件路径,以获取文件列表。 使用可选的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引擎使用)。 |
|
会话 |
没有一个 |
字符串 |
总是包含在响应正文中的会话标识符。该值是opt_namespace请求参数的值(如果指定的话),或者上传用户的名称。 |