Oracle APEX 26-2 - Mejoras en APEXlang

Con el lanzamiento de Oracle APEX 26.2, APEXlang da un salto, de alguna forma era de esperarse, este lenguaje de especificaciones se ve solido y es logico que vaya mejorando con el tiempo. Esta nueva versión mejora la experiencia del desarrollador en Visual Studio Code.

Primero, para poder utilizar esta nueva version necesitamos actualizar el entorno, veremos eso primero y luego las ocho principales mejoras.

🛠️ Requisitos del Entorno

Para aprovechar la capacidad de APEXlang 26.2 debes contar con lo siguiente:

• Oracle APEX: 26.2
• Oracle SQLcl: 26.3
• Oracle REST Data Services (ORDS): 26.3
• SQL Developer Extension for VS Code: 26.3
• APEXlang Compiler: 26.2

🚀 Las 8 principales mejoras en APEXlang 26.2

Ahora veamos las principales mejoras que viene con esta version.

1. Exportación de Traducciones

Ahora podemos exportar las traducciones de la aplicación desde la CLI mediante el flag -exptranslations:

SQL> apex export -applicationid 106 -exptype apexlang -exptranslations

Cuando se exporta una aplicación con esta instrucción se agrega a la estructura de la exportación la sub-carpeta generated-artifacts:

simple-app

 ├── application.apx
 ├── deployments
 │    └── default.json
 └── generated-artifacts
      └── translations.sql

Esto facilita la gestión y el versionado en en GIT.

2. Descomposición granular: 7 nuevos tipos de componentes con archivos .apx propios

APEXlang continúa modularizandose. En esta versión, 7 componentes nuevos se independizan y se exportan en sus propios archivos .apx:

• Listas de valores (LOVs)
• Fuentes de vistas duales y JSON (Dual Views & JSON Sources)
• Listas de navegación y Rutas de navegación (Breadcrumbs)
• Definiciones de Carga de Datos (Data Load Definitions)
• Consultas de informes y layouts de informes (Report Queries & Layouts)
• Configuraciones de búsqueda (Search Configurations)
• Plantillas de Email (Email Templates)

Cuando migres o exportes tu aplicación a APEXlang 26.2 notarás tres cosas:

a) Varios archivos que tienen el contenido modificado (al extraerse componentes compartidos a sus propios archivos).

b) Existencia de nuevos archivos .apx para estos 7 tipos de componentes

c) La eliminación de archivos antiguos que agrupaban estos elementos.

3. Preservación de Sesión Activa (keep session) al Importar desde VS Code

En la Version 26.1 cada vez que importabamos una aplicación al repositorio de metadatos de Oracle APEX desde VS Code, la sesión que teniamos activa en el navegador se invalidaba teniamos que volver a conectarnos.

Ahora, en APEXlang 26.2 al importar la aplicación se incorporó la opción opción keep session, lo que hace posible que al aplicar los cambios la sesión que tenemos activa continúe sin interrupciones.

4. Diff y reconciliación Remota vs Local en VS Code

En esta nueva version tenemos disponible un nuevo botón que permite la comparación (Compare/Diff) en el entorno de VS Code entre lo que esta en el repositorio de metadatos de Oracle APEX y nuestro proyecto local. Con esta funcionalidad podemos:

• Ver las diferencias visuales (diff) línea por línea entre el componente en Oracle APEX (remoto) y nuestro archivo .apx local.
• Podemos traer ("pull") los cambios que fueron realizados en el componente remoto (en Oracle APEX) a nuestro archivo de proyecto local en el .apx local.
• y por último, podemos refrescar la comparación una vez reconciliados los cambios.

5. Importación de Archivos Individuales

La quinta mejora destacable de esta versión es que ahora podemos importar cada archivo .apx modificado desde nuestro entorno local a la base de datos directamente, esto permite ver el impacto de forma inmediata sin tener que importar toda la aplicación.

⚠️ Importante: En esta versión, el orden de importación de cada archivo individual es importante por la dependencia que pueda existir entre estos.

Regla general: Importa primero los Componentes Compartidos (por ejemplo, una Lista de Valores) y posteriormente la Página que depende de dichos componentes.

6. Importación de Múltiples Archivos con -files




Si por otra parte utilizamos la línea de comandos en SQLcl, podemos utilizar la opción -files para facilitar la importación de una lista de archivos modificados.

Para hacerlo, ubicate en el directorio raiz de la aplicación y luego ejecuta el comando, eso hará mas sencilla su ejecución.

SQL> cd hr-app SQL> apex import -files pages/p0002-employees.apx pages/p0003-employee.apx shared-components/static-files.apx shared-components/static-files/app.min.js

💡 A diferencia del punto anterior, gracias al parámetro -files, el orden de los archivos a importar no tiene importancia: el compilador de APEXlang se encarga de resolver las dependencias internas.

7. APEXlang Atlas Learning Tool actualizado

Acompañando la actualización de version, la herramienta de referencia y aprendizaje APEXlang Atlas Learning Tool fue actualizada para incluir un selector de versión de Oracle APEX. Esto permite consultar qué propiedades y sintaxis son válidas específicamente para 26.2 frente a la versión anterior 26.1.

8. Cambio en el Valor por Defecto de Protección de Página (Page Protection)

Reforzando las buenas prácticas de seguridad, el valor por defecto de la propiedad de protección de página en APEXlang cambia:

• Versiones anteriores: Unrestricted
• APEXlang 26.2: Arguments Must Have Checksum

Esto que significa: que a partir de ahora, las páginas creadas mediante APEXlang tendrán ese valor por default en la protección de página exigiendo a que si se pasan parámetros, venga el checksum a menos que se especifique lo contrario.

Resumen

Con la nueva version de APEXlang, la 26.2 se sigue el camino de consolidación del desarrollo declarativo para Oracle APEX. Todas estas mejoras permiten que la experiencia de desarrollo sea más ágil y alineada a las mejores prácticas.

Saludos!

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 35 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 Vice Presidente desde el año 2026. 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 y en 2025 como Oracle ACE Pro por la Corporación Oracle por sus contribuciones a la Comunidad de Usuarios de Tecnologías de Oracle distinción que ha renovado en 2026, tiene amplia experiencia de conducción y formación de equipos de desarrollo de software, es Arquitecto de Software y ha construido mas de 50 soluciones para diversas empresas y gobiernos.