Aus CSV importieren ​

Derselbe dreistufige Assistent importiert drei verschiedene Dinge, je nachdem, wo Sie ihn öffnen:

Der Assistent führt Sie in beiden Fällen durch dieselben drei Schritte: Hochladen, Spalten zuordnen und Ergebnisse – nur die Spalten und das, was eine Zeile anlegt, unterscheiden sich.

Die Detailseite einer S7- oder OPC-UA-Datenquelle bietet außerdem Exportieren, das Gegenstück zur Aktion Importieren: eine CSV-Datei mit allen Datenpunkten, die die Quelle deklariert hat, in derselben Spaltenstruktur. Siehe Datenpunkte exportieren weiter unten.

Das Dropdown Erstellen der Monitor-Liste bietet dieselbe Paarung für CVE-Monitore: CSV exportieren lädt alle CVE-Monitore der Organisation herunter, in derselben Spaltenstruktur, die auch CSV importieren liest. Siehe CVE-Monitore exportieren weiter unten.

Exportieren und Importieren bilden zusammen einen Kreislauf, keine Einbahnstraße – siehe Eine Tabelle synchron halten weiter unten.

CVE-Monitore importieren ​

Organisationsadministratoren können mehrere CVE-Monitore auf einmal aus einer CSV-Datei anlegen. Öffnen Sie in der Monitor-Liste das Dropdown Erstellen und wählen Sie CSV importieren, um den Import-Assistenten zu öffnen.

CVE-Monitore sind der einzige Monitor-Typ, den dieser Import anlegt. Verbindungen zu OPC-UA-Servern und S7-SPS werden als Datenquellen angelegt, und alles, was auf einen Wert alarmiert, ist ein Bedingungsmonitor – beides ist keine Zeile in einer Tabelle. Um S7-Tags oder OPC-UA-Knoten in großer Zahl zu deklarieren, siehe S7-Datenpunkte importieren oder OPC-UA-Datenpunkte importieren.

Zwei Werte verhalten sich so, dass es sich lohnt, sie vorab zu kennen:

  • escalationPolicy verweist per Name auf eine bestehende Eskalationsrichtlinie – oder per id aus deren eigener URL: /app/escalation-policies/JgaEBgzn ist die Richtlinie JgaEBgzn. Ein Name muss exakt übereinstimmen – legen Sie die Richtlinie also vor dem Import an. Eine reine Zahl gilt als Name und sonst nichts: Eine Datei, die die Richtlinie als 7 benennt, lässt diese Zeile fehlschlagen, statt eine Zeilennummer aufzulösen.
  • incidentMessageTemplate ist der literale Vorfallstext, keine Referenz auf eine gespeicherte Vorlage.

Die Spalten sind unter Spalten zuordnen aufgeführt.

S7-Datenpunkte importieren ​

Organisationsadministratoren können viele S7-Datenpunkte auf einmal aus einer CSV-Datei mit Tag-Adressen deklarieren. Öffnen Sie die Detailseite einer S7-Datenquelle und wählen Sie Importieren, um den Assistenten zu öffnen – er ist bereits an diese Quelle gebunden.

Da die Quelle durch den Startpunkt des Imports feststeht, geht es in der Datei nur um Tags und um nichts anderes – keine Spalte endpoint, rack oder slot, und auch kein monitorType. Die Spalten sind unter Spalten zuordnen aufgeführt.

Ein durch diesen Import deklarierter Datenpunkt ist übernommen und wird im Takt der Quelle gelesen, wie jeder andere Datenpunkt der Quelle. Eine Zeile, die eine bereits auf der Quelle deklarierte Adresse und einen bereits deklarierten Datentyp nennt, ist ein No-op – sie löst zum bestehenden Datenpunkt auf, statt ein Duplikat anzulegen, sodass ein erneuter Lauf einer unveränderten Datei folgenlos bleibt.

Anders als beim CVE-Import läuft dieser Import alles oder nichts: Jede Zeile wird geprüft, bevor irgendetwas geschrieben wird, und wenn eine Zeile fehlschlägt, wird nichts angelegt – der Ergebnisschritt listet jede fehlgeschlagene Zeile auf, damit Sie die Datei korrigieren und es erneut versuchen können. Siehe Ergebnisse.

