Zum Hauptinhalt springen

Konfiguration anlegen

Bevor ein Import ausgeführt werden kann, muss eine Import-Konfiguration erstellt werden.

Klickweg: Seitenleiste / Erstellen / Import

Quelle

Zunächst muss die Basis-Konfiguration angelegt werden:

NAME - Ein sprechender Name für die Konfiguration. Er muss eindeutig sein und darf nur Buchstaben, Zahlen, Punkte und Bindestriche enthalten (FQDN-konform).

BESCHREIBUNG - Eine kurze Beschreibung der Konfiguration. Optional.

OBJEKTTYP - Der Typ der Objekte, die mit Hilfe der CSV-Datei importiert werden sollen.

QUELLE - Die Art der Quell-Daten. Aktuell nur CSV möglich.

DATEI - Über den Upload-Button kann eine CSV-Datei hochgeladen werden.

  • Die Datei kan auf den Button gezogen werden und wird direkt hochgeladen.
  • Alternativ kann der Button geklickt werden, um ein Upload-Formular zu öffnen.

Trennzeichen - Das Trennzeichen, das in der CSV-Datei verwendet wird.

Sind alle Basis-Informationen hinterlegt, muss der Button Datei einlesen betätigt werden, um die gewählte CSV-Datei einzulesen. Anschließend wird im rechten Vorschau-Fenster der Inhalt der CSV-Datei angezeigt.

In der oberen Navigations-Leiste erscheinen die zusätzlichen Reiter Konfiguration und Zuordnung.

Konfiguration

Im Reiter Konfiguration kann definiert werden, welche Aktionen beim Import ausgeführt werden sollen. Zur Verfügung stehen:

ERSTELLEN - Objekte werden erstellt. Ist ein Filter definiert, werden nur die Objekte angelegt, für die kein passendes Objekt gefunden wurde. Ist kein Filter definiert, werden alle Objekte angelegt.

AKTUALISIEREN - Objekte, für die über den Filter ein bereits vorhandenes Objekt gefunden wurde, werden mit den Daten aus der CSV-Zeile aktualisiert. Alle in der CSV-Datei vorhandenen Felder werden neu geschrieben, egal, ob der Inhalt neu ist oder nicht.

LÖSCHEN - Ist dieses Feld aktiviert, vergleicht SNAG-View 4 bei einer wiederholten Nutzung der Konfiguration die aktuellen Daten mit denen des letzten Durchlaufes. Alle Objekte, die im vorherigen Import vorhanden waren, in den aktuellen Daten aber keiner Zeile zugeordnet werden können, werden aus SNAG-View 4 gelöscht.

DEAKTIVIEREN - Nicht mehr vorhandenen Objekte werden deaktiviert und nicht gelöscht.

info

Um die Aktionen Aktualisieren, Löschen und Deaktivieren benutzen zu können, muss ein Filter definiert werden.

FILTER - Hier kann ein Filter hinterlegt werden, über den Zeilen der Import-Daten auf bereits existierende Objekte verknüpft werden können. Die Syntax entspricht der Standard SNAG-View 4 Filter-Syntax. Als Vergleichs-Wert können die Spaltennamen der CSV-Datei als Macros verwendet werden. Hierzu wird der Spalten-Name in $ gesetzt. Möchte man also die Spalte Name auf den Device-Namen mappen, muss als Filter name is "$Name$ eingegeben werden. Der eingegebene Filter muss mindestens eine Spalte referenzieren, damit er gültig ist.

Zuordnung

VORLAGE - Hierüber kann bei manchen Objekten ein Basis-Template definiert werden, dass für das Anlegen der Objekte verwendet wird.

ZUORDNUNG - Unter diesem Punkt wird jede Spalte der CSV-Datei aufgelistet und kann einem Attribut des zuvor gewählten Objekt-Typs zugeordnet werden. Manche Attribute, wie Tag können für mehrere Spalten verwendet werden. SNAG-View 4 weist Spalten automatisch zu, wenn der Spalten-Name dem Attributnamen entspricht.

Speichern

Sind alle Einstellungen vorgenommen, kann die Konfiguration über den Button Import erstellen gespeichert werden.

Beim Speichern werden die ersten zehn Zeilen der für die Konfiguration verwendeten CSV-Datei als Beispiel-Daten mitgespeichert.