扫码模型

1 使用场景

扫码模型可以应用于一些特殊的业务场景，适用于需要通过扫码获取参数值来打开某个模版页面的业务，例如设备巡检需要扫描设备上的条码或二维码来获取当前设备信息，为该设备添加巡检记录。

使用前提：扫码功能需要移动设备提供软硬件支持，目前扫码模型仅支持：①自带扫描按键功能的手持PDA设备；②在钉钉微应用内配置的扫码模型。

2 配置说明

（1）全局配置

表单模型选择“扫码模型”，配置界面如下。

• 页面标题：默认为空，必填。
• 数据连接：选配，由于该模型主要引用其他模版来显示，被引用模版中已经包含数据来源信息。扫码模型中的配置主要使用场景是模板参数使用execSql、execProcedure等函数取数或事件中执行SQL等事件。
• 参数设置：同组合模型可以定义模版的参数，配置后前端界面不显示，可以接收常量和表达式，一般可以接收例如系统变量、函数、来源于外部的参数值，一般用于向关联模版传递外部接收参数。
• 其他设置：允许配置【登录系统后才允许访问】，默认勾选

（2）模版配置

扫码模型的主要配置逻辑是通过移动设备扫码识别条码或二维码中的信息，可以将获得的信息作为其他模版页面的参数值进行传递，从而打开需要查看的页面。因此需要提前准备需要关联的模版，在扫码模型【模版配置】中进行配置。

• 扫码前加载：配置打开扫码页面时是否直接加载配置的模版页面，默认不勾选。
• 链接类型：扫码模型支持关联的模版链接类型有“跨设备表单/报表/数智大屏/系统页面/自定义链接页面”。参数值表达式支持获取扫码数据和模板参数值。

（3）扫码配置

• 扫码栏提示文字：，默认值“请扫码”，支持自定义修改。
• 扫码后事件：配置界面同其他模型的事件配置，支持的事件：钉钉消息/浙政钉消息/微信消息/企业微信消息/短信发送/SQL/存储过程/数据视图/元数据执行/系统通知。详细配置请查阅章节 事件配置。

（4）扫码值变量scanCode

在该模型下，【资源】中新增【模板变量】scanCode，表达式格式为${scanCode}，获取当前模板扫描栏组件前一次扫描获取的数据，返回值类型为字符型。

3 执行与显示

前面提到扫码模型仅支持移动设备，因此仅支持移动端界面。

（1）在钉钉微应用中使用扫码模型链接时支持直接去尝试唤起钉钉APP的扫码功能，扫码后跳转对应的模版页面；
（2）支持在扫码模型点击左上角扫码栏中的“”图标手动唤起扫码功能。
（3）支持在扫码模型扫码栏手动录入扫码值。