Objeto Role (Designer de Modelo)
O objeto Role define uma função de uma entidade. Uma função é uma descrição de duas entidades relacionadas. Esse objeto herda propriedades do objeto Field.
Propriedades
Nome |
Cardinalidade |
Tipo |
Descrição |
|---|---|---|---|
Name |
0-1 |
String |
O nome da função. Se a Cardinalidade for One ou OptionalOne, o nome da entidade relacionada será o padrão. Caso contrário, o valor da cadeia de caracteres usará como padrão o CollectionName da entidade relacionada. |
0-1 |
Object |
As propriedades de Lingüística da função. Esse elemento não será permitido se o Nome for omitido. Nesse caso, SingularName e PluralName usam como padrão o Nome e a Coleção da entidade relacionada, respectivamente. |
|
RelatedRoleID |
1 |
String |
A ID da função correspondente na entidade de destino. Essa função não pode ser RelatedRole. Além disso, a RelatedRole da RelatedRole deve ser esta função. |
Cardinality |
1 |
Enum |
Há quatro opções: One, Many, OptionalOne, OptionalMany. |
ContextualName |
0-1 |
Enum |
Quando a função é usada para atingir a entidade, o enumerador ContextualName substitui a configuração ContextualName dos atributos na entidade de destino da função. O enumerador pode ser um de três valores: Attribute, Merge ou Role. O valor do enumerador usará Atributo como padrão, que usa o nome de atributo como o nome contextual. Especifique Merge para fazer com que o nome do atributo e da função sejam mesclados e usados como nome contextual. Se esse atributo for o único atributo identificador da entidade, a especificação Função utiliza o nome da função como nome contextual. Se não for o único atributo identificador da entidade, Função é considerado como Merge. |
0-1 |
Object |
Um conjunto de campos e pastas de campos que o aplicativo cliente não deve exibir na entidade de destino da função quando a função for usada para atingir a entidade. Por exemplo, o atributo AddressType deve ser ocultado quando Address for exibido usando a função HomeAddress. |
|
ExpandInline |
0-1 |
Boolean |
Indica que o aplicativo cliente não deve exibir a função ao usuário e que, em vez disso, os campos da entidade relacionada devem ser exibidos como se fizessem parte dessa entidade. A expansão da Função é favorecida em relação ao comportamento de pesquisa quando ambos são especificados. |
PromoteLookup |
0-1 |
Boolean |
Indica que o aplicativo cliente, quando a entidade contentora é exibida como pesquisa, também exibe a entidade de destino como pesquisa. Esse valor só será permitido se a entidade contentora da função e a entidade de destino forem entidades de pesquisa. As funções de pesquisa na entidade relacionada de uma função de pesquisa são promovidas se o valor de PromoteLookup for verdadeiro e a entidade relacionada da função promovida não for a entidade à qual a função está sendo promovida ou uma de suas ancestrais ou descendentes diretas. |
Preferred |
0-1 |
Boolean |
Indica que os Caminhos que contêm essa função devem ser priorizados em relação aos Caminhos que não contêm funções preferidas. Utilize este Booleano para indicar qual caminho deve ser usado para atingir outra entidade quando há mais de um caminho de onde fazer a escolha. |
Recursion |
0-1 |
Boolean |
Indica se a relação deveria ser atravessada recursivamente por padrão. A recursão só será permitida se a entidade contentora for igual à entidade designada. As Funções são expandidas recursivamente, mas a recursão pára quando uma tentativa é feita para expandir itens da entidade A no contexto de A ou um dos ancestrais e descendentes diretos. |
0-1 |
Object |
O objeto do banco de dados que representa essa função. Observe que a ponta especificada da relação deve associar as colunas na tabela à qual a Entidade que contém o elemento RelatedRole está associada ou igual à coluna à qual essa entidade está associada. Observe que a outra ponta da relação deve estar na tabela à qual a Entidade que contém a Função está associada ou igual à coluna à qual essa entidade está associada. A associação é obrigatória, a menos que a entidade da Função esteja associada a uma tabela que contenha a coluna à qual a entidade RelatedRole está associada (ou vice-versa). Neste caso, a relação de confinamento entre a coluna e a tabela é implícita e a associação não é especificada. |
Comentários
No Construtor de Relatórios, uma função é uma descrição da relação entre duas entidades.
Para obter mais informações sobre valores Enum válidos, consulte Tipos de dados do Designer de Modelo.