Avanzate

Relova — Connettore Macchine Remoto

Connetti un database esterno, un foglio di calcolo o un'API e usa le sue righe come macchine, parti e fornitori live all'interno di iTenance, senza importare o copiare i dati.

Relova collega iTenance a un sistema che già gestisci — un ERP, uno storico SCADA, un registro patrimoniale legacy, un foglio di calcolo condiviso — e presenta le righe selezionate come normali record iTenance. I dati non vengono mai copiati nel tuo tenant: ogni schermata legge dalla sorgente, quindi ciò che vedi è sempre attuale. Le connessioni Relova sono di sola lettura per impostazione predefinita; Relova non può mai scrivere nel sistema a cui ti connetti.

Relova o Importazione Massiva?

Entrambi importano dati esterni. Scegli in base a se la sorgente continua a cambiare.

Usa Importazione Massiva quando…

  • Hai un file una tantum (un elenco fornitori, un registro patrimoniale iniziale).
  • Vuoi che i record diventino dati iTenance completamente modificabili.
  • La sorgente non cambierà, o sei disposto a reimportare quando lo farà.

Usa Relova quando…

  • La sorgente è un sistema live che si aggiorna autonomamente (ERP, storico, MES).
  • Vuoi che le letture o gli stati della macchina siano riflessi senza un nuovo caricamento.
  • Vuoi che una condizione remota (temperatura, ore di funzionamento, flag di guasto) generi automaticamente un ordine di lavoro.

Prima di iniziare

  • Il modulo Relova Remote Machines deve essere attivo sul tuo piano. Configurazione → Moduli, o chiedi al proprietario dell'account.
  • Hai bisogno del permesso Gestisci impostazioni — Relova si trova in Impostazioni.
  • Prepara i dettagli di connessione della sorgente: host, porta, nome del database e un nome utente e password di sola lettura. Crea un account di sola lettura dedicato sulla sorgente se possibile.
  • Se la sorgente accetta solo connessioni dall'interno della propria rete, disponi dell'accesso SSH a un host che possa raggiungerla (Relova può tunnellizzare attraverso di esso).

Passo 1 — Apri Relova

Vai su Impostazioni → Relova. La scheda Panoramica mostra quattro contatori — Connessioni, Errori, Mappature modulo, Riferimenti virtuali — e un elenco delle tue connessioni. La barra delle schede sotto il titolo (Panoramica · Connessioni · Mappature · Trigger) ti sposta tra le schermate.

In una configurazione completamente nuova ogni contatore è a zero e l'elenco mostra “Nessuna connessione configurata ancora.” con un pulsante Crea la tua prima connessione — questo è il Passo 2.

Passo 2 — Aggiungi una connessione

Apri la scheda Connessioni e clicca Nuova connessione (in alto a destra, il pulsante “+”). Compila il modulo:

  • Nome connessione — un'etichetta che riconoscerai, ad es. “ERP Produzione”.
  • Driver database — MySQL / MariaDB, PostgreSQL, SQL Server, Oracle, SAP HANA, o un file CSV / Excel, o un'API REST. Il resto del modulo cambia di conseguenza.
  • Host, Porta, Database, Schema — indirizzo di rete della sorgente. La porta viene pre-compilata dal driver.
  • Nome utente / Password — le credenziali di sola lettura. Vengono crittografate prima di essere memorizzate e non vengono mai più mostrate; lascia la password vuota durante la modifica per mantenere quella attuale.
  • Cache schema — per quanto tempo (in secondi) Relova può riutilizzare l'elenco di tabelle e colonne prima di rileggerlo. 300 (5 minuti) è un buon valore predefinito; 0 disabilita la cache.
  • Modalità query — Virtuale legge dalla sorgente ad ogni visualizzazione (più recente). Snapshot mantiene una copia cache di breve durata per elenchi più veloci. Su richiesta legge solo quando qualcuno apre il record.

Tunnel SSH (opzionale)

Attiva Tunnel SSH quando la sorgente è raggiungibile solo dall'interno di una rete privata. Fornisci l'host SSH, la porta e l'utente, e incolla una chiave privata (consigliato) o una password. Lascia l'host SSH vuoto per tunnellizzare attraverso l'host del database stesso.

Sorgenti CSV / Excel

Per un driver di file, fornisci il percorso assoluto al file sul server e scegli il delimitatore. Il file viene letto in loco — mettilo in un luogo che il tuo server possa sempre raggiungere, ad es. una cartella sincronizzata.

