Avanzado

Relova — Conector Remoto de Máquinas

Conecta una base de datos externa, hoja de cálculo o API y usa sus filas como máquinas, piezas y proveedores en vivo dentro de iTenance, sin importar o copiar los datos.

Relova enlaza iTenance a un sistema que ya utilizas — un ERP, un historiador SCADA, un registro de activos heredado, una hoja de cálculo compartida — y presenta filas seleccionadas de este como registros normales de iTenance. Los datos nunca se copian en tu espacio de trabajo: cada pantalla lee directamente de la fuente, por lo que lo que ves siempre está actualizado. Las conexiones de Relova son de solo lectura por diseño; Relova nunca puede escribir de vuelta en el sistema al que te conectas.

¿Relova o Importación Masiva?

Ambos traen datos externos. Elige según si la fuente sigue cambiando.

Usa la Importación Masiva cuando…

  • Tienes un archivo único (una lista de proveedores, un registro inicial de activos).
  • Quieres que los registros se conviertan en datos de iTenance completamente editables.
  • La fuente no cambiará, o estás dispuesto a reimportar cuando lo haga.

Usa Relova cuando…

  • La fuente es un sistema en vivo que se actualiza por sí mismo (ERP, historiador, MES).
  • Quieres que las lecturas o estados de las máquinas se reflejen sin una nueva carga.
  • Quieres que una condición remota (temperatura, horas de funcionamiento, señal de falla) genere una orden de trabajo automáticamente.

Antes de empezar

  • El módulo Máquinas Remotas Relova debe estar activo en tu plan. Configuración → Módulos, o pregunta al propietario de tu cuenta.
  • Necesitas el permiso Administrar configuración — Relova se encuentra en Configuración.
  • Ten listos los detalles de conexión de la fuente: host, puerto, nombre de la base de datos y un nombre de usuario y contraseña de solo lectura. Crea una cuenta dedicada de solo lectura en la fuente si puedes.
  • Si la fuente solo acepta conexiones desde dentro de su propia red, ten acceso SSH a un host que pueda alcanzarla (Relova puede tunelizar a través de él).

Paso 1 — Abrir Relova

Ve a Configuración → Relova. La pestaña General muestra cuatro contadores — Conexiones, Errores, Mapeos de módulos, Referencias virtuales — y una lista de tus conexiones. La tira de pestañas debajo del título (General · Conexiones · Mapeos · Disparadores) te mueve entre las pantallas.

En una configuración completamente nueva, cada contador es cero y la lista muestra “Aún no hay conexiones configuradas” con un botón Crear tu primera conexión — ese es el Paso 2.

Paso 2 — Añadir una conexión

Abre la pestaña Conexiones y haz clic en Nueva conexión (arriba a la derecha, el botón “+”). Rellena el formulario:

  • Nombre de la conexión — una etiqueta que reconocerás, por ejemplo, “ERP de Producción”.
  • Controlador de base de datos — MySQL / MariaDB, PostgreSQL, SQL Server, Oracle, SAP HANA, o un archivo CSV / Excel, o una API REST. El resto del formulario cambia para coincidir.
  • Host, Puerto, Base de datos, Esquema — dirección de red de la fuente. El puerto se rellena automáticamente desde el controlador.
  • Usuario / Contraseña — las credenciales de solo lectura. Se cifran antes de almacenarse y nunca se muestran de nuevo; deja la contraseña en blanco al editar para mantener la actual.
  • Caché de esquema — cuánto tiempo (en segundos) Relova puede reutilizar la lista de tablas y columnas antes de volver a leerla. 300 (5 minutos) es un buen valor predeterminado; 0 desactiva el almacenamiento en caché.
  • Modo de consulta — Virtual lee de la fuente en cada vista (más reciente). Instantánea mantiene una copia en caché de corta duración para listas más rápidas. Bajo demanda solo lee cuando alguien abre el registro.

Túnel SSH (opcional)

Activa el túnel SSH cuando la fuente solo es accesible desde dentro de una red privada. Proporciona el host SSH, el puerto y el usuario, y pega una clave privada (recomendado) o una contraseña. Deja el host SSH en blanco para tunelizar a través del propio host de la base de datos.

Fuentes CSV / Excel

