BP主数据屏幕增强：自定义字段的完整实现指南与避坑实践

1次阅读

共计 2858 个字符，预计需要花费 8 分钟才能阅读完成。

在企业级系统中，BP（Business Partner）主数据作为核心业务对象，往往需要根据不同业务线或地区需求扩展字段。常见场景包括：

行业特定属性（如医疗行业的执业许可证号）
区域合规字段（如欧盟的 GDPR 相关标识）
临时业务标记（如促销活动参与状态）

传统硬编码字段的方式会导致：

频繁发版影响系统稳定性
不同团队需求冲突
历史数据迁移成本高

ALTER TABLE bp_entity ADD COLUMN custom_field1 VARCHAR(255);

优点：
– 查询性能最佳
– 强类型支持

缺点：
– 需停机维护
– 字段数量有限制

@Entity
public class BPEntity {@Column(columnDefinition = "json")
    private String customFields; // {"field1":"value1"}
}

优点：
– 动态扩展性强
– 无需修改表结构

缺点：
– 索引支持有限
– 复杂查询性能差

CREATE TABLE bp_custom_fields (
    bp_id BIGINT,
    field_name VARCHAR(50),
    field_value TEXT,
    PRIMARY KEY (bp_id, field_name)
);

优点：
– 支持完善权限控制
– 可记录变更历史

缺点：
– 联表查询开销大
– 事务管理复杂

@Entity
public class CustomFieldDefinition {
    @Id
    private String fieldCode;
    private FieldType type; // ENUM: STRING,NUMBER,DATE
    private String defaultValue;
    private boolean required;
}

@Entity
public class BPCustomField {
    @EmbeddedId
    private FieldCompositeId id; // {bpId + fieldCode}

    @Lob
    private String fieldValue;

    @ManyToOne
    private CustomFieldDefinition definition;
}

@RestController
@RequestMapping("/api/bp/{bpId}/fields")
public class FieldController {

    @PostMapping
    public void addField(
        @PathVariable Long bpId,
        @Valid @RequestBody FieldUpdateRequest request) {

        // 验证字段定义是否存在
        CustomFieldDefinition def = definitionRepo.findById(request.getFieldCode())
            .orElseThrow(() -> new BusinessException("字段未定义"));

        // 类型转换校验
        FieldTypeValidator.validate(def.getType(), request.getValue());

        bpFieldRepo.save(new BPCustomField(new FieldCompositeId(bpId, def.getFieldCode()),
            request.getValue(),
            def
        ));
    }
}

分页查询优化

SELECT * FROM bp_custom_fields 
WHERE bp_id = ? AND field_name LIKE 'medical_%'
ORDER BY field_name
LIMIT 100 OFFSET 0;

热点字段垂直拆分

@Entity
@Table(name = "bp_medical_info") // 医疗行业专用字段
public class BPMedicalExtension {
    @Id
    private Long bpId;
    private String licenseNumber;
    private String hospitalGrade;
}

使用字段元数据版本号

public class CustomFieldDefinition {
    @Version
    private Integer schemaVersion;
}

变更时执行数据迁移脚本

-- V2__migrate_field_type.sql
UPDATE bp_custom_fields 
SET field_value = CONCAT('{"newFormat":"', field_value, '"'})
WHERE definition_id IN (
    SELECT field_code FROM field_definitions 
    WHERE type = 'LEGACY_STRING'
);

@PreAuthorize("hasPermission(#bpId,'BP_WRITE')")
@PostMapping("/{fieldCode}")
public void updateField(
    @PathVariable Long bpId,
    @PathVariable String fieldCode) {// ...}

正则表达式校验

@Pattern(regexp = "^[A-Z0-9_]{3,20}$")
private String fieldCode;

SQL 注入防护

// 使用 JPA 参数化查询
List<BPCustomField> fields = em.createQuery(
    "SELECT f FROM BPCustomField f WHERE f.id.bpId = :bpId", 
    BPCustomField.class)
    .setParameter("bpId", bpId)
    .getResultList();

字段定义删除问题
现象：删除字段定义后历史数据成为脏数据
方案：采用逻辑删除 + 定期归档
多语言支持缺失
现象：字段标签无法根据语言切换
方案：在 CustomFieldDefinition 中增加 label_zh、label_en 等多语言字段
批量导入性能瓶颈
现象：万级数据导入超时

方案：采用 JDBC 批量插入 + 关闭 Hibernate 二级缓存

@Transactional
public void batchImport(List<FieldValueDTO> dtos) {Session session = em.unwrap(Session.class);
    session.setJdbcBatchSize(100);
    // ... 批量处理逻辑
}