Role 개체(모델 디자이너)
Role 개체는 엔터티의 역할을 정의합니다. 역할은 관련된 두 엔터티에 대한 설명입니다. 이 개체는 Field 개체에서 속성을 상속받습니다.
속성
이름 |
카디널리티 |
유형 |
설명 |
|---|---|---|---|
Name |
0-1 |
String |
역할 이름입니다. 카디널리티가 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 |
이 역할을 포함하는 Paths가 기본 역할이 없는 Paths보다 우선 적용됨을 나타냅니다. 선택 가능한 경로가 둘 이상 있는 경우 Boolean을 사용하여 다른 엔터티에 접근하는 데 사용할 경로를 나타낼 수 있습니다. |
Recursion |
0-1 |
Boolean |
기본적으로 관계를 재귀적으로 순회해야 하는지 여부를 나타냅니다. 재귀는 포함하는 엔터티가 대상 엔터티와 같은 경우에만 허용됩니다. 역할은 재귀적으로 확장되지만 A 엔터티에서 A 컨텍스트나 직계 상위 또는 하위 항목으로 확장하는 경우 재귀가 중지됩니다. |
0-1 |
Object |
이 역할을 나타내는 데이터베이스 개체입니다. 관계의 한쪽 끝은 RelatedRole 요소를 포함하는 Entity가 바인딩되는 테이블의 열로 바인딩되거나 해당 엔터티가 바인딩되는 열과 같아야 합니다. 해당 관계의 반대쪽 끝은 이 Role에 포함된 Entity가 바인딩되는 테이블에 있거나 이 엔터티가 바인딩되는 열과 같아야 합니다. RelatedRole의 엔터티가 바인딩되는 열을 포함하는 테이블로 이 Role의 엔터티가 바인딩되거나 그 반대인 경우가 아니면 바인딩이 필요합니다. 이 경우 열과 테이블 간의 포함 관계가 유추되며 바인딩이 지정되지 않습니다. |