XML exportieren/importieren

In SKOOR Engine ist eine XML-Schnittstelle integriert, um den Export und Import beliebiger Objektstrukturen mit einer einzigen XML-Datei von einem SKOOR Engine -System in ein anderes zu ermöglichen. Auf diese Weise können Sie eine bestimmte Struktur in einer SKOOR Engine -Testumgebung erstellen, exportieren und dann in Ihre SKOOR Engine Produktionsumgebung importieren, sobald die Struktur erfolgreich eingerichtet wurde. Die XML-Schnittstelle ermöglicht es Ihnen auch, SKOOR Engine mit beliebigen Tools von Drittanbietern (z. B. CMDB, andere vorhandene Überwachungstools) zu synchronisieren.

Bitte beachten Sie Folgendes:

  • Beim XML-Import/Export hat jedes Objekt eine eindeutige ID, die sogenannte TID (Third Party ID).
  • Eine TID identifiziert ein SKOOR Engine Objekt global (über alle SKOOR Engine Instanzen hinweg).
  • Wenn eine TID als Folge einer Identitätssperre gespeichert werden muss, wird die TID als Eigenschaft namens tid gespeichert (siehe Importmodi im folgenden Abschnitt XML - Import).

Unterstützte Objekte für XML-Importe/-Exporte:

  • ACLs (nur Import)
  • Alarmgeräte
  • Alarmgruppen
  • Alarmvorlagen
  • Geräte
  • Ordner (in Vorlagen)
  • Gruppen
  • Arbeitsplätze
  • Karten
    • Karten filtern
  • OPM
  • Objekte verarbeiten
  • Eigenschaften
  • Berichte (nur PDF)
  • Planer melden
  • Zeitpläne
  • SLCs
  • SLOs
  • Vorlagen (siehe Abschnitt Vorlagen bezüglich der XML-Export-/Import-Funktionalität für Vorlagen)
  • Benutzer (nur Import)
  • Benutzergruppen (nur Import)


Diagramme wie Zustandsverlauf, Werteverlauf oder Werteverlauf plus können von der XML-Import/Export-Funktionalität nicht verarbeitet werden und können zu Warnungen im Export/Import-Prozess führen


Schnittstellendefinition:

  • XML-Import/Export entspricht dem XML 1.0-Standard
  • Unterstützt alle w3c-XML-Nachbearbeitungsstandards

XML-Export

Es gibt zwei Möglichkeiten, Objekte im XML-Format zu exportieren. Der erste und schnellste Weg ist, das Funktionsmenü einer Gruppe zu öffnen und auf XML Export zu klicken:


Diese Aktion exportiert sofort die Objekte unterhalb dieser Gruppe:


Die zweite Möglichkeit besteht darin, ein Objekt vom Typ XML-Export unter /root/Configurations zu erstellen:


XML-Exportkonfiguration:


Eigentum Beschreibung
Name Konfigurationsname exportieren
Export Der Pfad, unter dem Objekte exportiert werden sollen
Postprozessor Diese Funktion wird derzeit nicht verwendet


Das Objekt wird unter dem Knoten /root/Configurations/Import/Export erstellt. Um den Export tatsächlich zu initiieren und die XML-Datei zu erstellen, navigieren Sie zu /root/Configurations/Import/Export und klicken Sie auf Generate für das zuvor erstellte Objekt:


Drücken Sie die Schaltfläche Generieren :

 

Die XML-Exportdatei wird angezeigt und kann über den Browser heruntergeladen werden:


Meldungen mit nicht aufgelösten Links, wie im folgenden Abschnitt „ Ergebnisinformationen “ gezeigt, können durch Objekte wie Diagramme verursacht werden, die von der XML-Exportfunktion nicht unterstützt werden. Andere Objekte sollten davon nicht betroffen sein:


Eigenschaftsreferenzen in Objekten wie <$PID18$>, die möglicherweise in Textfeldern verwendet werden, werden ignoriert

XML-Import

Es stehen mehrere Importmodi zur Verfügung:

 

Importmodus Beschreibung
Hinzufügen
  • Die durch die XML-Datei definierten Objekte werden unterhalb der ausgewählten Gruppe hinzugefügt
  • Identität geht für alle hinzugefügten Objekte verloren (dasselbe Objekt kann mehr als einmal hinzugefügt werden)
  • Es wird keine TID gespeichert
