在钉钉中,如何传递表格控件和附件控件的数据到「发起审批实例」接口?
在钉钉中,你可以通过POST请求的方式,将表格控件和附件控件的数据传递给「发起审批实例」接口。以下是具体的步骤:
首先,你需要在表格控件和附件控件中填写数据。
然后,你可以在POST请求的body中,将这些数据作为参数传递。
对于表格控件,你可以将其值转换为JSON格式,然后在body中添加一个字段formComponentValues
,并将转换后的JSON字符串作为其值。
对于附件控件,你可以在body中添加一个字段attachments
,并将附件的文件名和文件内容作为其值。
你还需要在body中添加一个字段microappAgentId
,并将其值设置为微应用的ID。
最后,你还需要在body中添加一个字段originatorUserId
,并将其值设置为发起人的用户ID。
传递表格控件和附件控件的数据到「发起审批实例」接口,您需要按照以下步骤进行操作:
通过以上步骤,您就可以将表格控件和附件控件的数据成功传递到「发起审批实例」接口了。
在钉钉中,要传递表格控件和附件控件的数据到「发起审批实例」接口,需要在请求示例中的 "formComponentValues" 字段中添加对应控件的数据。具体做法如下:
[
[
{"name": "John", "age": "23"},
{"address": "New York", "email": "john@example.com"}
],
[
{"name": "Jane", "age": "25"},
{"address": "Los Angeles", "email": "jane@example.com"}
]
]
{
"componentCode": "attachment",
"componentValue": [
{
"id": "123456"
}
]
}
最后,将处理后的 "formComponentValues" 字段添加到 "formData" 中,并发送到「发起审批实例」接口即可。
在钉钉中,可以使用消息扩展插件来传递表格控件和附件控件的数据到「发起审批实例」接口。具体操作如下:
dd.biz.approve.ApproveInstance
对象的 setParam
方法,例如:const approveInstance = new dd.biz.approve.ApproveInstance();
approveInstance.setParam("msg_ext", messageExt);
approveInstance.create().then(function(instanceId) {
//...
}).catch(function(error) {
//...
});
在这个例子中,messageExt
是一个包含了表格控件和附件控件的数据的对象。
result
对象的 msg_ext
属性中获取到传递过来的数据,例如:const result = await instanceResult.getApprovalResult();
const messageExt = result.msg_ext;
在这个例子中,result
对象是由 getApprovalResult
方法返回的一个对象,包含了审批实例的状态和其他相关信息。
需要注意的是,传递过来的数据需要符合钉钉的消息扩展插件规范,才能正确地被接收到。具体规范可以参考钉钉的官方文档。
发起审批实例https://open.dingtalk.com/document/orgapp/initiate-approval
接口调用量说明
钉钉标准版接口累计可调用次数为1万次/月,当前接口会消耗调用次数。若该调用量无法满足需求,你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。
调用本接口发起一个审批。
重要
为提升接口使用体验,针对OA审批相关接口规范进行升级,从旧版升级到新版。本文旧版规范接口文档已于2022年10月8日迁移至历史文档(不推荐)目录,且本接口仅保持现有功能,不再新增支持其他能力。
如果未使用本接口,推荐使用新版规范发起审批实例接口。
如果已使用本接口,建议您根据自身实际情况评估是否切换至推荐接口。
重要
发起审批实例后,无法通过API修改审批实例信息。
要传递表格控件和附件控件的数据到「发起审批实例」接口,需要在请求示例中的"formComponentValues"字段中添加对应控件的数据。对于表格控件,需要将其数据转化为一个json对象的二维数组。对于附件控件,需要将其数据转化为一个json数组转义为字符串形式,其中每个json对象是一个附件文件,每个文件都必须包含spaceId、fileName、fileSize、fileType和fileId字段,这些字段都可以通过调用钉盘的上传附件接口获取。此回答来自“钉钉开发者社区(互助群)”
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。