HTTP 连接器 - 钉钉开放平台 - 批量获取实例评论记录并保存

1. 使用场景

本例介绍一下如何使用钉钉开放平台 OpenAPI 批量获取宜搭实例评论记录并存储到表单。

1.1. 连接器介绍文档

功能免费版轻享版专业版专属版HTTP连接器1 个1个不限数量不限数量如果当钉钉官方连接器无法满足你的需求，但又急需打通钉钉应用、自建系统或者第三方应用系统时，你可以通过宜搭连接器工厂进行自定义连接器。步骤一：新建连接器使用管理员身份登录宜搭工作台。单击右上角平台管理按钮，进入平台管理页面。单击...

https://docs.aliwork.com/docs/yida_support/wtwabe/zevvr1/_1/zbq17y

2. 实现功能

2.1. 申请钉钉开放平台应用凭证及接口权限

若已申请，可忽略此步骤。

此处为语雀内容卡片，点击链接查看：准备工作 - 宜搭自定义连接器鉴权凭证申请及接口权限申请

2.2. 创建 HTTP 连接器

本例用到的连接器：

批量查询宜搭表单实例的评论

2.2.1. 创建 HTTP 连接器

2.2.2. 配置连接器基本信息和登录方式

2.2.3. 配置连接器执行动作

接口请求：

Body 参数：

{
  "formUuid" : "String",
  "appType" : "String",
  "systemToken" : "String",
  "formInstanceIdList" : [ "String" ],
  "userId" : "String"
}

Headers 参数：

Content-Type：application/json

接口返回：

{
  "formRemarkVoMap": ""
}

2.2.4. 配置鉴权模板

若无账号，需新增账号，账号所需参数参考 2.1：

鉴权模板具体配置可参考：

此处为语雀内容卡片，点击链接查看：准备工作 - 宜搭自定义连接器鉴权模板配置

2.3. 在宜搭配置页面并配置集成自动化

2.3.1. 配置流程页面

提交该流程页面数据

2.3.2. 配置表单页面

创建【评论内容】表单 -> 存放流程评论数据

2.3.3. 配置集成自动化

2.3.3.1. 【流程表】评论成功 -> 存储评论内容

【流程表】评论成功后 -> 配置「脚本节点」处理字段格式 -> 使用「连接器」批量获取评论内容 -> 配置「脚本节点」处理连接器返回的评论内容参数 -> 「新增数据」节点，存储评论到【评论内容】。

脚本节点处理参数格式：

outputs.add("formInstanceIdList","formInstanceIdList",[value1]);
outputs.add("提交人userId","subUserId",value2?JSON.parse(value2)[0]:'');

连接器批量获取流程评论内容：

注意配置连接器所需参数：

formUuid、appType、systemToken 查看路径：系统后台 -> 应用设置 -> 部署运维。

脚本节点处理评论内容返回参数：

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);