钉钉发起审批实例接口,请假/调休控件组如何传参?
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
在钉钉中,通过API发起审批实例并包含请假/调休控件组时,需要按照特定的参数格式和结构进行传参。以下是一个基本的示例,展示了如何使用JSON格式传递请假/调休控件组的参数:
{
"processCode": "your_process_code", // 审批流的唯一标识码
"originatorUserId": "your_user_id", // 发起审批的用户ID
"deptId": "your_dept_id", // (可选)发起审批的部门ID
"formComponentValues": [
{
"componentName": "leave_type", // 控件名称,根据实际情况填写
"componentValue": "1" // 假设“1”代表事假,具体值根据你的审批模板定义
},
{
"componentName": "start_date", // 开始日期控件名称
"componentValue": "2023-04-01" // 开始日期,格式为YYYY-MM-DD
},
{
"componentName": "end_date", // 结束日期控件名称
"componentValue": "2023-04-03" // 结束日期,格式为YYYY-MM-DD
},
{
"componentName": "reason", // 原因描述控件名称
"componentValue": "个人原因需要请假" // 请假原因
},
{
"componentName": "adjust_type", // (可选)调休类型控件名称,如果有调休选项的话
"componentValue": "1" // 假设“1”代表正常调休,具体值根据你的审批模板定义
}
]
}
请注意,以上示例中的控件名称(如leave_type
、start_date
、end_date
等)和对应的值需要根据你的实际审批模板中的控件设置来调整。
在实际使用时,你需要将这个JSON对象转换为字符串,并作为POST请求的主体发送到钉钉的“发起审批实例”接口。
在钉钉中,发起审批实例时,可以通过控件组参数来传递请假或调休的信息。具体来说,可以在创建审批单时添加“请假/调休套件”,审批通过后,系统会自动在钉钉状态栏显示请假时间,并扣除对应的假期余额。
此外,根据是否指定审批人,调用接口的方式有所不同。如果指定审批人,可以通过approvers或approvers_v2参数来指定审批人。其中,approvers_v2支持或签和会签。如果不指定审批人,审批流程会复用审批后台的设置。在这种情况下,调用接口时不传入approvers或approvers_v2参数,会自动复用在审批管理后台预设的审批人。
请注意,无论是哪种方式,都需要在调用接口前确保已经为应用添加了接口权限。同时,对于企业内部应用和第三方企业应用,获取审批单流程中的节点信息接口的调用方式也存在差异。