Aktionen
Import
Für die Aktion „Import” gelten folgende Besonderheiten:
Eine Datei, die importiert werden soll, muss dem Standardformat entsprechen. Abweichungen vom Standard können aber über entsprechende XML-Tags angegeben werden.
Die erste Zeile der Importdatei enthält die Feldzuordnungen für den Import. Die Einzelzuordnungen dürfen in diesem Fall nicht mit einem Zeilenumbruch voneinander getrennt werden.
Alternativ können die Feldzuordnungen über den XML-Tag „<#1#>“ auch in der Serveraufgabe selbst definiert werden.
Die erste Zeile Einzelzuordnung der Feldzuordnungen enthält die Zielinformation mit dem führenden Item. Das führende Item bestimmt die weitere Verarbeitung. Kann in myCMDB das führende Item weder gefunden noch neu angelegt werden, wird die Importdatei nicht weiterverarbeitet.
Bei Quellfeldvariablen wird hier immer die Herkunft „TAB” verwendet.
Bsp:
[TAB:Status]
entspricht dem Inhalt der Spalte Status des aktuellen Datensatzes.
Die zweite Zeile der Importdatei enthält die Spaltennamen für den Import. Die einzelnen Spaltennamen werden mit einem Spaltentrennzeichen (im Standard ist dies ein Semikolon) voreinander getrennt.
Alternativ können die Spaltennamen über den XML-Tag „<#2#>“ auch in der Serveraufgabe selbst definiert werden. Falls die erste Zeile einer jeden Importdatei die Spaltennamen enthält muss <#2#>#Zeile1#</#2#> in der Serveraufgabe angegeben werden.
Die dritte Zeile der Importdatei ist eine beliebige Kommentarzeile nicht einfach überlesen wird. Wurde in der Serveraufgabe jedoch der XML-Tag #1# oder #2# verwendet und die Importdatei enthält eine Kommentarzeile muss diese explizit mit dem XML-Tag #3# angegeben werden.
Bsp:
#1#>
attrmyItem.Ident=[TAB:Ident];
attrmyItem.Status=[TAB:Status];
attrmyItem.OSP.Ident=attrmyItem.Ident;
</#1#>
<#2#>Ident;Status</#2#>
<#3#>#Zeile1#</#3#>
Hiermit könnte eine Datei importiert werden, die im csv-Format vorliegt und jede Datenzeile mit einem Zeilenumbruch abgeschlossen ist (Standard ZeilenTrennZeichen ist CRLF). Jede Zeile hat mindestens zwei Spalten, die mit Semikolon voneinander getrennt sind. Die erste Zeile der Datei wird überlesen, bzw. als Kommentar behandelt. Die erste Spalte heißt Ident und wird in attrmyItem.Ident übernommen. Die zweite Spalte heißt Status und wird in attrmyItem.Status übernommen. Wenn der Ident vorhanden ist, wird der Status mit dem neuen Status aus der Importdatei aktualisiert. Wenn der Ident nicht vorhanden ist, wird ein neuer Datensatz in der Datenbank angelegt.