Skip to main content

同步汇报信息

访问路径:数据功能 -> 企业微信 -> 同步汇报信息

功能简述

基于企微接口,同步特定汇报表单中用户提交的数据记录和附件,如果记录中含明细表模式,则系统会自动将明细表结构合并到主记录中,并拆分成多行记录。

Journal

配置参数

可以配置获取汇报信息的条件信息。

  • 企微应用:具有访问汇报应用记录权限的自建企微应用
  • 日报模版ID:通过管理后台获取的汇报模版ID,用于唯一识别当前汇报模版
  • 开始/截止日期:支持自定义变量的汇报提交时间段
  • 提交人/部门ID:用于获取特定人员或部门的提交记录
  • 附件存储目标:提供用于附件存储的地址,如AWS S3、共享目录等
  • 目标子目录:存储目标中创建的子目录,用于存储具体附件文件

参数匹配

系统提取的汇报内容,会以汇报表单中的栏位名称来定义,所以需要在接收数据的工作表中建立对应的字段类别(含汇报表单中的系统字段信息)

Mapping

为了防止和用户定义的表单名称冲突,特将表单中特定的系统栏位名称作了调整,按下述表格可以获取对应的汇报表单系统字段的信息。

  1. 系统栏位

    系统栏位名称类型来源字段名备注
    模版名称文本template_name
    汇报编号文本journal_uuid
    汇报时间日期report_time_stryyyy-MM-dd HH:mm:ss
    汇报人文本submitter_id
    汇报人部门文本需要用户根据userId来匹配
    汇报对象new文本receivers使用分号拼接ID
    评论JSONcomments
  2. 特殊栏位

    企微中有部分特殊类型的栏位,不能单纯通过表单中的栏位名称(用户定义名)获取结果,使用时需要按下述匹配模式提取数据。

    栏位类型类型来源字段名备注
    单选按钮文本用户定义名获取默认语种选项值
    多选按钮文本数组用户定义名使用分号;连接选中的多个选项值
    部门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备注
    明细子列表用户定义名-子组件用户定义名

    注:

    • 时长:该组件会被拆分成5个提取字段,分别对应开始、截止、间隔天数、间隔时数和间隔类别信息。按上述表单中的提取字段名获取对应的值
    • 定位/居住地:该组件结果会被拆分成4个提取字段,分别对应地理位置的不同信息,可以按需匹配
    • 明细:明细组件属于容器组件,内部可以创建多个子组件,访问时通过拼接明细组件用户定义名和子组件名来获得特定子记录的值。因为明细组件支持用户创建多条明细记录,所以在获取特定单号时,如果该表单含明细控件,且用户创建了多条子记录,那最终获取的将是多条类似记录集合。具体条数由明细控件中包含的最大记录数决定。如果一个表单中,含多个明细控件,一个表单中,用户在多个明细控件中提交的子记录集合数不一定的话,那么最终返回的将以最大子记录数的数字为准。各个明细组件间的子记录相互间没有对应关系
  3. 子表整合案例

    案例中,用户提交了一笔单据,但是因为单据中含有2个明细控件:订单子表和货运子表。用户提交了2笔订单子记录,3笔货运子记录。按子表最大记录数,共创建了3笔记录。这3笔记录中除了2个明细控件的栏位外,其他栏位内容均相同。对应2个单据的各条记录相互间没有对应的关联关系的。

    example