Auf die importierten Werte alarmieren ​

Werden vier weitere Spalten zugeordnet – aggregation, operation, operand und duration –, wird aus jeder Zeile statt einer reinen Datenpunkt-Deklaration ein Schwellwertalarm darauf: „Alarmieren, wenn der Durchschnitt von DB1.DBD10 über 5 Minuten über 80 liegt". Sind bei einer Zeile alle vier Spalten zugeordnet, legt der Import an:

  • eine Bedingung – den Graphen Sensor → Aggregate → Compare → Alert – die an den von der Zeile deklarierten Datenpunkt gepinnt ist, und
  • einen Bedingungsmonitor, der darauf alarmiert, in der Gruppe Conditions der Monitor-Liste.

Die Bedingung öffnet sich in derselben geführten Satzform, die auch ein von Hand angelegter Schwellwert verwendet, sodass hundert importierte Alarme danach bearbeitbar bleiben – nichts daran ist ausschließlich über den Canvas erreichbar.

Sobald eine der vier Spalten zugeordnet ist, müssen alle vier zugeordnet sein, zusammen mit name (der Name der Bedingung und ihres Monitors) und escalationPolicy (wer bei einem daraus entstehenden Vorfall alarmiert wird) – eine Zeile kann keinen Schwellwert aus drei Feldern und einer Vermutung für das vierte bilden. Bleiben alle vier nicht zugeordnet, gilt weiterhin das oben beschriebene einfache Verhalten: Zeilen deklarieren nur Datenpunkte, ohne Bedingungen oder Monitore.

Auch mit zugeordneten Spalten entscheidet jede Zeile selbst, ob sie einen Schwellwert trägt. Eine Zeile, die alle sechs Felder name, escalationPolicy, aggregation, operation, operand und duration ausfüllt, legt einen an. Eine Zeile, die alle sechs leer lässt, deklariert nur ihren Datenpunkt – eine Datei kann also Datenpunkte mit und ohne Schwellwert mischen, so wie der Export einer Quelle sie schreibt. Eine Zeile, die nur einen Teil davon ausfüllt, schlägt fehl, und ihr Fehler nennt die fehlenden Felder. Ein Feld, das über Fixer Wert… einen festen Wert erhält, gilt in jeder Zeile als ausgefüllt und hindert eine Zeile, deren übrige Schwellwert-Zellen leer sind, daher nicht daran, nur ihren Datenpunkt zu deklarieren.

Bedingungsnamen sind pro Organisation eindeutig und Groß-/Kleinschreibung wird ignoriert. Eine Zeile, deren Name bereits vergeben ist – durch eine bestehende Bedingung oder durch eine andere Zeile derselben Datei –, schlägt bei der Validierung fehl, bevor irgendetwas geschrieben wird, genau wie bei einer ungültigen Adresse – es sei denn, Bestehende Monitore aktualisieren ist aktiviert und die passende Bedingung ist bereits an genau den Datenpunkt dieser Zeile gepinnt; dann wird die Bedingung stattdessen aktualisiert.

Der Schalter Erstellte Monitore aktivieren im Zuordnungsschritt entscheidet, ob die von diesem Lauf angelegten Monitore aktiv oder inaktiv starten. Aus (die Voreinstellung) legt sie inaktiv an: Sie stehen zur Prüfung in der Monitor-Liste, und die Auswertung überspringt einen inaktiven Monitor vollständig, sodass keiner von ihnen einen Vorfall auslösen kann, bis Sie ihn von Hand aktivieren. Ein schaltet sie sofort scharf. Das ist eine gute Voreinstellung für einen ersten Import von hundert Schwellwerten – prüfen Sie die erzeugten Bedingungen und aktivieren Sie dann die, die passen.

OPC-UA-Datenpunkte importieren ​

