Erweitert

Relova – Remote Machine Connector

Verbinden Sie eine externe Datenbank, eine Tabellenkalkulation oder eine API und nutzen Sie deren Zeilen als Live-Maschinen, -Teile und -Lieferanten in iTenance – ohne Daten zu importieren oder zu kopieren.

Relova verknüpft iTenance mit einem System, das Sie bereits betreiben – einem ERP, einem SCADA-Historian, einem Altsystem für Anlagen, einer freigegebenen Tabellenkalkulation – und präsentiert ausgewählte Zeilen daraus als normale iTenance-Datensätze. Die Daten werden niemals in Ihren Tenant kopiert: Jeder Bildschirm liest direkt aus der Quelle, sodass das, was Sie sehen, immer aktuell ist. Relova-Verbindungen sind standardmäßig nur lesend; Relova kann niemals in das System zurückschreiben, das Sie verbinden.

Relova oder Massenimport?

Beide bringen externe Daten herein. Wählen Sie danach, ob sich die Quelle ständig ändert.

Massenimport verwenden, wenn …

  • Sie eine einmalige Datei haben (eine Lieferantenliste, ein Start-Anlagenregister).
  • Sie möchten, dass die Datensätze vollständig bearbeitbare iTenance-Daten werden.
  • Die Quelle sich nicht ändert oder Sie bereit sind, bei Änderungen erneut zu importieren.

Relova verwenden, wenn …

  • Die Quelle ein Live-System ist, das sich selbstständig aktualisiert (ERP, Historian, MES).
  • Sie Maschinenmesswerte oder Status ohne erneutes Hochladen sehen möchten.
  • Sie möchten, dass ein externer Zustand (Temperatur, Betriebsstunden, Fehlerkennzeichen) automatisch einen Arbeitsauftrag auslöst.

Bevor Sie beginnen

  • Das Modul Relova Remote Machines muss in Ihrem Plan aktiv sein. Einstellungen → Module, oder fragen Sie Ihren Kontoinhaber.
  • Sie benötigen die Berechtigung Einstellungen verwalten – Relova befindet sich unter Einstellungen.
  • Halten Sie die Verbindungsdetails der Quelle bereit: Host, Port, Datenbankname und einen schreibgeschützten Benutzernamen und Passwort. Erstellen Sie, wenn möglich, ein dediziertes schreibgeschütztes Konto an der Quelle.
  • Wenn die Quelle nur Verbindungen innerhalb ihres eigenen Netzwerks akzeptiert, haben Sie SSH-Zugriff auf einen Host, der diese erreichen kann (Relova kann darüber tunneln).

Schritt 1 – Relova öffnen

Gehen Sie zu Einstellungen → Relova. Die Registerkarte Übersicht zeigt vier Zähler – Verbindungen, Fehler, Modulzuordnungen, Virtuelle Referenzen – und eine Liste Ihrer Verbindungen. Die Registerkartenleiste unter dem Titel (Übersicht · Verbindungen · Zuordnungen · Trigger) wechselt zwischen den Bildschirmen.

Bei einer brandneuen Einrichtung sind alle Zähler auf Null und die Liste zeigt „No connections configured yet.“ mit einem Button Create your first connection – das ist Schritt 2.

Schritt 2 – Eine Verbindung hinzufügen

Öffnen Sie die Registerkarte Verbindungen und klicken Sie auf Neue Verbindung (oben rechts, der „+“-Button). Füllen Sie das Formular aus:

  • Verbindungsname – eine Bezeichnung, die Sie wiedererkennen, z. B. „Produktions-ERP“.
  • Datenbanktreiber – MySQL / MariaDB, PostgreSQL, SQL Server, Oracle, SAP HANA oder eine CSV-/Excel-Datei oder eine REST-API. Der Rest des Formulars ändert sich entsprechend.
  • Host, Port, Datenbank, Schema – Netzwerkadresse der Quelle. Der Port wird vom Treiber vorab ausgefüllt.
  • Benutzername / Passwort – die schreibgeschützten Anmeldeinformationen. Sie werden verschlüsselt, bevor sie gespeichert werden, und nie wieder angezeigt; lassen Sie das Passwort beim Bearbeiten leer, um das aktuelle beizubehalten.
  • Schema-Cache – wie lange (in Sekunden) Relova die Liste der Tabellen und Spalten wiederverwenden darf, bevor sie erneut gelesen wird. 300 (5 Minuten) ist ein guter Standardwert; 0 deaktiviert das Caching.
  • Abfragemodus – Virtuell liest bei jeder Ansicht direkt aus der Quelle (aktuellste Daten). Snapshot hält eine kurzlebige Cache-Kopie für schnellere Listen. On demand liest nur, wenn jemand den Datensatz öffnet.

