• 所有文件

    数据下载服务

    Data Download Service将工作空间的输出作为可下载的zip文件提供给用户。通常，该服务允许用户指定下载的数据层、格式和坐标系统。

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

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

    打开一个网页，其中包含一个zip文件的链接，该文件包含工作空间转换的结果。此外，电子邮件可以发送一个zip文件的链接。

    下载文件以zip(压缩存档)文件的形式返回，原因如下:

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

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

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

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

    需求

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

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

    具体服务请求参数

    的名字

    价值

    描述

    opt_responseformat

    xml | json
    默认值:xml

    反应的语言。文本必须全部为小写。
    opt_geturl 数据集的URL 要用于转换的源数据集的URL
    opt_showresult 真|假 XML/JSON响应是否包含FME转换结果。如果不存在该参数，则默认为true。
    opt_servicemode Sync | async | schedule

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

    或者，安排数据下载请求在指定的开始时间运行(仅一次)。如果指定了schedule，请参阅下面的附加参数。
    opt_requesteremail 逗号分隔的电子邮件地址 通知电子邮件发送到的地址。

    通知指令

    该服务支持通知指令．

    关闭例子

    指定notificationservice主题，分别在作业成功或失败时通知。

    http://localhost/fmedatadownload/Samples/austinApartments.fmw?&nm_jobsuccess_topic=DATADOWNLOAD_ASYNC_JOB_SUCCESS&nm_jobfailure_topic=DATADOWNLOAD_ASYNC_JOB_FAILURE

    调度数据下载请求

    使用opt_servicemode =时间表，您可以安排数据下载请求在指定的开始时间运行一次。需要增加以下参数:

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

    在请求期间使用远程数据

    使用来自HTTP POST体的数据作为Reader数据集

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

    使用来自HTTP GET的数据作为Reader数据集

    这个web服务可以通过HTTP GET接收数据并覆盖Reader数据集。该数据集应该指定为一个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服务器发送邮件通知．

    另请参阅