Condividi tramite


Oggetto Role (Progettazione modelli)

L'oggetto Role definisce il ruolo di un'entità. Un ruolo è la descrizione di due entità correlate. Questo oggetto eredita le proprietà dell'oggetto Field.

Proprietà

Nome Cardinalità Tipo Descrizione

Name

0-1

String

Nome del ruolo. Se la Cardinalità è One o OptionalOne, l'impostazione predefinita è Name dell'entità correlata. In caso contrario, l'impostazione predefinita del valore della stringa è CollectionName dell'entità correlata.

Linguistics

0-1

Object

Proprietà Linguistics del ruolo. Questo elemento non è consentito se Name viene omesso. In questo caso, le impostazioni predefinite di SingularName e PluralName sono rispettivamente Name e Collection dell'entità correlata.

RelatedRoleID

1

String

ID del ruolo corrispondente nell'entità di destinazione. Questo ruolo non può essere l'elemento RelatedRole. Inoltre l'elemento RelatedRole dell'elemento RelatedRole deve essere questo ruolo.

Cardinality

1

Enum

Esistono quattro opzioni: One, Many, OptionalOne, OptionalMany.

ContextualName

0-1

Enum

Quando il ruolo viene utilizzato per raggiungere l'entità, l'enumeratore ContextualName ha la priorità sull'impostazione di ContextualName per gli attributi nell'entità di destinazione del ruolo. L'enumeratore può avere uno dei valori seguenti: Attribute, Merge o Role. L'impostazione predefinita del valore dell'enumeratore è Attribute, che utilizza il nome dell'attributo come nome contestuale. Specificare Merge per fare in modo che il nome dell'attributo e il nome del ruolo vengano uniti e utilizzati come nome contestuale. Se questo attributo è l'unico attributo di identificazione dell'entità, quando si specifica Role il nome del ruolo verrà utilizzato come nome contestuale. Se non è l'unico attributo di identificazione dell'entità, Role viene trattato come Merge.

HiddenFields

0-1

Object

Un set di campi e cartelle dei campi che non devono essere visualizzati nell'applicazione client per l'entità di destinazione del ruolo quando il ruolo è utilizzato per raggiungere l'entità. L'attributo AddressType, ad esempio, deve essere nascosto quando Address viene visualizzato utilizzando il ruolo HomeAddress.

ExpandInline

0-1

Boolean

Indica che l'applicazione client non deve visualizzare il ruolo all'utente e che devono venire invece visualizzati i campi dell'entità correlata come se facessero parte di questa entità. L'espansione del ruolo viene preferita al comportamento di ricerca, quando sono entrambi specificati.

PromoteLookup

0-1

Boolean

Indica che l'applicazione client, quando l'entità contenitore è visualizzata come ricerca, visualizza anche l'entità di destinazione come ricerca. Questo valore è consentito solo se l'entità contenitore del ruolo e l'entità di destinazione sono entità di ricerca. I ruoli di ricerca nell'entità correlata di un ruolo di ricerca vengono promossi se il valore di PromoteLookup è True e l'entità correlata del ruolo promosso non è l'entità alla quale il ruolo viene promosso o uno dei suoi predecessori o discendenti diretti.

Preferred

0-1

Boolean

Indica che i percorsi che contengono questo ruolo devono essere preferiti a quelli che non contengono ruoli preferiti. Utilizzare questo valore Boolean per indicare le parti da utilizzare per raggiungere un'altra entità quando esiste più di un percorso tra cui scegliere.

Recursion

0-1

Boolean

Indica se la relazione deve essere attraversata in modo ricorsivo per impostazione predefinita. Recursion è consentito solo se l'entità contenitore è identica all'entità di destinazione. I ruoli vengono espansi in modo ricorsivo, ma la ricorsione si interrompe quando viene eseguito un tentativo di espandere gli elementi dell'entità A nel contesto di A oppure di uno dei suoi predecessori o discendenti diretti.

Binding

0-1

Object

Oggetto di database che rappresenta questo ruolo. Si noti che la fine specificata della relazione deve essere associata alle colonne nella tabella alla quale è associata l'entità che contiene l'elemento RelatedRole, oppure deve corrispondere alla colonna alla quale è associata quell'entità. L'altra estremità della relazione deve essere nella tabella alla quale è associata l'entità contenitore di questo Role, oppure deve corrispondere alla colonna alla quale è associata questa entità. L'associazione è obbligatoria, a meno che l'entità di questo Role non sia associata a una tabella che contiene la colonna alla quale è associata l'entità di RelatedRole o viceversa. In tal caso, la relazione di contenuto tra la colonna e la tabella è implicita e l'associazione non è specificata.

Osservazioni

In Generatore report un ruolo è una descrizione della relazione tra due entità.

Per ulteriori informazioni sui valori Enum validi, vedere Tipi di dati di Progettazione modelli.

Vedere anche

Concetti

Proprietà degli oggetti di Progettazione modelli
Utilizzo di Progettazione modelli
Relazioni tra oggetti di Progettazione modelli

Guida in linea e informazioni

Assistenza su SQL Server 2005