资源介绍

资源定义

单个审批流，由表单和审批流程组成，创建后可以让员工在发起审批时填写各个控件的值并形成审批实例。

字段说明

名称展开子列表	类型	描述
approval_name	string	审批名称的国际化文案 Key，以 @i18n@ 开头，长度不得少于 9 个字符示例值："@i18n@approval_name"
approval_code	string	审批定义code，传空表示新建示例值："7C468A54-8745-2245-9675-08B7C63E7A85"
description	string	审批描述的国际化文案 Key，以 @i18n@ 开头，长度不得少于 9 个字符示例值：@i18n@description
viewers	approval_create_viewers[]	viewers 字段指定了哪些人能从审批应用的前台发起该审批。1.当 type 为 USER 时，需要填写 user_id 、 open_id、union_id 中的一个，用于指定对哪个用户可见；2.当 type 为 DEPARTMENT 时，需要填写部门的 open_id，用于指定对哪个部门可见
form	approval_form	审批定义表单
node_list	approval_node[]	审批定义节点，需要将开始节点作为 list 第一个元素，结束节点作为最后一个元素
settings	approval_setting	审批定义其他设置
config	approval_config	审批定义配置项，用于配置对应审批定义是否可以由用户在审批后台进行修改
icon	int	审批图标枚举，默认为 0示例值：0默认值：`0`
i18n_resources	i18n_resource[]	国际化文案

数据示例

{
    "approval_name": "@i18n@approval_name",
    "approval_code": "813718CE-F38D-45CA-A5C1-ACF4F564B526",
    "viewers":[
        {
            "viewer_type":"TENANT",
            "viewer_user_id":""
        }
    ],
    "form": {
        "form_content": "[{\"id\":\"111\",\"name\":\"@i18n@event_name\",\"required\":true,\"type\":\"input\"},{\"id\":\"222\",\"name\":\"@i18n@time_interval\",\"required\":true,\"type\":\"dateInterval\",\"value\":{\"format\":\"YYYY-MM-DD hh:mm\",\"intervalAllowModify\":false}},{\"id\":\"333\",\"name\":\"@i18n@event_type\",\"type\":\"radioV2\",\"value\":[{\"key\":\"1\",\"text\":\"@i18n@recurrence_event\"},{\"key\":\"2\",\"text\":\"@i18n@single_event\"}]},{\"id\":\"444\",\"name\":\"@i18n@attende_count\",\"required\":true,\"type\":\"number\"},{\"id\":\"555\",\"name\":\"@i18n@apply_reason\",\"required\":true,\"type\":\"textarea\"}]"
        },

    "node_list": [{
          "id": "START",
          "privilege_field":{ 
				 "writable": ["111","222"],
				 "readable": ["111","222"]
		  }
        },{
          "id": "7106864726566",
          "privilege_field":{ 
				 "writable": ["111","222"],
				 "readable": ["111","222"]
		  },
          "name": "@i18n@node_name",
          "node_type": "AND",
          "approver": [
            {
              "type": "Personal",
              "user_id": "59a92c4a"
            }
          ],
          "ccer": [
            {
              "type": "Supervisor",
              "level": "2"
            }
          ]
        },{
          "id": "END"
        }],
    "settings" : {
          "revert_interval":0
        },
    "config" : {
          "can_update_viewer": false,
          "can_update_form": true,
          "can_update_process": true,
          "can_update_revert": true,
          "help_url":"https://www.baidu.com"
        },
    "icon": 1,
    "i18n_resources" : [{
          "locale": "zh-CN",
          "texts" : [
              {"key":"@i18n@approval_name","value":"审批名称"},
              {"key":"@i18n@event_name","value":"日程名称"},
              {"key":"@i18n@node_name","value":"审批"},
              {"key":"@i18n@time_interval","value":"日程名称"},
              {"key":"@i18n@event_type","value":"日程类型"},
              {"key":"@i18n@recurrence_event","value":"重复性日程"},
              {"key":"@i18n@single_event","value":"单次日程"},
              {"key":"@i18n@attende_count","value":"参与人数量"},
              {"key":"@i18n@apply_reason","value":"申请原因"}
            ],
          "is_default": true
        }]
}

什么是Approval Code

审批定义对应的唯一编码，可在编辑审批时从浏览器 url 中找到。点击以下链接可以进入管理后台：

https://www.feishu.cn/approval/admin/approvalList?devMode=on

点击上图中的编辑按钮，可以在URL中找到Approval Code，格式为：definitionCode=E3254848-D172-4169-B03E-744E7CD11F06

什么是表单（Form）

