1 用户场景

对于拥有港澳台身份证的人员，用户想录入苍穹人员中，但是苍穹人员只对大陆身份证进行了校验，非大陆的并没有做处理；用户想要校验港澳台地区身份证号的话，标准产品就实现不了，更加发散来说，对于外籍的人员信息，想要校验外籍的身份证信息的话，也存在这样的问题。

2 解决思路

身份证的格式和校验码，不同国家和地区都不相同。苍穹标准版对于身份证的格式和校验码是根据中国大陆身份证要求进行校验，如果需增加其它国家和地区，需要进行二次开发针对相应的校验规则进行校验处理。

3 操作步骤

主要步骤有新建一个插件类并启用，禁用标准版身份证校验的插件，具体操作流程如下。

3.1 新建一个插件类

类名例如：

UserIdCardFormatValidatorPlugin2.java

package kd.bos.sec.user;
import kd.bos.dataentity.entity.DynamicObject;
import kd.bos.dataentity.resource.ResManager;
import kd.bos.dataentity.utils.StringUtils;
import kd.bos.entity.ExtendedDataEntity;
import kd.bos.entity.plugin.AbstractOperationServicePlugIn;
import kd.bos.entity.plugin.AddValidatorsEventArgs;
import kd.bos.entity.validate.AbstractValidator;
import kd.bos.org.utils.Consts;
/**
 * 人员保存时，对身份证进行校验的插件
 * @author rd_chaohua_cheng
 */
public class UserIdCardFormatValidatorPlugin2 extends AbstractOperationServicePlugIn {
 
    @Override
    public void onAddValidators(AddValidatorsEventArgs e) {
        super.onAddValidators(e);
        e.addValidator(new UserIdCardFormatValidator2());
    }
    private static class UserIdCardFormatValidator2 extends AbstractValidator {
        @Override
        public void validate() {
            for (ExtendedDataEntity dataEntity : dataEntities) {
                DynamicObject userObj = dataEntity.getDataEntity(); // 人员实体
                // 获取身份证的值
                String idCard = userObj.getString(Consts.IDCARD);
                if (StringUtils.isNotBlank(idCard)) {
                    idCard = idCard.replaceAll(" ", "");
                    // 如果身份证输入有空格，去掉空格再写回去
                    userObj.set(Consts.IDCARD, idCard);
// 校验身份证的正确性（可校验格式及校验码），校验正确不处理。
                    // 可根据idCard的值进行一系列处理，如果校验失败就返回相应的错误信息。
// 这也是二次开发的主要部分,下面的范例只判断身份证长度的一个简单做法。
                    if (idCard.length() != 18) {
// 下面的errorMsg的值，使用了多国语的写法
                        String errorMsg = ResManager.loadKDString("“身份证号”位数不正确，请修改为18位", "UserIdCardFormatValidatorPlugin2_01", "bos-sec-user");
                        // 把错误信息加入提示语中（重要步骤）
                        addErrorMessage(dataEntity, errorMsg);
                    }
                }
            }
        }
    }
 
}

3.2 人员表单设计器修改

在开发平台的路径：系统服务云-》基础服务-》人员-》人员（页面编码：bos_user）

1）点击表单控件中的‘保存’，然后再点击‘操作代码’

2）选择‘保存’行，再点击‘修改’

3）点击‘其他控制’，再点击‘服务插件’

4）注册启用‘身份证校验二次开发插件’，并上移到‘人员保存插件’前；取消启用标准版的‘身份证校验插件’。

5）保存修改后的bos_user表单

3.3 操作验证

进入操作页面的路径：系统服务云-》基础服务-》人员管理-》人员

通过新增或修改人员进行验证。如果输入的身份证号刚好长度为18位，点击保存时，不会报身份证验证错误信息；如果输入的身份证号长度不等于18位，点击保存时，将出现插件返回的提示语。

支持了身份证校验可二开扩展校验非大陆身份证的功能

支持了身份证校验可二开扩展校验非大陆身份证的功能

恭喜您！