🚀Oracle APEX 26.1 — APEX Lang ⚙️

Primeramente exportaremos nuestra aplicación

Descomprímelo y podremos ver la estructura y explorar esos archivos si queremos; por ejemplo, la carpeta Pages contiene (¡sorpresa!) detalles de todas las páginas de la aplicación.

Podemos abrir VS Code y acceder a esta carpeta descomprimida; aquí verás la misma estructura. Ten en cuenta que VS Code ofrece mucha flexibilidad en cuanto a opciones de diseño, así que mostraré este formato y también reorganizaré las ventanas a medida que editemos la aplicación.

En este caso, elijo a Claude de Anthropic como IA, ya que tengo las extensiones de Claude para VS Code, al igual que tengo la extensión de SQL Developer que he conectado a mi instancia de espacio de trabajo de APEX.

Oracle Skills

Antes de que tu agente pueda hacer nada, necesitas instalar las habilidades de base de datos y APEX desde https://github.com/oracle/skills . Las habilidades proporcionan a la IA las capacidades necesarias para trabajar con APEXlang, y la definición que aparece a continuación proviene del sitio web de Oracle enlazado anteriormente.

Desde el CMD o desde el terminal del VSCode ejecutar lo siguiente:

npx skills add oracle/skills/apex

npx skills add oracle/skills/db

Luego verifiquemos que los agentes ya figuren en nuestro entorno

Verifica que el .agents folder se ha creado con la estructura correcta:

.agents/
  ├── apex/
  ├── apexlang/
  └── db/

Configurar Agente IA

¡Una vez verificados los skills, tenemos que ver con qué agente se trabajará! En este caso se usará Claude Code para lo que necesitaríamos crear un archivo CLAUDE.md en donde apuntaremos las skills cargadas.

La ventaja de configurar el archivo CLAUDE.md que apunte a las skills es que se soporta en todos los proyectos.

En este entorno lo que tenemos montado

Archivos montados

C:\VSCode\
├── .agents\skills\
│   ├── apex\SKILL.md    ✓ cargada
│   └── db\SKILL.md      ✓ cargada
├── .claude\
│   ├── CLAUDE.md        ✓ configurado
│   └── settings.json    ✓ permisos bash
└── crm-management-app\  ✓ proyecto APEXlang exportado
    ├── .apex\
    ├── pages\
    └── ...

A continuación mostraré un ejemplo para primer uso:

Cambiar el "name" del breadcrumb y el titulo a una región

En VS Code, la aplicación que hemos exportado en APEXLang, hay que agregar el folder a nuestro entorno y la visualizaremos en el panel del lado izquierdo y usando el agente de IA en este caso Claude Code, indicaremos los cambios que necesitamos realizar.

Una vez que se confirmen los cambios, tenemos que importar con el botón de la derecha, que se encuentra en la parte superior.

Considerar lo siguiente, en caso nos dé este error:

"message": "Multiple workspaces available, use the workspaceId or the workspace option."

[06/11/26, 12:15:37.384] [Worksheet       ] [INFO ] Action details
{
  "action": "Attach",
  "message": "Attached",
  "connection": {
    "name": "Local"
  },
  "session": "http://localhost:57662/20221610/databases/connections/sessions/uS4AxJlFrnCkmirrVfLY-A/",
  "worksheet": {
    "uri": "/c:/VSCode/crm-management-app/pages/p00002-crm-overview.apx"
  }
}
[06/11/26, 12:15:42.292] [APEXLangCommandHandlers] [ERROR] 
[
  {
    "message": "Multiple workspaces available, use the workspaceId or the workspace option."
  }
]

Para poder decir en que WORKSPACE y ID hara la importación necesitamos especificarlo en el archivo: default.json

Fuentes:

https://github.com/oracle/skills

https://docs.oracle.com/en/database/oracle/sql-developer-command-line/26.1/sqcug/apexlang-project-structure-apexlang.html?