Organisationsadministratoren können viele OPC-UA-Datenpunkte auf einmal aus einer CSV-Datei mit Node-IDs deklarieren – der Fall einer Node-Liste eines Maschinenbauers oder eines großen Servers, den Sie lieber nicht durchsuchen möchten. Öffnen Sie die Detailseite einer OPC-UA-Datenquelle und wählen Sie Importieren, um den Assistenten zu öffnen – er ist bereits an diese Quelle gebunden.

Da die Quelle durch den Startpunkt des Imports feststeht, geht es in der Datei nur um Nodes und um nichts anderes: Eine Zeile besteht aus einer einzigen Spalte, nodeId. Anders als bei einem S7-Tag wird der Werttyp eines OPC-UA-Datenpunkts nicht deklariert – er wird aus der ersten Messung gelernt, genau wie beim Deklarieren von Hand – daher gibt es keine dataType-Spalte zuzuordnen. Die Spalten sind unter Spalten zuordnen aufgeführt.

Node-IDs werden nur auf gültige Syntax geprüft – ns=2;s=Line1.Temperature oder ns=3;i=1001, dieselbe Textform, die auch die Detailseite der Quelle verwendet. Ob der Node tatsächlich auf dem Server existiert, wird beim Import nicht geprüft: Das würde den Import von einem erreichbaren Server abhängig machen, was dem Sinn einer vorbereiteten Datei vor der Inbetriebnahme widerspricht. Eine Node-ID, die der Server nicht erkennt, kommt als fehlerhafte Messung zurück, sobald die Quelle sie abfragt – sichtbar auf der Detailseite der Quelle wie jede andere fehlerhafte Messung.

Eine Zeile, die den eigenen Gesundheitsprüfungs-Node der Quelle nennt, wird abgelehnt, genau wie beim Deklarieren von Hand – der Punkt existiert bereits als Erreichbarkeits-Sonde der Quelle, ihn erneut zu importieren würde einen zweiten, bedeutungslosen Lebendigkeitspunkt statt einer echten Messung anlegen.

Ein durch diesen Import deklarierter Datenpunkt ist übernommen und wird im Takt der Quelle gelesen, wie jeder andere Datenpunkt der Quelle. Eine Zeile, die einen bereits auf der Quelle deklarierten Node nennt, ist ein No-op – sie löst zum bestehenden Datenpunkt auf, statt ein Duplikat anzulegen, sodass ein erneuter Lauf einer unveränderten Datei folgenlos bleibt, und zwei Zeilen, die denselben Node unterschiedlich schreiben (etwa mit oder ohne führende Null im Bezeichner), lösen ebenfalls zu einem einzigen Datenpunkt auf.

Anders als beim CVE-Import läuft dieser Import alles oder nichts: Jede Zeile wird geprüft, bevor irgendetwas geschrieben wird, und wenn eine Zeile fehlschlägt, wird nichts angelegt – der Ergebnisschritt listet jede fehlgeschlagene Zeile auf, damit Sie die Datei korrigieren und es erneut versuchen können. Siehe Ergebnisse.

Auf die importierten Werte alarmieren ​

Werden vier weitere Spalten zugeordnet – aggregation, operation, operand und duration –, wird aus jeder Zeile statt einer reinen Datenpunkt-Deklaration ein Schwellwertalarm darauf: „Alarmieren, wenn der Durchschnitt von ns=3;s=Boiler.Pressure über 5 Minuten über 80 liegt". Sind bei einer Zeile alle vier Spalten zugeordnet, legt der Import an:

  • eine Bedingung – den Graphen Sensor → Aggregate → Compare → Alert – die an den von der Zeile deklarierten Datenpunkt gepinnt ist, und
  • einen Bedingungsmonitor, der darauf alarmiert, in der Gruppe Conditions der Monitor-Liste.

Die Bedingung öffnet sich in derselben geführten Satzform, die auch ein von Hand angelegter Schwellwert verwendet, sodass hundert importierte Alarme danach bearbeitbar bleiben – nichts daran ist ausschließlich über den Canvas erreichbar. Da der Werttyp eines OPC-UA-Datenpunkts erst aus seiner ersten Messung gelernt wird, importiert und validiert ein Schwellwert auf einen frisch deklarierten Node auch dann sauber, wenn sich der Node als boolescher Wert herausstellt – er löst unter einem numerischen Vergleich wie avg ... > 80 dann schlicht nie sinnvoll aus.

