Role (objeto del Diseñador de modelos)

El objeto Role define una función de una entidad. Una función 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 de la función. 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 de la función. 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. de la correspondiente función en la entidad de destino. Esta función no puede ser RelatedRole. Además, RelatedRole de la función RelatedRole debe ser esta función.
Cardinality	1	Enum	Hay cuatro opciones: One, Many, OptionalOne, OptionalMany.
ContextualName	0-1	Enum	Cuando se utiliza la función para llegar a la entidad, el enumerador ContextualName reemplaza el valor ContextualName para atributos en la entidad de destino de la función. 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 función se mezclen y utilicen como nombre contextual. Si este atributo es el único que identifica a la entidad, al especificar Role se utiliza el nombre de función 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 de la función cuando se utiliza la función para llegar a la entidad. Por ejemplo, el atributo AddressType debe estar oculto cuando Address se muestra utilizando la función HomeAddress.
ExpandInline	0-1	Boolean	Indica que la aplicación cliente no debe mostrar la función 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 de la función 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 sólo si la entidad contenedora y la entidad de destino de la función son entidades de búsqueda. Las funciones de búsqueda de la entidad relacionada de una función de búsqueda se promueven si el valor de PromoteLookup es true y la entidad relacionada de la función promovida no es la entidad a la que se va a promover la función ni ninguno de sus antecesores o descendientes directos.
Preferred	0-1	Boolean	Indica que se deben preferir las rutas de acceso que contienen esta función a las rutas que no contienen funciones preferidas. 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. Las funciones 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 esta función. 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 esta función, o ser igual a la columna a la que esta entidad está enlazada. Binding es necesario a menos que la entidad de esta función 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 el Generador de informes, una función 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