Esportazione/importazione di XML

SKOOR Engine integra un'interfaccia XML che consente di esportare e importare qualsiasi struttura di oggetti con un unico file XML da un sistema SKOOR Engine a un altro. Ciò consente di creare una struttura specifica su un ambiente di test SKOOR Engine, esportarla e quindi importarla nell'ambiente di produzione SKOOR Engine una volta che la struttura è stata configurata correttamente. L'interfaccia XML consente inoltre di sincronizzare SKOOR Engine con qualsiasi strumento di terze parti (ad esempio CMDB, altri strumenti di monitoraggio esistenti).

Informazioni generali

Quando si ha a che fare con l'importazione/esportazione XML, ogni oggetto ha un ID univoco, il cosiddetto TID (Third party ID).
Un TID identifica un oggetto SKOOR Engine a livello globale (su tutte le istanze SKOOR Engine).
Se un TID deve essere memorizzato a seguito di un blocco dell'identità, il TID viene memorizzato come proprietà denominata tid (fare riferimento alle modalità di importazione nella sezione seguente XML - importazione).

Oggetti supportati per importazioni/esportazioni XML

ACL (solo importazione)
Dispositivi di allarme
Gruppi di allarme
Modelli di allarme
Dispositivi
Cartelle (nei modelli)
Gruppi
Lavori
Mappe filtro
OPM
Oggetti di processo
Proprietà
Rapporti (solo PDF)
Schedulers per report
Pianificazioni
SLC
SLO
Modelli (fare riferimento alla sezione Modelli per quanto riguarda la funzionalità di esportazione/importazione XML per i modelli)
Utenti (solo importazione)
Gruppi di utenti (solo importazione)

I grafici come la cronologia dello stato, la cronologia dei valori o la cronologia dei valori plus non possono essere gestiti dalla funzionalità di importazione/esportazione XML e potrebbero causare Warning durante il processo di esportazione/importazione

Definizione dell'interfaccia:

L'importazione/esportazione XML è conforme allo standard XML 1.0
Supporta tutti gli standard di post-elaborazione XML w3c

XML - esportazione

Esistono due modi per esportare oggetti in formato XML.

Esportazione singola

Il primo e più veloce modo è aprire il menu delle funzioni di un gruppo e cliccare su Esportazione XML:

Questa azione esporterà immediatamente gli oggetti presenti sotto questo gruppo:

Esportazione della configurazione

Il secondo modo consiste nel creare un oggetto di tipo esportazione XML in /root/Configurations:

Configurazione esportazione XML:

Proprietà	Descrizione
Nome	Nome della configurazione di esportazione
Esportazione	Il percorso in cui gli oggetti devono essere esportati
Postprocessore	Questa funzione non è attualmente utilizzata

L'oggetto verrà creato nel nodo /root/Configurations/Import / Export. Per avviare effettivamente l'esportazione e creare il file XML, passare a /root/Configurations/Import / Export e fare clic su Genera sull'oggetto creato in precedenza:

Premere il pulsante Genera:

Il file di esportazione XML verrà visualizzato e potrà essere scaricato tramite il browser:

I messaggi con collegamenti non risolti, come mostrato nella seguente sezione Informazioni sui risultati, possono essere causati da oggetti come i grafici che non sono supportati dalla funzione di esportazione XML. Gli altri oggetti non dovrebbero essere interessati da questo problema:

I riferimenti alle proprietà in oggetti come <$PID18$> che possono essere utilizzati all'interno dei campi di testo vengono ignorati

XML - importazione

Sono disponibili diverse modalità di importazione:

Modalità di importazione	Descrizione
Aggiungi	Gli oggetti definiti dal file XML vengono aggiunti sotto il gruppo selezionato L'identità viene persa per tutti gli oggetti aggiunti (lo stesso oggetto può essere aggiunto più di una volta) Non verrà memorizzato alcun TID
Aggiornamento	Gli oggetti sotto il gruppo di importazione vengono aggiornati con quelli definiti dal file XML L'identità viene mantenuta e considerata per tutti gli oggetti definiti dal file XML Gli oggetti appena aggiunti ottengono il TID definito dal file XML È possibile effettuare un numero illimitato di aggiornamenti su ciascun oggetto Gli oggetti sotto il gruppo di importazione che non sono presenti nel file XML saranno eliminati
Aggiungi/aggiorna oggetti XML principali	Funziona come l'aggiornamento, ma vengono considerati solo gli oggetti principali definiti nel file XML Gli oggetti esistenti nel gruppo di importazione non vengono rimossi come accadrebbe con un'importazione normale
Ambito libero	L'ambito è definito dal file XML (non è richiesto alcun oggetto radice) Gli oggetti possono essere sparsi in tutto il database SKOOR Engine. Le loro dipendenze vengono aggiornate come definito dal file XML L'identità verrà mantenuta e considerata È possibile effettuare un numero illimitato di aggiornamenti dello stesso oggetto

