El paquete APEX_APP_SETTING proporciona utilidades que puede utilizar al programar en el entorno de Oracle APEX relacionadas con los componentes compartidos de configuración de aplicaciones. Puede usar el paquete APEX_APP_SETTING para obtener y establecer el valor de la configuración de la aplicación.
Este paquete está compuesto por una función y un procedimiento que se detallan a continuación.
Función GET_VALUE
Esta función obtiene el valor definido de aplicación, para la aplicación actual.
Utiliza la sintaxis:
APEX_APP_SETTING.GET_VALUE(
p_name IN VARCHAR2
p_raise_error IN BOOLEAN DEFAULT FALSE );
Donde:
p_name, es el nombre de la configuración de la aplicación. Se mostrará un error si:
- El nombre de configuración de la aplicación no existe.
- Si la opción de compilación, asociada con la configuración de la aplicación está deshabilitada.
p_raise_error, si se establece en TRUE, el procedimiento genera un error si no existe una configuración de aplicación con el nombre pasado.
Por ejemplo:
declare
l_value varchar2(4000);
begin
l_value := APEX_APP_SETTING.GET_VALUE( p_name => ‘ACCESS_CONTROL_ENABLED’);
end;
Procedimiento SET_VALUE
Este procedimiento cambia el valor de configuración de la aplicación en la aplicación actual.
Su sintaxis es:
APEX_APP_SETTING.SET_VALUE(
p_name IN VARCHAR2,
p_value IN VARCHAR2,
p_raise_error IN BOOLEAN DEFAULT FALSE );
Donde:
p_name, es el nombre de la definición de aplicación. Al igual que la función de arriba levanta las excepciones mencionadas.
p_value, es el valor de la definición de aplicación y puede levantar un error si el valor se define como requerido y se proporciona un valor nulo, o bien, se definen valores válidos y el valor proporcionado no corresponde con uno de los valores válidos.
p_raise_error, si se establece como TRUE, el procedimiento levanta un error si la verificación de la opción de creación falla.
Un ejemplo del procedimiento es:
begin
APEX_APP_SETTING.SET_VALUE(
p_name => ‘ACCESS_CONTROL_ENABLED’,
p_value => ‘Y’ );
end;