viernes, 24 de octubre de 2014

Crear un Viewlink

Descripción: En este artículo veremos cómo se crea un ViewLink en ADF 11g.
Esta descripción es muy similar a ADF 10g, por lo que puede utilizarse como guía.

Nota: En este ejemplo vamos a  crear un viewlink que nos permita enlazar la entidad Departmentos y Empleados, para más adelante, al selecionar un departamento, se muestre automáticamente los empleados.

El viewLink es un Business Component (BC), por lo que iremos al proyecto Model, y con el menú contextual seleciconamos "New View Link".

new view link en el menu contextual del Model
selección New View Link desde Model

Una vez seleccionada esta opción del menú contextual, se nos presentará un asistente que nos llevará paso a paso a la creación del viewLink. 
En este paso, pondremos el nombre del viewLink. Recomiendo que en el sufijo del nombre se indique que este objeto es un viewLink. La razón, es que visualmente sabemos el tipo de componente del que se trata sin tener que mirar sus propiedades.




A continuación nos muestra la relación entre entidades. Seleccionamos en este caso las asociaciones (Associations) que están en nuestro proyecto, y que ya une las entidades que queremos relacionar.
Al seleccionar tanto en el Source (fuente) como en el Destination (destino), completaremos la operación pulsando el botón "Add".


seleccion source y destination en la relacion
selección de origen y destino de la relación

A continuación nos consulta si queremos crear los accesors tanto para la fuente como el destino. Dependiendo de lo que vayamos a necesitar, podemos marcarlo o dejarlo por defecto. 


crear accesors para source y destination
crear accesors para source y destination

El apartado Source Query, viene a reflejar la query que se esconde detrás del viewLink.
Aunque el viewLink, nos pueda dar la sensación de que no tenemos que preocuparnos por la consulta o consultas que se gestionan por debajo, esto no tiene que ser exactamente así.
En el caso de consultas "pesadas" o entre entidades que tienen una gran cantidad de registros, sería recomendable echarle un vistazo a esto. 

editar consulta fuente
editar consulta fuente

A continuación nos indica si queremos incluir el ViewLink dentro de un Application Module. Esto puede ser útil, aunque personalmente suelo añadir la relación editando el Application Module. 

incluir en Application Module
incluir en Application Module

Pantalla Summary o Resumen, en este paso, vemos un resumen de lo que hemos ido configurando en cada uno de los pasos vistos anteriormente. Tras pulsar "Finish" terminamos el proceso de creación del ViewLink.

vista resumen del viewlink
vista resumen del viewlink

Si queremos incluir el viewlink, o mejor dicho, la relación entre entidades en el Application Module, deberemos ir al Data Model (editar Application Module).
Podemos ver en la parte izquierda la relación entre las entidades (Entity) Departamento y Empleados a través del Viewlink.


incluir viewlink en el Application Module


Solo tendremos que seleccionar y pasar la relación a la parte derecha para que ésta ya esté disponible para su uso. 

Nota: Cada vez que incluimos algo en el Application Module, hay que tener ojo con que nos añade un número al final del nombre. Puedes mantenerlo, o quitarlo (si no existe otro objeto con el mismo nombre en el mismo Application Module).





Puedes seguir el blog por Blogger Twitter