Referencias de Clave Foránea

Una Referencia de Clave Foránea define la información necesaria para hacer referencia a una entidad en cierta tabla.

Debe configurar esta tabla de control si necesita validar un valor de clave foránea contra una tabla correspondiente. Por ejemplo, si hay un elemento de esquema asociado con una Referencia de Clave Foránea, el sistema valida el valor del elemento contra la tabla correspondiente. Para obtener más información sobre objetos basados en esquema, consulte Herramientas de Configuración. Otro ejemplo son las características cuyos valores válidos se definen en otra tabla (es decir, se utilizan tipos de características de "referencia de clave foránea"). Consulte Tipos de Característica para obtener una descripción de las características de este tipo.

Una Referencia de Clave Foránea no se utiliza sólo para propósitos de validación. También se utiliza para desplegar la descripción de información standard de la entidad de referencia, así como para proporcionar información de navegación a su transacción de mantenimiento. Las descripciones de la información aparecen en toda la UI; por ejemplo, cada vez que se despliega una cuenta en una página, aparece una descripción de la cuenta. El producto proporciona referencias de clave foránea de producto base para muchas de sus entidades, ya que se usan para la validación y el despliegue de elementos en interfaces de usuario de página fija y en interfaces de usuario basadas en portales.

Es posible que una implementación también necesite definir una referencia de clave foránea. Los siguientes puntos describen lo que debe saber antes de que pueda configurar una referencia de clave foránea para una tabla.

El nombre físico de la tabla. Comúnmente, es la tabla primaria de un objeto de mantenimiento.
El programa que se utiliza por defecto para crear la descripción de información de la entidad a la que se hace referencia.
La transacción que se utiliza para mantener la entidad a la que se hace referencia. Aquí es donde navega el usuario cuando utiliza el botón "ir a" o el hiperenlace asociado con la entidad.
El nombre de la página o la zona de búsqueda que se utiliza para buscar una entidad válida.

Los temas de esta sección describen varios aspectos de la definición y el uso de una referencia de clave foránea.

La Descripción de Información se Deriva Dinámicamente

Comúnmente se define una Referencia de Clave Foránea para la tabla primaria de un objeto de mantenimiento. En este caso, el sistema deriva dinámicamente la información standard asociada con una entidad específica a la que se hace referencia de la siguiente manera:

Se intenta determinar el objeto de negocio asociado con la entidad a la que se hace referencia. Para obtener más información, consulte el evento de sistema del algoritmo de objeto de mantenimiento Determinar Objeto de Negocio. Si se determinó un objeto de negocio, el sistema permite que el conector de Información del objeto de negocio, si lo hay, formatee la descripción.
Si no se determinó un objeto de negocio o si el objeto de negocio no dispone de este conector, el sistema permite que el conector de información del objeto de mantenimiento, si lo hay, formatee la descripción.
Si el objeto de mantenimiento no dispone de este conector, el sistema utiliza el programa de información especificado en la Referencia de Clave Foránea para formatear la información.

Nota: Nota técnica. La clase que devuelve la información desplegada junto a la entidad a la que se hace referencia se genera específicamente para uso como rutina de información. Consulte al grupo de soporte si necesita generar este tipo de clase.

Nota: Rutina genérica. El sistema proporciona una rutina de información genérica que devuelve la descripción de objetos de la tabla de control desde su tabla de idioma asociada. "Tabla de control" se refiere a una tabla con una tabla de idioma asociada que contiene un campo DESCR. Consulte Definición de Opciones de Tabla para obtener más información sobre tablas y campos. La clase java es com.splwg.base.domain.common.foreignKeyReference.DescriptionRetriever.

La Información de Navegación se Deriva Dinámicamente

Comúnmente se define una Referencia de Clave Foránea para la tabla primaria de un objeto de mantenimiento. En este caso, el sistema deriva dinámicamente la transacción real a la que se navegará para una determinada entidad a la que se hace referencia de la siguiente manera:

Se intenta determinar el objeto de negocio asociado con la entidad a la que se hace referencia. Para obtener más información, consulte el evento de sistema del algoritmo de objeto de mantenimiento Determinar Objeto de Negocio. Si se determinó un objeto de negocio, utilice el portal de mantenimiento definido como su opción de objeto de negocio Opción de Navegación de Portal.
Si no se determinó un objeto de negocio o si el objeto de negocio no define esa opción, el sistema utiliza la transacción especificada en la Referencia de Clave Foránea.

Opciones de Búsqueda

El producto proporciona dos metáforas principales para implementar una interface de usuario. Para los campos de entrada que son claves foráneas, las opciones de búsqueda dependen de la metáfora usada por la página en cuestión.

Una interfaz de usuario basada en portal es una interface de usuario más flexible, donde una implementación tiene más opciones para personalizar la presentación. El producto base usa mapas de Interface de Usuario o presentación automática de Interface de Usuario (UI) para mostrar los campos de entrada. Los elementos que son claves foráneas pueden desplegar un ícono de búsqueda si la referencia de Clave Foránea define una Zona de Búsqueda.
Nota: Definición directa de zonas de búsqueda. Los elementos de un mapa de Interface de Usuario (UI) pueden definir una zona de búsqueda directamente en HTML, en lugar de usar la zona de búsqueda definida en una referencia de Clave Foránea. Consulte los consejos del mapa de Interface de Usuario (UI) para obtener más información sobre cómo implementar búsquedas mediante el uso de zonas.
Una interface de usuario de página de mantenimiento fija es una página suministrada por el producto base, donde las implementaciones pueden introducir mejoras menores o ninguna mejora. La referencia de clave foránea se puede usar en una de dos maneras.
- El producto base puede usar una referencia de clave foránea para definir un elemento base en una de esas páginas. Si hay disponible una búsqueda para tales elementos, se usará la Clave de Navegación de Búsqueda de la referencia de clave foránea para implementar la búsqueda.
- Las entidades que soportan características generalmente incluyen una metáfora de Interface de Usuario (UI) de recolección de características en estos tipos de páginas. En esta metáfora, la característica de clave foránea muestra un ícono de búsqueda si la Referencia de Clave Foránea ha configurado una Clave de Navegación de Búsqueda.

Nota: No todas las referencias de Clave Foránea proporcionadas con el producto están configuradas con una opción de búsqueda. Esto puede ocurrir si las páginas entregadas básicas usan una lista desplegable para esta clave foránea en lugar de una búsqueda. Además, las referencias de Clave Foránea proporcionadas básicas que proporcionan una búsqueda pueden no estar configuradas con ambas opciones de búsqueda. Significa que, si se está enlazando este tipo de objeto como una característica, la búsqueda puede no estar disponible si no está configurada la búsqueda apropiada.