Role 对象（模型设计器）
Role 对象定义实体的角色。角色是对两个相关实体的说明。此对象从 Field 对象继承属性。
属性
| 名称 | 基数 | 类型 | 说明 |
|---|---|---|---|
Name |
0-1 |
String |
角色的名称。如果 Cardinality 为 One 或 OptionalOne，则相关实体的 Name 为默认值。否则，字符串值默认为相关实体的 CollectionName。 |
0-1 |
Object |
角色的 Linguistics 属性。如果未提供 Name，则不允许使用此元素。在这种情况下，SingularName 和 PluralName 分别默认为相关实体的 Name 和 Collection。 |
|
RelatedRoleID |
1 |
String |
目标实体的相应角色的 ID。此角色不能为 RelatedRole。此外，RelatedRole 的 RelatedRole 必须为此角色。 |
Cardinality |
1 |
Enum |
有四个选项：One、Many、OptionalOne、OptionalMany。 |
ContextualName |
0-1 |
Enum |
用角色来访问实体时，ContextualName 枚举器将覆盖该角色的目标实体中属性的 ContextualName 设置。枚举器可以为以下三个值之一：Attribute、Merge 或 Role。枚举器值默认为 Attribute，它使用属性名作为上下文名称。指定 Merge 将合并属性名和角色名作为上下文名称。如果此属性是实体的唯一标识属性，则指定 Role 会将角色名称用作上下文名称。如果它不是实体的唯一标识属性，则对 Role 的处理方式与 Merge 相同。 |
0-1 |
Object |
一组字段和字段文件夹，在用角色来访问实体时，客户端应用程序不应为角色的目标实体显示这些字段和字段文件夹。例如，在使用 HomeAddress 角色显示 Address 时，AddressType 属性应当是隐藏的。 |
|
ExpandInline |
0-1 |
Boolean |
指示客户端应用程序不应向用户显示角色，而应显示相关实体的字段，就好像这些字段是此实体的一部分一样。如果同时指定了角色扩展和查找行为，则前者优先。 |
PromoteLookup |
0-1 |
Boolean |
指示当包含实体显示为查找实体时，客户端应用程序也会将目标实体显示为查找实体。只有当角色的包含实体和目标实体都是查找实体时，才允许设置此值。如果 PromoteLookup 的值为 True，并且所提升角色的相关实体不是角色将提升为的目标实体，也不是其直接祖先或后代之一，则系统将提升查找角色的相关实体上的查找角色。 |
Preferred |
0-1 |
Boolean |
指示包含此角色的路径应当优先于不包含首选角色的路径。使用此布尔值可以指示如果有多个路径可供选择，则应当用哪个路径来访问另一个实体。 |
Recursion |
0-1 |
Boolean |
指示默认情况下是否应对关系进行递归遍历。只有当包含实体与目标实体相同时，才允许进行递归。角色将递归展开，但是，如果试图将实体 A 中的项扩展到 A 的上下文，或者它的一个直接祖先或后代，则递归将停止。 |
0-1 |
Object |
表示此角色的数据库对象。请注意，关系的指定端必须与包含 RelatedRole 元素的实体所绑定的表中的列绑定，或等于实体所绑定的列。关系的另一端必须在此角色的包含实体所绑定的表中，或等于此实体所绑定的列。必须进行绑定，除非此角色的实体所绑定的表包含 RelatedRole 的实体所绑定的列（或者相反）。在这种情况下，列和表之间的包含关系是隐含的，因此不用指定绑定。 |
备注
在报表生成器中，角色是对两个实体之间的关系的说明。
有关有效的枚举值的详细信息，请参阅模型设计器数据类型。