AHORA DocuHub

La integración con la aplicación AHORA DocuHub está disponible desde la versión 5.0.0.52.

Esta integración permite la descarga automática de documentación centralizada y contextualizada a una versión concreta, permitiendo la inclusión o modificación de ayuda, artículos, noticias de interés o vídeos formativos de forma inmediata y transparente al usuario, sin necesidad de actualizar el propio ERP.

Integración

Es importante tener presente que la integración AHORA ERP con AHORA DocuHub requiere de la instalación y ejecución de AHORA API. Toda la lógica de sincronización de los nodos de ayuda se ha implementado en AHORA API, por tanto, antes de comenzar con el proceso de sincronización es imprescindible asegurarse de los siguientes puntos:

• Existe una API en un equipo o servidor accesible desde el equipo en el que se está ejecutando el ERP. Esta API debe estar en ejecución, con la URL:PUERTO habilitado para su uso (evitando el bloqueo de antivirus y cortafuegos) y apuntando a la misma base de datos del ERP.
• La API tiene acceso a internet para poder comunicarse con el servicio de AHORA DocuHub para la obtención de la ayuda.
• El parámetro de configuración API_URL está debidamente informado y apuntando a dicha API.

En el caso de AHORA DocuHub no es necesario pasar por el formulario de Integraciones puesto que la configuración inicial se despliega por defecto desde fábrica y no es posible ni desactivarla ni modificarla. Es decir, la aplicación DocuHub no aparecerá en el desplegable de aplicaciones aunque internamente sí se utilizará.

Sincronizaciones

Para permitir la regeneración manual de la ayuda se habilita un nuevo mantenimiento de sincronizaciones en el menú de AHORA Business Hub.

Desde este mantenimiento se puede visualizar todas las ejecuciones de sincronización de DocuHub, así como lanzar manualmente una nueva acción de sincronización.

Se permite el filtrado por rango de fechas sobre la fecha de Inicio, así como mostrar sólo las sincronizaciones con error.

Los datos mostrados son:

• Id. Sincro: es el identificador numérico del registro de sincronización.
• Fech. Inicio: es la fecha en la que se comenzó la sincronización. El formato de fecha incluye milisegundos para poder visualizar el tiempo de ejecución exacto de una tarea de sincronización.
• Fec. Fin: el tiempo de finalización de la tarea. Si este campo está vacío es porque la tarea de sincronización o está en ejecución actualmente, o no finalizó de forma correcta.
• Mensaje: en caso de error, en este campo se mostraría el mensaje devuelto por la API. Un doble click con el ratón abre un visor con el texto completo.

Desde este mismo mantenimiento es posible lanzar una tarea se sincronización manual.

Sincronización Automática

La instalación y arranque de AHOR API (versión igual o superior a 5.0.0.52) ejecuta una primera sincronización con DocuHub además de programar una tarea que realizará la sincronización cada 24 Horas.

En el fichero de configuración (appsettings.json) de AHORA API se encuentra la definición del tiempo entre sincronizaciones, con un valor por defecto de 1440 minutos (24 horas). Para modificar la frecuencia será necesario editar el fichero de configuración (campo MinutesCheckDocuHub) y reiniciar el servicio Windows asociado a la misma para aplicar el cambio. 

La sincronización automática, no obstante, tienes ciertas reglas de ejecución introducidas para evitar ejecuciones concurrentes innecesarias, así como para recuperar el sistema ante posibles errores:

1. Si la última sincronización no ha finalizado (no tiene Fecha Fin)
   1. Si lleva más de 10 minutos sin finalizar (desde la Fecha Inicio), se finaliza con el mensaje "Superado el tiempo máximo de ejecución" y se lanza una nueva sincronización.
   2. Si lleva menos de 10 minutos no se lanzará la ejecución automática y se esperará el tiempo definido de espera (24 horas). 
2. Si la última sincronización ha finalizado (tiene Fecha Fin)
   1. Si lleva más de 1 hora finalizada se ejecuta una nueva  sincronización.
   2. Si lleva menos de 1 hora finalizada se toma como actualización reciente y no se volverá a ejecutar la sincronización hasta el tipo definido de espera (24 horas).

Los valores utilizados para controlar tanto las tareas sin finalizar (MinutesCheckHang) como la concurrencia entre tareas (MinutesCheckConcurrence) también son parámetros del fichero de configuración que se puede editar para ajustar a la casuística específica de cada entornos productivo. Así, por ejemplo, en servidores lentos o con conexión inestable se podría aumentar el tiempo de las tareas sin finalizar para darles más margen hasta finalizar.

En cualquier caso, si la sincronización automática no se ha ejecutado, siempre se tiene la opción de ejecución manual desde el mantenimiento de sincronizaciones.