En la entrada anterior, se trato el segundo grupo de funciones y procedimientos del paquete APEX_APPLICATION_INSTALL, en esta nueva entrega, finalizaremos con el último grupo de procedimientos y funciones de este paquete.
Procedimiento SET_APPLICATION_NAME
Este procedimiento define el nombre de la aplicación que se va a instalar.
La sintaxis utilizada es:
APEX_APPLICATION_INSTALL.SET_APPLICATION_NAME;(
p_application_name IN VARCHAR2);
Donde,
p_application_name, es el nombre de la aplicación que se va a instalar y no puede ser mayor a 255 caracteres.
Por ejemplo:
declare
l_name varchar2(255) := ‘Executive Dashboard’;
begin
apex_application_install.set_application_name( p_application_name => l_name );
end;
Procedure SET_AUTHENTICATION_SCHEMA
Utilice este procedimiento para sobreescribir el esquema de autenticación de la aplicación que se va a instalar.
La sintaxis utilizada es:
APEX_APPLICATION_INSTALL.SET_AUTHENTICATION_SCHEME(
p_name IN VARCHAR2 );
Donde,
p_name, es el nombre del esquema de autenticación que se va a activar. Este nuevo esquema debe existir en la aplicación. Si el valor es nulo, se mantiene el esquema de autenticación actual.
Por ejemplo:
begin
apex_application_install.set_authentication_scheme (
p_name => ‘SSO-Production’ );
end;
/
@f100.sql
begin
apex_application_install.set_authentication_scheme (
p_name => null );
end;
/
@f101.sql
Procedimiento SET_AUTO_INSTALL_SUP_OBJ
Este procedimiento establece la instalación automática del valor de los objetos de soporte utilizados durante la importación de la aplicación. Esta configuración es válida solo para instalaciones de línea de comandos. Si el valor se establece en TRUE y la exportación de la aplicación contiene objetos de soporte, automáticamente instala o actualiza los objetos de soporte cuando una aplicación importa desde la línea de comandos.
La sintaxis utilizada es:
APEX_APPLICATION_INSTALL.SET_AUTO_INSTALL_SUP_OBJ(
p_auto_install_sup_obj IN BOOLEAN);
Donde,
p_auto_install_sup_obj, es el valor boleano de instalación automática de objetos de soporte.
Por ejemplo:
begin
apex_application_install.set_auto_install_sup_obj( p_auto_install_sup_obj => true );
end;
Función SET_BUILD_STATUS
Utilice esta función parasobreescribir el valor del atribute estatus de creación de una aplicación que se va a importar.
La sintaxis utilizada es:
Function SET_BUILD_STATUS (
p_build_status IN VARCHAR2 );
Donde,
p_build_status, es el nuevo estatus a definir, el cual puede ser: RUN_AND_BUILD o RUN_ONLY. En el primero los desarrolladores puede ejecutar y editar las aplicaciones y en el segundo no se pueden editar.
Por ejemplo:
begin
apex_application_install.set_build_status (
p_build_status => ‘RUN_ONLY’ );
end;
/
@f100.sql
Procedimiento SET_IMAGE_PREFIX
Este procedimiento establece el prefijo de la imagen de la aplicación de importación. La mayoría de las instancias de Apex utilizan el prefijo de imagen predeterminado de /i/.
La sintaxis utilizada es:
APEX_APPLICATION_INSTALL.SET_IMAGE_PREFIX(
p_image_prefix IN VARCHAR2);
En donde,
p_image_prefix, es el nuevo prefijo de imagen.
Por ejemplo:
declare
l_prefix varchar2(255) := ‘/i/’;
begin
apex_application_install.set_image_prefix( p_image_prefix => l_prefix );
end;
Procedimiento SET_KEEP_SESSIONS
Este procedimiento conserva las sesiones asociadas con la aplicación en las actualizaciones.
La sintaxis utilizada es:
procedure SET_KEEP_SESSIONS (
p_keep_sessions IN BOOLEAN );
En donde,
p_keep_sessions, false es el valor predeterminado. true si se deben conservar las sesiones, false si se deben eliminar. KEEP_SESSIONS_ON_UPGRADE controla el comportamiento predeterminado. Si es N (el valor predeterminado), las sesiones se eliminarán. KEEP_SESSIONS_ON_UPGRADE es un parámetro de instancia.
Por ejemplo:
SQL> exec apex_application_install.set_workspace(p_workspace => ‘FRED_PROD’);
SQL> exec apex_application_install.set_keep_sessions(p_keep_sessions => true);
SQL> @f100.sql
Procedimiento SET_OFFSET
Este procedimiento establece el valor de offset utilizado durante la importación de la aplicación. Utilice el valor de offset para asegurarse de que los metadatos de la definición de la aplicación APEX no entren en conflicto con otros metadatos de la instancia. Para la instalación de una nueva aplicación, normalmente es suficiente llamar al procedimiento generate_offset para que APEX genere este valor por usted.
La sintaxis utilizada es:
APEX_APPLICATION_INSTALL.SET_OFFSET(
p_offset IN NUMBER);
Donde,
p_offset, El valor de offset. El offset debe ser un número entero positivo. En la mayoría de los casos, no necesita especificarlo y, en su lugar, llame a APEX_APPLICATION_INSTALL.GENERATE_OFFSET, que genera un valor aleatorio grande y luego configúrelo en el paquete APEX_APPLICATION_INSTALL.
Por ejemplo:
declare
l_offset number;
begin
l_offset := dbms_random.value(100000000000, 999999999999);
apex_application_install.set_offset( p_offset => l_offset );
end;
Procedimiento SET_PROXY
Utilice este procedimiento para el valor del atributo servidor proxy de la aplicación a ser importada.
La sintaxis utilizada es:
APEX_APPLICATION_INSTALL.SET_PROXY (
p_proxy IN VARCHAR2,
p_no_proxy_domains IN VARCHAR2 DEFAULT NULL );
Donde,
p_proxy, es el servidor proxy. No existe un valor predeterminado. El servidor proxy no puede tener más de 255 caracteres y no debe incluir ningún prefijo de protocolo como http://. Un valor de muestra podría ser: www-proxy.example.co
p_no_proxy_domains, es la lista de dominios para los que no se debe utilizar el servidor proxy. No existe un valor predeterminado.
Por ejemplo:
declare
l_proxy varchar2(255) := ‘www-proxy.example.com’
begin
apex_application_install.set_proxy( p_proxy => l_proxy );
end;
Procedimiento SET_REMOTE_SERVER
Utilice este procedimiento para configurar la URL base y los atributos de host HTTPS para los servidores remotos de la aplicación importada. Los servidores remotos se identifican por su ID estática.
La sintaxis utilizada es:
APEX_APPLICATION_INSTALL.SET_REMOTE_SERVER(
p_static_id IN VARCHAR2,
p_base_url IN VARCHAR2,
p_https_host IN VARCHAR2 DEFAULT NULL );
En donde,
p_static_id, es el identificador estático del objeto servidor remoto.
p_base_url, es el nuevo URL Base a usar para este objeto servidor remoto.
p_https_host, nueva propiedad de host HTTPS para usar con este objeto de servidor remoto. Solo es relevante cuando la URL base es https:// y la versión de la base de datos es 12.2 o superior.
Por ejemplo:
begin
apex_application_install.set_remote_server(
p_static_id => ‘MY_REMOTE_SERVER’,
p_base_url => ‘http://production.example.com’ );
end;
Procedimiento SET_SCHEMA
Utilice esta función para configurar el esquema de análisis («owner») de la aplicación APEX. El usuario de la base de datos de este esquema ya debe existir y este nombre de esquema ya debe estar asignado al espacio de trabajo utilizado para importar la aplicación.
La sintaxis utilizada es:
APEX_APPLICATION_INSTALL.SET_SCHEMA (
p_schema IN VARCHAR2);
Donde,
p_schema, es el nombre del esquema de base de datos.
Por ejemplo:
begin
apex_application_install.set_workspace(‘FRED_PROD’);
apex_application_install.generate_offset;
apex_application_install.set_schema( ‘FREDDY’ );
apex_application_install.set_application_alias( ‘FREDPROD_APP’ );
end;
/
@f645.sql
Procedimiento SET_WORKSPACE_ID
Utilice este procedimiento para definir el identificador del espacio de trabajo para la aplicación que se va a importar
La sintaxis utilizada es:
APEX_APPLICATION_INSTALL.SET_WORKSPACE_ID (
p_workspace_id IN NUMBER);
En donde,
p_workspace_id, es el identificador del espacio de trabajo.
Por ejemplo:
begin
apex_application_install.set_workspace_id(10500);
apex_application_install.generate_offset;
apex_application_install.set_schema( ‘FREDDY’ );
apex_application_install.set_application_alias( ‘FREDPROD_APP’ );
end;
Procedimiento SET_WORKSPACE
Utilice este procedimiento para definir el nombre del espacio de trabajo de la aplicación que se va a instalar.
La sintaxis utilizada es:
procedure SET_WORKSPACE (
p_workspace IN VARCHAR2 );
En donde,
p_workspace, es el nombre del espacio de trabajo.
Por ejemplo:
apex_application_install.set_workspace (
p_workspace => ‘FRED_PROD’ );