Sobald eine der vier Spalten zugeordnet ist, müssen alle vier zugeordnet sein, zusammen mit name (der Name der Bedingung und ihres Monitors) und escalationPolicy (wer bei einem daraus entstehenden Vorfall alarmiert wird) – eine Zeile kann keinen Schwellwert aus drei Feldern und einer Vermutung für das vierte bilden. Bleiben alle vier nicht zugeordnet, gilt weiterhin das oben beschriebene einfache Verhalten: Zeilen deklarieren nur Datenpunkte, ohne Bedingungen oder Monitore.

Auch mit zugeordneten Spalten entscheidet jede Zeile selbst, ob sie einen Schwellwert trägt. Eine Zeile, die alle sechs Felder name, escalationPolicy, aggregation, operation, operand und duration ausfüllt, legt einen an. Eine Zeile, die alle sechs leer lässt, deklariert nur ihren Datenpunkt – eine Datei kann also Datenpunkte mit und ohne Schwellwert mischen, so wie der Export einer Quelle sie schreibt. Eine Zeile, die nur einen Teil davon ausfüllt, schlägt fehl, und ihr Fehler nennt die fehlenden Felder. Ein Feld, das über Fixer Wert… einen festen Wert erhält, gilt in jeder Zeile als ausgefüllt und hindert eine Zeile, deren übrige Schwellwert-Zellen leer sind, daher nicht daran, nur ihren Datenpunkt zu deklarieren.

Bedingungsnamen sind pro Organisation eindeutig und Groß-/Kleinschreibung wird ignoriert. Eine Zeile, deren Name bereits vergeben ist – durch eine bestehende Bedingung oder durch eine andere Zeile derselben Datei –, schlägt bei der Validierung fehl, bevor irgendetwas geschrieben wird, genau wie bei einer ungültigen Node-ID – es sei denn, Bestehende Monitore aktualisieren ist aktiviert und die passende Bedingung ist bereits an genau den Datenpunkt dieser Zeile gepinnt; dann wird die Bedingung stattdessen aktualisiert.

Der Schalter Erstellte Monitore aktivieren im Zuordnungsschritt entscheidet, ob die von diesem Lauf angelegten Monitore aktiv oder inaktiv starten. Aus (die Voreinstellung) legt sie inaktiv an: Sie stehen zur Prüfung in der Monitor-Liste, und die Auswertung überspringt einen inaktiven Monitor vollständig, sodass keiner von ihnen einen Vorfall auslösen kann, bis Sie ihn von Hand aktivieren. Ein schaltet sie sofort scharf. Das ist eine gute Voreinstellung für einen ersten Import von hundert Schwellwerten – prüfen Sie die erzeugten Bedingungen und aktivieren Sie dann die, die passen.

Bestehende Zeilen beim erneuten Import aktualisieren ​

Standardmäßig schlägt eine Zeile, deren Name einem bereits vorhandenen entspricht, fehl – „Monitor name already exists" beim CVE-Import, „Condition name already exists" bei einem S7- oder OPC-UA-Import – ein einfacher Import ändert nie etwas, das bereits vorhanden ist. Um ein Geräteblatt oder eine Tag-Liste laufend zu pflegen und bei Änderungen erneut zu importieren, aktivieren Sie im Zuordnungsschritt den Schalter Bestehende Monitore aktualisieren (standardmäßig aus, für jeden Modus).

Beim CVE-Import aktualisiert eine Zeile, deren name einem bestehenden CVE-Monitor entspricht, dessen vendor, orderCode, product, firmware und escalationPolicy, statt fehlzuschlagen – Tags und die Quell-Datenquelle bleiben unverändert: Ein tags-Wert der Zeile wird bei einer Aktualisierung ignoriert (siehe Tags zuweisen), und die Quell-Datenquelle setzt dieser Import weder beim Anlegen noch bei einer Aktualisierung jemals. Eine Zeile, deren Name einem Monitor eines anderen Typs entspricht (etwa einem Heartbeat-Monitor), bleibt ein Zeilenfehler: Für eine CVE-Zeile gibt es an einem Monitor eines anderen Typs nichts zu aktualisieren, daher wird für diese Zeile nichts geschrieben.

