数据下载服务
数据下载服务为用户提供从工作区的输出作为可下载的zip文件。通常,该服务允许用户指定下载的数据层,格式和坐标系。
使用URL或表单请求此服务。例如:
http://
将打开一个网页,其中包含包含工作区转换结果的zip文件的链接。此外,可以使用到ZIP文件的链接发送电子邮件。
下载返回为zip(压缩归档)文件,原因如下:
- 结果是许多输出数据集(不仅仅是一个数据集)。
- 基于文件夹的数据集不包括单个文件;例如,ESRI形式格式具有扩展名为.shpp,.shx,.dbf和其他一些文件。
- 即使是基于文件的数据集也可能包含多个文件;例如,GML数据集包括GML文件和XSD(XML模式定义)文件。
笔记:将多个数据集写入fanout目录的工作区的zip文件由多个文件夹组成,这些文件夹包含独立的数据集。这些文件夹包含在一个文件夹中,该文件夹的名称基于目标扇出目录。
FME服务器还可以提供使用的输出不使用ZFIPPED数据流服务。
这数据上传服务与数据下载,数据流和数据一起工作作业提交者上传文件的服务。
要求
此服务适用于任何写入单个或多个文件的工作区。不需要发布参数。在目标为数据库格式的工作区上运行数据下载是不可能的。
笔记:您可能希望从工作区发布一些参数以控制来自URL或表单请求的转换。例如,要读取,输出坐标系和格式(通用写入器)的特征类型是在使用此服务时通常发布的参数。
服务特定请求参数
名称 |
价值 |
描述 |
---|---|---|
OPT_RESPONSERFORMAT. |
XML |杰森 |
响应的语言。文本必须是所有小写的。 |
opt_geturl. | 数据集的URL | 用于转换的源数据集的URL |
opt_showresult | 真实|错误的 | XML / JSON响应是否包括FME转换结果。如果不存在此参数,则默认值为true。 |
opt_servicemode | |同步异步| schedule | 在服务的同步和异步模式之间切换。当作业是异步(异步)提交的时,立即返回提交成功或失败的响应。设置为同步(同步)时,在作业完成之前不会返回响应。 或者,安排数据下载请求在指定的开始时间运行(仅一次)。如果指定了schedule,请参阅下面的附加参数。 |
opt_requesteremail | 逗号分隔的电子邮件地址 | 发送通知电子邮件的地址。 |
通知指令
这项服务支持通知指令。
指定在作业成功或失败时要通知的通知服务主题。
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> | 运行作业的日期/时间。如果日期/时间早于当前时间,则作业立即运行。 |
类别 | <分类名称> | 任务所属的一般类别或组的名称。 |
名称 | <表的名字> | 任务的名称。名称必须在类别中唯一。在计划运行后的任务完成后,它将自动删除。 |
描述 | <描述> | 任务的描述。 |
在请求期间使用远程数据
使用HTTP Post Body的数据作为读者数据集
此Web服务可以通过HTTP POST接收数据和覆盖源数据集。Post请求主体的内容将保存到临时文件中,该文件将被用作工作空间的读取器数据集。如果工作区中有多个阅读器,那么您将需要指出哪个阅读器将使用临时文件。通过编辑服务注册,您可以在发布工作空间时表示您的选择。
使用来自HTTP GET的数据作为Reader数据集
这个web服务可以通过HTTP GET接收数据并覆盖Reader数据集。该数据集应该指定为一个URL,并通过'opt_geturl'参数传递给服务。同时支持HTTP和FTP url。如果工作区中有多个阅读器,那么您将需要指出哪个阅读器将使用临时文件。通过编辑服务注册,您可以在发布工作空间时表示您的选择。
例如,这里是使用远程KMZ数据集的服务请求:
http://
响应元素
如果响应格式指定为XML或JSON,则服务响应可能包含下表中所示的元素:
元素 |
儿童元素 |
价值 |
描述 |
---|---|---|---|
statusinfo. |
消息 |
消息字符串 |
服务失败消息 |
地位 |
成功|失败 |
服务状态 |
|
模式 |
|同步异步 |
服务模式 |
|
FmetransformationResult. |
fmeserverresponse. |
FME服务器响应属性 |
FME服务器响应 |
fmeengineResponse. |
FME引擎响应属性 |
FME发动机响应 |
|
电子邮件 |
没有任何 |
电子邮件地址 |
请求者的电子邮件地址 |
URL. |
没有任何 |
URL字符串 |
用于下载结果数据集(zip)的URL |
乔迪 |
没有任何 |
招聘ID. |
当前的作业标识符 |
启用电子邮件通知
数据下载服务可以发送电子邮件,以便在作业成功或未尝试时向您通知您。如果作业成功完成,则电子邮件提供可点击的链接或ZIP文件以下载数据。
有关更多信息,请参阅配置FME服务器发送邮件通知。
也可以看看