# 消防巡检、设备巡查：如何快速知道谁、哪里没做巡检 适用于消防巡检、设备巡查、资产盘点等需要按周期确认谁没做、哪里没做的场景。草料可通过周期填写任务、计划管理或二维码统计，帮助管理员从已完成记录反推出未完成清单。 ## 这篇文档解决什么 固定周期的巡检计划下达后，管理员真正要盯的不是谁做了，而是谁没做、哪里没做。 难点在于：已完成的巡检会产生一条扫码记录，漏做的不会产生任何数据。翻记录只能看到做过的，反查不出漏的。要定位漏做，必须先有一份应做清单，再和实际记录比对。 草料提供三种方式。用哪一种，取决于你当前启用了哪个功能。 ## 先确认你用的是哪个功能 - 你已启用的功能：周期填写任务（新版，推荐）；看板查看：手机端周期视图；导出未完成明细：支持，手机端工作台内导出；对应章节：方式二 - 你已启用的功能：计划管理（旧版）；看板查看：手机端计划报表；导出未完成明细：看板不支持，需对接数据库；对应章节：方式一 - 你已启用的功能：都未启用；看板查看：PC 后台表单的二维码统计；导出未完成明细：支持，PC 后台直接导出；对应章节：方式三 官方对两个功能的定位是：周期填写任务是计划管理的升级版或精细化版本。计划管理体验较基础，扫码后感知不强，更多依靠管理员事后查报表；周期填写任务有倒计时、有状态标签，对一线员工的执行驱动力更强。两者不冲突，新用户推荐直接使用周期填写任务。 直白地说：计划报表和周期视图都只在手机端，PC 后台里找不到。要在电脑上看，只有方式三，或者走数据库对接。 ## 方式一：已开启「计划管理」 ### 1. 手机端查看计划报表 查看路径：微信搜索草料二维码小程序 → 工作台 → 计划报表。 管理人员在这里可以看到计划执行情况：按期完成、未完成、即将超期等；也会收到即将超期提醒，统计哪些设备的巡检任务还没完成。 两条提醒机制的边界要先知道： - 提醒人只支持设置账号下的高级成员。成员收到的是整个计划下所有二维码的即将超期情况，不能拆分成某个码即将超期推送给指定某个人。 - 已经到期但未完成的计划，不支持推送消息提醒，只支持即将超期提醒。已到期的执行情况请通过手机端计划报表查看。 限制：计划报表的数据不支持导出。只能在小程序里看，落不成表格。要导出请走下面的数据库对接。 ### 2. 对接官方数据库读取（需要导出、需要做表时用） 对接后读取 code_task_log 计划执行情况表。 该表在账号下创建计划并开始执行后才会推送。表中没有码名称信息，需要关联 base_codeinfo 或 template_XXX 扩充码的信息。 关键字段： - 状态：可选值：完成 / 未完成 / 即将超期 / 超期完成 / 超期未完成 - code_id：码的唯一标识，用来关联出码名称、位置 - 计划名称、开始时间、截止时间：定位是哪个周期 - 是否过滤：根据是否设置无需检查的条件进行过滤 筛选未完成 / 超期未完成，就是这一周期的漏检名单。 WPS 教程里有现成做法：用折线图，在数据筛选中选择状态为未完成超期未完成超期完成，即可查看每月漏检趋势。 历史数据边界见下方官方数据库对接的共同前提。 ## 方式二：已开启「周期填写任务」 适用范围：无论是单独一个二维码，还是一批二维码（如 100 个灭火器），都可以使用。免费版即可使用。 ### 1. 手机端查看与导出 先进入小程序：微信搜索草料二维码小程序 → 工作台。工作台内有两个入口，用途不同： - 入口：当前周期填写任务；路径：工作台 → 当前周期填写任务；适合谁：一线员工看今天的待办；管理员在这里批量处理任务 - 入口：周期视图；路径：工作台 → 表单数据 → 目标表单 → 周期视图；适合谁：管理员看整体完成率，揪出哪些任务没做、哪些超期完成 周期填写任务的执行情况数据支持导出，在手机端工作台内操作。 两条边界： - 看板只有手机端，电脑端不支持。 - 当前周期填写任务的个人看板只展示与该员工相关的任务。只有该员工被设置为任务的提醒对象，或拥有码管理员权限，任务才会显示。员工反馈看板为空时，先检查是否已加入提醒对象。 ### 2. 对接官方数据库读取 需要把未完成数据接进 BI、做长期趋势、或和其他系统打通时用。 周期填写任务相关的表有多张，按用途选： - 表名：cycle_task_entity_task；用途：保存具体到每个码的周期执行情况，适合做任务闭环明细分析。这是查哪个点位没做的主表 - 表名：cycle_task_instance；用途：保存每轮周期填写任务的聚合统计结果，适合分析完成率、超时率、跳过率。这是查整体完成率的表 - 表名：cycle_task；用途：周期计划下每一轮实际执行的周期填写任务，用于定位周期时间片 cycle_task_entity_task 关键字段：code_id 目标码 ID、execute_status 执行状态（完成 / 未完成 / 跳过）、execute_time 实际执行时间。筛选 execute_status = 未完成，再用 code_id 关联 base_codeinfo 取出码名称和位置，就是漏做点位清单。 注意：如果源数据不存在或状态为删除，会删除该条数据；状态为隐藏时不会删除，仍会同步。任务被删除或进入暂停并删除状态时，会级联删除该任务下的实例和实体任务数据。 ## 方式三：计划和周期填写任务都未启用 用表单的二维码统计视图反查。 操作路径：PC 后台 → 左侧【表单】→ 打开对应表单 → 数据与统计 → 二维码统计。 这个视图统计该表单在每个关联二维码的周期性填写数，支持填写总数、每月、每周、每日进行查看，可根据时间范围、关联的批量模板、关联的二维码筛选。官方明确它适用于设备巡检、区域巡查、资产盘点等场景，可以查看每个二维码被检查或盘点的情况。 点击某个数值，可以直接筛查出该数值对应的明细数据，该筛选数据支持导出。 用法：按周期筛选后，看每个二维码的填写数。填写数为 0 的码，就是该周期没做的点位。 这个方式不依赖计划或周期填写任务，也是唯一能在电脑端直接完成的。代价是没有应做清单，系统不会主动标记未完成，需要你自己看哪些码是 0。 ## 官方数据库对接的共同前提 方式一和方式二的数据库读取都依赖这一步，开通一次，两类表都能读。 开通入口：草料后台导航栏【数据管理】→【数据 API】→【官方数据库】，填写申请信息后自动开通并推送数据。首次推送需要 1~3 小时，具体看你后台已有的数据量。 基本性质：只读数据库，不可编辑；类型为 MySQL 5.7；实时同步码信息、表单记录、状态明细、计划完成明细等数据。 推送条件：数据会根据你在草料设置的功能来推送。后台添加了计划并执行后，才会推送 code_task_log；未设置相关功能或无数据产生时不会推送。只有产生了实际业务数据后，相关数据表才会创建并开始同步。只创建批量模板和表单、没有填写数据，是不会创建数据表的。 历史数据边界（重要）：计划和周期填写任务的数据表都只推送对接完成之后新产生的周期数据，此前的历史周期数据不会推送。如果需要历史数据，请联系草料官方单独处理。 读取工具：最简单的是 WPS 多维表格。WPS 多维表格现已支持连接数据库（限时免费），教程见 [WPS 多维表格连接数据库](https://cli.im/help/101176)。也可以用飞书，但飞书多维表格免费版只能推送三张数据表，数据同步上限 1000 行，超出需购买高级版或企业版，教程见 [飞书多维表格连接数据库](https://cli.im/help/101574)。完整的数据表字段说明见 [官方数据库说明](https://cli.im/help/62995)。 ## 三种方式怎么选 - 用周期填写任务，只是想拿到本周期的未完成名单：手机端工作台内看周期视图并导出，不用开数据库。 - 用计划管理，需要导出名单：只能走数据库对接，读 code_task_log 筛选未完成 / 超期未完成。 - 需要长期趋势、跨月漏检分析、或接入 BI：走数据库对接。注意历史数据不推送，越早开通越好。 - 两个功能都没开，也不打算开：用方式三的二维码统计，筛选周期后看填写数为 0 的码，可直接导出。 - 新账号从零开始搭：直接用周期填写任务，不必再用计划管理。 ## 常见问题 为什么已完成的记录能查，没完成的查不到？ 扫码提交才会生成记录。没做的点位不会产生任何数据。要定位漏做，必须靠计划或周期填写任务这类预设了应做清单的功能来反算，或者用点位清单去比对表单记录。 对接数据库后，为什么看不到以前的数据？ 计划和周期填写任务的数据表都只推送对接之后新周期的数据，历史周期数据不在推送范围内。需要历史数据请联系草料官方单独处理。 计划报表能导出吗？ 不能。计划管理的看板数据不支持导出，需要导出请走官方数据库对接，读 code_task_log。周期填写任务不受此限，执行情况数据可在手机端工作台内导出。 设备停机、点位裁撤，会不会算成漏检？ 周期填写任务支持人工干预。管理员在手机端工作台 → 当前周期填写任务 → 批量处理，把一批任务设为已完成或无需完成，支持本周期生效、限时生效、长期生效三种模式。生产线检修一周可批量设为一周内无需完成，避免产生虚假逾期；点位裁撤可设为长期无需完成。 计划管理侧对应的是过滤规则。数据表中会保留所有计划任务数据，通过是否过滤字段判断该条计划是否被过滤。注意状态变更后要在下个周期过滤才生效。 员工说手机上看不到任务？ 个人看板只展示与该员工相关的任务，需要他被设置为任务的提醒对象，或拥有码管理员权限。