共享属性（Shared Property）

共享属性（Shared Property）是一种可以在多个 Object Type 之间复用的属性定义。当多个业务实体拥有相同语义的字段时，通过共享属性可以统一管理该字段的名称、类型、描述等元数据，避免重复定义，确保跨实体的语义一致性。

核心概念

• 定义一次，多处引用：一个 Shared Property 创建后，可以被任意多个 Object Type 的属性所引用
• 统一语义：引用同一 Shared Property 的所有属性，在 ChatBI 等分析场景中会被视为同一语义维度
• 独立维护：修改 Shared Property 的元数据（如描述）后，所有引用它的属性都会同步更新

典型使用场景

场景	示例
多实体共用状态字段	status（状态）字段在订单、退款、物流等多个实体中含义相同
统一货币单位定义	currency_code（货币代码）在销售、采购、结算等实体中含义一致
跨域通用分类标签	category_id（类别编号）被商品、活动、内容等多种实体引用

与普通属性的区别

对比项	普通属性	共享属性引用
定义方式	在 Object Type 内直接定义	先创建 Shared Property，再在属性中引用
跨实体复用	❌ 每个实体单独定义	✅ 多实体共享同一定义
语义一致性	各自独立，可能不一致	统一语义，保证一致性
维护成本	需要逐一修改各实体中的同名字段	修改 Shared Property 一处即可

相关操作

• 创建与编辑 Shared Property — 了解如何新建和修改 Shared Property
• 将属性关联到 Shared Property — 了解如何在 Object Type 的属性上引用 Shared Property