Role (objeto del Diseñador de modelos)

El objeto Role define un rol de una entidad. Un rol es una descripción de dos entidades relacionadas. Este objeto hereda las propiedades del objeto Field.

Propiedades

Nombre	Cardinalidad	Tipo	Descripción
Name	0-1	String	Nombre del rol. Si la cardinalidad es One u OptionalOne, el nombre de la entidad relacionada es el predeterminado. De lo contrario, el valor de la cadena toma el valor predeterminado CollectionName de la entidad relacionada.
Linguistics	0-1	Object	Propiedad Linguistics del rol. Este elemento no se permite si se omite Name. En este caso, SingularName y PluralName toman los valores predeterminados de Name y Collection de la entidad relacionada, respectivamente.
RelatedRoleID	1	String	Id. del correspondiente rol en la entidad de destino. Este rol no puede ser RelatedRole. Además, RelatedRole del rol RelatedRole debe ser este rol.
Cardinality	1	Enum	Hay cuatro opciones: One, Many, OptionalOne, OptionalMany.
ContextualName	0-1	Enum	Cuando se utiliza el rol para llegar a la entidad, el enumerador ContextualName reemplaza el valor ContextualName para atributos en la entidad de destino del rol. El enumerador puede ser uno de estos tres valores: Attribute, Merge o Role. El enumerador toma como valor predeterminado Attribute, que utiliza el nombre de atributo como nombre contextual. Especifique Merge para que el nombre de atributo y el nombre de rol se combinen y utilicen como nombre contextual. Si este atributo es el único que identifica a la entidad, al especificar Role se utiliza el nombre de rol como nombre contextual. Si no es el único atributo que identifica la entidad, Role se trata como Merge.
HiddenFields	0-1	Object	Conjunto de campos y carpetas de campo que la aplicación cliente no debe mostrar para la entidad de destino del rol cuando se utiliza el rol para llegar a la entidad. Por ejemplo, el atributo AddressType debe estar oculto cuando Address se muestra utilizando el rol HomeAddress.
ExpandInline	0-1	Boolean	Indica que la aplicación cliente no debe mostrar el rol al usuario y que se deben mostrar los campos de la entidad relacionada en su lugar como si formasen parte de esta entidad. Se prefiere la ampliación del rol al comportamiento de búsqueda cuando se especifican ambos.
PromoteLookup	0-1	Boolean	Indica que la aplicación cliente, cuando se muestra la entidad contenedora como de búsqueda, muestra también la entidad de destino como de búsqueda. Este valor se permite solamente si la entidad contenedora y la entidad de destino del rol son entidades de búsqueda. Los roles de búsqueda de la entidad relacionada de un rol de búsqueda se promueven si el valor de PromoteLookup es true y la entidad relacionada del rol promovido no es la entidad a la que se va a promover el rol ni ninguno de sus antecesores o descendientes directos.
Preferred	0-1	Boolean	Indica que se deben preferir las rutas de acceso que contienen este rol a las rutas que no contienen roles preferidos. Utilice este valor Boolean para indicar la ruta que se debe utilizar para llegar a otra entidad cuando hay varias rutas entre las que elegir.
Recursion	0-1	Boolean	Indica si se debe recorrer la relación recursivamente de manera predeterminada. La recursión se permite únicamente si la entidad contenedora es la misma que la entidad de destino. Los roles se amplían recursivamente, pero la recursión de detiene cuando se intentan expandir elementos desde la entidad A al contexto de A, o uno de sus antecesores o descendientes directos.
Binding	0-1	Object	Objeto de base de datos que representa este rol. Tenga en cuenta que el extremo especificado de la relación debe enlazarse a columnas de la tabla a la que está enlazada la entidad que contiene el elemento RelatedRole, o ser igual a la columna a la que está enlazada la entidad. El otro extremo de la relación debe estar en la tabla a la que está enlazada la entidad contenedora de este rol, o ser igual a la columna a la que esta entidad está enlazada. Binding es necesario a menos que la entidad de este rol esté enlazada a la tabla que contiene la columna a la que está enlazada la entidad de RelatedRole (o viceversa). En este caso, la relación de inclusión entre la columna y la tabla es implícita y no se especifica el enlace.

Notas

En los modelos, un rol es una descripción de la relación entre dos entidades.

Para obtener más información acerca de valores Enum válidos, vea Tipos de datos del Diseñador de modelos.

Vea también

Conceptos

Propiedades de los objetos del Diseñador de modelos

Trabajar con el Diseñador de modelos

Diagrama de relaciones de objetos del Diseñador de modelos