自定义模板识别
前面几篇文档中我们介绍了几种主流的卡证识别的前端事件配置方法,在这一篇教程中我们将主要介绍「自定义模板识别」的配置方法,使用它可以轻松对各类非标准的文件进行文字识别!点击体验效果
购买接口
首先,我们需要先找到一个自定义识别模板的接口,以阿里云官方提供的自定义模板识别接口为例:
我们先购买一个500次的免费体验版本,然后可以在控制台-云市场-已购买的服务中看到我们的AppCode,这是用来调用接口的凭证(后面会用到)。
接口分析
然后我们回到刚刚接口的界面,详细地分析下这个接口:
请求方式:POST
返回类型:JSON
接口的URL:http://ocrdiy.market.alicloudapi.com/api/predict/ocr_sdt 或 https://ocrdiy.market.alicloudapi.com/api/predict/ocr_sdt
请求的Headers(服从阿里云云市场的标准鉴权方式):Authorization: APPCODE + 半角空格 + 你自己的APPCODE
请求的Body:这个页面写的不够详细,查看自定义模板识别产品文档,可以发现这个接口同时支持单模板和多模板两种方式,我们以单模板为例进行讲解,则此处body内容包括需要识别的图片和模板ID,这个模板ID会在我们设置好自定义识别模板后得到。
返回的示例数据:
设置自定义模板
自定义模板识别的使用与其他文字识别的不同在于需要提前设置好模板,下面我们以一张拟制的设备详情单为例,设置我们的自定义模板。
假设我们有多张这样的设备详情单,包含设备编号、设备名称、所属组织、责任人以及其他备注这几项,格式相同,那么我们设置好一个识别模板,之后就可以调用前端事件识别这一类文件。
回到刚刚的接口页面,点击下方的“一键管理模板”,进入模板管理界面。
点击“创建模板”,上传我们刚刚用作示例的图片。
之后,根据模板设置规则,分别框出不变的参照锚点(下图红色框中所示内容),以及需要识别的内容(下图蓝色框中所示内容)。
点击保存并发布,一个自定义模板就制作好了,这个模板ID在我们配置前端事件时会用到。
配置前端事件
下面,我们正式进入接口的配置环节。首先在表单中添加好触发字段(该字段的值改变就会去触发调用接口)以及返回字段(将调用接口的值写入返回字段里),由于我们这里是OCR识别,所以触发字段为图片字段,其他字段为单行文本字段。
下面我们设置触发字段;
按照上面的分析:
- 选择请求类型为: POST
- URL为: http://ocrdiy.market.alicloudapi.com/api/predict/ocr_sdt 或 https://ocrdiy.market.alicloudapi.com/api/predict/ocr_sdt
- 返回值格式为: JSON
然后我们进入Header/Body的设置:
Header为Authorization: APPCODE + 半角空格 + 你自己的APPCODE
Body如下图所示。其中需要说明的是,刚刚我们看到的详细的产品文档中只写了image需要是Base64格式的数据,但实际上经过测试,图片的url地址也是可以的,所以这里可以直接设置。另外,template_id中对应的就是我们刚刚设置好的自定义模板里的模板ID。
设置返回值:
在触发字段(图片字段:设备详情单图片)的值发生改变后,简道云会自动调用我们上面配置的接口,来识别图片中的信息,识别出的数据会按上述固定的格式返回给简道云,我们需要根据JsonPath规则,提取出返回值中的数据放入对应的字段。
效果展示
按照上述过程,我们已经完成了一个自定义模板识别的前端事件配置,现在来看看效果吧。点击体验效果
您也可以尝试根据此教程设置自己的自定义模板,并配置前端事件。