Bei einem S7- oder OPC-UA-Import mit zugeordneten vier Schwellwert-Spalten (siehe Auf die importierten Werte alarmieren oder den entsprechenden OPC-UA-Abschnitt) aktualisiert eine Zeile, deren name einer bestehenden Bedingung entspricht, die bereits an genau den von der Zeile deklarierten Datenpunkt gepinnt ist – dieselbe Adresse oder Node-ID –, deren aggregation, operation, operand und duration sowie die escalationPolicy des Monitors, statt fehlzuschlagen. Der Aktiv-Status des Monitors und seine Tags bleiben unverändert, genauso wie der CVE-Import Tags und Quell-Datenquelle eines CVE-Monitors unverändert lässt. Eine Zeile, deren Name einer Bedingung entspricht, die an einen anderen Datenpunkt gepinnt ist – der Name wurde etwa für ein anderes Tag wiederverwendet –, bleibt ein Zeilenfehler, und weil ein S7- oder OPC-UA-Lauf alles oder nichts ist, wird in diesem Fall nichts aus der Datei geschrieben: Es gibt nichts Sicheres zu aktualisieren, wenn Zeile und bestehende Bedingung nicht einig sind, worauf sie überhaupt alarmieren.

Eine Zeile, deren Name noch keinem Eintrag entspricht, legt weiterhin einen an, unabhängig vom Schalter.

Der Ergebnisschritt weist diese aktualisierten Zeilen getrennt von neu angelegten aus – siehe Ergebnisse.

CVE-Monitore exportieren ​

Öffnen Sie in der Monitor-Liste das Dropdown Erstellen und wählen Sie CSV exportieren, um alle CVE-Monitore der Organisation herunterzuladen – in derselben Spaltenstruktur, die auch CVE-Monitore importieren liest: monitorType, name, vendor, orderCode, product, firmware, escalationPolicy, incidentMessageTemplate und tags. escalationPolicy wird als Name geschrieben und tags mit \| getrennt – dieselben Formen, die Spalten zuordnen auch wieder einliest. incidentMessageTemplate ist immer leer – kein CVE-Monitor besitzt dieses Feld, es gibt also nichts hineinzuschreiben.

Der Export berücksichtigt die aktiven Filter der Liste – Status, Eskalationsrichtlinie, Datenquelle, Tags und Suche sowie die Umschalter „Veraltet“ und „Stummgeschaltet“ – mit Ausnahme des Typfilters, da diese Aktion unabhängig von der übrigen Anzeige immer nur CVE-Monitore exportiert.

Importieren Sie die Datei mit eingeschaltetem Bestehende Monitore aktualisieren erneut, ist das ein No-op: Jede Zeile trifft anhand ihres Namens auf ihren eigenen Monitor, sodass der Ergebnisschritt jede Zeile als aktualisiert statt als neu angelegt ausweist.

Zum Exportieren ist dieselbe Berechtigung als Organisationsadministrator erforderlich wie zum Importieren.

Datenpunkte exportieren ​

Auf der Detailseite einer S7- oder OPC-UA-Datenquelle lädt Exportieren eine CSV-Datei mit allen Datenpunkten herunter, die die Quelle deklariert hat – in derselben Spaltenstruktur, die ihre eigene Aktion Importieren liest: address/dataType (S7) bzw. nodeId (OPC UA), plus name, escalationPolicy, aggregation, operation, operand, duration und tags für einen Datenpunkt, an den genau eine Schwellenwert-Bedingung gepinnt ist. Ein Datenpunkt ohne Schwellenwert lässt diese Spalten leer; einer mit mehr als einem Schwellenwert wird einmal pro Schwellenwert exportiert, als separate Zeilen mit derselben Adresse bzw. Node-ID. escalationPolicy wird als Name geschrieben, duration in Sekunden, operation als gt/gte/lt/lte/eq/neq und tags mit \| getrennt – dieselben Formen, die Spalten zuordnen auch wieder einliest.

