HTTP 连接器 - 钉钉开放平台 - 批量获取实例评论记录并保存
1. 使用场景
本例介绍一下如何使用钉钉开放平台 OpenAPI 批量获取宜搭实例评论记录并存储到表单 。
1.1. 连接器介绍文档
2. 实现功能
2.1. 申请钉钉开放平台应用凭证及接口权限
若已申请,可忽略此步骤。
此处为语雀内容卡片,点击链接查看:准备工作 - 宜搭自定义连接器鉴权凭证申请及接口权限申请
2.2. 创建 HTTP 连接器
本例用到的连接器:
2.2.1. 创建 HTTP 连接器
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1679295800649-a120e2b4-15b2-453d-8805-ee47b256da96.png)
2.2.2. 配置连接器基本信息和登录方式
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716359444487-1edd0395-c82f-40df-ba15-25845f33e1c7.png)
2.2.3. 配置连接器执行动作
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716359514383-97e289de-60d9-4637-a9b3-59a71daf7525.png)
接口请求 :
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716359572461-32710194-7bbb-499a-bb5d-1d008bc1fcab.png)
Body 参数:
{
"formUuid" : "String",
"appType" : "String",
"systemToken" : "String",
"formInstanceIdList" : [ "String" ],
"userId" : "String"
}
Headers 参数 :
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716359636006-7dddd895-b06e-40c6-af66-30df494a1a48.png)
Content-Type:application/json
接口返回:
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716359686753-db7627eb-198c-4630-98c8-842e861247ac.png)
{
"formRemarkVoMap": ""
}
2.2.4. 配置鉴权模板
若无账号,需新增账号,账号所需参数参考 2.1:
鉴权模板具体配置可参考:
此处为语雀内容卡片,点击链接查看:准备工作 - 宜搭自定义连接器鉴权模板配置
2.3. 在宜搭配置页面并配置集成自动化
2.3.1. 配置流程页面
提交该流程页面数据
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716359809142-3236b909-e24b-4da7-ad1d-d32c238b6919.png)
2.3.2. 配置表单页面
创建【评论内容】表单 -> 存放流程评论数据
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716359844595-ddde00fd-84a2-4c0b-a723-2086315da23c.png)
2.3.3. 配置集成自动化
2.3.3.1. 【流程表】评论成功 -> 存储评论内容
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716360020007-d95877c8-bc2b-40ae-9e19-32e6fe7f6aef.png)
【流程表】评论成功后 -> 配置「脚本节点」处理字段格式 -> 使用「连接器」批量获取评论内容 -> 配置「脚本节点」处理连接器返回的评论内容参数 -> 「新增数据」节点,存储评论到【评论内容】 。
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716360096993-9016dc59-fbb8-4ee1-a05b-68114e5d9c1c.png)
脚本节点处理参数格式:
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716360304689-855a089d-6610-421a-ad77-100d7c63bdfc.png)
outputs.add("formInstanceIdList","formInstanceIdList",[value1]);
outputs.add("提交人userId","subUserId",value2?JSON.parse(value2)[0]:'');
连接器批量获取流程评论内容:
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716360489488-ead47d10-8c93-48ac-bc71-01956ef1a544.png)
脚本节点处理评论内容返回参数:
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716360838172-c5c314c3-a2f6-4662-851c-c0488ac989c2.png)
var nowDataResult = result[value1] || [];
var sortResult = nowDataResult.sort(function (now, next) {
return new Date(now.gmtCreate).getTime() - new Date(next.gmtCreate).getTime();
});
var firstResult = sortResult[sortResult.length - 1];
var imgs = (firstResult.images ? JSON.parse(firstResult.images) : []).map(function (item) {
return {
downloadUrl: item.imageUrl,
previewUrl: item.imageUrl,
url: item.imageUrl,
name: item.fileName,
};
});
var files = (firstResult.files ? JSON.parse(firstResult.files) : []).map(function (item) {
return {
downloadUrl: item.downloadUrl,
previewUrl: item.downloadUrl,
url: item.downloadUrl,
name: item.fileName,
};
});
outputs.add("评论人","creator",[firstResult.creator]);
outputs.add("at人员","atUser",(firstResult.atUserId || '').split(','));
outputs.add("评论时间","gmtCreate",String(new Date(firstResult.gmtCreate.replace('T', ' ').substr(0, 16)).getTime()));
outputs.add("评论内容","text",firstResult.content);
outputs.add("评论图片","imgs",imgs);
outputs.add("评论附件","files",files);
新增数据到【评论内容】表单:
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716360922775-5ac59234-3f75-41f3-bb8d-b122b17ddce9.png)
2.3.3.2. 【流程表】详情删除评论,自动清理【评论内容】
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716361057873-feb777cd-b117-4796-b697-d1c665539cb0.png)
评论删除成功 -> 获取数据节点,获取【评论内容】数据 -> 删除节点,删除历史存储的数据。
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716361158687-fbe49ac7-7006-4c84-82d8-739e0c3afdd7.png)
获取评论数据:
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716361184757-3e46ec68-03dc-424d-b2d5-3187016e8a6a.png)
删除评论数据:
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716361206797-7427fa51-c772-4d0e-943b-044f5f2666e5.png)
3. 实现效果
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716361404885-fd8d460d-791a-4bce-ad8b-001894323d9e.png)
评论存储成功:
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1716361369751-d9d7efc5-47a1-46de-ae40-e87a40560ba4.png)
4. 在线试玩
本文档对您是否有帮助?