企业内部开发
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
企业内部开发
客户端API
JS-SDK
审批
应用发起审批
应用发起审批
最后更新:2025/04/09

目录

  • ww.thirdPartyOpenPage(params)
  • 功能描述
  • 使用限制
  • 参数说明
  • params: Object
  • 返回说明
  • 旧版jweixin调用
  • 示例代码
  • ww.thirdPartyOpenPage(params)

    兼容性:企业微信 2.5.0 开始支持

    功能描述

    在应用页面中发起审批流程。之后审批流程的每次状态变化都会通知开发者,开发者可按需进行拓展开发。具体参见审批流程引擎

    ww.thirdPartyOpenPage({
      oaType: '10001',
      templateId: '46af67a118a6ebf000002',
      thirdNo: 'thirdNo',
      extData: {
        fieldList: [
          {
            type: 'text',
            title: '采购类型',
            value: '市场活动'
          },
          {
            type: 'link',
            title: '订单链接',
            value: 'https://work.weixin.qq.com'
          }
        ]
      }
    })

    使用限制

    • 本接口必须使用应用身份进行注册

    • 应用必须具有审批权限

    参数说明

    params: Object

    属性类型必填说明
    oaTypestring

    操作类型

    合法值说明
    10001

    发起审批

    10002

    查看审批详情

    templateIdstring

    发起审批的模板 ID

    可在第三方应用-审批接口中创建模板获取

    thirdNostring

    审批单号

    由开发者自行定义,不可重复

    extDataObject

    详情数据,用于审批详情页信息展示 开发者可利用此特性,在发起审批时,传入需要申请人、审批人、抄送人看到的信息 若需用户填写数据,可在自行使用表单收集,并传入exData中,用于展示

    属性类型必填说明
    fieldListObject[]
    属性类型必填说明
    titlestring

    标题

    typestring

    字段类型

    link 类型仅在审批详情页展示

    合法值说明
    link

    链接

    text

    文本

    valuestring

    字段值

    successFunction

    成功回调

    failFunction

    失败回调

    cancelFunction

    取消回调

    completeFunction

    完成回调

    返回说明

    Promise<Object>

    属性类型必填说明
    errMsgstring

    通用错误信息

    errCodenumber

    通用错误码

    错误信息

    errMsg说明
    已存在相同的审批编号oaType为10001时,传入的thirdNo已经被其他审批单占用。
    审批申请不存在oaType为10002时,在历史记录中,传入的thirdNo对应的审批单不存在。
    审批模板ID不正确调用接口时传入了错误的templateId
    应用ID不正确使用了错误的 agentId

    旧版jweixin调用

    示例代码

    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);
    });
    上一篇下载直播回放
    下一篇审批控件中的外部选项
      本节内容
    服务端API
    基础
    连接微信
    办公
    会议
    会议统计管理
    客户端API
    小程序
    基础
    连接微信
    办公
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们