Para un controlador de archivo, proporciona la ruta absoluta al archivo en el servidor y elige el delimitador. El archivo se lee en su lugar; colócalo en un lugar al que tu servidor siempre pueda acceder, por ejemplo, una carpeta sincronizada.

Haz clic en Probar conexión primero — Relova abre la conexión, ejecuta una lectura inofensiva e informa del éxito o del error exacto. Cuando pase, haz clic en Guardar. La conexión aparece en la lista con un punto de estado.

Estados de conexión

  • Conectado — la última comprobación fue exitosa.
  • Degradado — accesible pero lento o devuelve advertencias.
  • Error — la última comprobación falló. Abre la conexión para ver por qué; usa Probar conexión después de corregir.
  • Deshabilitado — lo desactivaste. Los registros mapeados dejan de resolverse hasta que lo vuelvas a habilitar.

Cada fila tiene Probar, Editar, Habilitar / Deshabilitar y Eliminar. Al eliminar una conexión también se eliminan sus mapeos y cada referencia virtual que produjo.

Paso 3 — Explorar la fuente (opcional pero útil)

Desde una fila de conexión, elige Explorador de esquema (el icono de la base de datos). Elige la conexión y Relova listará sus tablas a la izquierda. Haz clic en una tabla para ver sus columnas —nombre, tipo, anulable, clave— y haz clic en Previsualizar datos para ver las primeras filas. Usa esto para encontrar los nombres exactos de tablas y columnas que necesitarás en el Paso 4. Actualizar vuelve a leer el esquema y borra la caché.

Paso 4 — Mapear una tabla a un módulo

Aquí es donde las filas remotas se convierten en registros de iTenance. Abre la pestaña Mapeos y haz clic en Nuevo mapeo.

  • Conexión y Tabla de origen — qué tabla remota alimenta este mapeo.
  • Nombre del mapeo — ej. “Activos ERP”.
  • Módulo de destino — Máquinas / Equipos, Repuestos, Inventario, Proveedores, Ubicaciones. Esto decide en qué se convierten las filas.
  • Instalaciones — delimita el mapeo a una instalación, o déjalo abierto. Una orden de trabajo generada a partir de este mapeo se archivará en esta instalación.
  • Columna de clave remota — la columna que identifica de forma única cada fila remota (normalmente id). Relova la usa para mantener las referencias estables entre sincronizaciones.

Mapeos de columnas

Haz clic en Añadir mapeo para cada campo que quieras rellenar: elige un campo local (ej. machine_name) y la columna remota que lo alimenta. Los campos marcados con * son obligatorios — el módulo no aceptará un registro hasta que estén mapeados. El panel te indica cuándo se han cubierto todos los campos obligatorios.

Campos de visualización

Marca las columnas que deben aparecer en la instantánea del registro — los valores que se muestran en las listas y en la página de registro remoto. Limita esto a lo que la gente realmente necesita ver.

Valores predeterminados estáticos y uniones

Usa valores predeterminados para rellenar una columna local obligatoria que no tiene una fuente remota sensible — por ejemplo, un location_id fijo, o un machine_id para anclar cada fila de este mapeo a una máquina de iTenance. Usa uniones para extraer una columna de una tabla remota relacionada sin una vista de base de datos.

Comportamiento de sincronización

Virtual — siempre en vivo. Caché de instantáneas — almacena en caché cada fila durante el TTL de caché que establezcas (minutos). Bajo demanda — solo se lee cuando se abre. Añade una columna de detección de cambios (ej. updated_at) para que Relova pueda buscar solo las filas que cambiaron desde la última sincronización en lugar de toda la tabla.

Haz clic en Previsualizar para ver las filas en bruto junto al resultado mapeado, luego en Guardar. Relova indexa las filas remotas y comienzan a aparecer en el módulo de destino, cada una marcada como un registro remoto.

Viviendo con registros remotos

  • Una máquina remota se ve como cualquier otra en las listas y en su página de detalles, con una pequeña insignia que la marca como remota.
  • Los campos que provienen de la fuente (nombre, modelo, número de serie, lecturas) son de solo lectura en iTenance. Actualizar desde la fuente en el registro obtiene los valores más recientes.
  • Las relaciones solo locales — ubicación, fabricante, categoría, instalaciones — se configuran con Editar relaciones y permanecen en iTenance; una sincronización nunca las sobrescribe.
  • Puedes generar órdenes de trabajo, añadir tareas y registrar tiempos de inactividad contra una máquina remota exactamente como de costumbre.

