Mecanismos de Integración con Athento

Hemos visto en otras entradas cómo el ECM se puede usar como hub de información de la organización para centralizar en un único punto la documentación corporativa. Eso pasa por supuesto, por integrar las aplicaciones de negocio contra el gestor documental para que sean capaces de introducir y consultar información desde él entre otras operaciones. En esta entrada, veremos los dos principales Mecanismos de Integración con Athento.

Athento.js

Athento.js es un Javascript embebido en aplicaciones externas que permite exponer diversas funcionalidades del gestor documental:

• Formularios de creación de documentos
• Previsualización de documentos
• Listado de documentos
• Búsqueda de documentos, etc.

El uso de los embebibles de Athento facilita las labores de integración y, además, tiene la ventaja de que cualquier cambio realizado en Athento será visible en todas las aplicaciones integradas sin tener que hacer ninguna modificación.

API REST

El repositorio proporciona una REST API completa accesible a través de HTTP / HTTPS. Esta API es la mejor manera de integrar de forma remota con el repositorio: portales, motores de flujo de trabajo, ESB, aplicaciones desarrolladas en JavaScript, Ruby, etc. La API REST está disponible en servidores Nuxeo en la siguiente URL: http: // localhost: 8080 / Nuxeo / api / v1 / *

En la siguiente URL encontrará ejemplos de llamadas a servicios web básicos de la plataforma:

https://athento.atlassian.net/wiki/pages/viewpage.action?pageId=43548711


El API provee de los siguientes endpoints:

Endpoints de recursos, para hacer CRUD sobre recursos 100% al estilo REST.

• Variedad de recursos son accesibles:
• Documentos (/nuxeo/api/v1/id/{docId} o /nuxeo/api/v1/path/{path}): CRUD en documentos (incluida la búsqueda paginada). 
• Usuarios (/nuxeo/api/v1/user/{userId}): CRUD en usuarios. 
• Grupos (/nuxeo/api/v1/group/{groupId}): CRUD en grupos de usuarios. 
• Directorios (/nuxeo/api/v1/directory/{directoryId}): CRUD en directorios. 
• Tipos documentales, esquemas de metadatos, facetas y definiciones (/nuxeo/api/v1/config/types|schemas|facets/{type|schema|facet}): Esto es útil cuando se están haciendo inmersiones remotas de la estructura del repositorio, etc.

Queries 

Accesibles desde (nuxeo/site/api/v1/query?query={query} o /nuxeo/site/api/v1/query/{page_provider_name}?queryParams={params_values}

Endpoint de comandos

Se utilizan para llamar un comando, por ejemplo, en una operación o cadena de operaciones desplegadas en el servidor. Esta es la principal forma de acceder a los servicios de la plataforma de forma remota. Más de 100 comandos están accesibles de esta manera para el procesamiento remoto de recursos. El framework de desarrollo hace muy fácil el añadir una operación personalizada para completar el API.

Endpoint de carga masiva

(/nuxeo/api/v1/automation/batch/upload}), permite subir conjuntos de ficheros antes de usarlos en una operación transaccional, como por ejemplo, actualizar el contenido de una lista de documentos, etc.

• La API REST de Nuxeo ofrece funcionalidad adicional comparada con una API REST estándar:
• Permite secuenciar la ejecución de un comando sobre un recurso. 
• Contribuciones REST que permiten pedir más información cuando se reciben los recursos a través de algunos headers, con el objetivo de reducir el número de request a efectuar. 
• Adaptadores web que “transforman” los recursos devueltos, por ejemplo, obtener las tareas de un documento o sus documentos relacionados.

Más información sobre la API REST de Nuxeo desde aquí:

Puedes consultar ejemplos sencillos de la API aquí

SDKs Disponibles

Para facilitar el uso de la API en la integración con Nuxeo, este provee varios SDK:

• Java client 
• JavaScript client 
• iOS client 
• Android client 
• PHP client (implementación parcial) 
• DART client

Puente SOAP

La plataforma incluye una implementación de JAX-WS para acceder a servicios SOAP. Concretamente, se usa Sun JAX-WS (Metro). Por defecto, los servicios SOAP incluyen:

• Acceso de lectura al repositorio y a la gestión de usuarios. 
• Acceso de lectura al módulo de Audit 
• Bindings de CMIS

De cualquier manera, es fácil construir nuevos servicios SOAP sobre Nuxeo, ya que:

• Ya tiene la infraestructura JAX-WS
• Ya cuenta con el sistema de autenticación 
• Provee la clase base para manejar repositorio y seguridad. 
• Provee objetos JAXB para documentos, descriptores de seguridad, propiedades, etc.