ORDS 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.
• Formularios Visuales: 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.
• Modo "Tengo Fé" (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.
• Eliminación Segura e Inteligente: Al eliminar un elemento, la extensión calcula la estrategia correcta según tu versión de ORDS. Por ejemplo, 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.
• 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 ORDS REST Data Services en la barra de actividad (Activity Bar). Verás desplegado tu árbol actual de servicios.

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 Tengo fé, donde podrás modificar comentarios, atributos de paginación o el código fuente de los manejadores.
• Haz clic en Aplicar cambios directo a la DB 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 evaluará la mejor estrategia (Borrado directo o Recreación de plantilla) y te mostrará un panel de advertencia.
• Podrás revisar el código PL/SQL exacto que se generó o aplicar la eliminación directamente.

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.