数据下载服务

数据下载服务为用户提供来自工作区的输出,作为可下载的zip文件。通常,该服务允许用户为下载指定数据层、格式和坐标系统。

此服务是使用URL或表单请求的。例如:

http://<主机>/ fmedatadownload /<库>/<工作区>.fmw吗?<参数>

打开一个web页面,其中有一个指向包含工作区转换结果的zip文件的链接。此外,还可以发送带有zip文件链接的电子邮件。

下载是作为一个zip(压缩档案)文件返回的原因如下:

  • 结果是大量的输出数据集(而不仅仅是一个数据集)。
  • 基于文件夹的数据集不包含单个文件;例如,ESRI形状格式具有扩展名为.shp、.shx、.dbf和其他一些文件。
  • 即使基于文件的数据集也可能包含多个文件;例如,一个GML数据集包括一个GML文件和一个XSD (XML模式定义)文件。

注意:将多个数据集写入扇出目录的工作区的zip文件由多个文件夹组成,这些文件夹包含单独的数据集。这些文件夹包含在一个文件夹中,该文件夹的名称基于目标扇出目录。

FME服务器还可以提供未压缩的输出数据流服务。

数据上传服务与数据下载、数据流和作业提交者上载文件的服务。

需求

此服务可用于任何写入单个或多个文件的工作区。不需要发布参数。无法在目标为数据库格式的工作区上运行数据下载。

注意:您可能希望从工作区发布一些参数,以控制来自URL或表单请求的转换。例如,在使用此服务时,要读取的特性类型、输出坐标系统和格式(通用编写器)通常是发布的参数。

特定于服务的请求参数

的名字

价值

描述

opt_responseformat

xml | json
默认值:xml

回应的语言。文本必须都是小写的。

opt_geturl 到数据集的URL 要用于转换的源数据集的URL
选择显示结果 真|假 XML/JSON响应是否包含FME转换结果。如果不存在此参数,则默认值为true。
选择服务模式 同步|异步|时间表

在服务的同步和异步模式之间切换。当异步提交作业时,立即返回提交成功或失败的响应。当设置为synchronous(同步)时,在作业完成之前不会返回响应。

或者,安排数据下载请求在指定的开始时间运行(仅限一次性)。如果指定了计划,请参阅下面的其他参数。

请求电子邮件 逗号分隔的电子邮件地址 通知电子邮件消息发送到的地址。

通知指令

该服务支持通知指令

安排数据下载请求

使用opt_servicemode=计划,您可以将数据下载请求调度为在指定的启动时间运行一次。需要下列额外参数:

的名字 价值 描述
触发 跳动 指示作业计划运行一次。只有跳动是支持的。
开始 <yyyy-MM-dd HH: mm: ss> 运行作业的日期/时间。如果日期/时间早于当前时间,则作业立即运行。
类别 <类别_name> 任务所属的一般类别或组的名称。
的名字 <计划名称> 任务的名称。在一个类别中,名称必须是唯一的。计划只运行一次的任务完成后,就会自动删除它。
描述 <描述> 任务的描述。

在请求期间使用远程数据

使用来自HTTP POST正文的数据作为读取器数据集

此web服务可以通过HTTP POST接收数据并覆盖源数据集。POST请求体的内容将被保存到一个临时文件中,该文件将用作工作区的Reader数据集。如果工作区中有多个阅读器,那么您需要指出哪个阅读器将使用临时文件。在发布工作区时,您可以通过编辑服务注册来指示您的选择。

使用来自HTTP GET的数据作为读卡器数据集

此web服务可以通过HTTP GET接收数据并覆盖读卡器数据集。数据集应指定为URL,并通过“opt_geturl”参数传递给服务。支持HTTP和FTP url。如果工作区中有多个读卡器,则需要指示哪个读卡器将使用临时文件。通过编辑服务注册,可以在发布工作区时指示您的选择。

例如,下面是一个使用远程KMZ数据集的服务请求:

http://<主机>/ fmedatadownload /测试/ Viewer.fmw ? opt_geturl = http://data.vancouver.ca/download/kml/elementary_school_boundaries.kmz

响应的元素

如果响应格式指定为XML或JSON,则服务响应可能包含下表所示的元素:

元素

子元素

价值

描述

statusInfo

消息

消息字符串

服务失败消息

状态

成功|失败

服务状态

模式

同步|异步

服务模式

fmeTransformationResult

fmeServerResponse

FME服务器响应属性

FME服务器响应

fmeEngineResponse

FME引擎响应特性

FME引擎响应

电子邮件

没有一个

电子邮件地址

请求者的电子邮件地址

url

没有一个

URL字符串

用于下载结果数据集(ZIP)的URL

jobID

没有一个

工作ID

当前作业标识符

启用电子邮件通知

数据下载服务可以发送电子邮件消息,通知您工作成功或不成功完成。如果作业成功完成,电子邮件提供可单击链接或zip文件来下载数据。

有关更多信息,请参见配置FME服务器以发送电子邮件通知

另请参阅