数据上传服务

您可以为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文件中的文件内容。
在本例中,文件名是相对于zip文件的容器的逻辑路径。
例如,一个名为roads的SHAPE文件。path .zip文件中的SHP被返回为roads.zip/roads.shp。

如果为false,并且请求的路径检查zip或归档文件的内容,则会产生错误响应。

如果为false,并且请求的路径有效,但是opt_pathlevel为2或更高,则路径级别为1。

opt_responseformat

xml | json
默认值:xml

定义响应的语言。文本必须全部为小写。

opt_pathlevel

-1 | 0 | n
默认值:1

指定显示文件和文件夹信息的递归深度的级别。
值为-1表示完全递归。
值为0表示根本不返回任何信息。
其他任何正数表示递归的级别数。例如,值1只请求被请求路径中的文件;也就是说,只有请求路径的子路径,而不是子路径。

响应的元素

元素

子元素

价值

描述

statusInfo

状态

成功|失败

服务状态。

文件、文件夹存档

的名字

字符串

上传的文件的名称。

大小

长整数

上传文件的大小(以字节为单位)。size元素不适用于文件夹,并且在文件夹元素下面没有。

路径

字符串

文件的绝对路径或物理路径(由FME引擎使用)。

会话

没有一个

字符串

一个会话标识符,它总是作为HTTP cookie包含在每个数据上传响应中,也包含在响应体中。如果指定,该值为opt_namespace请求参数的值,或者上传用户的名称。