资源介绍
| 名称展开子列表 | 类型 | 描述 |
|---|---|---|
| approval_code | string | 审批定义 code， 创建审批定义返回的值，表示该实例属于哪个流程；该字段会影响到列表中该实例的标题，标题取自对应定义的 name 字段示例值："81D31358-93AF-92D6-7425-01A5D67C4E71" |
| status | string | 审批实例状态示例值："PENDING"可选值有：PENDING：审批中APPROVED：审批流程结束，结果为同意REJECTED：审批流程结束，结果为拒绝CANCELED：审批发起人撤回DELETED：审批被删除展开 |
| extra | string | 审批实例扩展 JSON示例值："{"xxx":"xxx"}" |
| instance_id | string | 审批实例唯一标识，用户自定义，需确保证租户、应用下唯一示例值："24492654" |
| links | external_instance_link | 审批实例链接集合 ，用于【已发起】列表的跳转，跳转回三方系统； pc_link 和 mobile_link 必须填一个，填写的是哪一端的链接，即会跳转到该链接，不受平台影响 |
| title | string | 审批展示名称，如果填写了该字段，则审批列表中的审批名称使用该字段，如果不填该字段，则审批名称使用审批定义的名称示例值："@i18n@1" |
| form | external_instance_form[] | 用户提交审批时填写的表单数据，用于所有审批列表中展示。可传多个值，但审批中心pc展示前2个,移动端展示前3个,长度不超过2048字符 |
| user_id | string | 审批发起人 user_id，发起人可在【已发起】列表中看到所有已发起的审批; 在【待审批】，【已审批】【抄送我】列表中，该字段展示审批是谁发起的。审批发起人 open id，和 user id 二选一。示例值："a987sf9s" |
| user_name | string | 审批发起人 用户名，如果发起人不是真实的用户（例如是某个部门），没有 user_id，则可以使用该字段传名称示例值："@i18n@9" |
| open_id | string | 审批发起人 open id，和 user id 二选一示例值："ou_be73cbc0ee35eb6ca54e9e7cc14998c1" |
| department_id | string | 发起人部门，用于列表中展示发起人所属部门。不传则不展示。如果用户没加入任何部门，传 ""，将展示租户名称传 department_name 展示部门名称示例值："od-8ec33278bc2" |
| department_name | string | 审批发起人 部门，如果发起人不是真实的用户（例如是某个部门），没有 department_id，则可以使用该字段传名称示例值："@i18n@10" |
| start_time | string | 审批发起时间，Unix毫秒时间戳示例值："1556468012678" |
| end_time | string | 审批实例结束时间：未结束的审批为 0，Unix毫秒时间戳示例值："1556468012678" |
| update_time | string | 审批实例最近更新时间；用于推送数据版本控制如果 update_mode 值为 UPDATE，则只有传过来的 update_time 有变化时（变大），才会更新审批中心中的审批实例信息。使用该字段主要用来避免并发时老的数据更新了新的数据示例值："1556468012678" |
| display_method | string | 列表页打开审批实例的方式示例值："BROWSER"可选值有：BROWSER：跳转系统默认浏览器打开SIDEBAR：飞书中侧边抽屉打开NORMAL：飞书内嵌页面打开 |
| update_mode | string | 更新方式， 当 update_mode=REPLACE时，每次都以当前推送的数据为最终数据，会删掉审批中心中多余的任务、抄送数据（不在这次推送的数据中）; 当 update_mode=UPDATE时，则不会删除审批中心的数据，而只是进行新增和更新实例、任务数据示例值："UPDATE"可选值有：REPLACE：全量替换，默认值UPDATE：增量更新 |
| task_list | external_instance_task_node[] | 任务列表数据 校验规则：最大长度：200 |
| cc_list | cc_node[] | 抄送列表数据校验规则：最大长度：200 |
| i18n_resources | i18n_resource[] | 国际化文案 |
数据示例
{
"approval_code": "84C18825-A3D2-41D0-891F-E7A2424C5D48",
"instance_id": "3162634",
"status": "PENDING",
"extra": "",
"links": {
"pc_link": "http://applink.feishu.cn/sso/common?redirectUrl=/seeyon/main.do?method=main&client=pc",
"mobile_link": "http://applink.feishu.cn/sso/common?redirectUrl=/seeyon/main.do?method=main&client=pc"
},
"title": "@i18n@1",
"form": [{
"name": "@i18n@2",
"value": "@i18n@3"
}],
"user_id": "16fb9ff3",
"user_name": "张三",
"open_id": "123",
"department_id": "",
"department_name": "hr",
"start_time": "1657093395000",
"update_time": "1657093395000",
"end_time": 0,
"update_mode": "REPLACE",
"task_list": [{
"task_id": "112253",
"user_id": "16fb9ff3",
"links": {
"pc_link": "http://",
"mobile_link": "http://"
},
"status": "PENDING",
"extra": "",
"title": "同意",
"create_time": "1638468921000",
"end_time": 0,
"update_time": "1638468921000",
"action_context": "123456",
"action_configs": [{
"action_type": "APPROVE",
"action_name": "@i18n@1",
"is_need_reason": true,
"is_reason_required": true,
"is_need_attachment": true
}]
}],
"cc_list": [{
"cc_id": "1231243",
"user_id": "16fb9ff3",
"open_id": "",
"links": {
"pc_link": "http://",
"mobile_link": "http://"
},
"read_status": "READ",
"extra": "",
"title": "XXX",
"create_time": "1657093395000",
"update_time": "1657093395000"
}],
"i18n_resources": [{
"locale": "zh-CN",
"is_default": true,
"texts": [ {"key":"@i18n@1", "value":"测试"}, {"key":"@i18n@2", "value":"天"},{"key":"@i18n@3", "value":"2022-07-06"}]
}]
}表单说明
用户ID说明
部门ID说明
扫码加入交流群修改于 2023-02-02 03:29:44