¿Cómo explotar los datos de auditorías en Athento ECM desde API?

Athento ECM ofrece un servicio en la API v1 para la consulta de registros de auditorías. La definición es la siguiente:

GET https://<athentohost>/nuxeo/api/athento/v1/audit/workflow

con los siguientes parámetros de request:

• page: es la página actual para obtener resultados
• pageSize: es el tamaño de página para obtener resultados
• queryParams: es el listado de parámetros de query relacionados con el tipo documental de búsqueda de auditorías.
  • bas:eventCategory: para filtrar por la categoría del evento.
  • bas:eventCategories: para filtrar por varias categorías del evento (lista)
  • bas:principalName:para filtrar por el usuario que generó el evento.
  • bas:principalNames: para filtrar por varios autores (lista)
  • bas:startDate: para filtrar por fecha de inicio de búsqueda.
  • bas:endDate: para filtrar por fecha de fin de búsqueda.
  • bas:eventId: para filtrar por el identificador del evento.
  • bas:eventIds: para filtrar por varios eventos (lista)
  • bas:targetDocumentType: para filtrar por el tipo documental del documento final.
  • bas:targetDocumentUUID: para filtrar por el docid del documento final (similar a en parameters poner uuid)
  • bas:targetDocumentPath: para filtrar por el path del documento.
  • bas:logId: para filtrar por un id de log concreto.
• parameters: son los parámetros de contexto para realizar la consulta:
  • uuid: para indicar el identificador del documento sobre el que se quiere realizar la consulta. No es obligatorio y cuando no se añade se obtienen todos los registros del sistema.

Ejemplo:

GET https://<athentohost>/nuxeo/api/athento/v1/audit/workflow?page=0&pageSize=20&queryParams=bas:eventCategory=eventWorkflowCategory,bas:startDate=2019-03-01,bas:endDate=2019-07-31

El resultado será en formato JSON con la información relativa al total y al listado de entradas de auditoría.

Pueden usarse la función now() para localizar por fechas, usando "d", "m" y "y" para establecer un número de días anteriores o posteriores.

Ejemplo para obtener desde un mes anterior hasta el momento de la ejecución:

GET https://<athentohost>/nuxeo/api/athento/v1/audit/workflow?page=0&pageSize=20&queryParams=bas:eventCategory=eventWorkflowCategory,bas:startDate=now(-1m),bas:endDate=now()

Ejemplo para obtener desde un año anterior hasta 10 días después de la ejecución:

GET https://<athentohost>/nuxeo/api/athento/v1/audit/workflow?page=0&pageSize=20&queryParams=bas:eventCategory=eventWorkflowCategory,bas:startDate=now(-1y),bas:endDate=now(10d)