1. 组件介绍
必要前置组件:无
建议后置组件:条件分支(可通过分支条件判断OCR能力是否调用成功并设计后续对应流程)
利用本组件可以使用OCR技术对二代身份证正反面的各种字段进行识别(示例)。
2. 输入项
请参照可视化编辑器内组件面板中各输入项的帮助信息
3. 输出项
请参照可视化编辑器内组件面板中各输出项的帮助信息
3.1. 接口关键返回结果
该输出项以字典形式返回接口中的关键识别结果字典,字典中包含的键值说明如下
key | key含义 | value数据类型 |
type | 类型(正面face\反面back) | 字符串 |
name | 姓名(正面) | 字符串 |
sex | 性别(正面) | 字符串 |
ethnicity | 民族(正面) | 字符串 |
birthDate | 出生日期(正面) | 字符串 |
address | 住址(正面) | 字符串 |
idNumber | 身份证号码(正面) | 字符串 |
issueAuthority | 签发机关(反面) | 字符串 |
validPeriod | 有效期限(反面) | 字符串 |
3.2. 错误信息
该输出项以字符串的形式返回错误码与错误信息,详细说明请参照读光OCR错误中心
https://next.api.aliyun.com/document/ocr-api/2021-07-07/errorCode
4. 组件使用示例
4.1. 组件配置示例
在“AI引擎”中,选择“阿里云文字识别(OCR)”。
在“待识别图片文件路径”中,填写您希望识别图片的文件路径(本例中以下图为例) 。
高级选项保持默认值。
4.2. 示例执行结果
5. 流程示例
5.1. 搭建流程
利用OCR身份证识别组件,选取待识别图片文件路径 。
利用条件分支组件,通过分支条件( v_recognize_table_success_1 等于值(布尔值)True )判断该OCR能力是否调用成功。
利用记录日志组件,在调用失败的条件分支中,打印错误信息 。
利用获取指定key的值组件,在调用成功的条件分支中,获取接口关键返回结果字典v_recognize_table_data_1中type的值(type为证件类型:face-正面,back-反面)。
利用条件分支组件,通过分支条件(type变量等于值(字符串)face )判断该证件的类型为正面,增加分支条件(type变量等于值(字符串)back )判断该证件的类型为反面。
利用获取指定key的值组件,在分支条件-1(face分支)调用成功的条件分支中,获取接口关键返回结果字典v_recognize_table_data_1中指定key的值(以name-姓名为例)。
利用记录日志组件,打印获取到的关键识别结果。
利用获取指定key的值组件,在分支条件-2(back分支)调用成功的条件分支中,获取接口关键返回结果字典v_recognize_table_data_1中指定key的值(issueAuthority/validPeriod)。
利用记录日志组件,打印获取到的关键识别结果。
利用记录日志组件,在默认分支记录v_recognize_table_data_1的值。
5.2. 执行结果
如下图所示,该OCR能力成功被调用后,在日志面板中打印识别结果 。