Llamar a procedimientos de manera visual en Oracle APEX-Invoke API

 Desde APEX 22.2 está disponible el tipo de proceso INVOKE API que consiste en llamar de forma declarativa al procedimiento, función o paquete a ejecutar como parte del procesamiento de una página web de la aplicación.

Para ejemplificar el uso del proceso Llamar a API  se ha creado una aplicación de nombre Gestor de Proyectos, basada en la tabla PROYECTO con la siguiente estructura:

CREATE TABLE "PROYECTO" 

(      

  "PROYECTO_ID" NUMBER(6,0)

    GENERATED BY DEFAULT ON NULL PRIMARY KEY, 

  "NOMBRE_PROYECTO" VARCHAR2(120) NOT NULL ENABLE, 

  "MONTO_PROYECTO" NUMBER(7,3) NOT NULL ENABLE, 

  "FECHA_INICIO" DATE DEFAULT TO_DATE(SYSDATE), 

  "ESTADO_PROYECTO" VARCHAR2(30)

);

El procedimiento de nombre establecer_estado_proyecto_por_monto  contiene el siguiente código:

create or replace procedure establecer_estado_proyecto_por_monto(

    p_proyecto_id number,

                                                                  p_monto_proyecto number)

  as

    var_estado_proyecto varchar2(30);

 begin

     if p_monto_proyecto>10000 then

         var_estado_proyecto:='ANALISIS';

     end if;

     update proyecto

         set estado_proyecto=var_estado_proyecto

      where  proyecto_id=p_proyecto_id;

      commit;

 end;

/

Agregar a la aplicación una página de tipo Informe Interactivo de nombre Proyectos basada en la tabla Proyecto, deberá incluir una pantalla de edición(formulario o pantalla).

Las instrucciones a seguir para la aplicación de este tipo de proceso se detalla a continuación:

1) Abra la página de tipo pantalla de nombre Proyecto, esta es la pantalla de edición creada con el informe interactivo.

2) Seleccionar la región de Procesos y con el botón derecho del mouse hacer clic sobre procesos y elegir la opción Crear Proceso del menú contextual. 

3) En el panel de propiedades del proceso, llenar el cuadro de propiedades con los  datos de la siguiente imagen:

4) Clic en el botón Guardar.

Una vez guardados los cambios, el proceso tendrá los parámetros del procedimiento como se muestra en la siguiente imagen:

Al ejecutar la aplicación e introducir los datos desde el formulario, se obtiene el siguiente resultado:

Entre los dos proyectos insertados, solo el proyecto con monto de 15000 USD. pasa al estado de ANALISIS como lo define el procedimiento almacenado invocado.

Como conclusión, el proceso Llamada a API facilita la invocación de procedimientos almacenados debido a que se trata de un componente visual que automáticamente asocia los elementos de la página web con los parámetros del procedimiento llamado.

Roberto Párraga Zambrano