钉钉可以传递哪些控件数据到「发起审批实例」接口?
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
在钉钉的「发起审批实例」接口中,可以传递以下控件数据:
文本控件(text):通过文本控件,可以传递普通的文本信息。
数字控件(number):通过数字控件,可以传递数字类型的数据,如金额、数量等。
日期控件(date):通过日期控件,可以传递日期类型的数据。
单选框控件(radio):通过单选框控件,可以传递多个选项中的一个值。
多选框控件(checkbox):通过多选框控件,可以传递多个选项中的多个值。
下拉框控件(select):通过下拉框控件,可以传递从预定义选项中选择的一个值。
成员选择器控件(contact):通过成员选择器控件,可以传递选择的用户、部门或角色信息。
附件控件(file):通过附件控件,可以传递上传的文件信息。
图片控件(image):通过图片控件,可以传递上传的图片信息。
在钉钉的「发起审批实例」接口中,您可以传递不同类型的控件数据作为审批的内容。以下是一些常见的控件类型和对应可以传递的数据:
文本框(text):可以传递字符串类型的文本数据。
单选框(radio):可以传递选择的单个选项值。
多选框(checkbox):可以传递选择的多个选项值,使用数组形式表示。
日期/时间(date/time):可以传递日期或时间的具体数值,以字符串格式表示。
数字输入框(number):可以传递数值型数据。
审批人(selector):可以传递选择的审批人信息,如用户ID、部门ID等。
部门(selector):可以传递选择的部门信息,如部门ID等。
文件上传(file):可以传递上传的文件信息,如文件ID等。
这仅是一些常见的控件类型,实际上,钉钉提供了更多丰富的控件类型供您使用。具体可用的控件类型和传递的数据请参考钉钉开放平台的相关文档,并根据您的实际需求构建相应的参数数据。
单行文本:text
多行文本:textarea
选择器:select,供选择器使用的选项项称为 Options
开关:switch
日期选择器:datepicker
日期时间选择器:datetimepicker
倒计时:countdown,需传入倒计时endtime
人员选择器:userpicker,选择器需要获取的用户userid组成的数组
人员搜索选择器:usersearch,选择器需要获取的用户userid组成的数组
你可以在发起审批时,传入对应的控件key和value,比如:
{"text":{"key":"name","value":"John"}}
{"userpicker":["zhangsan","lisi"]}
然后钉钉就会按照你传入的控件key和value,渲染相应的表单控件出来,让审批人进行审批。
可以传递表单组件的数据到「发起审批实例」接口。具体实现方式为在请求体中添加formComponentValues参数,其中每个表单组件需要传递name和value两个值。例如:{ "name" : "请假天数", "value" : "3" }。此回答整理自钉群“钉钉开发者社区(互助群)”