数据上传服务

您可以为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文件中的文件内容。
在本例中,文件名是相对于zip文件容器的逻辑路径。
例如,名为roads的SHAPE文件。在roads.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引擎使用)。

会话

没有一个

字符串

总是包含在响应正文中的会话标识符。该值是opt_namespace请求参数的值(如果指定的话),或者上传用户的名称。