Manual de Acceso a USUG a través del package

Manual de Acceso a USUG a
través del package
USU_PACK_USUARIO
Versión 1.0
Área de Integración y Arquitectura de Aplicaciones
MANUAL INTERNO
Manual de Acceso a USUG a través del package
USU_PACK_USUARIO
Hoja de Control
Título
Manual de Acceso a USUG a través del package USU_PACK_USUARIO
Documento de Referencia
Responsable
Área de Integración y Arquitectura de Aplicaciones
Versión
1.0
Fecha Versión
06/02/2013
Registro de Cambios
Versión
Causa del Cambio
Responsable del Cambio
Fecha del Cambio
Área de Integración y Arquitectura de
1.0
Versión inicial del documento
Aplicaciones
2 de 14
06/02/2013
MANUAL INTERNO
Manual de Acceso a USUG a través del package
USU_PACK_USUARIO
Índice
1.
INTRODUCCIÓN ................................................................................................................................................................ 4
2.
USU_PACK_USUARIO ....................................................................................................................................................... 4
2.1. FUNCIÓN CONSULTA .................................................................................................................................................... 4
2.1.1.
Documentación ....................................................................................................................................................... 4
2.1.2.
Especificación ......................................................................................................................................................... 4
2.2. FUNCIÓN CONSULTA_NIF ........................................................................................................................................... 5
2.2.1.
Documentación ....................................................................................................................................................... 5
2.2.2.
Especificación ......................................................................................................................................................... 6
2.3. FUNCIÓN CONSULTA_LOGIN ..................................................................................................................................... 6
2.3.1.
Documentación ....................................................................................................................................................... 6
2.3.2.
Especificación ......................................................................................................................................................... 7
2.4. FUNCIÓN CONSULTA_PERFILES ................................................................................................................................ 7
2.4.1.
Documentación ....................................................................................................................................................... 7
2.4.2.
Especificación ......................................................................................................................................................... 8
2.5. FUNCIÓN CONSULTA_PERFIL..................................................................................................................................... 8
2.5.1.
Documentación ....................................................................................................................................................... 8
2.5.2.
Especificación ......................................................................................................................................................... 9
2.6. FUNCIÓN CONSULTA_PERFIL_BD ............................................................................................................................. 9
2.6.1.
Documentación ....................................................................................................................................................... 9
2.6.2.
Especificación ....................................................................................................................................................... 10
2.7. FUNCIÓN CONSULTA_USUARIOS_PERFIL ............................................................................................................. 10
2.7.1.
Documentación ..................................................................................................................................................... 10
2.7.2.
Especificación ....................................................................................................................................................... 11
2.8. FUNCIÓN CONSULTA_PERFILES_WS ...................................................................................................................... 11
2.8.1.
Documentación ..................................................................................................................................................... 11
2.8.2.
Especificación ....................................................................................................................................................... 13
2.9. FUNCIÓN CONSULTA_USUARIOS_PERFIL_WS ..................................................................................................... 13
2.9.1.
Documentación ..................................................................................................................................................... 13
2.9.2.
Especificación ....................................................................................................................................................... 14
3 de 14
MANUAL INTERNO
Manual de Acceso a USUG a través del package
USU_PACK_USUARIO
1. INTRODUCCIÓN
El presente documento explica como ralizar consultas de logines USUG (Intranet) a través del package de base de
datos USU_PACK_USUARIO.
2. USU_PACK_USUARIO
2.1.
Función CONSULTA
2.1.1.
Documentación
·
FUNCIÓN: CONSULTA
·
DESCRIPCIÓN: Devuelve los diferentes campos del cod. usuario suministrado
·
PARÁMETROS:
w_Cd_Usuario: Parámetro de Entrada Obligatorio. Varchar2(12).
z_Ds_Usuario: Parámetro de Salida. Varchar2(150)
z_Ds_Direccion Parámetro de Salida. Varchar2(150)
z_Ds_Telefono: Parámetro de Salida. Varchar2(30)
z_Ds_Organismo: Parámetro de Salida. Consejería. Varchar2(150)
z_Ds_Dependencia: Parámetro de Salida. Varchar2(150)
z_Ds_Puesto_Trabajo: Parámetro de Salida. Varchar2(150)
z_Cd_Email: Parámetro de Salida. Varchar2(40)
z_Fc_Alta_Usu: Parámetro de Salida. Date
z_Fc_Mod_Usu: Parámetro de Salida. Date
z_Fc_Baja_Usu: Parámetro de Salida. Date
z_Dni: Parámetro de Salida. Varchar2(9)
z_Usu_Icm Parámetro de Salida. Varchar2(1). Usuario de Icm
z_Ds_Nombre: Parámetro de Salida. Varchar2(50)
z_Ds_Apell1: Paráemtro de Salida. Varchar2(50)
z_Ds_Apell2: Parámetro de Salida. Varchar2(50)
z_Mensaje_Err: Parámetro de Salida. Mensaje de Error.
·
VALORES DE RETORNO DE LA FUNCIÓN:
0 - True (El cod. Usuario suministrado se ha encontrado en el repositorio)
1 - False (El cod .usuario suministado no se ha encontado en el repositorio)
2 - False (Cuando no se suministra el parámetro obligatorio cod. Usuario, cualquier otro Error, el error se
espcifica en el parámetro z_Mensaje_Err)
********************************************************************************************/
2.1.2.
Especificación
FUNCTION CONSULTA
(w_Cd_Usuario IN Usu_Usuario.Cd_Usuario%TYPE,
z_Ds_Usuario OUT Usu_Usuario.Ds_Usuario%TYPE,
4 de 14
MANUAL INTERNO
Manual de Acceso a USUG a través del package
USU_PACK_USUARIO
z_Ds_Direccion OUT Usu_Usuario.Ds_Direccion%TYPE,
z_Ds_Telefono OUT Usu_Usuario.Ds_Telefono%TYPE,
z_Ds_Organismo OUT Usu_Usuario.Ds_Organismo%TYPE,
z_Ds_Dependencia OUT Usu_Usuario.Ds_Dependencia%TYPE,
z_Ds_Puesto_Trabajo OUT Usu_Usuario.Ds_Puesto_Trabajo%TYPE,
z_Cd_Email OUT Usu_Usuario.Cd_Email%TYPE,
z_Fc_Alta_Usu OUT Usu_Usuario.Fc_Alta_Usu%TYPE,
z_Fc_Mod_Usu OUT Usu_Usuario.Fc_Mod_Usu%TYPE,
z_Fc_Baja_Usu OUT Usu_Usuario.Fc_Baja_Usu%TYPE,
z_Dni OUT Usu_Usuario.Dni%TYPE,
z_Usu_Icm OUT Usu_Usuario.Usu_Icm%TYPE,
z_Ds_Nombre OUT Usu_Usuario.Ds_Nombre%TYPE,
z_Ds_Apell1 OUT Usu_Usuario.Ds_Apell1%TYPE,
z_Ds_Apell2 OUT Usu_Usuario.Ds_Apell2%TYPE,
z_Mensaje_Err OUT Varchar2) RETURN Integer;
2.2.
Función CONSULTA_NIF
2.2.1.
Documentación
·
FUNCIÓN: CONSULTA_NIF
·
DESCRIPCIÓN: Devuelve los diferentes campos del nif suministrado
·
PARÁMETROS:
w_Dni: Parámetro de Entrada Obligatorio. Varchar2(12).
z_Cd_Usuario: Parámetro de Salida. Varchar2(12)
z_Ds_Usuario: Parámetro de Salida. Varchar2(150)
z_Ds_Direccion Parámetro de Salida. Varchar2(150)
z_Ds_Telefono: Parámetro de Salida. Varchar2(30)
z_Ds_Organismo: Parámetro de Salida. Consejería. Varchar2(150)
z_Ds_Dependencia: Parámetro de Salida. Varchar2(150)
z_Ds_Puesto_Trabajo: Parámetro de Salida. Varchar2(150)
z_Cd_Email: Parámetro de Salida. Varchar2(40)
z_Fc_Alta_Usu: Parámetro de Salida. Date
z_Fc_Mod_Usu: Parámetro de Salida. Date
z_Fc_Baja_Usu: Parámetro de Salida. Date
z_Usu_Icm Parámetro de Salida. Varchar2(1). Usuario de Icm
z_Ds_Nombre: Parámetro de Salida. Varchar2(50)
z_Ds_Apell1: Paráemtro de Salida. Varchar2(50)
z_Ds_Apell2: Parámetro de Salida. Varchar2(50)
5 de 14
MANUAL INTERNO
Manual de Acceso a USUG a través del package
USU_PACK_USUARIO
z_Mensaje_Err: Parámetro de Salida. Mensaje de Error.
·
VALORES DE RETORNO DE LA FUNCIÓN:
0 - True (El nif suministrado se ha encontrado en el repositorio)
1 - False (El nif suministado no se ha encontado en el repositorio)
2 - False (Cuando no se suministra el parámetro obligatorio nif)
3 - False (El nif suministrado tiene 2 o más logines asociados, devuelve el primero de ellos (rownum=1))
4 - False (cualquier otro Error, el error se espcifica en el parámetro z_Mensaje_Err)
2.2.2.
Especificación
FUNCTION CONSULTA_NIF
(w_Dni IN Usu_Usuario.Dni%TYPE,
z_Cd_Usuario OUT Usu_Usuario.Cd_Usuario%TYPE,
z_Ds_Usuario OUT Usu_Usuario.Ds_Usuario%TYPE,
z_Ds_Direccion OUT Usu_Usuario.Ds_Direccion%TYPE,
z_Ds_Telefono OUT Usu_Usuario.Ds_Telefono%TYPE,
z_Ds_Organismo OUT Usu_Usuario.Ds_Organismo%TYPE,
z_Ds_Dependencia OUT Usu_Usuario.Ds_Dependencia%TYPE,
z_Ds_Puesto_Trabajo OUT Usu_Usuario.Ds_Puesto_Trabajo%TYPE,
z_Cd_Email OUT Usu_Usuario.Cd_Email%TYPE,
z_Fc_Alta_Usu OUT Usu_Usuario.Fc_Alta_Usu%TYPE,
z_Fc_Mod_Usu OUT Usu_Usuario.Fc_Mod_Usu%TYPE,
z_Fc_Baja_Usu OUT Usu_Usuario.Fc_Baja_Usu%TYPE,
z_Usu_Icm OUT Usu_Usuario.Usu_Icm%TYPE,
z_Ds_Nombre OUT Usu_Usuario.Ds_Nombre%TYPE,
z_Ds_Apell1 OUT Usu_Usuario.Ds_Apell1%TYPE,
z_Ds_Apell2 OUT Usu_Usuario.Ds_Apell2%TYPE,
z_Mensaje_Err OUT Varchar2) RETURN Integer;
2.3.
Función CONSULTA_LOGIN
2.3.1.
Documentación
·
FUNCIÓN: CONSULTA_LOGIN
·
DESCRIPCIÓN: Devuelve el login filtrando por dni y aplicación
·
PARÁMETROS:
w_Dni: Parámetro de Entrada Obligatorio. Varchar2(12).
w_Cd_Aplicacion: Parámetro de Entrada. Varchar2(4)
6 de 14
MANUAL INTERNO
Manual de Acceso a USUG a través del package
USU_PACK_USUARIO
w_Cd_Usuario: Parámetro de Salida. Varchar2(12)
z_Mensaje_Err: Parámetro de Salida. Descripción de Mensaje de Error
·
VALORES DE RETORNO DE LA FUNCIÓN:
0 - True (El dni, aplicacion suministrado se ha encontrado en el repositorio)
1 - False (El cod .usuario suministado no se ha encontado en el repositorio)
2 - False (Cuando no se suministran los parámetro obligatorios Dni y Cod. Aplicacion. Cualquier otro Error,
el error se espcifica en el parámetro z_Mensaje_Err)
3 - False (El dni solicitado tiene 2 logines asociados a la aplicación)
2.3.2.
Especificación
FUNCTION CONSULTA_LOGIN
(w_Dni IN Varchar2,
w_Cd_Aplicacion IN Varchar2,
z_Cd_Usuario OUT Varchar2,
z_Mensaje_Err OUT Varchar2) RETURN Integer;
2.4.
Función CONSULTA_PERFILES
2.4.1.
Documentación
·
FUNCIÓN: CONSULTA_PERFILES
·
DESCRIPCIÓN: Devuelve todos los grupos y su descripción de una aplicación
·
PARÁMETROS:
w_Cd_Aplicacion: Parámetro de Entrada. Varchar2(4)
z_Perfiles USU_PACK_USUARIO.Tipo_Perfil (éste tipo contiene las variables Cd_Perfil Number(3), Ds_Perfil
Varchar2(30))
z_Mensaje_Err: Parámetro de Salida. Descripción de Mensaje de Error
·
VALORES DE RETORNO DE LA FUNCIÓN:
0 - True (Se han encontrado grupos de la aplicación solicitada)
1 - False (El parámetro suministrado Cod. Aplicacion es obligatorio)
2 - False (No existe ésta aplicación)
3 - False (Ésta Aplicación no tiene perfiles)
4 - False (cualquier otro Error, el error se especifica en el parámetro z_Mensaje_Err)
EJEMPLO de LLAMADA a ésta Función:
7 de 14
MANUAL INTERNO
Manual de Acceso a USUG a través del package
USU_PACK_USUARIO
DECLARE
v_Perfiles USU_PACK_USUARIO.Tipo_Perfil;
v_mensaje_err Varchar2(4000);
v_resultado Number;
BEGIN
v_resultado := USU_PACK_USUARIO.CONSULTA_PERFILES('AAAA', v_Perfiles,
v_Mensaje_Err);
IF (v_resultado = 0) THEN
FOR i IN v_Perfiles.FIRST..v_Perfiles.LAST LOOP
DBMS_OUTPUT.PUT_LINE(TO_CHAR(v_Perfiles(i).Cd_Perfil));
DBMS_OUTPUT.PUT_LINE(v_Perfiles(i).Ds_Perfil);
END LOOP;
v_Perfiles.DELETE; -- Borrar y liberar memoria, para evitar colapsar la base de datos
-ELSIF (v_resultado <> 0) THEN DBMS_OUTPUT.PUT_LINE(v_Mensaje_Err);
-- Proceso de Gestion del error
END IF;
END;
2.4.2.
Especificación
FUNCTION CONSULTA_PERFILES
(w_Cd_Aplicacion IN Varchar2,
z_Perfiles OUT USU_PACK_USUARIO.Tipo_Perfil,
z_Mensaje_Err OUT Varchar2) RETURN Integer;
2.5.
Función CONSULTA_PERFIL
2.5.1.
Documentación
·
FUNCIÓN: CONSULTA_PERFIL
·
DESCRIPCIÓN: Devuelve el grupo y la descripción al que pertenece el usuario y aplicación suministrados
Solo devuelve el grupos si la aplicacion esta dada de alta en una única base de datos
·
PARÁMETROS:
w_Cd_Aplicacion: Parámetro de Entrada. Varchar2(4)
w_Cd_Usuario: Parámetro de entrada Varchar2(12)
z_Perfil Usu_Pack_Usuario.Tipo_Perfil (éste tipo contiene las variables Cd_Perfil Number(3), Ds_Perfil
Varchar2(30))
8 de 14
MANUAL INTERNO
Manual de Acceso a USUG a través del package
USU_PACK_USUARIO
z_Mensaje_Err: Parámetro de Salida. Descripción de Mensaje de Error
·
VALORES DE RETORNO DE LA FUNCIÓN:
0 - True (Se han encontrado grupos de la aplicación solicitada)
1 - False (Los parámetros Cod. Aplicacion y Cod. Usuario son obligatorios)
2 - False (No existe ésta Aplicación)
3 - False (No existe éste Usuario)
4 - False (Ésta Aplicación-Usuario no tiene perfil)
5 - False (Ésta Aplicación-Usuario está dada de alta en diferentes bases de datos. No se puede obtener el
perfil)
6 - False (Cualquier otro Error, el error se especifica en el parámetro z_Mensaje_Err)
2.5.2.
Especificación
FUNCTION CONSULTA_PERFIL
(w_Cd_Aplicacion IN Varchar2,
w_Cd_Usuario IN Varchar2,
z_Cd_Perfil OUT Usu_Perfil.Cd_Perfil%TYPE,
z_Ds_Perfil OUT Usu_Perfil.Ds_Perfil%TYPE,
z_Mensaje_Err OUT Varchar2) RETURN Integer;
2.6.
Función CONSULTA_PERFIL_BD
2.6.1.
Documentación
·
FUNCIÓN: CONSULTA_PERFIL_BD
·
DESCRIPCIÓN: Devuelve el grupo y la descripción al que pertenece el usuario, aplicación y base de datos
suministrados
·
PARÁMETROS:
w_Cd_Aplicacion: Parámetro de Entrada. Varchar2(4)
w_Cd_Usuario: Parámetro de entrada Varchar2(12)
w_Cd_Bd: Parámetro de entrada Varchar2(30) (Base de datos)
z_Perfil Usu_Pack_Usuario.Tipo_Perfil (éste tipo contiene las variables Cd_Perfil Number(3), Ds_Perfil
Varchar2(30))
z_Mensaje_Err: Parámetro de Salida. Descripción de Mensaje de Error
·
VALORES DE RETORNO DE LA FUNCIÓN:
0 - True (Se han encontrado grupos de la aplicación solicitada)
9 de 14
MANUAL INTERNO
Manual de Acceso a USUG a través del package
USU_PACK_USUARIO
1 - False (Los parámetros Cod. Aplicacion, Cod. Usuario y Base de Datos son obligatorios)
2 - False (No existe ésta Aplicación)
3 - False (No existe éste Usuario)
4 - False (No existe ésta Base de Datos)
5 - False (La Aplicación-Base de datos No están asociadas)
6 - False (Ésta Aplicación-BaseDatos-Usuario no tiene Perfil)
7 - False (Cualquier otro Error, el error se especifica en el parámetro z_Mensaje_Err)
2.6.2.
Especificación
FUNCTION CONSULTA_PERFIL_BD
(w_Cd_Aplicacion IN Varchar2,
w_Cd_Usuario IN Varchar2,
w_Cd_Bd IN Varchar2,
z_Cd_Perfil OUT Usu_Perfil.Cd_Perfil%TYPE,
z_Ds_Perfil OUT Usu_Perfil.Ds_Perfil%TYPE,
z_Mensaje_Err OUT Varchar2) RETURN Integer;
2.7.
Función CONSULTA_USUARIOS_PERFIL
2.7.1.
Documentación
·
FUNCIÓN: CONSULTA_USUARIOS_PERFIL
·
DESCRIPCIÓN: Devuelve todos los usuarios y su descripción que pertenecen al Perfil de aplicación
suministrado
·
PARÁMETROS:
w_Cd_Aplicacion: Parámetro de Entrada. Varchar2(4)
w_Cd_Perfil: Parámetro de Entrada. Number(3)
z_Usuarios USU_PACK_USUARIO.Tipo_Usuario (éste tipo contiene las variables Cd_Usuario
Varchar2(12), Ds_Usuario Varchar2(150))
z_Mensaje_Err: Parámetro de Salida. Descripción de Mensaje de Error
·
VALORES DE RETORNO DE LA FUNCIÓN:
0 - True (Se han encontrado grupos de la aplicación solicitada)
1 - False (Los parámetros suministrados Cod. Aplicacion y Cod. Perfil son obligatorios)
2 - False (No existe ésta Aplicación)
3 - False (Ésta Aplicación-Perfil no existe)
4 - False (Ésta Aplicación-Perfil no tiene Usuarios)
10 de 14
MANUAL INTERNO
Manual de Acceso a USUG a través del package
USU_PACK_USUARIO
5 - False (Ésta Aplicación-Perfil está dada de alta en diferentes bases de datos. No se pueden obtener los
usuarios)
6 - False (cualquier otro Error, el error se especifica en el parámetro z_Mensaje_Err)
EJEMPLO de LLAMADA a ésta Función:
DECLARE
v_Usuarios USU_PACK_USUARIO.Tipo_Usuario;
v_mensaje_err Varchar2(4000);
v_resultado Number;
BEGIN
v_resultado := USU_PACK_USUARIO.CONSULTA_USUARIOS_PERFIL('AAAA', 1, v_Usuarios,
v_Mensaje_Err);
IF (v_resultado = 0) THEN
FOR i IN v_Usuarios.FIRST..v_Usuarios.LAST LOOP
DBMS_OUTPUT.PUT_LINE(v_Usuarios(i).Cd_Usuario);
DBMS_OUTPUT.PUT_LINE(v_Usuarios(i).Ds_Usuario);
END LOOP;
v_Usuarios.DELETE; -- Borrar y liberar memoria, para evitar colapsar la base de datos
-ELSIF (v_resultado <> 0) THEN DBMS_OUTPUT.PUT_LINE(v_Mensaje_Err);
-- Proceso de Gestion del error
END IF;
END;
2.7.2.
Especificación
FUNCTION CONSULTA_USUARIOS_PERFIL
(w_Cd_Aplicacion IN Varchar2,
w_Cd_Perfil IN Number,
z_Usuarios OUT USU_PACK_USUARIO.Tipo_Usuario,
z_Mensaje_Err OUT Varchar2) RETURN Integer;
2.8.
Función CONSULTA_PERFILES_WS
2.8.1.
Documentación
·
FUNCIÓN: CONSULTA_PERFILES_WS
·
DESCRIPCIÓN: Devuelve todos los grupos y su descripción de una aplicación
11 de 14
MANUAL INTERNO
Manual de Acceso a USUG a través del package
USU_PACK_USUARIO
Ésta función es para ejecución del WEBSERVICE
·
PARÁMETROS:
w_Cd_Aplicacion: Parámetro de Entrada. Varchar2(4)
z_Perfiles OUT Usu_Pack_Usuario.Cur_Usuario (éste cursor contiene las variables Cd_Perfil Number(3),
Ds_Perfil Varchar2(30))
z_Mensaje_Err: Parámetro de Salida. Descripción de Mensaje de Error
VALORES DE RETORNO DE LA FUNCIÓN:
0 - True (Se han encontrado grupos de la aplicación solicitada)
1 - False (El parámetro suministrado Cod. Aplicacion es obligatorio)
2 - False (No existe ésta aplicación)
3 - False (Ésta Aplicación no tiene perfiles)
4 - False (cualquier otro Error, el error se especifica en el parámetro z_Mensaje_Err)
EJEMPLO de LLAMADA a ésta Función:
DECLARE
v_Perfiles Usu_Pack_Usuario.Cur_Perfil;
v_mensaje_err Varchar2(4000);
v_resultado Number;
Reg_Perfiles Usu_Pack_Usuario.Reg_Perfil;
BEGIN
v_resultado := USU_PACK_USUARIO.CONSULTA_PERFILES('AAAA', v_Perfiles,
v_Mensaje_Err);
IF (v_resultado = 0) THEN
LOOP
FETCH v_Perfiles INTO Reg_Perfiles;
EXIT WHEN v_Perfiles%NOTFOUND;
DBMS_OUTPUT.PUT_LINE(TO_CHAR(Reg_Perfiles.Cd_Perfil));
DBMS_OUTPUT.PUT_LINE(Reg_Perfiles.Ds_Perfil);
END LOOP;
CLOSE v_Perfiles; -- Es obligatorio cerrar el cursor para no dejar cursores abiertos en la base de
datos y no colapsar la base de datos
-ELSIF (v_resultado <> 0) THEN DBMS_OUTPUT.PUT_LINE(v_Mensaje_Err);
-- Proceso de Gestion del error
END IF;
END;
12 de 14
MANUAL INTERNO
Manual de Acceso a USUG a través del package
USU_PACK_USUARIO
2.8.2.
Especificación
FUNCTION CONSULTA_PERFILES_WS
(w_Cd_Aplicacion IN Varchar2,
z_Perfiles OUT DBA_USU.Usu_Pack_Usuario.Cur_Perfil,
z_Mensaje_Err OUT Varchar2) RETURN Integer;
2.9.
Función CONSULTA_USUARIOS_PERFIL_WS
2.9.1.
Documentación
·
FUNCIÓN: CONSULTA_USUARIOS_PERFIL_WS
·
DESCRIPCIÓN: Devuelve todos los usuarios y su descripción que pertenecen al Perfil de aplicación
suministrado
Ésta función es para ejecución del WEBSERVICE
·
PARÁMETROS:
w_Cd_Aplicacion: Parámetro de Entrada. Varchar2(4)
w_Cd_Perfil: Parámetro de Entrada. Number(3)
z_Usuarios Usu_Pack_Usuario.Tipo_Usuario (éste tipo contiene las variables Cd_Usuario Varchar2(12),
Ds_Usuario Varchar2(150))
z_Mensaje_Err: Parámetro de Salida. Descripción de Mensaje de Error
·
VALORES DE RETORNO DE LA FUNCIÓN:
0 - True (Se han encontrado grupos de la aplicación solicitada)
1 - False (Los parámetros suministrados Cod. Aplicacion y Cod. Perfil son obligatorios)
2 - False (No existe ésta Aplicación)
3 - False (Ésta Aplicación-Perfil no existe)
4 - False (Ésta Aplicación-Perfil no tiene Usuarios)
5 - False (Ésta Aplicación-Perfil está dada de alta en diferentes bases de datos. No se pueden obtener los
usuarios)
6 - False (cualquier otro Error, el error se especifica en el parámetro z_Mensaje_Err)
·
EJEMPLO de LLAMADA a ésta Función:
DECLARE
v_Usuarios Usu_Pack_Usuario.Cur_Usuario;
v_mensaje_err Varchar2(4000);
v_resultado Number;
Reg_Usuarios Usu_Pack_Usuario.Reg_Usuario;
13 de 14
MANUAL INTERNO
Manual de Acceso a USUG a través del package
USU_PACK_USUARIO
BEGIN
v_resultado := USU_PACK_USUARIO.CONSULTA_USUARIOS_PERFIL('AAAA', 1, v_Usuarios,
v_Mensaje_Err);
IF (v_resultado = 0) THEN
LOOP
FETCH v_Usuarios INTO Reg_Usuarios;
EXIT WHEN v_Usuarios%NOTFOUND;
DBMS_OUTPUT.PUT_LINE(Reg_Usuarios.Cd_Usuario);
DBMS_OUTPUT.PUT_LINE(Reg_Usuarios.Ds_Usuario);
END LOOP;
CLOSE v_Usuarios; -- Es obligatorio cerrar el cursor para no dejar cursores abiertos en la base de
datos y no colapsar la base de datos
-ELSIF (v_resultado <> 0) THEN DBMS_OUTPUT.PUT_LINE(v_Mensaje_Err);
-- Proceso de Gestion del error
END IF;
END;
2.9.2.
Especificación
FUNCTION CONSULTA_USUARIOS_PERFIL_WS
(w_Cd_Aplicacion IN Varchar2,
w_Cd_Perfil IN Number,
z_Usuarios OUT DBA_USU.Usu_Pack_Usuario.Cur_Usuario,
z_Mensaje_Err OUT Varchar2) RETURN Integer;
14 de 14