Se gli oggetti vengono importati sullo stesso sistema da cui sono stati esportati in precedenza, la modalità Aggiungi può portare alla duplicazione di oggetti come i dispositivi di allarme collegati agli oggetti esportati

Queste modalità di importazione sono elencate nel rispettivo menu a tendina con il titolo Istanza, al fine di separarle dalle modalità di importazione da utilizzare solo per i modelli, elencate con il titolo Modello

Importazione singola

Come per l'esportazione XML, le importazioni possono essere eseguite direttamente su qualsiasi oggetto di gruppo. Fare clic su Importazione XML nel menu delle funzioni del gruppo che dovrebbe contenere gli oggetti dopo l'importazione:

Caricare e selezionare un file da importare e scegliere la modalità richiesta dal menu a tendina:

Fare clic su Controlla per verificare il file di importazione e correggere eventuali errori, se necessario. Consultare il file di log fornito per analizzare gli errori. Quando il controllo ha esito positivo, fare clic su Importa:

Configurazione dell'importazione

Se è necessaria una configurazione di importazione persistente, è possibile crearla in /root/Configurations/Import / Export:

Configurazione importazione XML:

Proprietà	Descrizione
Nome	Nome della configurazione di importazione XML
Modalità di importazione	Modalità di importazione (vedere la descrizione sopra)
Sotto	Punto di ingresso dell'albero degli oggetti per aggiungere oggetti sotto
File	File XML da importare (deve essere caricato prima)
Preprocessore	Attualmente non in uso
Carica file	Trascinare un file XML per caricarlo su SKOOR Engine e selezionarlo dal menu a tendina File

La procedura di importazione è la stessa descritta sopra. Se l'importazione ha esito positivo, verrà visualizzato il messaggio Importazione riuscita come codice risultato. Verrà visualizzato un riepilogo che verrà scritto nel file di log. Cliccando sul file di log, apparirà una nuova finestra con informazioni dettagliate sull'importazione.

Il controllo e l'importazione finale di un file XML possono richiedere un'ora o anche più, a seconda del numero di oggetti coinvolti e della modalità di importazione scelta. Premendo il pulsante Importa si avvierà finalmente l'importazione. Eseguire questa operazione solo se il controllo ha avuto esito positivo, come indicato accanto a Codice risultato

L'importazione verifica innanzitutto se vi sono violazioni dei limiti di licenza. In tal caso, l'utente riceve un messaggio di errore e l'importazione non va a buon fine

Se si verifica un errore durante l'importazione, tutti gli oggetti appena creati vengono rimossi completamente: nessun oggetto rimarrà nel sistema

Modificare il file XML prima dell'importazione

In genere, non è necessario modificare il file esportato prima di importarlo nuovamente. Tuttavia, a volte le modifiche alla configurazione possono essere più rapide se eseguite nel file XML prima dell'importazione.

Esempio: modifica del collettore dei lavori importati

Se sono configurati più collettori di dati, potrebbe essere necessario modificarli durante l'importazione di lavori da un sistema SKOOR diverso.

In primo luogo, cercare il tag Agents nel file XML (al suo interno possono essere presenti più tag Agent):

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

Quindi, aggiungere un nuovo tag Agent con le seguenti convenzioni:

Inserire un ID agente che inizi con un carattere alfabetico. Questo ID non è correlato ad alcun oggetto nel SKOOR Engine, ma viene utilizzato solo all'interno dello stesso XML
Nel tag Name, aggiungere il nome di un collettore esistente nel sistema di destinazione

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

Ora, l'ID agente può essere utilizzato per configurare il nuovo collettore per tutti i lavori nel tag Jobs. Impostare il tag Agent dei lavori di conseguenza:

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