¿Cómo incluyo una vista de documentos en mi aplicación?

Athento ECM ofrece una vista pública que permite, mediante una query NXQL, mostrar un listado de documentos, esta funcionalidad se cubre con QSearch.

¿Qué es QSearch?

QSearch (Athento Query Search) es una vista destinada a la visualización de documentos  resultado de una query basada en el lenguaje NXQL de Nuxeo ECM.

¿Cómo se usa?

Para usar la vista QSearch de Athento ECM simplemente ha realizar una llamada GET a la siguiente URL:

GET https:/<ATHENTO_HOST>/nuxeo/nxqsearch/default/<DOCUMENT_PATH>@qsearch?contentViewName=query_search&query=<QUERY>&conversationId=0NXMAIN&token=<TOKEN>

donde,

• ATHENTO_HOST: Es la URL de la instancia de Athento ECM.
• DOCUMENT_PATH: Es la ruta de la carpeta por defecto destino donde se crearán nuevos documentos.
• QUERY: Es la query en texto plano (URLEncoded) o en Base64 que queremos mostrar en la vista de resultados.
• TOKEN: Es el token de seguridad para acceder a la vista de forma autenticada.

Obtención del Token de seguridad

Para adquirir el token de seguridad para acceder a la vista de QSearch es necesario realizar una llamada GET autenticada mediante usuario y contraseña.

La llamada es:

GET https:/<ATHENTO_HOST>/nuxeo/authentication/token?applicationName=<APPLICATION_NAME>&deviceId=<DEVICE_ID>&permission=<PERMISSION>

donde,

• ATHENTO_HOST: Es la URL de la instancia de Athento ECM.
• APPLICATION_NAME: Es la aplicación de cliente sobre la que se genera el token.
• DEVICE_ID: Es el dispositivo del cliente sobre el que se genera el token.
• PERMISSION: Son los permisos asociados al token (r, w, rw para lectura, escritura y lectura-escritura respectivamente)

Ej: Obtener un token para lectura escritura asociado a un aplicación AthentoApp y un dispositivo con id MiDispositivo:

GET https:/des.athento.com/nuxeo/authentication/token?applicationName=AthentoApp&deviceId=MiDispositivo&permission=rw