Agente
Visión General
Gran parte de los ERPs no dispone de APIs abiertas y completas que permitan la integración de estos softwares con otras aplicaciones y soluciones.
Como alternativa, la mayoría de los fabricantes de ERPs permite o tolera una integración a nivel de datos. En este tipo de integración, un agente externo, normalmente un servicio instalado en la misma máquina del banco de datos, tiene acceso a la base de datos y puede ejecutar queries en tablas o vistas del sistema.
Con base en este concepto, creamos el "Agente", una extensión segura de Skyone Studio que puede instalarse en entornos On Premises, utilizando mecanismos de comunicación seguros.
Cuando se utiliza, el Agente es un componente pasivo, ejecutando únicamente solicitudes enviadas por softwares externos o automatizadas en Skyone Studio.
Características Generales del "Agente":
Conectarse localmente a una base de datos o a un recurso REST.
Soporte para múltiples tipos de bases de datos.
Soporte al conjunto completo de recursos REST.
Procesar solicitudes provenientes de cualquier integración en Skyone Studio, con usuarios y permisos distintos.
Conectarse a Skyone Studio y mantener un canal de comunicación abierto para recibir llamadas inmediatamente.
Recibir llamadas tipo “RPC like” desde Skyone Studio, que se mapean en acciones sobre la base de datos o en llamadas REST.
Responder de manera asíncrona a las llamadas de Skyone Studio.
Reiniciarse automáticamente en caso de que la computadora donde está instalado sea reiniciada, sin necesidad de volver a ingresar los datos de autenticación.
Requisitos mínimos
Los requisitos mínimos para ejecutar el Agente son:
Disco: 1 GB libre
Memoria: 512 MB
CPU: 1 core a 1.5 GHz
Instalación
Para descargar e instalar el Agente:
Haz clic en "Terminales" y, a continuación, en "Descargar Agente".
Existen tres opciones de descarga: Windows, Linux y Docker. Elige la opción más adecuada y haz clic en "Download".
Sigue las instrucciones correspondientes al sistema operativo:
Para el sistema operativo Windows:
En la pantalla que aparece al ejecutar la aplicación, haz clic en "Avanzar". Espera a que finalice la instalación.
Una vez que la instalación haya sido realizada con éxito, selecciona la opción "Iniciar Aplicación" y luego haz clic en "Concluir" para finalizar el proceso.
El Agente se inicializará y se presentarán algunos pasos de configuración. Haz clic en "Próximo".
Ingresa tus credenciales de acceso a Skyone Studio y haz clic en "Próximo".
Selecciona la organización (espacio de trabajo) en la que deseas utilizar el Agente, e ingresa un nombre y ubicación para el mismo.
¡Listo! Tu Agente está configurado y preparado para usarse en entornos Windows. Haz clic en "Finalizar" para cerrar el procedimiento de configuración.
Para instalar el Agente en Linux, sigue los pasos a continuación:
Accede al Modo Administrador Es necesario entrar en modo root con el siguiente comando:
Descarga el Instalador Descarga el archivo .deb del Agente utilizando curl:
Instala el Agente Una vez descargado el archivo, ejecuta la instalación del paquete .deb:
Accede a la carpeta de instalación
Ejecuta el Agente
Registra el Agente Registra el terminal con las credenciales proporcionadas:
Tus espacios de trabajo serán listados y deberás seleccionar el que deseas conectar:
Para instalar el Agente en Docker:
Asegúrate de tener Docker instalado en la máquina. Si no lo tienes, sigue el procedimiento disponible [aquí].
Descarga la imagen del Agente:
Una vez finalizada la descarga, ejecuta el Agente con el siguiente comando:
Verifique todas las opciones de configuración a continuación en la pestaña Docker dentro de "Configuraciones".
Conoce más sobre las versiones soportadas del Agente.
Configuraciones
Siga las instrucciones para configurar su Agente, de acuerdo con el sistema operativo:
Al hacer clic en el Agente en Windows, "Configuraciones" es la primera pestaña que se muestra:
Estado del servicio de integración: permite Iniciar, Detener y Reiniciar el servicio de integración. Cuando está detenido, no es posible ejecutar operaciones en Skyone Studio que involucren cuentas conectadas con un Terminal registrado.
Prueba de conexión a Internet: verifica si el Agente está conectado a Internet.
Conexión con el servidor: verifica si el Agente está conectado a los servidores de Skyone Studio.
Límite de procesos concurrentes: permite ajustar la capacidad de procesos en paralelo dentro del rango de 1 a 100. El valor por defecto es 50. Después de cualquier cambio, haz clic en "Aplicar" y luego confirma la reinicialización del servicio del Agente haciendo clic en "Sí", para que los nuevos ajustes entren en vigor.
Permitir certificados SSL no confiables en solicitudes REST/SOAP: al activar esta opción, el Agente permitirá la comunicación aunque el certificado SSL no sea considerado seguro según estándares convencionales. Al activar la opción, aparecerá una ventana para confirmar la reinicialización del servicio y aplicar los cambios.
Indicadores de estado:
Cuando ambos servicios (integración y servidor) funcionan correctamente, el ícono se mostrará verde.
Si hay un problema de conexión, el ícono se mostrará rojo.
Si el Agente está esperando conexión con algún servicio, el ícono se mostrará gris.
Después de registrar el Agente, aparecerá en la pestaña Terminales.
Es posible cerrar la ventana del Agente sin afectar el uso de Skyone Datos, pero la computadora debe permanecer encendida para mantener la comunicación.
Para configurar el Agente en Linux, accede al terminal después de la instalación.
Comandos disponibles:
global_settings -view: permite visualizar las configuraciones globales del Agente, como el estado del servidor y de la integración.global_settings -concurrency_limit (1..100): configura la cantidad de procesos paralelos que el Agente puede manejar dentro del rango 1–100. Valor por defecto: 50.global_settings -allow_unsafe_ssl_certificate true|false: habilita o deshabilita la verificación del certificado SSL del destino antes de realizar una llamada REST/SOAP.
Después de cualquier cambio, es necesario reiniciar el Agente para aplicar las nuevas configuraciones.
Para configurar el Agente en Docker, modifica los campos previamente establecidos durante la instalación:
INTEGRA_ENV_USER=<email>: el correo electrónico utilizado en Skyone Studio.INTEGRA_ENV_PASSWORD=<password>: la contraseña utilizada en Skyone Studio.INTEGRA_ENV_ORGANIZATION_ID=<organization_id>: tu Organization ID, disponible en la sección de instalación de Docker en Skyone Studio.INTEGRA_ENV_AGENT_NAME=<agent_name>: nombre del agente.INTEGRA_ENV_AGENT_LOCATION=<agent_location>: ubicación del agente.INTEGRA_ENV_CONCURRENCY_LIMIT=<concurrency_limit>: configura la cantidad de procesos paralelos que el agente puede manejar dentro del rango 1–100. Valor por defecto: 50.INTEGRA_ENV_ALLOW_UNSAFE_SSL_CERTIFICATES=<allow_unsafe_ssl_certificates>: habilita o deshabilita la verificación del certificado SSL del destino antes de realizar una llamada REST/SOAP.
Logs
Windows:
Existe una pestaña de Logs, de solo lectura, que muestra todos los registros del Agente. Estos registros se actualizarán conforme ocurran nuevos eventos.
Linux y Docker
Es posible acceder a la carpeta de logs dentro del directorio donde se está ejecutando la aplicación.
Ejemplo:
Registro del Agente: Errores Posibles
Los siguientes errores pueden ocurrir al registrar el Agente:
Agent already configured on host (Agente ya configurado en el host)
Skyone Studio identificó que ya existe un Agente previamente configurado en la estación. - Puedes abortar la instalación o, si tienes autorización, ingresar al panel de Skyone Studio y eliminar el Terminal asociado al Agente anterior. Después de eso, podrás intentar la operación nuevamente. - Si no tienes permiso para eliminar el Terminal, es posible que estés intentando instalar el Agente en el Espacio de Trabajo incorrecto. Nota: el mismo Agente puede ser utilizado por múltiples integraciones, por lo que no es necesario realizar instalaciones duplicadas.
Agent name already exists (El nombre del Agente ya existe)
Esto puede ocurrir si deseas mover el Agente de una estación a otra sin perder el trabajo ya realizado en las integraciones que apuntan al Terminal del Agente. - En este caso, debes instalar el Agente en la nueva estación y utilizar el mismo nombre para reemplazar el anterior. - Skyone Datos notificará que el Agente anterior con el mismo nombre será desactivado y reemplazado por el nuevo, solicitando tu confirmación para proceder.
Control channel is not configured (Canal de control no configurado)
Este mensaje aparece únicamente durante la configuración del Agente, antes de ingresar los datos, e indica que el Agente aún no ha sido configurado. No se requiere ninguna acción.
Last updated