跳到主要内容

数据目录

注意:

本功能仅能查询到「当前日期」之前的数据。

例如:今天是2021年12月1日,该功能仅可查询12月1日以前的数据。

1. 使用场景

通过宜搭内置的「数据目录」连接器,可获取企业即时沟通中群聊的统计数据。包括:

  • 群聊用户数:指企业内发送群聊消息用户数。
  • 新增群数:指企业内部群新增数量。
  • 活跃群数:指有群聊消息发生的企业内部群数量。
  • 群聊消息数:指企业内部群消息数。
  • 内部群数量:指当前存在的企业内部群数量。
  • 部门群数量:指当前存在的部门群数量。

2. 操作步骤

2.1 步骤一:表单设计

创建两个表单,分别用于触发连接器以及接收并展示连接器返回的数据。

2.1.1 创建「查询企业群聊统计数据」表单

操作步骤:

  1. 创建普通表单,命名为「查询企业群聊统计数据」。
  2. 添加日期组件,命名为「查询日期」,并设置为必填项。(操作如图2.1-1 所示)

图2.1-1 添加并配置日期组件

  1. 点击页面右上角「保存」按钮,即可。

2.1.2 创建「企业群聊数据明细」表单

操作步骤:

  1. 创建普通表单,命名为「企业群聊数据明细」。
  2. 添加多行文本组件,命名为「返回数据」,状态设置为「隐藏」。(操作如图2.1-2 所示)

图2.1-2 添加并配置多行文本组件

  1. 添加子表单组件,命名为「企业群聊统计明细表」,状态设置为「只读」。(操作如图2.1-3 所示)

图2.1-3 添加并配置子表单组件

  1. 在子表单内添加7个单行文本组件,分别命名为「查询日期、群聊用户数、新增群数、活跃群数、群聊消息数、内部群数量、部门群数量」,状态均设置为「只读」。(操作如图2.1-4 所示)

图2.1-4 添加并配置子表单内的7个单行文本组件

  1. 在JS面板内添加下述代码,进行数据处理。(操作如图2.1-5 所示)

图2.1-5 添加JS代码进行数据处理

上述代码如下所示:

注意进行组件唯一标识的替换!

export function didMount() {
// 获取连接器返回数据,其中「textareaField_ky16z248」为多行文本组件唯一标识,请注意替换,否则会失效哦!!!
const str = this.$("textareaField_ky16z248").getValue();
//进行数据处理
const obj = JSON.parse(str);
const val = obj.dataList;
let arr = [];
const valList = val.map(item => {
let valObject = {};
//查询日期
//需将 textField_ky16z24k 替换为您创建的组件的唯一标识
valObject.textField_ky16z24k = item["stat_date"];
//用户群聊数
//需将 textField_ky16z24l 替换为您创建的组件的唯一标识
valObject.textField_ky16z24l = item["4030_DAY"];
//新增群数
//需将 textField_ky16z24j 替换为您创建的组件的唯一标识
valObject.textField_ky16z24j = item["4031_DAY"];
//活跃群数
//需将 textField_ky16z24i 替换为您创建的组件的唯一标识
valObject.textField_ky16z24i = item["4032_DAY"];
//群聊信息数
//需将 textField_ky16z24h 替换为您创建的组件的唯一标识
valObject.textField_ky16z24h = item["4033_DAY"];
//内部群数量
//需将 textField_ky16z24g 替换为您创建的组件的唯一标识
valObject.textField_ky16z24g = item["4034_DAY"];
//部门群数量
//需将 textField_ky16z24f 替换为您创建的组件的唯一标识
valObject.textField_ky16z24f = item["4035_DAY"];
arr.push(valObject);
})
//将处理好的数据赋值给子表单组件
//需将 tableField_ky16z24a 替换为您创建的单行文本组件的唯一标识
this.$("tableField_ky16z24a").setValue(arr);
}
  1. 点击页面右上角「保存」按钮,即可。

2.2 步骤二:添加连接器

连接器详细介绍,请移步:

此处为语雀内容卡片,点击链接查看:集成&自动化

给「查询企业群聊统计数据」表单添加连接器,用于与钉钉数据目录连接器进行数据集成。

操作步骤:

  1. 后台管理页面>>选中「查询企业群聊统计数据」表单>>选择「集成&自动化」>>点击「新建集成&自动化」按钮。(操作步骤如图2.2-1 所示)

图2.2-1 连接器入口

  1. 新建名为「查询企业统计数据」的连接器,触发类型选择「表单事件触发」,点击「确定」按钮。

(操作如图2.2-2 所示)

图2.2-2 创建连接器

  1. 配置表单事件触发:触发事件选择「创建成功」,数据过滤选择「全部数据」,点击「保存」按钮。

(操作如图2.2-3 所示)

图2.2-3 配置连接器表单事件触发

  1. 选择应用>>「数据目录」>>「下一步」。(操作如图2.2-4 所示)

图2.2-4 选择连接器应用

  1. 选择执行动作>>「获取企业群聊统计数据」>>「下一步」。(操作如图2.2-5 所示)

图2.2-5 选择连接器执行动作

  1. 配置执行动作>>查询时间>>「字段」>>「查询日期」>>「保存」。(操作如图2.2-6 所示)

图2.2-6 配置连接器执行动作

  1. 添加新增数据节点,在「接收企业群聊统计数据」表单中,新增单条数据,将「连接器返回数据」的值设置为「业务返回结果」「字段」。(操作如图2.2-7 所示)

图2.2-8 添加并配置「新增数据」节点

  1. 点击页面右上角「保存」按钮后,点击「发布」按钮,即可。

2.3 步骤三:提交表单数据

操作步骤:

提交「查询企业群聊统计数据」表单,用于触发连接器。连接器的返回结果可以在「企业群聊统计数据明细」表单中进行查看。(操作如图2.3-1 所示)

图2.3-1 提交表单

3. 效果展示

操作路径:后台管理页面 >>「企业群聊数据明细」>> 数据管理 >> 查看详情(最终效果如图3.1 所示)

图3.1 连接器最终效果展示


Copyright © 2024钉钉(中国)信息技术有限公司和/或其关联公司浙ICP备18037475号-4