Crear un maestro detalle con ViewLInk

Descripción: En este artículo veremos cómo crear con un maestro-detalle (master detail) utilizando un viewlink en una página de Oracle ADF.

Para empezar este ejemplo, crearemos una página en la cual pondremos nuestro maestro-detalle.

También debemos ir al ApplicationModule que gestionará la página, y comprobar que el ViewLink aparece incluido en él. Si no es así, debermos incluirlo.

Aquí empieza lo interesante, dentro de DataControls, desplegando el componente AppModuleDataControl, podremos encontrar las entidades que están en el Application Module, así como su vinculación entre éstas.

En este ejemplo de Departaentos-Empleados, si desplegamos la entidad Departamentos (DepartmentsView1 en la imagen), nos encontraremos con los atributos que contiene, y también la tabla EmpleadosView1.
Aquí es donde aparece reflejada la relación del ViewLink , pues el viewLink se debe ver como una relación entre tablas.

Para crear el maestro detalle en la página, arrastramos el detalle a la página (vista de diseño), y podremos ver que se nos abre un menú contextual indicándonos las distintas opciones que tenemos para mostrar.

En este caso podemos ver que nos muestran una opción Master-Detail, y que dentro de ésta, también existe varias opciones. 

En este ejemplo escogemos ver tanto el maestro como detalle, en forma de tablas. 

Para ver su funcionamiento ejecutamos la página como lo hacemos normalmente. 

 Finalmente tenemos nuestra página, con un maestro y un detalle. En la cual, si pulsamos un elementos en la tabla maestro, se actualizarán los datos en la tabla detalle, mostrando los registros relacionados con el item seleccionado en la tabla maestro.

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".

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".

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

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

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

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

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 @ADFSalvaje