Curso ADF 11g - Parte 4

Tema : Personalización de View Objects.

Nuestro último capítulo permitió la personalización de componentes del tipo entidad. Recuerde que ese tipo de componentes esta ligado a la “representación de datos” que tenemos en nuestra capa de modelo. Una vez que tenemos representado los datos, es momento de desarrollar “la presentación de datos”.

Cuando hablamos de presentación de datos, no nos referimos de ninguna manera a la parte de interfaz de usuario (página web) sino a la presentación de datos que se realiza en la capa de modelo. Es como si usted estuviera construyendo un reporte y antes de diseñar gráficamente el reporte, lo primero que usted elabora es la SQL que permitiría “presentar los datos”. Bien justamente estamos en esta etapa y en vez de crear la sentencia SQL, lo que se hace es elaborar componentes del tipo View Object.

Requerimiento:

• Oracle Jdeveloper 11g. 11.1.1.3
• Oracle Database Express 11g
• Haber culminado la parte 3 del tutorial.

Capítulos Anteriores

Parte 1: Creación del Modelo de Datos.

Parte 2: Creación de Componentes de Negocio

Parte 3: Personalización de Entidades

Opcional :

Si no culmino los capítulos anteriores y quiere empezar desde este capítulo, puede descargar el siguiente código para continuar el curso.

Código previo.

Nuestro objetivo en esta parte será lo siguiente:

• Personalizaremos los atributos que muestran las vistas por default.
• Modificar las etiquetas (Label) y Formatos.
• Asociar una lista de valores a lo campos.

PERSONALIZAR ATRIBUTOS DE VISTAS.

1. Ejecute el módulo de aplicaciones, y consulta la vista de Movimiento-Detalle.

2. Note que la vista de detalle, muestra entre sus atributos el Id del Producto (ProductoId). Sin embargo si vamos luego a mostrar esta información al usuario final no sería adecuado mostrar la descripción del producto en vez del Id??. Por supuesto que sí, entonces veamos que paso realizaremos para lograr este cambio.

3. Regrese al Jdeveloper y hagamos doble clic sobre la vista detalle.

4. Elija la categoría “Entity Objects” en el editor y note que la vista DetalleVO esta compuesto exclusivamente de la entidad Detalle. Esto tiene mucho sentido porque hemos usado el asistente para su creación.

5. Si hacemos clic sobre la categoría Query descubriremos que a vista recupera su información en base a una consulta SQL que usa exclusivamente la tabla DETALLE para obtener su información.

6. En este punto, usted seguro esta tentado a ir directamente al SQL y hacer un join con la tabla PRODUCTO y finalizar este requerimiento. Esto no es necesario, porque podemos apoyarnos en las herramientas del framework para lograr lo mismo. Regrese a la categoría “Entity Object” y ahora agreguemos la entidad Producto como parte de la vista

Con este paso estamos ligando una vista “DetalleVO” con 2 entidades Detalle y Producto. Esto es posible y lo hacemos porque justamente necesitamos información de otra entidad para obtener los datos que necesitamos. Esto sería la manera de hacer un join con el framework. Comprobemos estos regresando nuevamente a la categoría Query y notando que el join se realizó.

Ojo, esto se realizo porque existe una relación entre Detalle y Producto generó en base a la foreing key que existe entre ambas tablas en la BD>

7. Bueno, ahora será necesario indicar que atributos de la entidad Producto queremos agregar en la vista. Entonces vayamos a la categoría Attributes y elijamos la opción “Add Attribute from Entity” tal como se muestra en la figura.

8. Elija el atributo Descripción de la entidad Producto, agréguelo a la sección de Selected y Pulse Ok.

9.Ahora pulse el botón, Set Source Order para ordenar los campos.

10. Ordénelo tal como se muestra en la imagen.Pulse OK y grabe los cambios.

11. Ejecutemos el módulo de aplicación y vemos los resultados.

12. Veamos la vista Movimiento-Detalle y notemos que ya apareció el atributo Descripción del Producto.

PERSONALIZAR FORMATOS Y ETIQUETAS.

13. El siguiente cambio es muy sencillo, note que en la imagen anterior la fecha no tiene formato común en nuestra región. En vez de decir 2008-01-12 preferiríamos el valor 12/01/2012. Adicionalmente cambiaremos la etiqueta “ClienteId” por “Id Cliente” para que sea más fácil de interpretar al usuario. Veamos como hacemos esto

14. Haga doble clic en la vista MovimientoVO.Luego elija la categoría Attributes y finalmente haga doble clic sobre al atributo “Fecha”

15. La pantalla que se muestra se puede configurar las propiedades del atributo “Fecha”. En nuestro caso vamos a la categoría “Control Hints” donde podemos personalizar cosas como los formatos o las etiquetas.En nuestro caso modificaremos las siguientes propiedades.

Format Type: Simple Date

Format: dd/MM/yyyy

Pulse OK.

16. Hagamos doble clic ahora sobre el atributo “ClienteId”.

17. Seleccionemos nuevamente la categoría Control Hint y modifiquemos la propiedad Label por “Id Cliente”. Pulse OK y Grabe los cambios.

18. Ejecutemos el módulo de aplicación para verificar los cambios.

19. Al consultar la vista de movimiento notará que se realizaron correctamente.

ASOCIAR LOS ATRIBUTOS CON LISTAS DE VALORES

20. En la anterior imagen note que el atributo “Id Cliente” es un atributo del tipo Texto. Sin embargo para el usuario del sistema, que registrará esta información, sería mas intuitivo “ingresar” al cliente por medio de una búsqueda por medio de una lista, en vez de recordar el Id de dicho cliente. Bien veamos como realizar este cambio con el framework. Seleccione la vista MovimientoVO. Luego, seleccione el atribute el atributo ClienteId y haga clic sobre el botón “Add List of Values” de manera similar a la siguiente imagen.

21. En este paso debemos definir la fuente de datos que usaremos para poblar la lista de valores del atributo ClienteId. Por ello, hagamos clic sobre el botón “Create New View Accesors”

22. Seleccionemos la vista ClienteVO, pues será de esta de la que tomaremos el nombre del cliente. Pulse OK.

23. En el campo “List Attribute” defina el atributo que pertenece al atributo CLIENTE que estará asociado al atributo ClienteId de la vista Movimiento. En este caso el nombre es el mismo ClienteId.

24. Haga clic en el tab “UI Hints” para definir la forma en que se presentará los datos. Sobre esta pestana, es importante notar que el campo “Default Type List” determina la manera como mostraremos este dato. En esta caso mantenemos le valor por “Choice List” que determina un lista del tipo Combo.

Adicionalmente seleccionamos Nombre como el atributo a mostrar en la lista. Pulse OK y Grabe los cambios.

25. Probemos los cambios desde el módulo de aplicación y vemos que los cambios se han aplicado correctamente.

26. Perfecto. Ya estamos viendo que este framework es poderoso para facilitar muchas labores que implicarían horas de programación y que lo podemos resolver con unos cuantos pasos de configuración. En siguientes capítulos conoceremos aún más de este framework. Si tiene dudas, por favor comente el post para poderle ayudar a solucionarlas.

CODIGO FUENTE FINAL