La operación Consultar perfil (queryProfile): está englobada en el Servicio User Web Service que da soporte a la gestión de usuarios. Esta operación se emplea con el objetivo de obtener la lista de perfiles del sistema.
Este servicio es controlado por el componente UIM (módulo de Información de Usuarios).
El método acepta de entrada una estructura con la clave privada de acceso al servicio. Realiza consulta en la BD para obtener la lista completa de perfiles.
Devuelve como respuesta una estructura con una variable que indica ue indica si la consulta ha tenido éxito o no, una lista de perfiles y un mensaje correspondiente a la operación realizada.
queryProfile(string privatekey);
Parámetros de Entrada |
privatekey |
string clave para poder acceder al servicio privado. Parámetro obligatorio no nulo.
|
Valores de Salida |
result |
structure con los valores de salida:
boolean |
validation |
true si tiene éxito en la consulta en la BD, false si no. |
list string |
profiles |
Lista de perfiles del sistema. |
string |
message |
Mensaje de éxito o de error y su tipo. |
|
Ejemplo Petición XML
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.cos.acg.ual.es/">
<soapenv:Header/>
<soapenv:Body>
<ws:queryProfile>
<privatekey>"ejemplo clave"</privatekey>
</ws:queryProfile>
</soapenv:Body>
</soapenv:Envelope>
Ejemplo Respuesta XML
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:queryProfileResponse xmlns:ns2="http://ws.cos.acg.ual.es/">
<result>
<validation> "ejemplo true o false" </validation>
<profiles> "ejemplo perfil" </profiles>
...
<profiles> "ejemplo perfil" </profiles>
<message> "ejemplo mensaje de exito o de error" </message>
</result>
</ns2:queryProfileResponse>
</soap:Body>
</soap:Envelope>
Mensajes de Error |
Internal Server Error
|
Se producen por fallos en el servidor al buscar alguna clase necesaria para la ejecución.
|
Private key Error
|
Se produce por clave privada incorrecta. El servicio es Privado y se necesita una clave para acceder a él.
|
PSQLException
|
Se producen por problemas en la conexión a la base de datos.
|
Example Error Response XML
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:queryProfileResponse xmlns:ns2="http://ws.cos.acg.ual.es/">
<result>
<validation> false </validation>
<message> > Private key Error </message>
</result>
</ns2:queryProfileResponse>
</soap:Body>
</soap:Envelope>
>