Guía de Integración de Intelligence

Introducción

Este manual describe el flujo de trabajo de integración estándar de GBS Intelligence, que permite la búsqueda biográfica en la base de datos. Cualquier llamada a la API mencionada en este manual debe realizarse de acuerdo con la Especificación de API de GBS Intelligence .

Todas las llamadas a GBS Intelligence deben realizarse al servidor ETR, según se menciona en la especificación de la API.

Inicio de sesión

Cualquier solicitud a GBS Intelligence requiere un inicio de sesión autenticado session-guid. Para obtenerlo, es necesario enviar session-guiduna solicitud de inicio de sesión, proporcionando una combinación válida de usuario/contraseña.

El usuario y la contraseña deben ser los mismos usados para iniciar sesión en GBDS y otras aplicaciones Griaule.

La operación de inicio de sesión devolverá un session-guid que debe proporcionarse en todas las solicitudes a GBS Intelligence.

Lista de Campos de Búsqueda por Request

Cualquier request de búsqueda sometida a GBS Intelligence debe especificar el campo biográfico a utilizar. Para verificar los campos biográficos disponibles, se puede usar listSearchFields

Si el nombre del campo biográfico especificado en la solicitud de búsqueda no coincide con un campo que exista en la base de datos, se devolverá un error.

Buscando por Valor

Al realizar una solicitud de búsqueda, se recomienda dividir el flujo de trabajo en dos pasos: conteo y lista.

Al contar los resultados disponibles para los criterios de búsqueda proporcionados con antelación, es posible paginar los resultados, evitando cualquier sobrecarga al recuperar y visualizar los resultados.

Después de contar los resultados, es posible solicitar y paginar los resultados de la búsqueda mediante los parámetros de consulta de la solicitud.

Contar

La solicitud de resultados de búsqueda de conteo debe contener los campos namey valuea ser buscados.

Cualquier perfil que contenga el valor a buscar dentro del campo biográfico proporcionado será devuelto como resultado de la búsqueda, independientemente de la posición.

por ejemplo, una expresión regular que describa los criterios de búsqueda sería *value*, siendo *un comodín que abarca cualquier carácter en cualquier cantidad.

Lista

La solicitud de Resultados de Búsqueda de Lista también debe contener los campos namey valuea ser buscados, y los criterios de búsqueda serán los mismos usados para contar los resultados.

Esta solicitud acepta parámetros de consulta que pueden usarse 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 a devolver, comenzando por el first.

Accediendo a detalles del perfil

Después de realizar la búsqueda y recuperar los resultados, es posible usar los PGUIDs devueltos para acceder a los detalles del perfil mediante la llamada Request Profile.

Este método devolverá todos los datos del perfil del PGUID proporcionado, incluidos datos biográficos e imágenes codificadas en base64.

Herramienta de conversión de imagen

GBS Intelligence también proporciona un método para convertir imágenes en diferentes formatos, proporcionando la imagen original codificada en base64, su formato y el formato deseado para la conversión.