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 |
|
Aktualisieren | Die Objekte unterhalb der Importgruppe werden mit denen aktualisiert, die in der XML-Datei definiert sind
|
XML-Top-Objekte hinzufügen/aktualisieren |
|
Umfang frei |
|
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