Paso 5 — Generar órdenes de trabajo automáticamente (Disparadores)

Abre la pestaña Disparadores y haz clic en Nueva regla. Un disparador observa un campo de las filas sincronizadas de un mapeo y abre una orden de trabajo en el momento en que el valor cumple tu condición.

  • Mapeo a observar — qué filas del mapeo se observarán (esto también establece las instalaciones en las que se archivará la orden de trabajo).
  • Nombre — para qué es esta regla, ej. “Temperatura excesiva del rodamiento”.
  • Cuando el campo — una columna de la instantánea sincronizada (empieza a escribir para ver sugerencias de los campos de visualización del mapeo), ej. temperature.
  • Operador — Supera / Cae por debajo de / Es igual a / Mayor que / Contiene texto / Es uno de / Cambia en absoluto, y así sucesivamente.
  • Valor — el número o texto con el que comparar. “Es uno de” toma una lista; “Cambia en absoluto” no necesita valor.
  • Prioridad — la prioridad que obtiene la orden de trabajo creada (Baja / Normal / Alta / Crítica).
  • Enfriamiento — minutos que la regla permanece en silencio después de dispararse, para que un valor que fluctúa alrededor del umbral no cree una pila de duplicados. 1440 = un día.
  • Plantillas de título / descripción — la redacción de la orden de trabajo. Inserta valores remotos con {nombre_columna}, ej. Alerta de rodamiento: {temperatura}°C en {nombre_maquina}. Déjalo en blanco para un valor predeterminado sensible.
Guardar. La regla se muestra en la lista con su condición, prioridad y enfriamiento; la franja de Actividad reciente a continuación registra cada vez que coincidió, se omitió (enfriamiento) o creó una orden de trabajo. Usa el interruptor en una fila para pausar una regla sin eliminarla.
La orden de trabajo se archiva en las instalaciones del mapeo. Se vincula a una máquina de iTenance solo cuando esa máquina está realmente ligada a la fila remota — un registro sombra materializado, o una máquina que nombraste en los valores predeterminados del mapeo. Los valores remotos se usan solo para la redacción, nunca para elegir en qué máquina aterriza la orden de trabajo.

Seguridad y aislamiento

  • Solo lectura, siempre. Relova bloquea cualquier instrucción que no sea una lectura. No puede INSERTAR, ACTUALIZAR, ELIMINAR ni cambiar el esquema de origen.
  • Las credenciales se cifran en reposo con una clave separada de los demás datos de tu aplicación, y nunca se devuelven al navegador.
  • Las solicitudes salientes están protegidas. Relova se niega a conectarse a rangos de direcciones internas/loopback a menos que su operador haya incluido explícitamente un host en la lista de permitidos, lo que evita que un formulario de conexión apunte a la infraestructura interna.
  • Cada conexión, mapeo y referencia remota está limitada a su tenant. Un tenant nunca podrá ver ni consultar los datos de Relova de otro tenant.
  • Los límites de filas y los tiempos de espera de consulta se aplican a cada lectura directa, por lo que un mapeo incorrecto no puede extraer un conjunto de resultados ilimitado.

Solución de problemas

La prueba de conexión falla inmediatamente.

Host/puerto incorrecto, o el firewall de origen no permite su servidor iTenance. Confirme los detalles con un cliente de base de datos desde la misma red, luego agregue el túnel SSH si el origen es privado.

La conexión se prueba correctamente pero las listas están vacías.

El mapeo no tiene campos obligatorios cubiertos, o el nombre de la tabla de origen es incorrecto. Vuelva a verificar el Paso 4 con el navegador de esquema y use Vista previa.

“Los campos obligatorios aún no están mapeados”.

Una columna local NOT-NULL sin valor predeterminado no está mapeada. Mapee una columna remota a ella o asígnele un valor predeterminado.

Los valores parecen obsoletos.

El mapeo está en modo Instantánea: reduzca el TTL de la caché, agregue una columna de detección de cambios o cámbielo a Virtual. En un registro, use Actualizar desde el origen.

Relova en el dominio central no muestra nada.

Relova siempre funciona desde un espacio de trabajo de tenant. Ábralo desde su dirección de tenant normal, no desde el dominio de inicio de sesión central.

Ver también