# WPS多维表格连接数据库，搭建可视化看板

WPS的多维表格现已支持连接数据库（限时免费），可将草料收集到的数据推送到WPS的多维表格中，自由应用数据，搭建自己想要的看板内容。

不同表单的数据都可以链接到同一个WPS多维表格中，制作仪表盘看板

## 案例效果

通过连接草料的官方数据库到 WPS 多维表格，可实现快速查看设备巡检的完成情况，包括巡检次数、设备状态、月检统计等。

示例看板：  
[金山文档 | WPS云文档 - 灭火器检查看板](https://kdocs.cn/l/cmAsFrSvGa2p)

![灭火器管理仪表盘，展示设备总数、巡检次数、异常记录及月度巡检完成情况等核心运营数据。](https://blogcdnimg.clewm.net/2025/04/image-1744024620240_17440246207220.png)

## 使用前须知

### 数据 API 功能介绍

草料提供了官方数据库功能，草料平台中的码数据、表单数据、状态与计划数据等，会实时同步外部工具连接此数据库，数据推送后就可以制作出各类想要的看板效果。[查看官方数据库说明](/help/integration-and-connection/data-api/official-database-guide "查看官方数据库说明")

api数据会根据在草料设置的功能来推送，如： 在草料后台设置了状态功能，就会推送 code_state，即码的状态数据；在草料后台添加了计划并执行后，就会推送 code_task_log，即码的计划完成情况数据；未设置相关功能或者无数据产生时并不会推送。

建议您在使用二维码并有相关数据产生后，再去制作可视化看板。

### WPS 多维表格

金山多维表支持从金山表格组件、智能表单、第三方应用（如数据库、销售易系统等）同步数据到多维表。  
[金山文档多维表「导入/同步数据」官方帮助文档](https://365.kdocs.cn/l/csygTcClRakR)

## 应用教程

### 开启草料的官方数据库

1. 登录草料后台，点击左侧「数据管理」→「数据API」，选择「官方数据库」进行申请： [前往官方数据库](https://user.cli.im/opendata) ![草料二维码后台“数据管理”页的API开通界面，提供Webhook、官方数据库、自有数据库三种数据接口的开通入口与简要说明。](https://blogcdnimg.clewm.net/2025/04/image-1744025063142_17440250641307.png)
    
2. 开通后会获得以下示例信息（请以实际开通信息为准）：
    - 类型：MySQL 5.7
    - 主机：rm-bp1m4fy8d66u3c6xmbo.mysql.rds.aliyuncs.com
    - 端口：3306
    - 数据库名：cli_13268724（示例）
    - 用户名：cli_13268724（示例）
    - 密码：ekiji17jd02jk9md（示例）

### WPS 多维表格连接数据库

1. 打开 WPS，新建多维表格  
    进入 WPS，选择「新建」→「多维表格」。 ![展示WPS Office新建文档的下拉菜单，含文字/演示/表格/PDF等Office文档、智能文档及多维表格等应用服务入口。](https://blogcdnimg.clewm.net/2025/04/image-1744025104431_17440251053096.png) ![WPS多维表格新建界面，展示空白模板创建入口及热门/办公常用模板分类推荐。](https://blogcdnimg.clewm.net/2025/04/image-1744025119174_17440251200431.png)
    
2. 导入/同步数据，选择 MySQL  
    ![展示WPS多维表格中“导入/同步数据”功能的下拉菜单，突出显示MySQL数据库选项，用于说明如何从外部数据库引入数据。](https://blogcdnimg.clewm.net/2025/04/image-1744025132493_17440251333134.png)
    
3. 填入草料官方数据库信息，点击确定  
    在连接向导中，输入上一步获取的数据库主机、端口、数据库名、用户名及密码，即可建立连接。 ![编辑数据库账号的弹窗界面，用于填写阿里云RDS实例的连接信息，右侧标注提示“填写草料提供的信息”。](https://blogcdnimg.clewm.net/2025/04/image-1744025160217_17440251611235.png)

### 添加数据表

选择需要的数据表添加，添加后即可展示草料平台中的数据，数据表的名称在草料中有统一规范，需要提前了解各类数据表的说明，[查看数据表说明](/help/integration-and-connection/data-api/official-database-guide "查看数据表说明")

![MySQL数据同步配置弹窗，用于选择数据库账号、同步库及需同步的表。](https://blogcdnimg.clewm.net/2025/04/image-1744025237299_17440252381372.png)

#### 常见表说明

1. base_codeinfo
    
    - 码的基本信息表。
    - 当账号下有二维码信息时会自动推送此表，包含活码、模板子码等基础信息。 ![MySQL数据库同步配置弹窗，用于设置同步库、表、字段及记录范围，并选择自动同步频率。](https://blogcdnimg.clewm.net/2025/04/image-1744025244562_17440252449073.png) ![数据表视图界面，展示多条“灭火器检查”记录的列表，含状态、区域、模板等字段，用于数据浏览与管理。](https://blogcdnimg.clewm.net/2025/04/image-1744025262499_17440252633612.png)
        
2. template_codeinfo_XXX
    
    - 批量模板创建的子码信息表。
    - 命名规则为：template_codeinfo_DXX，其中 DXX 为批量模板编号。
    - 例如：后台批量模板编号为 M4，则对应的数据表名为 template_codeinfo_D4。
    - 该表会包含子码的可变内容信息。 ![批量活码模板列表页，展示多个模板卡片及操作选项，红色箭头指向“灭火器检查”模板。](https://blogcdnimg.clewm.net/2025/04/image-1744025287941_17440252883039.png) ![MySQL数据库同步配置弹窗，用于选择同步库、表、字段范围及记录范围，并设置同步时机后保存。

](https://blogcdnimg.clewm.net/2025/04/image-1744025276704_17440252775470.png) ![设备台账表格视图，展示灭火器等器材的编号、位置、规格、生产厂、有效期及负责人信息，支持排序筛选与数据导出。](https://blogcdnimg.clewm.net/2025/04/image-1744025296801_17440252978001.png)
        
3. code_state
    
    - 码的状态表。
    - 当二维码中有关联的状态时会推送此表。 ![MySQL数据库同步配置弹窗，用于选择同步库、表及同步范围等参数。](https://blogcdnimg.clewm.net/2025/04/image-1744025309941_17440253108666.png) ![设备巡检记录的表格视图，展示20余条巡检数据，含检查状态、运行状态等关键字段，用于查看设备巡检执行情况。](https://blogcdnimg.clewm.net/2025/04/image-1744025317557_17440253179394.png)
        
4. code_task_log
    
    - 计划执行情况表。
    - 当账号下创建计划并开始执行后，会推送该表。
    - 开通数据库后，只推送之后新开始执行的计划周期数据；历史周期、开通时正在执行的当前周期计划数据不会推送。 ![MySQL数据库同步配置弹窗，用于选择账号、库、表及同步范围与频率，支持保存或取消操作。](https://blogcdnimg.clewm.net/2025/04/image-1744025338973_17440253398815.png) ![这是“灭火器检查看板”的计划任务列表页，展示20条A1/A2/A3类灭火器检查任务的执行状态、时间及是否过期情况。](https://blogcdnimg.clewm.net/2025/04/image-1744025350122_17440253511121.png)
        
5. table_dXX
    
    - 表单数据明细表。
    - 当账号下有表单数据提交时，会推送此表。
    - 命名规则：table_ 开头，dXX 代表表单唯一编号。例如：table_d45 表示一个表单编号为 45 的数据表。 ![后台“表单”模块的列表页，展示多个业务表单及其记录数、创建时间等信息，支持按创建时间排序与批量操作。](https://blogcdnimg.clewm.net/2025/04/image-1744025369373_17440253703665.png) ![MySQL数据库同步配置弹窗，用于选择账号、库、表及同步范围与时机，并保存同步设置。](https://blogcdnimg.clewm.net/2025/04/image-1744025358685_17440253590618.png) ![这是灭火器巡检记录的表格视图，展示多条巡检数据，含时间、人员、状态等字段，支持分页与筛选操作。](https://blogcdnimg.clewm.net/2025/04/image-1744025374728_17440253750744.png)

### 创建图表

WPS 多维表可制作图表，点击「新建」→「仪表盘」，通过柱状图、折线图、条形图、饼状图等方式，完成看板设计。 ![展示数据表“table_d5”的新建操作界面，左侧菜单展开“新建”选项，右侧为该表的记录列表，含处理状态、来源等字段。](https://blogcdnimg.clewm.net/2025/04/image-1744025727649_17440257282522.png) ![仪表盘编辑页，当前无内容，提示用户点击“添加组件”以插入数据可视化元素。](https://blogcdnimg.clewm.net/2025/04/image-1744025763053_17440257633936.png) ![弹出的“添加组件”面板，展示推荐图表（柱状图、折线图等）与插件（排行榜）选项，用于向仪表盘添加可视化元素。](https://blogcdnimg.clewm.net/2025/04/image-1744025784544_17440257851704.png)

以下为部分常见统计示例：

#### 示例 1：统计灭火器总数

1. 选择「统计数字」组件；
2. 选择 template_codeinfo_XXX（批量模板创建的子码信息表）；
3. 直接统计当前模板下二维码的数量，即可得出灭火器总数。 ![配置“灭火器总数”数据图表的弹窗界面，用户可选择数据源、统计方式及明细字段后确认生成图表。](https://blogcdnimg.clewm.net/2025/04/image-1744025859845_17440258602074.png)

#### 示例 2：统计巡检次数

1. 选择「统计数字」组件；
2. 选择 table_dXX（表单数据明细表），统计表单提交的总条数；
3. 每提交一次巡检表单，即表示巡检完成一次，总条数即可代表巡检次数。 ![配置“灭火器检查次数”数据指标的弹窗界面，用于选择数据源、设置统计方式及字段显示。](https://blogcdnimg.clewm.net/2025/04/image-1744025870584_17440258709209.png)

- 折线图：  
  选择 table_dXX 表单数据明细表，根据「记录时间」进行按天/按月/按年分组统计，以查看各时间段的巡检次数变化。 ![该图展示“每月巡检次数”折线图的配置面板，用于设置数据源、维度（如记录时间）、统计值及分组方式。](https://blogcdnimg.clewm.net/2025/04/image-1744025885820_17440258861533.png)

- 柱状图：  
  选择 table_dXX 表单数据明细表，根据「记录人」进行分组统计，可查看不同巡检人员的巡检次数。 ![仪表盘中“巡检员检查情况”柱状图的配置面板，用于设置数据源、维度（如“记录人”）、统计值及分组等可视化参数。](https://blogcdnimg.clewm.net/2025/04/image-1744025899099_17440259005262.png)

#### 示例 3：统计灭火器正常/异常情况

1. 在 template_codeinfo_XXX 表中，新建字段 → 单向关联 → code_state（码的状态表） ![展示数据表视图中“双向关联”字段类型的配置操作界面，含字段名输入、类型选择及关联设置选项。](https://blogcdnimg.clewm.net/2025/04/image-1744025922002_17440259232801.png)
    
2. 关联方式选择自动匹配，两表中均包含 code_id，关联后可获取子码对应的状态信息 ![展示数据表关联配置界面，用户正通过“自动匹配”方式将 code_state 表与另一表按 code_id 字段建立单向关联。](https://blogcdnimg.clewm.net/2025/04/image-1744025936367_17440259374527.png)
    
3. 添加饼状图，在分组字段中选择需要统计的状态字段 ![该图展示数据可视化配置界面，用户正通过下拉菜单选择数据源（如 template_codeinfo_d4），并关联维度字段（如 code_state）以构建饼图。](https://blogcdnimg.clewm.net/2025/04/image-1744025951145_17440259522133.png)
    
4. 点击图表中的扇形区域可查看明细数据 ![弹窗展示“明细数据”表格，含筛选排序功能与多列信息，用于查看具体记录详情。](https://blogcdnimg.clewm.net/2025/04/image-1744025972073_17440259730437.png)

#### 示例 4：统计计划完成情况

1. 在 code_task_log（计划执行情况表）中新建字段 → 单向关联 → template_codeinfo_XXX ![展示数据表管理界面，左侧导航栏选中“code_task_…”表，右侧为该表记录列表及字段配置面板，含新增字段、时间/联系人等类型选项。](https://blogcdnimg.clewm.net/2025/04/image-1744026162176_17440261631554.png)
    
2. 关联方式选择自动匹配，同样使用 code_id 字段进行关联 ![展示数据关联配置界面，重点为“自动匹配”模式下通过 code_id 字段将源表与 template_codeinfo_d4 表建立关联的设置过程。](https://blogcdnimg.clewm.net/2025/04/image-1744026170347_17440261707032.png)
    
3. 添加饼状图，通过筛选日期和状态，查看指定时间内的计划完成情况 ![图表配置界面，展示“未命名图表”数据筛选与样式设置，含数据源、筛选条件、扇区分组及排序等参数配置区域。](https://blogcdnimg.clewm.net/2025/04/image-1744026185249_17440261862145.png) ![饼图统计“灭火器月检”任务完成与未完成情况，支持按状态分组及排序配置。](https://blogcdnimg.clewm.net/2025/04/image-1744026191707_17440261920569.png)
    
4. 统计每月漏检情况：可使用折线图，并在数据筛选中，选择状态为「未完成」「超期未完成」「超期完成」等，以查看每月漏检趋势。 ![展示数据看板中“每月漏检情况”图表的筛选条件设置界面，支持按计划名称、状态等维度筛选，并可配置数据范围与图表样式。](https://blogcdnimg.clewm.net/2025/04/image-1744026201405_17440262026410.png) !

[图表配置面板，用于设置“每月漏检情况”折线图的数据源、维度、统计值及分组等参数。](https://blogcdnimg.clewm.net/2025/04/image-1744026211215_17440262122986.png)

## 结语

通过以上步骤，您可以将草料平台收集的多源数据（二维码、表单、状态、计划等）实时同步到 WPS 多维表格中，并灵活创建可视化图表和看板，满足多种业务分析需求。  
如有更多疑问，可查看以下链接：

- 草料帮助中心(/help/integration-and-connection/data-api/official-database-guide)
- 金山文档多维表官方帮助文档(https://365.kdocs.cn/l/csygTcClRakR)

提示：由于草料数据库的推送与实际使用场景密切相关，建议在二维码已有数据产生后再去制作可视化看板，确保您获取到的信息更为完整和实时。