Aktualisieren

Die Objekte unterhalb der Importgruppe werden mit denen aktualisiert, die in der XML-Datei definiert sind

  • Die Identität wird beibehalten und für alle durch die XML-Datei definierten Objekte berücksichtigt

  • Neu hinzugefügte Objekte erhalten die durch die XML-Datei definierte TID
  • Es sind beliebig viele Updates für jedes Objekt möglich

  • Objekte unterhalb der Importgruppe, die nicht in der XML-Datei enthalten sind, werden gelöscht
XML-Top-Objekte hinzufügen/aktualisieren
  • Funktioniert wie Update , aber es werden nur die obersten Objekte berücksichtigt, die in der XML-Datei definiert sind
  • Bestehende Objekte in der Importgruppe werden nicht wie bei einem normalen Import entfernt
Umfang frei
  • Der Geltungsbereich wird durch die XML-Datei definiert (es ist kein Root-Objekt erforderlich)
  • Objekte können über die SKOOR Engine Datenbank verstreut sein. Ihre Abhängigkeiten werden wie in der XML-Datei definiert aktualisiert
    • Die Identität wird gewahrt und berücksichtigt
    • Es sind beliebig viele Updates desselben Objekts möglich

 

Wenn Objekte auf demselben System importiert werden, auf dem sie zuvor exportiert wurden, kann der Modus „ Hinzufügen “ zu doppelten Objekten führen, z. B. Alarmgeräten, die mit exportierten Objekten verknüpft sind

Diese Importmodi sind in der jeweiligen Dropdown-Liste mit dem Titel Instanz aufgeführt, um sie von den nur für Vorlagen zu verwendenden Importmodi zu trennen, die mit dem Titel Vorlage aufgeführt sind


Wie beim XML-Export können Importe direkt auf beliebige Gruppenobjekte durchgeführt werden. Klicken Sie im Funktionsmenü der Gruppe, die die Objekte nach dem Import enthalten soll, auf XML-Import :


Laden Sie eine zu importierende Datei hoch, wählen Sie sie aus und wählen Sie den erforderlichen Modus aus der Dropdown-Liste aus:


Klicken Sie auf Prüfen , um die Importdatei zu überprüfen und gegebenenfalls Fehler zu korrigieren. Bitte konsultieren Sie die bereitgestellte Logdatei, um Fehler zu analysieren. Wenn die Prüfung erfolgreich war, klicken Sie auf Import :


Wenn eine persistente Importkonfiguration benötigt wird, kann diese unter /root/Configurations/Import / Export erstellt werden:


XML-Importkonfiguration:

 

Eigentum Beschreibung
Name Name der XML-Importkonfiguration
Importmodus Importmodus (siehe Beschreibung oben)
Unter Einstiegspunkt des Objektbaums, um darunter Objekte hinzuzufügen
Datei Zu importierende XML-Datei (muss erst hochgeladen werden)
Präprozessor Derzeit nicht in Gebrauch
Datei hochladen

Ziehen Sie eine XML-Datei per Drag & Drop, um die Datei in SKOOR Engine hochzuladen, und wählen Sie sie aus dem Dropdown-Menü Datei aus


Der Importvorgang ist derselbe wie oben beschrieben.
Bei einem erfolgreichen Import wird Import erfolgreich als Ergebniscode angezeigt . Eine Zusammenfassung wird angezeigt und in die Protokolldatei geschrieben. Durch Anklicken der Protokolldatei erscheint ein neues Fenster mit detaillierten Informationen zum Import.

Das Prüfen und abschließende Importieren einer XML-Datei kann je nach Anzahl der beteiligten Objekte und gewähltem Importmodus eine Stunde oder länger dauern. Durch Drücken der Import- Schaltfläche wird der Import endgültig ausgelöst. Tun Sie dies nur, wenn die Prüfung erfolgreich war, wie neben Ergebniscode angegeben

Der Import prüft zunächst, ob Lizenzlimits verletzt werden. In diesem Fall erhält der Benutzer eine Fehlermeldung und der Import schlägt fehl

Wenn beim Import ein Fehler auftritt, werden alle neu erstellten Objekte vollständig entfernt – es verbleiben keine Dangling-Objekte im System