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
