格言格语/离线填报

下发到 HAC

在联网页面中把离线表单项目下载到设备,并可选地把说明 PDF 一并绑定到表单项目。

构建与校验完成后,需要用户在联网状态下进入活字格页面,把表单项目保存到 HAC。本节涉及“下载离线表单”和“下载离线表单说明 PDF”两个命令。

这两个命令都支持异步。异步命令默认提供两个隐藏异步结果变量:

  • IsSuccess:操作是否成功。
  • Error:失败时的错误信息。

页面可以利用这两个变量提示用户,或继续执行后面的命令。

下载离线表单命令

命令名称:下载离线表单

作用:将“构建离线表单”命令生成的 Pattern JSON 下载到设备端,保存为设备上的离线表单项目。命令支持异步,通过隐藏异步结果变量 IsSuccessError 触发后续动作。

命令参数:

参数说明
离线表单JSON通常使用“构建离线表单”命令生成的 JSON,必填。

命令执行行为:

  1. 先解析并校验离线表单 JSON;校验失败时提示错误,不执行下载。
  2. 为每个表单项补充 updateTime
  3. 调用 HAC 下载离线表单项目并保存在本地。
  4. 完成后通过 IsSuccessError 触发后续异步命令。
图片占位
下载页面命令编排示意

建议准备一张活字格在线页面截图,展示构建变量、检测变量、下载命令以及 IsSuccess/Error 后续提示的完整编排。

页面只需要展示给现场人员的最终状态,错误分支可以放同一张图下方或第二张截图。

下载命令会为表单自动补充 ticket 与表单项的 updateTime,因此构建 JSON 时不需要手工维护这两个运行时字段。

下载离线表单说明 PDF

命令名称:下载离线表单说明 PDF

作用:将一个或多个说明 PDF 下载到设备,并绑定到指定的离线表单项目,通常用于说明文档节点。

命令参数:

参数说明
项目编号要绑定说明 PDF 的离线表单项目编号,必填。
说明 PDF 附件传入服务器上的说明 PDF 附件路径,必填。命令会根据路径自动获取附件资源,也支持指定页面单元格获取。

附件路径支持使用英文竖线 | 分隔多个附件标识,例如 fileA|fileB|fileC。命令会将每个附件标识转换为下载地址并逐个下载,全部完成后才触发成功回调。

图片占位
HAC 端已下载表单列表

建议准备一张 HAC 移动端截图,展示已下载的离线表单项目列表、说明 PDF 入口和下载完成状态。

可使用纵向手机截图;如涉及示例业务数据,请使用测试任务编号。

本页目录