Importieren Sie die Datei mit eingeschaltetem Bestehende Monitore aktualisieren erneut gegen dieselbe Quelle, ist das ein No-op: Jede Zeile trifft auf ihren eigenen Datenpunkt und ihre eigene Bedingung (soweit vorhanden), sodass der Ergebnisschritt jede Zeile als aktualisiert statt als neu angelegt ausweist.

Zum Exportieren ist dieselbe Berechtigung als Organisationsadministrator erforderlich wie zum Importieren.

Eine Tabelle synchron halten ​

Der Export schreibt genau die Spaltenstruktur, die der Import liest – beide bilden also einen Kreislauf, keine Einbahnstraße: Exportieren Sie die Datenpunkte einer Quelle oder die CVE-Monitore der Monitor-Liste, bearbeiten Sie die Datei in einer Tabellenkalkulation, und importieren Sie sie mit eingeschaltetem Bestehende Monitore aktualisieren erneut. Da die exportierten Spaltennamen genau den Feldnamen des Imports entsprechen, erkennt der Zuordnungsschritt beim erneuten Import jede Spalte automatisch wieder – von Hand nachzuordnen ist nichts, auch nicht bei den Schwellwert-Spalten.

So pflegen Sie eine Gerätetabelle oder eine Monitor-Liste dauerhaft außerhalb von Pulse: Ändern Sie einen Operanden, benennen Sie eine Eskalationsrichtlinie um, ergänzen Sie eine Firmware-Version – und importieren Sie die bearbeitete Datei anschließend erneut. Eine Zeile, deren Name (bzw. Adresse oder Node-ID, bei einem Datenpunkt) sich nicht geändert hat, aktualisiert das bereits passende Objekt, statt an der Kollision zu scheitern; eine neu hinzugefügte Zeile legt weiterhin an, wie bei jedem anderen Import.

Tags zuweisen ​

Eine optionale Spalte tags weist einem von diesem Import angelegten Monitor bestehende Tags zu: mit | getrennte Tag-Namen, jeweils von umgebenden Leerzeichen befreit (zum Beispiel Line 1|Boiler). Jeder Name muss exakt (ohne Berücksichtigung von Groß-/Kleinschreibung) auf ein bestehendes Tag passen – der Import legt nie ein Tag an, daher ist ein Name, der auf keines passt, bei einer CVE-Zeile, die einen Monitor anlegt, ein Zeilenfehler oder lässt bei einer S7- oder OPC-UA-Zeile, die einen Bedingungsmonitor anlegt, den ganzen Lauf fehlschlagen, genau wie jede andere Spalte, die diese Importe nicht auflösen können. Eine Zeile, die einen bestehenden Monitor oder eine bestehende Bedingung aktualisiert, ignoriert ihre tags-Spalte, daher ist ein unbekannter Name dort kein Fehler. Was das für das Geschriebene bedeutet, steht unter Schritt 3 — Ergebnisse.

Ein Tag-Name, der selbst ein | enthält, kann diese Spalte nicht unverändert durchlaufen: sowohl der Export als auch das Aufteilen an | beim Import behandeln jedes | als Trennzeichen, ohne ein Escaping für ein | innerhalb eines Namens. Vermeiden Sie ein | im Namen eines Tags, wenn Sie es exportieren und wieder importieren möchten.

Bei einem S7- oder OPC-UA-Import hat tags nur dann einen Monitor, dem es zugewiesen werden kann, wenn die Zeile auch die vier Schwellwert-Spalten zuordnet und einen Bedingungsmonitor anlegt – siehe Auf die importierten Werte alarmieren (S7) oder den entsprechenden OPC-UA-Abschnitt. Bei einer reinen Datenpunkt-Zeile wird die Spalte gelesen, aber ignoriert, da nichts angelegt wird, das ein Tag tragen könnte.

CSV-Format ​

Die erste Zeile muss eine Kopfzeile mit Spaltennamen sein – im nächsten Schritt werden diese Namen den Feldern zugeordnet (die Zuordnung lässt sich von Hand anpassen). Speichern Sie die Datei als UTF-8.

