APEX 03 -04 - Preservación de la historia de las definiciones bajo el paradigma basado en archivos

Preservar la historia de tus definiciones depende de ti!

En la cuarta entrega de la SAGA del Ciclo de Desarrollo para aplicaciones APEX exploramos como gestionar el historial de cambios en nuestra aplicacion...

Mientras cambiamos los objetos de la base de datos y los componentes de la aplicación APEX con el tiempo, los datos en los diccionarios respectivos reflejan sólo las definiciones actuales de los objetos del esquema y los componentes de APEX que se utilizan en este momento.

👉Preservar el historial de los cambios que el equipo realiza a estas definiciones requiere un esfuerzo consciente de nuestra parte. Esto implica realizar el archivado de una instantánea de un momento dado de archivos de texto simples que representen las definiciones, cada vez que el proyecto alcanza un hito significativo (release). 

Además de los scripts SQL que podemos utilizar para crear el esquema de objetos de la base de datos, cada aplicación y componente APEX también tiene una representación en su archivo de texto equivalente.

De esta forma podemos fácilmente recuperar los archivos de texto que representan nuestra aplicación en cualquier momento. Como se muestra en la Figura 4, la exportación del estado actual de la aplicación produce un archivo zip que contiene los scripts SQL que representan la aplicación y cada componente que contiene. 

La exportación también puede incluir archivos YAML y archivos de extracto de código opcionales que simplifican la comparación de qué ha cambiado en la última versión y permitir realizar escaneos en cualquier código SQL, PL/SQL o JavaScript que los componentes de la aplicación incluyan. 

Los archivos de texto que comprenden las definiciones de objetos de la base de datos y los de los componentes APEX se conocen como Artefactos de Aplicación.

Figura 4: Exportando una aplicación APEX para producir el archivado de componentes de archivo

El ciclo de vida de desarrollo de APEX sigue un paradigma familiar basado en archivos

💡Almacenar metódicamente el historial de los artefactos de nuestras aplicaciones a lo largo del tiempo nos permite instalar cualquier versión de la aplicación, en cualquier momento, en cualquier sistema de destino, para cualquier propósito. 

La instalación de definiciones de objetos de esquema de base de datos implica ejecutar los scripts SQL relevantes en el orden oportuno para crear tablas, vistas, paquetes PL/SQL y más. De manera similar, se instala una versión particular de nuestras aplicaciones APEX importando un archivo de la aplicación y los scripts de componentes como se muestra en la Figura 5.

El historial de instantáneas de los artefactos de las aplicaciones que hemos tomado a lo largo del tiempo representa la "fuente de verdad" para las aplicaciones. En nuestro entorno de producción, la versión instalada en la base de datos es la actual que utilizan los usuarios finales. En nuestro entorno de prueba, podría ser la instantánea semanal más reciente de la próxima versión de nuestra aplicación. Y en el entorno de desarrollo, la versión instalada está en desarrollo activo. 

Figura 5: Importando una aplicación APEX desde un archivo de sistema a la base de datos 

Sigue leyendo los siguientes post de esta fabulosa SAGA del Ciclo de Desarrollo para Aplicaciones APEX y conoceras una explicación de las mejores prácticas que tú y tu equipo necesitan para entregar de manera efectiva versiones mejoradas de Aplicaciones APEX a lo largo del tiempo, con alta calidad, de a pocos cambios a la vez.

Aqui el siguiente post de la SAGA ->El seguimiento de errores y funcionalidades para una correcta planificación de entregas

Juntos, creamos las aplicaciones del futuro!

Mi nombre es José Preda.

* José es Analista de Sistemas e Ingeniero de Software con especializaciones en tecnologías de Oracle, Microsoft, redes, infraestructura tecnológica y gestión de recursos humanos. Posee más de 30 años de experiencia en el área de tecnología, es de Paraguay, vive y trabaja en San Luis, Argentina. Fue consultor, capacitador y soporte técnico para Base de Datos y herramientas de Oracle, desde el año 2013 es miembro activo del Grupo de Usuarios Oracle de Argentina del cual es miembro del directorio desde el año 2023. Es CEO de su propia Consultora: Soft San Luis, una startup especializada en brindar formación profesional, consultoría, mentoría y soluciones con tecnología Oracle y Oracle APEX a empresas, equipos de desarrollo de consultoras y a particulares. En 2024 ha sido reconocido como  Oracle ACE Associate por la Corporación Oracle por sus contribuciones a la Comunidad de Usuarios de Tecnologías de Oracle