通过JS-SDK,可在应用页面中发起审批,之后审批流程的每次状态变化,都会通知开发者,可按需进行拓展开发,具体参见审批流程引擎
调用前提:
1.通过agentConfig注入应用的权限。查看
2.应用需具有审批权限。
注:企业微信客户端2.5.0及以上版本支持。
请求示例:
wx.invoke('thirdPartyOpenPage', {
"oaType": "10001",// String
"templateId": "46af67a118a6ebf000002",// String
"thirdNo": "thirdNo",// String
"extData": {
'fieldList': [{
'title': '采购类型',
'type': 'text',
'value': '市场活动',
},
{
'title': '订单链接',
'type': 'link',
'value': 'https://work.weixin.qq.com',
}],
}
},
function(res) {
// 输出接口的回调信息
console.log(res);
});
参数说明:
参数 | 必须 | 说明 |
---|---|---|
oaType | 是 | 操作类型,目前支持:10001-发起审批;10002-查看审批详情。 |
templateId | 是 | 发起审批的模板ID,在自建应用-审批接口中创建模板可获取。 |
thirdNo | 是 | 审批单号,由开发者自行定义,不可重复。 |
extData | 是 | 详情数据,Json格式,用于审批详情页信息展示。 |
extData数据说明:
extData在发起时由开发者传入,其中数据将全部展示在审批申请中:
1.开发者可利用此特性,在发起审批时,传入需要申请人、审批人、抄送人看到的信息;
2.若需用户填写数据,可在自行使用表单收集,并传入extData中,用于展示。
{
"extData": {
'fieldList': [
{
'title': '采购类型',
'type': 'text',
'value': '市场活动',
},
{
'title': '采购说明',
'type': 'text',
'value': '购买个人办公电脑',
},
{
'title': '采购金额',
'type': 'text',
'value': '4839.00元',
},
{
'title': '申请时间',
'type': 'text',
'value': '2018/06/20',
},
{
'title': '订单链接',
'type': 'link', // link类型,用于在审批详情页展示第三方订单跳转地址
'value': 'https://www.qq.com',
},
],
},
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
title | 否 | 字段标题,将会在审批详情页中展示。 |
type | 否 | 字段类型,目前支持:text-文本;link:链接。link仅展示在审批详情页。 |
value | 否 | 字段值,将会在审批详情页中展示。 |
错误说明:
错误提示 | 说明 |
---|---|
已存在相同的审批编号 | oaType为10001时,传入的thirdNo已经被其他审批单占用。 |
审批申请不存在 | oaType为10002时,在历史记录中,传入的thirdNo对应的审批单不存在。 |
审批模板ID不正确 | 调用接口时传入了错误的templateId |
应用ID不正确 | 使用了错误的 agentId |