Der Import akzeptiert Komma, Semikolon oder Tabulator als Trennzeichen – welches davon in der Kopfzeile am häufigsten vorkommt, gilt für die gesamte Datei, Sie müssen also keines davon auswählen. Ein führendes UTF-8-Byte-Order-Mark, das Excel je nach Systemsprache automatisch einfügt, wird beim Einlesen entfernt. Dadurch lässt sich ein mit Semikolon getrennter, mit BOM versehener Export – die Standardausgabe eines deutschsprachigen Excel – genauso importieren wie eine einfache, kommagetrennte Datei. Im Übrigen gelten die üblichen CSV-Regeln (RFC 4180): Werte, die selbst das Trennzeichen, ein Anführungszeichen oder einen Zeilenumbruch enthalten, in doppelte Anführungszeichen setzen und darin enthaltene Anführungszeichen verdoppeln.

Als funktionierende Vorlage nutzen Sie im Upload-Schritt Beispiel-CSV herunterladen: Sie enthält die Spalten des gerade geöffneten Assistenten mit einer oder mehreren Beispielzeilen.

Schritt 1 — Hochladen ​

Ziehen Sie eine CSV-Datei in die Ablagefläche oder klicken Sie, um eine Datei auszuwählen. Eine Vorschautabelle zeigt die ersten Zeilen, damit Sie prüfen können, ob die Datei korrekt gelesen wurde; mit Ersetzen tauschen Sie die Datei aus. Klicken Sie auf Weiter oder auf Abbrechen, um den Assistenten zu schließen.

Schritt 2 — Spalten zuordnen ​

Ordnen Sie jedem Feld eine Spalte aus Ihrer CSV zu. Der Assistent erkennt passende Spaltennamen automatisch und befüllt die Zuordnung nach Möglichkeit vor. Für jedes Feld können Sie:

  • die CSV-Spalte wählen, deren Werte verwendet werden,
  • mit Fixer Wert… einen Wert für alle Zeilen festlegen (praktisch für gemeinsame Einstellungen wie die Eskalationsrichtlinie) oder
  • das Feld Nicht zugeordnet lassen – nur bei optionalen Feldern erlaubt.

Die Tabelle listet jede Spalte, ob sie erforderlich ist und welche Werte sie akzeptiert.

CVE-Monitor-Spalten ​

SpalteErforderlichGültige Werte / Format
monitorTypeJacve
nameJaFreitext
vendorJaGerätehersteller, z. B. Siemens
orderCodeEines von beidenBestellnummer / MLFB des Geräts, z. B. 6ES7516-3AN00-0AB0 – eine Zeile braucht dies oder product
productEines von beidenProdukt- / Modultypname in der Schreibweise der Hersteller-Sicherheitsmeldungen, z. B. AC500 V3
firmwareOptionalFirmware-Version, z. B. V2.9.2 (leer → passt auf alle Firmware-Versionen)
escalationPolicyJaName (exakt) oder die id aus der URL der Richtlinie
incidentMessageTemplateOptionalFreitext (die Nachricht selbst)
tagsOptionalBestehende Tag-Namen, getrennt mit |, z. B. Line 1|Boiler – siehe Tags zuweisen

TIP

CVE-Monitore gleichen veröffentlichte Sicherheitsmeldungen über vendor + orderCode und/oder product (+ optional firmware) mit einem Gerät ab. Siehe CVE-Monitore zur Funktionsweise des Abgleichs.

S7-Datenpunkt-Spalten ​

