结构体与共享属性

结构体：一个属性，几个字段

前面几种类型，一个属性只装一个值。客户的联系人却是「姓名加邮箱」两样东西，总是一起出现。这时可以用结构体（struct）：一个属性里放几个有名字、有类型的字段。

{
  "name": "contact",
  "type": "struct",
  "title": "Contact",
  "structFields": [
    { "name": "name", "type": "string", "title": "Name" },
    { "name": "email", "type": "string", "title": "Email" }
  ]
}

读回来的值是一个对象："contact": { "name": "Lena Zhou", "email": "lena@example.com" }。结构体有几条硬规则：

• 结构体里不能再放结构体。
• 字段只能是标量（string、integer、long、short、byte、boolean、float、double、decimal、date、timestamp）或 geopoint，不能是数组。
• 至少要有一个字段，AIDC 里最多 20 个。
• 结构体不能做主键或标题键。
• 结构体属性本身也可以是数组，也就是一组结构体。

比如供应商有多位联系人，就把 contact 写成结构体数组：type 写 array，arraySubType 写 struct，再给出 structFields。

结构体、多个属性，还是对象类型

判断的办法：这几个字段有没有自己的身份，要不要连关系，要不要被单独找出来？三样都不要，用结构体；有一样要，就建成对象类型。

结构体的字段只有名字、类型、显示名和说明，没有单位、同义词，也不能单独设必填。只要其中任何一样用得到，就平铺成几个属性更合适；结构体留给总是作为一个整体出现的东西。

另一个常见的坑，是想在结构体里再套一层，比如给 contact 加一个有街道、城市两个字段的 address。这不允许：把街道、城市拉平成 contact 的字段，或者把地址建成独立的对象。

共享属性：一个定义，多处使用

示例工厂里，客户、订单、工单都有「负责人」ownerId，也都有「创建时间」createdAt。如果每个类型各写一遍，显示名、说明、同义词就会慢慢各写各的。共享属性（Shared Property）把这份定义写一次，让多个对象类型引用。

{
  "kind": "sharedPropertyType",
  "apiName": "ownerId",
  "title": "Owner",
  "description": "The person accountable for this record.",
  "schema": {
    "type": "string",
    "synonyms": ["responsible", "accountable person"]
  }
}

每个用到它的类型，在自己的 columns 里加一行。类型要和共享属性一致；属性自己没写的显示名、说明、单位、同义词、值类型和格式，取共享属性的，自己写了的优先。

{ "name": "ownerId", "type": "string", "sharedProperty": "ownerId" }

已经存在的属性也能事后接入：在它的定义里加上 sharedProperty，属性的名字和已有的数据都不变。接入前先确认类型一致。

共享的只有元数据，各类型的对象数据并不共享：客户的 ownerId 和工单的 ownerId 是两组值，只是共用一份定义。共享属性也是接口的零件，接口 Schedulable 的 dueAt 和 status 就由它承载，下一门课会讲。

共享属性的好处在修改时才显出来：给 ownerId 加一个同义词「责任人」，所有引用它的类型立刻读到新的元数据，不用逐个去改。反过来，它被很多类型共用，改类型或删除之前，要先查清有多少类型在用它。

下一节讲值类型：把取值的规则写进类型里。