# SuperPage交互-OCR识别

SuperPage中提供了OCR识别交互，利用互联网上的OCR服务（使用OCR服务需要系统配置好外部服务信息，在系统设置>更多>外部服务>文字识别中启用相应服务并添加对应参数，可参考文档文字识别）识别证件图片中的文字信息。如点击按钮上传身份证照片后获取身份证号码和姓名：

OCR识别

# 使用OCR识别身份证

OCR识别交互执行过程中会依次执行如下流程：

获取用户的证件图片，通过附件组件或者直接上传，具体见支持的文件类型。
压缩并上传图片给互联网OCR服务。
获取互联网OCR服务返回的信息并设置给指定的参数，此时用户可以根据识别信息进行数据库查询以便校验识别结果的合法性，根据用户设置的校验公式进行校验，校验失败会提示用户并不再执行下面的步骤，具体见对返回的信息做数据校验。
设置识别结果和数据库查询结果给参数、输入组件、或者给指定数据集增加一行数据，可参考将识别返回信息设置给参数或组件。
完成识别。

如下是使用上传身份证按钮识别身份证信息的具体步骤：

识别身份证

添加上传身份证正面照按钮：在组件区>常用分组下将按钮组件拖入到画布中，可参考文档按钮。
添加OCR识别交互：选中按钮，在属性栏>交互下点击添加动作，选择OCR识别。
设置交互属性：
1. 设置识别的文件类型为上传图片、设置识别设备为阿里云证照识别，场景为身份证。
2. 将返回信息设置给参数或组件：勾选将返回内容设置给参数，并点击组件设置添加目标组件和值。

OCR识别的来源文件包括上传图片、附件组件，在OCR识别交互下的文件属性中选择对应的文件类型即可：

TIP

上传的图片会保存在工作目录workdir的\clusters-share\upload-files路径下

OCR识别提供了2种证照识别设备，包括阿里云证照识别、百度证照识别。在OCR识别交互下的设备属性中选择即可，证照识别设备不同可识别的证照场景也不同：

TIP

不同的证照场景返回内容的辅助输入结果不一致，可参考将识别返回信息设置给参数或组件

通过OCR识别返回的信息，可以设置给全局参数或者页面中的组件，组件设置的值类型可选表达式或辅助输入结果：

表达式：当选择表达式时，可以通过输入表达式函数获取交互结果的值，如使用PARSE_JSON()函数获取交互数据中的姓名PARSE_JSON([事件].[交互数据],'姓名')
辅助输入结果：即通过OCR识别返回的结果，辅助输入结果返回的值与识别的证照场景相关：
- 身份证：姓名、性别、民族、出生、住址、公民身份号码
- 驾驶证：姓名、性别、住址、证号、国籍、准驾车型、初次领证日期、出生日期、有效期限、至
- 行驶证：号牌号码、车辆类型、所有人、住址、使用性质、品牌型号、车辆识别代码、发动机号码、注册日期、发证日期
- 银行卡：银行卡卡号、有效日期、银行名称、银行卡类型
- 二维码：类型、文本
- 营业执照：社会信用代码、经营范围、单位名称、证件编号、注册资本、法人、地址

OCR交互支持对返回的信息做数据校验。在数据校验开始前和校验后两个阶段，都可以将返回的信息填充到参数或组件，而校验通过的数据才可填充到组件或插入到数据集中，校验设置如下：

数据校验

校验表达式：在校验表达式中可输入校验公式，如校验识别的证件ID（公民身份号码）不为空且数据集中不存在该条数据，表达式示例len(filter(select([OCR识别信息].[证件ID]),[sfz_baidu_id]=@))=0 AND [sfz_baidu_id] is not NULL
校验成功提示设置：勾选校验成功提示并输入提示信息内容即可，如上传成功！
校验失败提示设置：校验表达式返回是false，则校验失败。勾选校验失败提示并输入提示信息内容即可，如身份信息已存在，或公民身份号码未获取到，请上传有效的证件图片！