SSH-Tunnel (optional)

Schalten Sie SSH-Tunnel ein, wenn die Quelle nur innerhalb eines privaten Netzwerks erreichbar ist. Geben Sie den SSH-Host, Port und Benutzer an und fügen Sie einen privaten Schlüssel (empfohlen) oder ein Passwort ein. Lassen Sie den SSH-Host leer, um über den Datenbank-Host selbst zu tunneln.

CSV-/Excel-Quellen

Für einen Dateitreiber geben Sie den absoluten Pfad zur Datei auf dem Server an und wählen Sie das Trennzeichen. Die Datei wird direkt gelesen – legen Sie sie an einem Ort ab, den Ihr Server immer erreichen kann, z. B. einen synchronisierten Ordner.

Klicken Sie zuerst auf Verbindung testen – Relova öffnet die Verbindung, führt einen harmlosen Lesevorgang aus und meldet Erfolg oder den genauen Fehler. Wenn es erfolgreich ist, klicken Sie auf Speichern. Die Verbindung erscheint in der Liste mit einem Statuspunkt.

Verbindungsstatus

  • Verbunden – letzte Prüfung erfolgreich.
  • Herabgestuft – erreichbar, aber langsam oder mit Warnungen.
  • Fehler – die letzte Prüfung ist fehlgeschlagen. Öffnen Sie die Verbindung, um den Grund zu sehen; verwenden Sie Verbindung testen nach der Behebung.
  • Deaktiviert – Sie haben es ausgeschaltet. Zugeordnete Datensätze werden erst aufgelöst, wenn Sie es wieder aktivieren.

Jede Zeile hat Testen, Bearbeiten, Aktivieren / Deaktivieren und Löschen. Das Löschen einer Verbindung entfernt auch ihre Zuordnungen und jede von ihr erzeugte virtuelle Referenz.

Schritt 3 – Quelle durchsuchen (optional, aber nützlich)

Wählen Sie aus einer Verbindungszeile Schema-Browser (das Datenbanksymbol). Wählen Sie die Verbindung, und Relova listet ihre Tabellen auf der linken Seite auf. Klicken Sie auf eine Tabelle, um deren Spalten – Name, Typ, Nullwerte zulassen, Schlüssel – anzuzeigen, und klicken Sie auf Datenvorschau, um die ersten Zeilen zu sehen. Verwenden Sie dies, um die genauen Tabellen- und Spaltennamen zu finden, die Sie in Schritt 4 benötigen. Aktualisieren liest das Schema erneut und löscht den Cache.

Schritt 4 – Eine Tabelle einem Modul zuordnen

Hier werden Remote-Zeilen zu iTenance-Datensätzen. Öffnen Sie den Reiter Zuordnungen und klicken Sie auf Neue Zuordnung.

  • Verbindung und Quelltabelle – welche Remote-Tabelle diese Zuordnung speist.
  • Zuordnungsname – z.B. „ERP-Anlagen“.
  • Zielmodul – Maschinen / Geräte, Teile, Inventar, Lieferanten, Standorte. Dies entscheidet, was aus den Zeilen wird.
  • Standort – ordnen Sie die Zuordnung einem Standort zu, oder lassen Sie sie offen. Ein von dieser Zuordnung erzeugter Arbeitsauftrag wird diesem Standort zugeordnet.
  • Remote-Schlüsselspalte – die Spalte, die jede Remote-Zeile eindeutig identifiziert (normalerweise id). Relova verwendet sie, um Referenzen zwischen Synchronisierungen stabil zu halten.

Spaltenzuordnungen

