下发到 HAC
在联网页面中把离线表单项目下载到设备,并可选地把说明 PDF 一并绑定到表单项目。
构建与校验完成后,需要用户在联网状态下进入活字格页面,把表单项目保存到 HAC。本节涉及“下载离线表单”和“下载离线表单说明 PDF”两个命令。
这两个命令都支持异步。异步命令默认提供两个隐藏异步结果变量:
IsSuccess:操作是否成功。Error:失败时的错误信息。
页面可以利用这两个变量提示用户,或继续执行后面的命令。
下载离线表单命令
命令名称:下载离线表单。
作用:将“构建离线表单”命令生成的 Pattern JSON 下载到设备端,保存为设备上的离线表单项目。命令支持异步,通过隐藏异步结果变量 IsSuccess 与 Error 触发后续动作。
命令参数:
| 参数 | 说明 |
|---|---|
离线表单JSON | 通常使用“构建离线表单”命令生成的 JSON,必填。 |
命令执行行为:
- 先解析并校验离线表单 JSON;校验失败时提示错误,不执行下载。
- 为每个表单项补充
updateTime。 - 调用 HAC 下载离线表单项目并保存在本地。
- 完成后通过
IsSuccess与Error触发后续异步命令。
图片占位
下载页面命令编排示意
建议准备一张活字格在线页面截图,展示构建变量、检测变量、下载命令以及 IsSuccess/Error 后续提示的完整编排。
页面只需要展示给现场人员的最终状态,错误分支可以放同一张图下方或第二张截图。
下载命令会为表单自动补充 ticket 与表单项的 updateTime,因此构建 JSON 时不需要手工维护这两个运行时字段。
下载离线表单说明 PDF
命令名称:下载离线表单说明 PDF。
作用:将一个或多个说明 PDF 下载到设备,并绑定到指定的离线表单项目,通常用于说明文档节点。
命令参数:
| 参数 | 说明 |
|---|---|
项目编号 | 要绑定说明 PDF 的离线表单项目编号,必填。 |
说明 PDF 附件 | 传入服务器上的说明 PDF 附件路径,必填。命令会根据路径自动获取附件资源,也支持指定页面单元格获取。 |
附件路径支持使用英文竖线 | 分隔多个附件标识,例如 fileA|fileB|fileC。命令会将每个附件标识转换为下载地址并逐个下载,全部完成后才触发成功回调。
图片占位
HAC 端已下载表单列表
建议准备一张 HAC 移动端截图,展示已下载的离线表单项目列表、说明 PDF 入口和下载完成状态。
可使用纵向手机截图;如涉及示例业务数据,请使用测试任务编号。