SpalteErforderlichGültige Werte / Format
addressJaEine S7-Adresse, z. B. DB1.DBW0 oder DB2.DBD4
dataTypeJaBOOL, BYTE, WORD, DWORD, INT, DINT oder REAL
nameNur wenn eine Schwellwert-Spalte zugeordnet istWie die Bedingung und ihr Monitor heißen sollen
escalationPolicyNur wenn eine Schwellwert-Spalte zugeordnet istName (exakt) oder die id aus der URL der Richtlinie
aggregationAlle vier, oder keine (siehe unten)min, max, sum, avg (oder average), count
operationAlle vier, oder keinegt (oder >, above), gte (>=), lt (<, below), lte (<=), eq (=), neq (!=)
operandAlle vier, oder keineDer Schwellwert, z. B. 80 oder 80,5 (ein Komma wird ebenfalls als Dezimaltrennzeichen gelesen)
durationAlle vier, oder keineDas Aggregationsfenster: Sekunden, oder eine Zahl mit Einheit, z. B. 300, 5m, 1h (auch 2,5m funktioniert)
tagsOptionalBestehende Tag-Namen, getrennt mit | – ignoriert, sofern die Zeile keinen Bedingungsmonitor anlegt (siehe Tags zuweisen)

TIP

Siehe S7-Datenquellen, was jede Adressform und jeder Datentyp bedeutet, und Auf die importierten Werte alarmieren zu den vier Schwellwert-Spalten.

OPC-UA-Datenpunkt-Spalten ​

SpalteErforderlichGültige Werte / Format
nodeIdJaEine OPC-UA-Node-ID, z. B. ns=2;s=Line1.Temperature oder ns=3;i=1001
nameNur wenn eine Schwellwert-Spalte zugeordnet istWie die Bedingung und ihr Monitor heißen sollen
escalationPolicyNur wenn eine Schwellwert-Spalte zugeordnet istName (exakt) oder die id aus der URL der Richtlinie
aggregationAlle vier, oder keine (siehe unten)min, max, sum, avg (oder average), count
operationAlle vier, oder keinegt (oder >, above), gte (>=), lt (<, below), lte (<=), eq (=), neq (!=)
operandAlle vier, oder keineDer Schwellwert, z. B. 80 oder 80,5 (ein Komma wird ebenfalls als Dezimaltrennzeichen gelesen)
durationAlle vier, oder keineDas Aggregationsfenster: Sekunden, oder eine Zahl mit Einheit, z. B. 300, 5m, 1h (auch 2,5m funktioniert)
tagsOptionalBestehende Tag-Namen, getrennt mit | – ignoriert, sofern die Zeile keinen Bedingungsmonitor anlegt (siehe Tags zuweisen)

TIP

Siehe OPC-UA-Konfiguration zur Node-ID-Syntax und dazu, wie der Werttyp eines Datenpunkts gelernt wird, sowie Auf die importierten Werte alarmieren zu den vier Schwellwert-Spalten.

Wenn alle erforderlichen Felder zugeordnet sind, klicken Sie auf Import starten. Um den Assistenten zu schließen und Ihre Arbeit zu verwerfen, klicken Sie auf Abbrechen; um die Zuordnungen zu behalten und später fortzufahren, schließen Sie den Bereich stattdessen mit der Schaltfläche × in der Kopfzeile – der Assistent setzt dort fort, wo Sie aufgehört haben.

Schritt 3 — Ergebnisse ​

Eine Zusammenfassung zeigt, wie viele Zeilen erfolgreich importiert wurden und wie viele fehlgeschlagen sind. Ist Bestehende Monitore aktualisieren aktiviert, zeigt sie außerdem, wie viele Zeilen statt eines neuen Eintrags einen bestehenden CVE-Monitor oder eine bestehende Bedingung aktualisiert haben.

  • CVE-Monitore werden zeilenweise übernommen, sodass eine fehlgeschlagene Zeile die übrigen Zeilen nicht davon abhält, angelegt oder aktualisiert zu werden.
  • S7- und OPC-UA-Datenpunkte (und die Bedingungen, die eine Schwellwert-Zeile anlegt oder aktualisiert) werden gemeinsam übernommen: Ist auch nur eine Zeile fehlgeschlagen, zeigt die Zusammenfassung null Erfolge und null Aktualisierungen, und es wurde nichts geschrieben.

Jede fehlgeschlagene Zeile wird mit der verursachenden Fehlermeldung aufgeführt. Klicken Sie auf Fehlgeschlagene Zeilen herunterladen, um nur diese Zeilen als CSV zu exportieren, sie zu korrigieren und die Datei erneut zu importieren.

Verwandte Themen ​