# 通过华为云Astro轻应用中的连接器上传并识别身份证图片 #### 期望实现效果 华为云Astro轻应用封装了不同类型的连接器用于对接其他服务，对接后即可在应用中使用该服务。例如，通过连接器对接OCR后，可识别某用户上传到华为OBS上的身份证图片的全部信息。 图1在页面提交身份证信息 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002178727045.png "点击放大") 图2成功识别图片 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001926479440.png "点击放大") #### 功能实现方法 1. 准备工作。 - 需要拥有一个华为账号或一个可用于访问OBS的IAM用户，即先注册华为云并实名认证、创建IAM用户、充值以及购买资源包，具体操作请参见[使用OBS前需要做的准备工作](https://support.huaweicloud.com/qs-obs/obs_qs_0001.html)。 - 获取AK（Access Key ID）、SK（Secret Access Key），即访问密钥对，具体操作请参见[获取AK/SK](https://support.huaweicloud.com/devg-apisign/api-sign-provide-aksk.html)。 - 已在华为OBS上，创建存储桶（例如"appcubecn4"），用于后续存储对象使用，具体操作请参见[如何创建桶](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829088.html)，请记录创建桶时选择的区域。 2. 创建一个低代码应用。 1. 参考[授权用户使用华为云Astro轻应用并购买实例](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_9046.html)中操作，申请华为云Astro轻应用免费试用或购买商业实例。 2. 实例购买后，在华为云Astro轻应用服务控制台的"主页"中，单击"进入首页"，进入应用开发页面。 3. 在"应用"中，单击"新建低代码应用"或单击![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002134818046.png "点击放大")，进入新建低代码应用页面。 首次创建应用时，请根据界面提示创建一个命名空间。命名空间一旦创建，不能修改和删除，创建前请确认好相关信息。建议使用公司或团队的缩写作为命名空间。 4. 在新建低代码应用页面，应用类型选择"标准应用"，单击"确定"。 5. 输入应用的标签和名称，单击"新建"，即可进入应用设计器。 图3创建一个空白应用 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002170372113.png "点击放大") 表1新建空白应用参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 标签 | 新建应用的标签，长度不能超过80个字符。标签是应用在系统中的唯一标识，创建后不支持修改。 | 我的第一个应用 | | 名称 | 新建应用的名称，输入标签值后单击该参数的输入框，系统会自动生成应用的名称，同时自动在名称前，添加***命名空间***__。命名要求如下： - 长度不能超过31个字符，包括前缀命名空间的长度。 名称前的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 - 必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不允许以下划线结尾。 | A | 3. 创建一个OBS连接器。 1. 在应用设计器中，选择"集成"，单击"连接器"下的"连接器实例"。 2. 在存储中，选择"OBS"，单击"+"，进入创建OBS页面。 3. 输入基本信息并添加桶，单击"保存"。 图4设置基本信息 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002142526430.png "点击放大") 图5添加桶 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001992588829.png "点击放大") 表2新建OBS连接器参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 名称 | 新建OBS连接器的名称。命名要求如下： - 长度不能超过64个字符，包括前缀命名空间的长度。 标识前模糊掉的内容为命名空间，在华为云Astro轻应用中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 - 必须以英文字母开头，只能由英文字母，数字和单下划线组成，且不能以下划线结尾。 | uploadMod | | 鉴权方式 | 根据实际情况选择鉴权方式： - 选择AK/SK方式：需先获取访问密钥，并手动输入AK/SK。 - 选择委托授权方式：需统一授权，无需再填写访问密钥。 | AK/SK | | 访问密钥 | 配置用户的访问密钥AK。 | [1]中获取的Access Key ID值 | | 密钥 | 配置与访问密钥AK结合使用的私有访问密钥SK。 | [1]中获取的Secret Access Key值 | | 桶 | 设置存储桶所在的区域和桶名称。 | 区域选择"华北-北京四"，桶名称为"appcubecn4"，即[1]中提前创建的桶 | 4. 创建对象orcTry，用于存放图片URL等信息。 1. 在应用设计器的左侧导航栏中，选择"数据"，单击对象中的"+"。 2. 设置对象的名称和唯一标识为"orcTry"，单击"确定"。 图6创建对象orcTry ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001955872394.png "点击放大") 表3新建orcTry对象参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 对象名称 | 新建对象的名称，创建后可修改。 取值范围：1\~80个字符。 | orcTry | | 唯一标识 | 新建对象在系统中的标识，创建后不支持修改。命名要求如下： - 长度不能超过63个字符，包括前缀命名空间的长度。 - 必须以英文字母开头，只能由英文字母，数字和下划线组成，且不能以下划线结尾。 | orcTry | 3. 在已创建的对象中，单击![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001987673961.png)，进入对象详情页面。 4. 在"字段"页签，单击"添加"，为对象添加pictureName字段。 图7添加pictureName字段 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001955874482.png "点击放大") 表4添加字段参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 显示名称 | 新建字段的名称，创建后可修改。 取值范围：1\~63个字符。 | pictureName | | 唯一标识 | 新建字段在系统中的标识，创建后不支持修改。命名要求如下： - 长度不能超过63个字符，包括前缀命名空间的长度。 - 必须以英文字母开头，只能由英文字母，数字和单下划线组成，且不能以下划线结尾。 | pictureName | | 字段类型 | 单击![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001987754137.png)，在弹出的页面中，根据页面提供的参数解释，选择新建字段所属的类型。 | 文本 | 5. 按照上述操作，为对象添加[表5]中字段。 表5添加其他字段 | 显示名称 | 唯一标识 | 字段类型 | |:---|:---|:---| | pictureId | pictureId | 文本 | | picUrl | picUrl | 文本区 | | result | result | 文本区 | 5. 创建OCR连接器。 1. 在应用设计器中，选择"集成"，单击"连接器"下的"连接器实例"。 2. 在AI中，选择"OCR"，单击"+"，进入创建OCR页面。 3. 输入基本信息，单击"保存"。 图8设置基本信息 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001955875022.png "点击放大") 表6新建OCR连接器参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 名称 | 新建OCR连接器的名称。命名要求如下： - 长度不能超过63个字符，包括前缀命名空间的长度。 - 必须以英文字母开头，只能由英文字母，数字和单下划线组成，且不能以下划线结尾。 | newOcr | | 区域 | OCR服务的区域。 | 华北-北京四 | | 访问密钥ID | 访问密钥ID和访问密钥一起使用，对请求进行加密签名。 | 参考[1]中操作获取，配置为"AK"的值 | | 访问密钥 | 访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 | 参考[1]中操作获取，配置为"SK"的值 | 6. 创建脚本，用于提交图片信息以及OCR接口识别图片内容。 1. 在应用设计器中，选择"逻辑"，单击脚本后的"+"。 2. 新建一个空白脚本，脚本名称为octTryTs。 图9新建octTryTs脚本 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000002134946212.png "点击放大") 3. 在脚本编辑器中，输入如下示例代码。 ``` //本脚本用于提交图片信息以及调用ocr接口识别图片内容 import * as db from 'db';//导入处理object相关的标准库 import * as context from 'context';//导入上下文相关的标准库 import * as ocr from 'ocr'; //定义入参结构 @action.object({ type: "param" }) export class ActionInput { @action.param({ type: 'String', required: true, label: 'String' }) proId: string; @action.param({ type: 'String', required: true, label: 'String' }) proName: string; @action.param({ type: 'Any', required: true, label: 'Any' }) url: any; } //定义出参结构，出参包含1个参数，workOrder的记录id @action.object({ type: "param" }) export class ActionOutput { @action.param({ type: 'String' }) id: string; @action.param({ type: 'String', required: true, label: 'String' }) url: string; } //使用数据对象命名空间__orcTry__CST @useObject(['命名空间__orcTry__CST']) @action.object({ type: "method" }) export class CreateWorkOrder { //定义接口类，接口的入参为ActionInput，出参为ActionOutput @action.method({ input: 'ActionInput', output: 'ActionOutput' }) public createWorkOrder(input: ActionInput): ActionOutput { let cli = ocr.newClient("命名空间__newOcr"); //创建连接器实例 let out = new ActionOutput(); //新建出参ActionOutput类型的实例，作为返回值 let error = new Error(); //新建错误类型的实例，用于在发生错误时保存错误信息 try { let url = "https://appcubecn4.obs.cn-north-4.myhuaweicloud.com/" + input.url[0]['originalUrl']; // 拼接成完整的图片url信息 let resp = cli.idCardWithURL(url, "front"); // 调用ocr接口，front表示识别身份证正面 let productData = new Object(); productData['命名空间__pictureName__CST'] = input.proName; //将入参赋值给productData变量，方便后面使用 productData['命名空间__pictureId__CST'] = input.proId; productData['命名空间__picUrl__CST'] = url; productData['命名空间__result__CST'] = JSON.stringify(resp['result']); let s = db.object('BJ4__orcTry__CST'); //获取命名空间__orcTry__CST这个Object的操作实例 let id = s.insert(productData); if (id) { out.id = id; out.url = url; } else { error.name = "WOERROR"; error.message = "Unable to create pic!"; throw error; } } catch (error) { console.error(error.name, error.message); context.setError(error.name, error.message); } return out; } } ``` 4. 单击![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001926661746.png)，保存脚本，保存成功后单击![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001953740689.png)，激活脚本。 7. 新建页面模型。 1. 在应用设计器中，选择"界面"，单击页面后的"+"，新建一个标准页面。 2. 在标准页面底部，单击"模型视图"。 3. 单击"新增模型"，输入模型名称（如orcNew）、"来源"选择"服务"，单击"下一步"。 图10新建模型 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001926739962.png "点击放大") 4. 选择[6]中创建的脚本，单击"确定"后，再单击"下一步"。 图11选择脚本 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001992476149.png "点击放大") 5. 直接单击"确定"，完成模型的创建。 8. 创建图片上传表单页面。 1. 在标准页面中，拖入2个输入框组件、1个按钮和1个上传组件。 2. 将输入框标签分别修改为"name"和"id"，将按钮显示名称设置为"添加"。 图12表单最终设置效果 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001992597217.png "点击放大") 3. 选中name输入框，在"属性 \> 数据绑定 \> 值绑定"中，单击![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001926904898.png)。 4. 选择[7]中创建模型中的proName字段，单击"确定"。 图13选择proName字段 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001955884978.png "点击放大") 5. 选中id输入框，在"属性 \> 数据绑定 \> 值绑定"中，单击![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001963409469.png)。 6. 选择[7]中创建模型中的proId字段，单击"确定"。 图14选择proId ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001955890398.png "点击放大") 7. 同样，按照上述操作，为上传组件绑定模型，并设置存储信息。 图15为上传组件绑定模型 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001992490365.png "点击放大") 图16设置存储信息 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001955895252.png "点击放大") 9. 为添加按钮，添加事件。 1. 选中添加按钮组件，选择"事件"页签。 2. 单击"点击"后的"+"，进入添加动作页面。 3. 在自定义动作中，输入自定义代码，单击"保存"。 图17自定义动作 ![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001955896948.png "点击放大") 其中，"orcNew"为[7]中创建模型的名称。 ``` $model.ref('orcNew').run().then(function(data){ console.log(data); }).catch(function(error){ console.log('error is', error); }); ``` 10. 返回标准页面，单击![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001953945029.png)，保存页面，保存成功后单击![](https://support.huaweicloud.com/bestpractice-astrozero/zh-cn_image_0000001954064801.png)，预览效果。