表单包括一或多个控件，员工发起审批时需要填写的表单页面，每个审批定义都有自己的表单。

组成审批的部分。一个表单由一或多个审批控件组成。每个控件都有一个基础属性：

struct{
    String Id; //标识在一个审批定义中某一个控件的唯一 ID
    String CustomId; //自定义控件 ID，标识在一个审批定义中某一个控件的唯一 ID
    String Name; //该控件的名称
    String Type; //该控件的类型
}

2.自定义控件ID

可以通过在审批管理后台编辑定义时指定一个 ID，之后可以用指定的 ID 唯一确定一个在该定义中的控件。

3.控件类型说明

控件类型	说明
单行文本	用于填写一个单行文本
多行文本	用于填写一个多行文本
数字	用于填写一个数字
金额	用于填写审批金额数量及单位，默认单位为CNY
日期	用于填写详细时间
日期区间	用于填写一个日期区间，包括有开始时间、结束时间以及持续时间
单选	用于选择单个选择
多选框	用于选择多个选择
地址	用于填写一个地址
联系人	用于在审批中添加联系人
说明	用于在审批定义中添加说明（如填写规范、注意事项），在发起审批时不可编辑
明细	用于填写明细信息，在明细中可以添加其他控件比如数字、金额等。在创建审批定义时设计一个明细控件表示明细的一个条目中包括哪些控件，发起人可以根据自身需求增加条目，每一个条目都和创建审批定义时所设明细控件一致
计算公式	在创建审批定义时设计计算方式，表示该控件的值依赖于其他控件（数字、金额）计算得出
图片	用于在审批中添加图片
附件	用于在审批中添加附件，如文件等
关联	用于在当前审批中关联其他审批，使审批人能够在审批时查看所关联审批的概况
请假	用于填写请假审批的相关内容，包括选择请假类型（如病假、产假等，请假类型需要管理员提前在假期管理中设置并在创建审批定义时选择当前审批定义发起实例时可选种类有哪些），填写请假开始时间，填写请假结束时间以及请假时长
加班	用于填写加班申请的相关内容，包括选择加班类型（比如调休、带薪、不带薪等，由管理员在创建审批定义时设定），填写加班开始/结束时间和时长以及填写加班原因
换班	用于填写换班审批的相关内容，包括填写换班时间以及填写换班原因
出差	用于填写出差审批的相关内容，包括填写行程（一段行程中包括行程开始时间、行程结束时间、行程时长、出发地、目的地、交通方式、单程/往返以及备注，其中行程时长以自然日为单位计算，并且倘若出差有多段行程，可以由发起人手动增加新的一段行程），出差总时长，出差原因以及同行人
补卡	用于填写补卡审批的相关内容，包括填写补卡时间和填写补卡原因

什么是审批流程（Process）

管理员在创建审批定义同时会设计一个审批流转方式，这个方式包括了一个由该定义产生的实例每一步如何进行。流程由审批节点构成，一个审批定义对应一个审批流程。一个审批流程对应一或多个审批节点。员工在发起审批实例后，按照设计好的审批流程进行流转。设计审批流程时，需要指定在流程的每一步（审批节点，详情见下）的审批操作。包括有每一步的审批人或者到当前步骤时系统自动通过或系统自动拒绝。如果当前步骤不是由系统自动进行操作，则需要设置审批人或者设置由发起人自选审批人。

1.发起人自选审批人

即创建审批定义时在某一步不指定审批人，设置了由发起人自选，那么是由操作人在发起审批实例时自己选择审批人，审批定义创建时只需指定当前步骤是由所有操作人所选审批人或签或者会签即可。如果在定义设置了发起人自选审批人，在通过 API 发起审批实例时必须要指定该步骤发起人所选审批人。

2.审批节点

每一个审批流程由一或多个审批节点构成，每一个节点表示审批流转过程中的一个步骤，在当前节点完成后进入下一个节点。每当实例创建时生成该实例对应的各个审批节点，并由审批节点构成审批流程。

3.自定义节点 ID

和控件类似的，节点 ID 也可以指定，指定后可以用指定的 ID 唯一确定一个在该流程中的节点。

用户ID说明

了解user_id，open_id，union_id的区别和用途，参见教程用户相关的 ID 概念

部门ID说明

了解department_id，open_department_id的区别和用途，参见教程部门 Department 资源概述

资源定义#

字段说明#

数据示例#

什么是Approval Code#

什么是表单（Form）#

1.审批控件（Widget）#

2.自定义控件ID#

3.控件类型说明#

什么是审批流程（Process）#

1.发起人自选审批人#

2.审批节点#

3.自定义节点 ID#

用户ID说明#

部门ID说明#