Klicken Sie auf Zuordnung hinzufügen für jedes Feld, das Sie füllen möchten: Wählen Sie ein lokales Feld (z.B. machine_name) und die Remote-Spalte, die es speist. Mit * gekennzeichnete Felder sind erforderlich – das Modul akzeptiert keinen Datensatz, bis sie zugeordnet sind. Das Panel zeigt Ihnen an, wann alle erforderlichen Felder abgedeckt sind.

Anzeigefelder

Markieren Sie die Spalten, die in der Momentaufnahme des Datensatzes erscheinen sollen – die Werte, die in Listen und auf der Remote-Datensatzseite angezeigt werden. Beschränken Sie dies auf das, was die Benutzer tatsächlich sehen müssen.

Statische Standardwerte & Joins

Verwenden Sie Standardwerte, um eine erforderliche lokale Spalte zu füllen, die keine sinnvolle Remote-Quelle hat – zum Beispiel eine feste location_id oder eine machine_id, um jede Zeile dieser Zuordnung an eine iTenance-Maschine zu binden. Verwenden Sie Joins, um eine Spalte aus einer verwandten Remote-Tabelle ohne Datenbankansicht zu ziehen.

Synchronisationsverhalten

Virtuell – immer live. Snapshot-Cache – jede Zeile für die von Ihnen eingestellte Cache-TTL (Minuten) zwischenspeichern. Bei Bedarf – nur beim Öffnen lesen. Fügen Sie eine Änderungserkennungsspalte (z.B. updated_at) hinzu, damit Relova nur Zeilen abrufen kann, die sich seit der letzten Synchronisierung geändert haben, anstatt die gesamte Tabelle.

Klicken Sie auf Vorschau, um Rohzeilen neben dem zugeordneten Ergebnis zu sehen, dann auf Speichern. Relova indiziert die Remote-Zeilen und sie beginnen im Zielmodul zu erscheinen, jeweils als Remote-Datensatz gekennzeichnet.

Umgang mit Remote-Datensätzen

  • Eine Remote-Maschine sieht in Listen und auf ihrer Detailseite aus wie jede andere, mit einem kleinen Abzeichen, das sie als Remote kennzeichnet.
  • Felder, die aus der Quelle stammen (Name, Modell, Seriennummer, Messwerte), sind in iTenance schreibgeschützt. Aus Quelle aktualisieren auf dem Datensatz ruft die neuesten Werte ab.
  • Nur-lokale Beziehungen – Standort, Hersteller, Kategorie, Betriebsstätte – werden mit Beziehungen bearbeiten festgelegt und bleiben in iTenance; eine Synchronisierung überschreibt sie niemals.
  • Sie können Arbeitsaufträge erstellen, Aufgaben hinzufügen und Ausfallzeiten für eine Remote-Maschine genau wie gewohnt protokollieren.

Schritt 5 – Arbeitsaufträge automatisch erstellen (Trigger)

Öffnen Sie den Reiter Trigger und klicken Sie auf Neue Regel. Ein Trigger überwacht ein Feld der synchronisierten Zeilen einer Zuordnung und öffnet einen Arbeitsauftrag, sobald der Wert Ihre Bedingung erfüllt.

  • Zuordnung überwachen – welche Zuordnungszeilen überwacht werden sollen (dies legt auch den Standort fest, dem der Arbeitsauftrag zugeordnet wird).
  • Name – wofür diese Regel ist, z.B. „Lagerübertemperatur“.
  • Wenn Feld – eine Spalte aus dem synchronisierten Snapshot (beginnen Sie mit der Eingabe für Vorschläge aus den Anzeigefeldern der Zuordnung), z.B. temperature.
  • Operator – Steigt über / Fällt unter / Gleich / Größer als / Enthält Text / Ist einer von / Ändert sich überhaupt, und so weiter.
  • Wert – die Zahl oder der Text, mit dem verglichen werden soll. „Ist einer von“ nimmt eine Liste; „Ändert sich überhaupt“ benötigt keinen Wert.
  • Priorität – die Priorität, die der erstellte Arbeitsauftrag erhält (Niedrig / Normal / Hoch / Kritisch).
  • Abklingzeit – Minuten, in denen die Regel nach dem Auslösen still bleibt, damit ein Wert, der um den Schwellenwert schwankt, keine Stapel von Duplikaten erzeugt. 1440 = ein Tag.
  • Titel-/Beschreibungs-Vorlagen – die Formulierung des Arbeitsauftrags. Fügen Sie Remote-Werte mit {column_name} ein, z.B. Lageralarm: {temperature}°C an {machine_name}. Leer lassen für einen sinnvollen Standardwert.
