操作教程|通过DataEase开源BI工具对接金山多维表格

发布于 2024年05月20日

前言

金山多维表格是企业数据处理分析经常会用到的一款数据表格工具,它能够将企业数据以统一的列格式整齐地汇总至其中。DataEase开源数据可视化分析工具可以与金山多维表格对接,方便企业更加快捷地以金山多维表格为数据源,制作出可以实时更新、便捷分享的企业数据大屏。

本文将为您详细介绍通过DataEase开源数据可视化分析工具对接金山多维表格的具体步骤。

操作步骤

一、配置金山多维表格

1. 创建金山多维表格,录入测试数据;

2. 在金山多维表格的“开发”模块下新建脚本;

3. 在新建的脚本框中编写脚本程序;

脚本程序的代码参考如下(详细内容可以参考完整文档:https://www.kdocs.cn/l/ctzsgDlAGF0l):

/*
* 查看完整文档, 请访问 https://www.kdocs.cn/l/ctzsgDlAGF0l
* 示例: 创建记录 (!!请使用空白数据表测试!!)
*/
// function createRecords() {
// const sheet = Application.Selection.GetActiveSheet()
// const records = Application.Record.CreateRecords({
// SheetId: sheet.sheetId,
// Records: [{ fields: { "名称": "demo", "数量": 1, "日期": "2022/1/1", "状态": "未开始" } }]
// })
// }


let url = Context.argv.url // 获取当前多维表格的地址
//let url = "https://www.kdocs.cn/l/cpyG84lengQx?startTime=1714273639337&newFile=true&referer=pc_new__3.0.0__other__kdocs__0&R=L1MvMQ=="// 也可以直接写地址
let returnData // 定义返回数据变量
const sheets = Application.Sheet.GetSheets() // 获取当前表格对象
console.log("API 分页查询开始:--------------------------------")
//console.log(sheets)
returnData = pagedQuery(1) // 传入 sheet 页 1,并 push 给变量 returnData
function pagedQuery(sheet) {
let all = []
let offset = null;
while (all.length === 0 || offset) {
let records = Application.Record.GetRecords({ // 循环获取不同的记录
SheetId: sheet,
//ViewId: view_id,
Offset: offset,
})
offset = records.offset
all = all.concat(records.records) // 拼接不同行的值
//console.log(all)
}
console.log("记录条数:" + all.length)
return all // 返回表格内容
}
//console.log(returnData)
console.log("API 分页查询结束:--------------------------------")
console.log("开始返回数据:--------------------------------")
console.log(returnData)
return returnData

4. 创建脚本令牌;

5. 复制脚本Webhook(即网络钩子)。

二、将金山多维表格数据源接入DataEase

进入DataEase的数据源配置页面,创建API数据源,配置完基础信息后,添加“数据表”并录入API的详细信息。

1. 连接API

① 在“名称”栏录入该接口的名称;

② 在“请求”栏录入复制的金山多维表格Webhook地址;

③ 在“请求参数”栏的请求头中录入“Content-Type”:“application/json”;

④ 在“请求参数”栏的请求头中录入“AirScript-Token”:即金山多维表格中创建的脚本令牌;

⑤ 在“请求参数”栏的请求体中录入json字符串,参考如下:

{
    "Context":{
        "argv":{
        }
    }
}

所有信息录入完成后,点击“下一步”按钮。

2. 提取数据

勾选“数据结构”栏目中对应的解析字段数据层级,点击“保存”按钮。

结果展示

金山多维表格与DataEase开源数据可视化分析工具的对接演示效果如下图所示:

编者注:本文参考了包永康在WPS社区发布的《使用金山文档+DataEase制作高大上的数字看板》一文(https://bbs.wps.cn/topic/18861)。