同步审批信息
访问路径:数据功能 -> 企业微信 -> 同步审批信息
功能简述
基于企微接口,同步特定审批流程中用户提交的申请记录和附件,如果记录中含明细表模式,则系统会自动将明细表结构合并到主记录中,并拆分成多行记录。
配置参数
可以配置获取汇报信息的条件信息。
- 企微应用:具有访问审批记录权限的自建企微应用
- 审批模版ID:通过管理后台获取的审批模版ID,用于唯一识别当前审批模版
- 开始/截止日期:支持自定义变量的审批提交时间段
- 提交人/部门ID:用于获取特定人员或部门的提交记录
- 审批状态:区分审批记录的状态信息
- 附件存储目标:提供用于附件存储的地址,如AWS S3、共享目录等
- 目标子目录:存储目标中创建的子目录,用于存储具体附件文件
参数匹配
系统提取的审批内容,会以审批表单中的栏位名称来定义,所以需要在接收数据的工作表中应建立对应的字段类别(含审批表单中的系统字段信息)
为了防止和用户定义的表单名称冲突,特将表单中特定的系统栏位名称作了调整,按下述表格可以获取对应的审批表单相关的系统字段信息。
-
系统栏位
系统栏位名称 类型 来源字段名 备注 模版ID 文本 template_id
模版名称 文本 sp_name
审批编号 文本 sp_no
审批状态 数值 sp_status
数值型描述,参考下文备注 审批状态 文本 sp_status_str
文本解释,参考下文备注 申请提交时间 日期 apply_time_str
单据提交时间,yyyy-MM-dd HH:mm:ss 申请更新时间 日期 apply_endtime_str
如果审批结束,即为审批结束时间 申请人Id 文本 appyer_id
申请人部门Id 文本 apply_party_id
审批流程信息 JSON sp_record
含所有审批环节 抄送信息 JSON notifyer
含抄送人信息 备注信息 JSON comments
-
特殊栏位
企微中有部分特殊类型的栏位,不能单纯通过表单中的栏位名称(用户定义名)获取结果,使用时需要按下述匹配模式提取数据。
栏位类型 类型 来源字段名 备注 单选按钮 文本 用户定义名 获取默认语种选项值 多选按钮 文本数组 用户定义名 使用 分号;
连接选中的多个选项值部门 new
文本数组 用户定义名 使用 分号
拼接ID成员 new
文本数组 用户定义名 使用 分号
拼接ID时长 时间 用户定义名-new_begin 开始时间(yyyy-MM-dd HH:mm:ss) 时长 时间 用户定义名-new_end 截止时间(yyyy-MM-dd HH:mm:ss) 时长 数值 用户定义名-days 间隔天数 时长 数值 用户定义名-hours 间隔时数 时长 文本 用户定义名-type 间隔类型(halfday-日期;hour-日期+时间) 定位/居住地 数值 用户定义名-latitude 纬度,精确到6位小数,30.547239 定位/居住地 数值 用户定义名-longitude 经度,精确到6位小数,104.063291 定位/居住地 文本 用户定义名-title 腾讯科技(成都)有限公司 定位/居住地 文本 用户定义名-address 四川省成都市武侯区天府三街198号腾讯成都大厦A座 收款账户 new
文本 用户定义名-account_type 账户类型 1:对公账户 2:个人账户 收款账户 new
文本 用户定义名-account_name 账户名 收款账户 new
文本 用户定义名-account_number 账号 收款账户 new
文本 用户定义名-bank_alias 银行名称 收款账户 new
文本 用户定义名-bank_branch_name 银行支行 收款账户 new
文本 用户定义名-remark 备注 明细 子列表 用户定义名-子组件用户定义名 注:
- 审批状态:1 审批中/Processing, 2 已通过/Approved, 3 已驳回/Rejected, 4 已撤销/Cancelled, 6 通过后撤销/CancelledAfterPast, 7 已删除/Deleted, 10 已支付/Paied
- 时长:该组件会被拆分成5个提取字段,分别对应开始、截止、间隔天数、间隔时数和间隔类别信息。按上述表单中的提取字段名获取对应的值
- 定位/居住地:该组件结果会被拆分成4个提取字段,分别对应地理位置的不同信息,可以按需匹配
- 明细:明细组件属于容器组件,内部可以创建多个子组件,访问时通过拼接明细组件用户定义名和子组件名来获得特定子记录的值。因为明细组件支持用户创建多条明细记录,所以在获取特定单号时,如果该表单含明细控件,且用户创建了多条子记录,那最终获取的将是多条类似记录集合。具体条数由明细控件中包含的最大记录数决定。如果一个表单中,含多个明细控件,一个表单中,用户在多个明细控件中提交的子记录集合数不一定的话,那么最终返回的将以最大子记录数的数字为准。
各个明细组件间的子记录相互间没有对应关系
-
子表整合案例
案例中,用户提交了
一笔单据
,但是因为单据中含有2个明细控件
:订单子表和货运子表。用户提交了2笔订单子记录,3笔货运子记录。按子表最大记录数
,共创建了3笔记录。这3笔记录中除了2个明细控件的栏位外,其他栏位内容均相同。对应2个单据的各条记录相互间没有对应的关联关系的。