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. Dies ermöglicht das Erstellen einer spezifischen Struktur in einer SKOOR Engine Testumgebung, den Export und den anschließenden Import in Ihre SKOOR Engine Produktionsumgebung, sobald die Struktur erfolgreich eingerichtet wurde. Über die XML-Schnittstelle können Sie SKOOR Engine auch mit beliebigen Drittanbieter-Tools (z. B. CMDB, anderen vorhandenen Überwachungstools) synchronisieren.

allgemeine Informationen

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 aufgrund 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 filtern
OPM
Objekte verarbeiten
Eigenschaften
Berichte (nur PDF)
Berichtsplaner
Zeitpläne
SLCs
SLOs
Vorlagen (Informationen zur XML-Export-/ Importfunktion für Vorlagen finden Sie im Abschnitt „Vorlagen“).
Benutzer (nur Import)
Benutzergruppen (nur Import)

Diagramme wie Zustandsverlauf, Wertverlauf oder Wertverlauf Plus können von der XML-Import-/Exportfunktionalität nicht verarbeitet werden und können zu Warnungen im Export-/Importprozess führen

Schnittstellendefinition:

Der XML-Import/Export entspricht dem XML 1.0-Standard
Unterstützt alle W3C-XML-Postverarbeitungsstandards

XML – Export

Es gibt zwei Möglichkeiten, Objekte im XML-Format zu exportieren.

Einmaliger Export

Der erste und schnellste Weg besteht darin, das Funktionsmenü einer Gruppe zu öffnen und auf XML-Export zu klicken:

Durch diese Aktion werden die Objekte unter dieser Gruppe sofort exportiert:

Konfiguration exportieren

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 starten und die XML-Datei zu erstellen, navigieren Sie zu /root/Configurations/Import/Export und klicken Sie für das zuvor erstellte Objekt auf „Generieren“ :

Klicken Sie auf die Schaltfläche „Generieren“ :

Die XML-Exportdatei erscheint 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 hiervon nicht betroffen sein:

Eigenschaftsverweise 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 Die Identität aller hinzugefügten Objekte geht 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 für alle durch die XML-Datei definierten Objekte beibehalten und berücksichtigt Neu hinzugefügte Objekte erhalten die durch die XML-Datei definierte TID Es sind beliebig viele Aktualisierungen pro 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, es werden jedoch nur die obersten Objekte berücksichtigt, die in der XML-Datei definiert sind Vorhandene Objekte in der Importgruppe werden nicht entfernt, wie dies bei einem normalen Import der Fall wäre
Umfang frei	Der Geltungsbereich wird durch die XML-Datei definiert (es ist kein Root-Objekt erforderlich) Objekte können über die gesamte SKOOR Engine Datenbank verstreut sein. Ihre Abhängigkeiten werden gemäß der Definition in der XML-Datei aktualisiert Die Identität wird gewahrt und berücksichtigt Es sind beliebig viele Aktualisierungen desselben Objekts möglich

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

Diese Importmodi werden in der jeweiligen Dropdown-Liste mit dem Titel „ Instanz“ aufgeführt, um sie von den Importmodi zu unterscheiden, die nur für Vorlagen verwendet werden sollen, die mit dem Titel „Vorlage“ aufgeführt sind

Einmaliger Import

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

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

Klicken Sie auf „Überprüfen“ , um die Importdatei zu überprüfen und gegebenenfalls Fehler zu korrigieren. Bitte konsultieren Sie die bereitgestellte Protokolldatei, um Fehler zu analysieren. Wenn die Prüfung erfolgreich war, klicken Sie auf Importieren :

Konfiguration importieren

Wenn eine dauerhafte 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 zum Hinzufügen von Objekten darunter
Datei	Zu importierende XML-Datei (muss zuerst hochgeladen werden)
Präprozessor	Derzeit nicht im Einsatz
Datei hochladen	Ziehen Sie eine XML-Datei per Drag & Drop, um sie in die 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 einen Klick auf die Protokolldatei erscheint ein neues Fenster mit detaillierten Informationen zum Import.

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

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

Tritt beim Import ein Fehler auf, werden alle neu erstellten Objekte vollständig entfernt – es verbleiben keine freien Objekte im System

Bearbeiten Sie die XML-Datei vor dem Import

Normalerweise ist es nicht erforderlich, die exportierte Datei vor dem erneuten Import zu ändern. Allerdings können Konfigurationsänderungen manchmal schneller durchgeführt werden, wenn sie vor dem Import im XML durchgeführt werden.

Beispiel: Kollektor importierter Jobs ändern

Wenn mehrere Kollektoren konfiguriert sind, kann es erforderlich sein, diese beim Importieren von Jobs aus einem anderen SKOOR-System zu ändern.

Suchen Sie zunächst nach dem Agents Tag in der XML-Datei (es können mehrere Agent Tags darin enthalten sein):

<Agents>
  <Agent id="xxxx">
    <Name>collector-local</Name>
  </Agent>
</Agents>

Fügen Sie dann ein neues Agent Tag mit den folgenden Konventionen hinzu:

Geben Sie eine Agent ID ein, die mit einem alphabetischen Zeichen beginnt. Diese ID bezieht sich nicht auf ein Objekt in der SKOOR Engine , sie wird nur innerhalb des XML selbst verwendet
Fügen Sie im Tag „Name“ den Namen eines vorhandenen Kollektor im Zielsystem hinzu

<Agents>
  <Agent id="xxxx">
    <Name>collector-local</Name>
  </Agent>
  <Agent id="myNewCollectorId">
    <Name>external-collector-1</Name>
  </Agent>
</Agents>

Jetzt kann die Agent ID verwendet werden, um den neuen Kollektor für alle Jobs im Jobs- Tag zu konfigurieren. Legen Sie das Agent -Tag der Jobs entsprechend fest:

<Jobs>
  ...
    <Name>My Job</Name>
    <Agent>myNewCollectorId</Agent>
  ...
</Jobs>

Docs

XML exportieren/importieren