Freigeben über


Role-Objekt (Modell-Designer)

Das Role-Objekt definiert eine Rolle einer Entität. Eine Rolle ist eine Beschreibung zweier verbundener Entitäten. Dieses Objekt erbt Eigenschaften vom Field-Objekt.

Eigenschaften

Name

Kardinalität

Typ

Beschreibung

Name

0-1

String

Der Name der Rolle. Wenn das Cardinality-Element den Wert One oder OptionalOne aufweist, wird standardmäßig der Name der verbundenen Entität verwendet. Andernfalls entspricht der Zeichenfolgenwert standardmäßig dem CollectionName-Element der verbundenen Entität.

Linguistics

0-1

Object

Die Linguistikeigenschaften der Rolle. Dieses Element ist nicht zulässig, wenn das Name-Element nicht angegeben wird. In diesem Fall wird für das SingularName- und das PluralName-Element standardmäßig das Name- bzw. das Collection-Element verwendet.

RelatedRoleID

1

String

Die ID der entsprechenden Rolle in der Zielentität. Diese Rolle kann nicht mit dem RelatedRole-Element identisch sein. Außerdem muss das RelatedRole-Element des RelatedRole-Elements mit dieser Rolle identisch sein.

Cardinality

1

Enum

Es gibt vier Optionen: One, Many, OptionalOne und OptionalMany.

ContextualName

0-1

Enum

Wenn die Rolle verwendet wird, um die Entität zu erreichen, setzt der ContextualName-Enumerator die ContextualName-Einstellung für Attribute in der Zielentität der Rolle außer Kraft. Der Enumerator kann einen von drei Werten annehmen: Attribute, Merge oder Role. Der Enumerator hat standardmäßig den Wert Attribute, wodurch der Attributname als kontextbezogener Name verwendet. Geben Sie Merge an, wenn Attribut- und Rollenname zusammengeführt und das Ergebnis als kontextbezogener Name verwenden werden soll. Wenn dieses Attribut das einzige identifizierende Attribut der Entität darstellt, bewirkt die Angabe von Role, dass der Rollenname als kontextbezogener Name verwendet wird. Wenn das Attribut nicht das einzige identifizierende Attribut der Entität ist, hat Role dieselbe Wirkung wie Merge.

HiddenFields

0-1

Object

Eine Gruppe von Feldern und Feldordnern, die die Clientanwendung für die Zielentität der Rolle nicht anzeigen soll, wenn die Rolle verwendet wird, um die Entität zu erreichen. So könnte es beispielsweise gewünscht sein, das AddressType-Attribut auszublenden, wenn die Address-Entität mithilfe der HomeAddress-Rolle angezeigt wird.

ExpandInline

0-1

Boolean

Gibt an, dass die Clientanwendung die Rolle nicht für Benutzer anzeigen soll und dass stattdessen die Felder der verbundenen Entität so angezeigt werden sollen, als wären sie Teil dieser Entität. Die Rollenerweiterung wird der Verwendung als Nachschlageentität vorgezogen, wenn beides angegeben wird.

PromoteLookup

0-1

Boolean

Gibt an, dass die Clientanwendung die Zielentität ebenfalls als Nachschlageentität anzeigt, falls die enthaltende Entität als Nachschlageentität angezeigt wird. Dieser Wert ist nur zulässig, wenn sowohl die enthaltende Entität der Rolle als auch die Zielentität Nachschlageentitäten sind. Nachschlagerollen in der verbundenen Entität einer Nachschlagerolle werden heraufgestuft, wenn PromoteLookup auf TRUE festgelegt ist und die verbundene Entität der heraufgestuften Rolle nicht der Entität, auf die die Rolle heraufgestuft wird, oder einer ihr direkt übergeordneten oder untergeordneten Entität entspricht.

Preferred

0-1

Boolean

Gibt an, dass Path-Elemente, die diese Rolle enthalten, den Vorzug vor Path-Elementen erhalten sollen, die keine bevorzugten Rollen enthalten. Verwenden Sie diesen Boolean-Wert, um anzugeben, welcher Pfad zum Erreichen einer anderen Entität verwendet werden soll, wenn mehrere Pfade zur Auswahl stehen.

Recursion

0-1

Boolean

Gibt an, ob die Beziehung standardmäßig rekursiv traversiert werden soll. Die Rekursion ist nur zulässig, wenn die enthaltende Entität mit der Zielentität identisch ist. Rollen werden rekursiv erweitert; die Rekursion endet jedoch, wenn ein Versuch unternommen wird, Elemente aus Entität A in den Kontext von A oder einer ihr direkt übergeordneten oder untergeordneten Entität zu erweitern.

Bindung

0-1

Object

Das Datenbankobjekt, das diese Rolle darstellt. Beachten Sie, dass das angegebene Ende der Beziehung an Spalten in der Tabelle gebunden sein muss, an die die Entität, die das RelatedRole-Element enthält, gebunden ist, oder mit der Spalte identisch sein muss, an die die Entität gebunden ist. Das andere Ende der Beziehung muss sich in der Tabelle befinden, an die die enthaltende Entität dieser Rolle gebunden ist, oder der Spalte entsprechen, an die diese Entität gebunden ist. Die Bindung ist nur dann nicht erforderlich, wenn die Entität dieser Rolle an eine Tabelle gebunden ist, die die Spalte enthält, an die die Entität des RelatedRole-Elements gebunden ist (oder umgekehrt). In diesem Fall wird die Einschlussbeziehung zwischen der Spalte und der Tabelle vorausgesetzt, und es wird keine Bindung angegeben.

Hinweise

Im Berichts-Generator ist eine Rolle eine Beschreibung der Beziehung zwischen zwei Entitäten.

Weitere Informationen zu gültigen Enum-Werten finden Sie unter Modell-Designer-Datentypen.