数据下载服务
数据下载服务将工作区的输出作为可下载的zip文件提供给用户。通常,该服务允许用户为下载指定数据层、格式和坐标系。
使用URL或表单请求此服务。例如:
http://
将打开一个网页,其中包含指向包含工作区转换结果的zip文件的链接。此外,还可以发送带有zip文件链接的电子邮件。
由于以下原因,下载以zip(压缩存档)文件的形式返回:
- 结果是许多输出数据集(而不仅仅是一个数据集)。
- 基于文件夹的数据集不包含单个文件;例如,ESRI形状格式包含扩展名为.shp、.shx、.dbf和其他一些文件。
- 即使是基于文件的数据集也可能包含多个文件;例如,GML数据集包括GML文件和XSD(XML模式定义)文件。
注:将多个数据集写入扇形目录的工作区中的zip文件由多个包含独立数据集的文件夹组成。这些文件夹包含在单个文件夹中,该文件夹的名称基于目标Fanout目录。
FME服务器还可以提供使用数据流服务。
这个数据上传服务与数据下载、数据流和作业提交者上传文件的服务。
要求
此服务适用于任何编写单个或多个文件的工作区。不需要发布的参数。在目标是数据库格式的工作区上运行数据下载是不可能的。
注:您可能希望从工作区发布一些参数,以控制URL或表单请求的转换。例如,使用此服务时,要读取的要素类型、输出坐标系和格式(通用编写器)通常是已发布的参数。
特定于服务的请求参数
名字 |
价值观 |
描述 |
---|---|---|
opt_响应格式 |
xml | json |
回答的语言。文本必须全部为小写。 |
opt_geturl | 指向数据集的URL | 要用于转换的源数据集的URL |
opt_showresult | 对|错 | XML/JSON响应是否包含FME转换结果。如果此参数不存在,则默认值为true。 |
opt_servicemode | 同步|异步|调度 | 在服务的同步和异步模式之间切换。当以异步方式提交作业时,将立即返回提交成功或失败的响应。当设置为同步(sync)时,在作业完成之前不会返回响应。 或者,安排数据下载请求在指定的开始时间运行(仅一次性)。如果指定了时间表,请参阅下面的附加参数。 |
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正文中的数据作为读卡器数据集
此web服务可以通过HTTP POST接收数据并覆盖源数据集。POST请求正文的内容将保存到一个临时文件中,该文件将用作工作区的读取器数据集。如果工作区中有多个读卡器,则需要指示哪个读卡器将使用临时文件。通过编辑服务注册,可以在发布工作区时指明您的选择。
使用HTTP GET中的数据作为Reader数据集
此web服务可以通过HTTP GET接收数据并覆盖Reader数据集。数据集应该指定为URL,并通过'opt_geturl'参数传递给服务。支持HTTP和FTP两种url。如果工作区中有多个阅读器,那么您将需要指出哪个阅读器将使用临时文件。您可以在发布工作区时通过编辑服务注册来指示您的选择。
例如,以下是使用远程KMZ数据集的服务请求:
http://
响应元素
如果响应格式指定为XML或JSON,则服务响应可能包含下表所示的元素:
元素 |
子元素 |
价值观 |
描述 |
---|---|---|---|
状态信息 |
消息 |
消息字符串 |
服务失败消息 |
地位 |
成功|失败 |
服务状态 |
|
模式 |
|同步异步 |
服务模式 |
|
fmeTransformationResult |
fmeServerResponse |
FME服务器响应属性 |
FME服务器响应 |
Fmeengine响应 |
发动机响应特性 |
发动机响应 |
|
电子邮件 |
没有人 |
电子邮件地址 |
请求者的电子邮件地址 |
网址 |
没有人 |
URL字符串 |
用于下载结果数据集(ZIP)的URL |
若比德 |
没有人 |
工作ID |
当前作业标识符 |
启用电子邮件通知
数据下载服务可以发送电子邮件,在作业成功或不成功完成时通知您。如果作业成功完成,电子邮件将提供一个可单击的链接或zip文件来下载数据。
有关详细信息,请参阅配置FME服务器以发送电子邮件通知.
另见