1. Introducción¶
Este manual describe el flujo de integración estándar para GBS Intelligence, que permite la búsqueda biográfica dentro de la base de datos. Cualquier llamada a la API mencionada en este manual debe realizarse de acuerdo con la Especificación de la API de GBS Intelligence.
Important
Cualquier llamada a GBS Intelligence debe realizarse al servidor ETR, como se menciona en la especificación de la API.
2. Inicio de sesión¶
Cualquier solicitud a GBS Intelligence requiere un session-guid autenticado. Para obtener el session-guid, se debe enviar una solicitud de Inicio de sesión proporcionando una combinación de usuario/contraseña válida.
Note
El usuario y la contraseña deben ser los mismos que se utilizan para iniciar sesión en GBDS y otras aplicaciones de Griaule.
La operación de inicio de sesión devolverá un session-guid que debe proporcionarse en todas las solicitudes a GBS Intelligence.
3. Solicitud de lista de campos de búsqueda¶
Cualquier solicitud de búsqueda enviada a GBS Intelligence debe especificar el campo biográfico a utilizar. Para verificar los campos biográficos disponibles para la búsqueda, es posible solicitar la Lista de campos de búsqueda.
Warning
Si el nombre del campo biográfico especificado en la solicitud de búsqueda no coincide con un campo que existe dentro de la base de datos, se devolverá un error.
4. Búsqueda por valor¶
Siempre que se realice una solicitud de búsqueda, se recomienda dividir el flujo de trabajo en dos pasos: contar y listar.
Al contar los resultados disponibles para los criterios de búsqueda dados de antemano, es posible paginar los resultados, evitando cualquier sobrecarga en la recuperación y visualización de los resultados.
Una vez contados los resultados, es posible solicitar y paginar los resultados de búsqueda a través de los parámetros de consulta de la solicitud.
4.1. Contar¶
La solicitud de Contar resultados de búsqueda debe contener el nombre y el valor del campo a buscar.
Important
Cualquier perfil que contenga el valor a buscar dentro del campo biográfico dado se devolverá como resultado de la búsqueda, independientemente de la posición.
- ej. una expresión regular que describe los criterios de búsqueda sería
*valor*, siendo*un comodín que cubre cualquier carácter en cualquier cantidad.
4.2. Listar¶
La solicitud de Listar resultados de búsqueda también debe contener el nombre y el valor del campo a buscar, y los criterios de búsqueda serán los mismos utilizados para contar los resultados.
Esta solicitud acepta parámetros de consulta que se pueden utilizar para filtrar la lista devuelta, como first, que determina la posición del primer resultado devuelto en la lista, y size, que define el número de resultados que se devolverán, a partir del first.
5. Acceso a los detalles del perfil¶
Después de realizar la búsqueda y recuperar los resultados, es posible utilizar los PGUID devueltos para acceder a los detalles del perfil a través de la llamada Solicitud de perfil.
Este método devolverá todos los datos del perfil del PGUID dado, incluidos los datos biográficos e imágenes codificadas en base64.