Clicca Test connessione prima — Relova apre la connessione, esegue una lettura innocua e segnala il successo o l'errore esatto. Quando passa, clicca Salva. La connessione appare nell'elenco con un punto di stato.

Stati connessione

  • Connesso — l'ultimo controllo è riuscito.
  • Degradato — raggiungibile ma lento o con avvisi.
  • Errore — l'ultimo controllo è fallito. Apri la connessione per vedere perché; usa Test connessione dopo aver risolto.
  • Disabilitato — l'hai spenta. I record mappati smettono di risolversi finché non la riabiliti.

Ogni riga ha Test, Modifica, Abilita / Disabilita ed Elimina. L'eliminazione di una connessione rimuove anche le sue mappature e ogni riferimento virtuale che ha prodotto.

Passaggio 3 — Sfoglia la sorgente (facoltativo ma utile)

Da una riga di connessione scegli Schema browser (l'icona del database). Scegli la connessione e Relova elenca le sue tabelle a sinistra. Fai clic su una tabella per vedere le sue colonne — nome, tipo, nullable, chiave — e fai clic su Anteprima dati per vedere le prime righe. Usalo per trovare i nomi esatti di tabelle e colonne che ti serviranno nel Passaggio 4. Aggiorna rilegge lo schema e svuota la cache.

Passaggio 4 — Mappa una tabella su un modulo

È qui che le righe remote diventano record iTenance. Apri la scheda Mappature e fai clic su Nuova mappatura.

  • Connessione e Tabella sorgente — quale tabella remota alimenta questa mappatura.
  • Nome mappatura — ad es. "Asset ERP".
  • Modulo di destinazione — Macchine / Attrezzature, Ricambi, Inventario, Fornitori, Posizioni. Questo decide cosa diventano le righe.
  • Sede — circoscrivi la mappatura a una sede, o lasciala aperta. Un ordine di lavoro generato da questa mappatura viene archiviato in questa sede.
  • Colonna chiave remota — la colonna che identifica in modo univoco ogni riga remota (solitamente id). Relova la usa per mantenere stabili i riferimenti tra le sincronizzazioni.

Mappature colonne

Fai clic su Aggiungi mappatura per ogni campo che desideri compilare: scegli un campo locale (ad es. machine_name) e la colonna remota che lo alimenta. I campi contrassegnati con * sono obbligatori — il modulo non accetterà un record finché non saranno mappati. Il pannello ti informa quando tutti i campi obbligatori sono coperti.

Campi di visualizzazione

Seleziona le colonne che devono apparire nello snapshot del record — i valori mostrati negli elenchi e nella pagina del record remoto. Limita questo a ciò che le persone devono effettivamente vedere.

Valori predefiniti statici e join

Usa i valori predefiniti per compilare una colonna locale obbligatoria che non ha una fonte remota sensata — ad esempio un location_id fisso o un machine_id per ancorare ogni riga di questa mappatura a una macchina iTenance. Usa i join per recuperare una colonna da una tabella remota correlata senza una vista database.

Comportamento di sincronizzazione

Virtuale — sempre live. Cache snapshot — memorizza nella cache ogni riga per il TTL cache impostato (minuti). Su richiesta — leggi solo quando aperto. Aggiungi una colonna di rilevamento modifiche (ad es. updated_at) in modo che Relova possa recuperare solo le righe modificate dall'ultima sincronizzazione invece dell'intera tabella.

Fai clic su Anteprima per vedere le righe grezze accanto al risultato mappato, quindi Salva. Relova indicizza le righe remote e iniziano a essere visualizzate nel modulo di destinazione, ognuna contrassegnata come record remoto.

Vivere con i record remoti

  • Una macchina remota appare come qualsiasi altra negli elenchi e nella sua pagina di visualizzazione, con un piccolo badge che la contrassegna come remota.
  • I campi che provengono dalla sorgente (nome, modello, numero di serie, letture) sono di sola lettura in iTenance. Aggiorna dalla sorgente sul record recupera gli ultimi valori.
  • Le relazioni solo locali — posizione, produttore, categoria, sede — sono impostate con Modifica relazioni e rimangono in iTenance; una sincronizzazione non le sovrascrive mai.
  • Puoi creare ordini di lavoro, aggiungere attività e registrare tempi di inattività su una macchina remota esattamente come al solito.

Passaggio 5 — Genera ordini di lavoro automaticamente (Trigger)

Apri la scheda Trigger e fai clic su Nuova regola. Un trigger monitora un campo delle righe sincronizzate di una mappatura e apre un ordine di lavoro nel momento in cui il valore soddisfa la tua condizione.

  • Mappatura da monitorare — quali righe di mappatura monitorare (questo imposta anche la sede a cui viene archiviato l'ordine di lavoro).
  • Nome — a cosa serve questa regola, ad es. "Sovratemperatura cuscinetto".
  • Quando campo — una colonna dallo snapshot sincronizzato (inizia a digitare per suggerimenti dai campi di visualizzazione della mappatura), ad es. temperature.
  • Operatore — Sale sopra / Scende sotto / Uguale a / Maggiore di / Contiene testo / È uno di / Cambia del tutto, e così via.
  • Valore — il numero o il testo da confrontare. "È uno di" accetta un elenco; "Cambia del tutto" non richiede alcun valore.
  • Priorità — la priorità che ottiene l'ordine di lavoro creato (Bassa / Normale / Alta / Critica).
  • Cooldown — minuti in cui la regola rimane inattiva dopo l'attivazione, in modo che un valore che si aggira intorno alla soglia non crei una pila di duplicati. 1440 = un giorno.
  • Modelli titolo / descrizione — la dicitura dell'ordine di lavoro. Inserisci i valori remoti con {nome_colonna}, ad es. Allarme cuscinetto: {temperatura}°C su {nome_macchina}. Lascia vuoto per un valore predefinito sensato.
Salva. La regola viene visualizzata nell'elenco con la sua condizione, priorità e cooldown; la striscia Attività recenti sottostante registra ogni volta che è stata abbinata, saltata (cooldown) o ha creato un ordine di lavoro. Usa l'interruttore su una riga per mettere in pausa una regola senza eliminarla.
L'ordine di lavoro è archiviato presso la sede della mappatura. È collegato a una macchina iTenance solo quando quella macchina è realmente legata alla riga remota — un record ombra materializzato, o una macchina che hai nominato nei valori predefiniti della mappatura. I valori remoti vengono utilizzati solo per la dicitura, mai per scegliere su quale macchina atterra l'ordine di lavoro.

Sicurezza e isolamento

  • Sola lettura, sempre. Relova blocca qualsiasi istruzione che non sia una lettura. Non può INSERIRE, AGGIORNARE, ELIMINARE o modificare lo schema sorgente.
  • Le credenziali sono crittografate a riposo con una chiave separata dagli altri dati dell'applicazione e non vengono mai restituite al browser.
  • Le richieste in uscita sono protette. Relova rifiuta di connettersi a intervalli di indirizzi interni/loopback a meno che l'operatore non abbia esplicitamente inserito un host nella lista bianca, impedendo che un modulo di connessione venga indirizzato all'infrastruttura interna.
  • Ogni connessione, mappatura e riferimento remoto è limitato al tuo tenant. Un tenant non può mai vedere o interrogare i dati Relova di un altro tenant.
  • I limiti di riga e i timeout delle query si applicano a ogni lettura pass-through, quindi una mappatura errata non può estrarre un set di risultati illimitato.

Risoluzione dei problemi

Il test di connessione fallisce immediatamente.

Host/porta errati, o il firewall di origine non consente il server iTenance. Conferma i dettagli con un client di database dalla stessa rete, quindi aggiungi il tunnel SSH se l'origine è privata.

La connessione si testa correttamente ma gli elenchi sono vuoti.

La mappatura non copre i campi richiesti, o il nome della tabella di origine è sbagliato. Ricontrolla il Passaggio 4 rispetto al browser dello schema e usa Anteprima.

“I campi obbligatori non sono ancora mappati”.

Una colonna locale NOT-NULL senza un valore predefinito non è mappata. Mappa una colonna remota ad essa o assegna un valore predefinito.

I valori sembrano obsoleti.

La mappatura è in modalità Snapshot — abbassa il TTL della cache, aggiungi una colonna di rilevamento delle modifiche o passala a Virtuale. Su un record, usa Aggiorna dalla fonte.

Relova sul dominio centrale non mostra nulla.

Relova funziona sempre da uno spazio di lavoro del tenant. Aprilo dal tuo normale indirizzo del tenant, non dal dominio di accesso centrale.

Vedi anche