• 后端使用说明

    pom 增加依赖

    在 后端服务中需要添加以下依赖,该依赖放置在 <dependencies> 标签中且在第一位;

    <dependency>
        <groupId>org.hzero.boot</groupId>
        <artifactId>hzero-boot-customize</artifactId>
        <!-- <version>0.1.1.RELEASE</version>   组件版本应该在srm-parent中维护 -->
    </dependency>
    
    • hzero-boot-customize 主要包含了个性化模型扫描REST端点以及个性化后端SQL拦截器,使用个性化插件的服务都需要依赖该boot组件
    • srm-parent中维护组件的版本号

    srm-basic-platform 服务中添加以下依赖

    <dependency>
        <groupId>org.hzero.plugin</groupId>
        <artifactId>platform-cusz-saas</artifactId>
        <version>0.1.1.RELEASE</version>
    </dependency>
    
    • platform-cusz-saas 依赖主要包含了个性化管理的后端维护代码,以插件形式打包,依托于srm-basic-platform服务运行

    Entity 类注意事项

    表中存在的字段必须声明在 Entity 类中,表中以 attribute 开头的字段无需声明,该类字段会从 AuditDomain.flex 属性中获取;

    Entity 类上需要添加 @MultiLanguage 注解,多语言字段添加 @MultiLanguageField 注解;

    不建议以 attribute 开头的字段作为多语言字段;

    DTO 类需继承 AuditDomain,且需重写 associateEntityClass() 方法,并返回对应 Entity 类的class;

    多语言字段1

    多语言字段2

    查询逻辑注意事项

    请确保在个性化配置中增加的个性化字段在后端查询的原始 SQL 中提前配置好相关表, 否则配置的个性化字段无法生效。

    主模型关联的模型在 模型配置 中维护;

    LOV 值集翻译

    若模型字段的组件类型为值集下拉框,且对应的值集时 URL值集,需要在值集中配置 翻译SQL

    例如,保存字段类型为值集的数据时,存入表中的为 code,但展示时需为 name;