Oracle REST Data Services Generator

Extensión para Visual Studio Code diseñada para gestionar y generar scripts PL/SQL de Oracle REST Data Services (ORDS) directamente desde tu editor. Replica la experiencia del árbol de "REST Data Services" de SQL Developer, permitiéndote explorar, crear, editar y eliminar módulos, plantillas y métodos de forma rápida y segura.

Características Principales

• Explorador Integrado: Visualiza tus servicios REST en un árbol jerárquico (Módulo → Plantilla → Métodos) directamente en la barra lateral de VS Code.
• Generador: Interfaz amigable para crear o modificar módulos, plantillas y manejadores (GET, POST, PUT, DELETE) sin tener que escribir o recordar la sintaxis de los paquetes PL/SQL (ORDS.DEFINE_MODULE, ORDS.DEFINE_TEMPLATE, etc.) a mano.
• Eliminación Segura e Inteligente: Al borrar un método específico, genera un script de recreación dinámico para conservar el resto de la configuración del módulo intacta.
• Modo Experto (Edición Directa): Modifica parámetros, consultas (SQL) o código (PL/SQL) de tus servicios y aplica los cambios a la base de datos con un solo clic.
• Auto-escapado de Comillas: Pega tus consultas SQL tal cual las probaste; la extensión se encarga de escapar las comillas simples automáticamente al generar el PL/SQL.

Requisitos

• Esta extensión requiere que tengas instalada y configurada la extensión oficial Oracle SQL Developer Extension for VS Code.
• Utiliza las conexiones a bases de datos Oracle definidas en esa extensión para consultar el árbol de ORDS y aplicar los cambios.

Uso

1. Explorar el Árbol de ORDS

Selecciona una conexión a tu base de datos y abre la vista de Oracle REST Data Services en la barra de actividad (Activity Bar). Verás desplegado tu árbol actual de servicios. En la parte superior del panel, encontrarás botones para Seleccionar conexión y Refrescar árbol.

2. Crear Nuevos Servicios

• Nuevo Módulo: Haz clic en el icono + (Nuevo módulo) en la parte superior del panel del árbol de ORDS.
• Nueva Plantilla: Haz clic derecho sobre un Módulo existente y elige Agregar Plantilla.
• Nuevo Manejador: Haz clic derecho sobre una Plantilla existente y elige Agregar Manejador. (Nota: El formulario consultará la base de datos para detectar qué métodos HTTP ya están en uso y solo te permitirá agregar los que estén disponibles).

3. Editar Elementos Existentes

Haz clic derecho sobre cualquier Módulo, Plantilla o Método y selecciona Editar.

• Se abrirá la pestaña Generar, donde podrás modificar comentarios, atributos de paginación o el código fuente de los manejadores.
• Haz clic en Aplicar script para ejecutar automáticamente los ajustes en tu conexión activa.

4. Eliminar Elementos

Haz clic derecho sobre cualquier nodo y selecciona Eliminar.

• La extensión generará el script de eliminación correspondiente y te mostrará una vista previa.
• Podrás revisar el código PL/SQL exacto generado antes de aplicar la eliminación.

5. Modo Experto

Haz clic en la pestaña Modo Experto. Al hacer clic derecho para Editar o Eliminar un nodo en el árbol de ORDS, el contexto se cargará directamente en esta pestaña para que puedas modificar y aplicar los cambios al instante sin necesidad de confirmación intermedia. Si esta pestaña no está activa, las funciones de Editar o Eliminar se cargarán en sus respectivas secciones estándar.

6. Exportar Todo

Haz clic en el icono de descarga (Exportar todo) en la parte superior del panel del árbol de ORDS.

• Esta función generará y exportará un script SQL con todos los módulos, plantillas y manejadores de la conexión actual.

Acerca del Proyecto

Esta herramienta está pensada para agilizar drásticamente el flujo de desarrollo de APIs REST sobre Oracle Database, ahorrándote el trabajo tedioso y repetitivo de formatear cadenas de texto o lidiar con las limitaciones de algunas versiones antiguas de ORDS. También evita tener que salir de VS Code para poder crear nuevas APIs REST.

Desarrollado para simplificar la vida de los desarrolladores en bases de datos Oracle.