1 业务场景

1.1 背景介绍

苍穹平台预置了多个国家地区的个人证件号码的正则表达式，可以对号码的长度、字符排列等进行基本格式校验。很多国家的证件号码有较为复杂的编码规则或校验逻辑。

在具体业务应用场景中，对于个人证件号码的校验可能有更高要求。不仅要做长度和字符排列等基本格式校验，还要校验号码是否完全符合某个国家或地区的个人证件号码编码规范，或者需要对接第三方验证系统以验证号码是否真实有效。对于这类场景需求，基于正则表达式验证很可能就不能满足了。

这个时候，可以尝试通过个人证件号码校验扩展解决方案来实现更复杂的校验。

个人证件号码格式配置，请参考：个人证件号码格式。

1.2 场景描述

以中国身份证号码为例，用户在单据中输入证件号码后，通过调用苍穹平台提供的证件号码接口，可以基于预置的中国身份证号码校验正则表达式，对号码长度和特殊字符进行校验。但在很多应用场景中，很可能会需要根据中国身份证号码的编码规则，对身份证号码进行更充分的有效性校验，例如对出生日期和最后一位校验码进行有效性校验等。

下面将以这个场景为例，介绍如何通过个人证件号码校验扩展解决方案，来满足更复杂的校验需求。

个人证件号码接口，请参考：个人证件号码接口。

2 解决方案

基于苍穹5.0的扩展场景功能，业务可以通过插件扩展出更多适用于本地化要求的证件号码校验规则。

3 操作步骤

3.1 查找业务扩展场景

路径：【配置工具】→【业务扩展】→【业务扩展场景】

搜索业务场景编码“BOS_I18N_ID_NUMBER_CHECK”，获取对应的扩展场景插件接口。

3.2 实现业务扩展插件

基于扩展场景插件接口说明(见步骤3.1)，自定义证件号码校验规则插件。示例如下：

3.3 注册业务扩展插件

路径：【配置工具】→【业务扩展】→【业务扩展插件】

注意：注册后需启用才能生效。

3.4 证件号码字段校验

示例：对同一个身份证号码(110101190001011001)进行合法性校验

当未启用业务扩展插件时，校验该号码，接口提示：

当启用业务扩展插件时，校验该号码，接口提示：

4 参考资料

• 基于业务场景的插件扩展方案介绍