Speichern. Die Regel wird in der Liste mit ihrer Bedingung, Priorität und Abklingzeit angezeigt; der Bereich Letzte Aktivitäten darunter protokolliert jedes Mal, wenn sie übereinstimmte, übersprungen wurde (Abklingzeit) oder einen Arbeitsauftrag erstellte. Verwenden Sie den Schalter in einer Zeile, um eine Regel zu pausieren, ohne sie zu löschen.
Der Arbeitsauftrag wird dem Standort der Zuordnung zugeordnet. Er wird nur dann mit einer iTenance-Maschine verknüpft, wenn diese Maschine wirklich an die Remote-Zeile gebunden ist – ein materialisierter Schatten-Datensatz oder eine Maschine, die Sie in den Standardwerten der Zuordnung benannt haben. Remote-Werte werden nur für die Formulierung verwendet, niemals um zu bestimmen, auf welcher Maschine der Arbeitsauftrag landet.

Sicherheit & Isolation

  • Immer schreibgeschützt. Relova blockiert jede Anweisung, die kein Lesezugriff ist. Es kann das Quellschema nicht INSERTEN, UPDATEN, DELETEN oder ändern.
  • Anmeldeinformationen werden im Ruhezustand verschlüsselt mit einem Schlüssel, der von Ihren anderen Anwendungsdaten getrennt ist und niemals an den Browser zurückgegeben wird.
  • Ausgehende Anfragen werden geschützt. Relova weigert sich, sich mit internen/Loopback-Adressbereichen zu verbinden, es sei denn, Ihr Betreiber hat einen Host explizit auf die Positivliste gesetzt, was verhindert, dass ein Verbindungsformular auf die interne Infrastruktur verweist.
  • Jede Verbindung, Zuordnung und Remote-Referenz ist auf Ihren Tenant beschränkt. Ein Tenant kann niemals die Relova-Daten eines anderen Tenants sehen oder abfragen.
  • Zeilenlimits und Abfrage-Timeouts gelten für jeden Pass-Through-Lesevorgang, sodass eine fehlerhafte Zuordnung keinen unbegrenzten Ergebnissatz ziehen kann.

Fehlerbehebung

Verbindungstest schlägt sofort fehl.

Falscher Host/Port, oder die Quell-Firewall erlaubt Ihren iTenance-Server nicht. Bestätigen Sie die Details mit einem Datenbank-Client aus demselben Netzwerk und fügen Sie dann den SSH-Tunnel hinzu, wenn die Quelle privat ist.

Verbindungstest ist in Ordnung, aber Listen sind leer.

Die Zuordnung enthält keine erforderlichen Felder, oder der Name der Quelltabelle ist falsch. Überprüfen Sie Schritt 4 anhand des Schema-Browsers und verwenden Sie die Vorschau.

„Erforderliche Felder sind noch nicht zugeordnet“.

Eine NICHT-NULL-lokale Spalte ohne Standardwert ist nicht zugeordnet. Ordnen Sie entweder eine Remote-Spalte zu oder geben Sie ihr einen Standardwert.

Werte sehen veraltet aus.

Die Zuordnung befindet sich im Snapshot-Modus – senken Sie die Cache-TTL, fügen Sie eine Spalte zur Änderungserkennung hinzu oder stellen Sie sie auf Virtuell um. Verwenden Sie bei einem Datensatz Aus Quelle aktualisieren.

Relova auf der zentralen Domain zeigt nichts an.

Relova arbeitet immer von einem Tenant-Arbeitsbereich aus. Öffnen Sie es von Ihrer normalen Tenant-Adresse, nicht von der zentralen Anmeldedomäne.

Siehe auch