<< Click to Display Table of Contents >> 作业 |
❖作业执行
支持的版本: 7.1.4及以后。
当浏览器访问URL:http://ip:port/bi/Viewer?proc=9&action=runJob&req=800&isAjax=true&fromClient=true&jobPath=job1¶m_deptno=10 并且传递正确的参数时,将会运行指定的作业,本接口并不等待计划任务运行完成,而是提交过运行请求之后直接返回。
返回结果:
•成功
{
"status": "success",
"msg": "Job '测试计划任务' has been run"
}
•失败
{
"status": "failure",
"msg": "错误信息"
}
返回结果截图,如下所示:
、
➢注意
1. 7.1.4,7.1.5以及7.5版本发生部分错误时返回二进制数据。
2.不支持调用url给发送邮件和同步数据类型的作业传参。
参数(下表中的参数为可变参数,url中的其它参数均为固定值):
参数名 |
类型 |
是否必须 |
描述 |
---|---|---|---|
jobPath |
字符串 |
必须 |
作业的完整路径。比如"job1" |
param 开头的参数 |
|
|
对于http请求中以param_开头的参数将作为运行参数传递给计划任务。 比如计划任务中有一个参数“deptno”,那么可以通过这种方式传递参数: param_deptno=10 多值参数使用英文逗号","分割。 |
❖获取作业状态
支持的版本: 7.1.4及以后。
当浏览器访问URL:http://ip:port/bi/Viewer?proc=9&action=getNode&req=800&isAjax=true&fromClient=true&jobPath=job1¶m_deptno=10 并且传递正确的参数时,将会返回指定作业的运行状态。
返回结果:
[
{
"status": "success", "fireTime": "2017-09-29 12:05:37",
"path": "测试计划任务"
}
]
status为计划任务的运行状态,fireTime为上次启动时间。
status可能的值见下表:
状态 |
描述 |
---|---|
toRun |
待运行状态. 即已经提交了运行请求, 正在初始化计划任务。 |
running |
正在运行 |
cancelled |
计划任务被取消 |
failure |
计划任务运行失败 |
success |
计划任务运行成功 |
返回结果截图,如下所示:
参数(下表中的参数为可变参数,url中的其它参数均为固定值):
参数名 |
类型 |
是否必须 |
描述 |
---|---|---|---|
jobPath |
字符串 |
必须 |
作业的完整路径。比如"job1" |
❖取消作业执行
支持的版本: 7.1.4及以后。
当浏览器访问URL:http://ip:port/bi/Viewer?proc=9&action=stopJob&req=800&isAjax=true&fromClient=true&jobPath=job1 并且传递正确的参数时,将会取消正在运行的指定作业。
返回结果:
•成功:
[
{
"status": "Success to stop",
"path": "测试计划任务"
}
]
•失败
[
{
"status": " Failure to stop",
"path": "测试计划任务"
}
]
•取消没有运行的作业
[]
返回结果截图,如下所示:
参数(下表中的参数为可变参数,url中的其它参数均为固定值):
参数名 |
类型 |
是否必须 |
描述 |
---|---|---|---|
jobPath |
字符串 |
必须 |
作业的完整路径。比如"job1" |