Feldzuordnungen
In Feldzuordnungen können (bis auf die Feldgrößenbeschränkung des Feldes selbst) beliebig viele Einzelzuordnungen eingetragen werden. Jede Einzelzuordnung MUSS mit einem Semikolon abgeschlossen werden
Bsp:
Einzelzuordnung1; Einzelzuordnung2; Einzelzuordnung3; …
Zwischen Einzelzuordnungen kann ein Leerzeichen und/oder ein Zeilenumbruch eingefügt werden, muss aber nicht.
Konfiguration Einzelzuordnung
Jede Einzelzuordnung besteht aus einem XML-Tag oder aus der Zielinformation, gefolgt von einem Gleichheitszeichen und abschließend der Quellinformation, also:
Zielinformation=Quellinformation;
Bsp:
attrPerson.Name=[LDAP:sn];
In diesem Beispiel ist „attrPerson.Name“ die Zielinformation und „[LDAP:sn]“ die Quellinformation.
Konfiguration Zielinformation
Die Zielinformation ist entweder der Name einer Zielfeldfunktion, oder einer Zielfeldvariablen.
Die möglichen Zielfeldfunktionen werden bei der jeweiligen Serveraufgabe beschrieben, da nicht alle Funktionen in allen Serveraufgaben-Arten verwendet werden können.
Die Zielfeldvariablen bestehen aus zwei, mit Punkt getrennten Teilen. Vor dem Punkt steht der Name einer Datenbanktabelle eines myCMDB-Items und nach dem Punkt der Spaltenname einer Datenbanktabelle.
Bsp: attrPerson.Name
🡪 attrPerson entspricht dem Tabellenname des myCMDB-Items „Person“.
🡪 Name entspricht dem Spaltenname des Attributs „Nachname“ des myCMDB-Items „Person“.
Konfiguration Quellinformation
Die Quellinformation ist entweder der Name einer Quellfeldfunktion, oder einer Quellfeldkonstanten, oder einer Quellfeldvariablen oder einer beliebigen Kombination dieser drei Möglichkeiten.
Die möglichen Inhalte dieser drei Möglichkeiten werden vor allem bei der jeweiligen Serveraufgabe beschrieben. Quellfeldfunktionen sind eine Sonderform von Quellfeldkonstanten, also ebenfalls unveränderliche Zeichenketten.
Quellfeldvariablen werden in eckige Klammern notiert, z.B.:
„[Herkunft:Name]“
🡪 Herkunft: beschreibt aus welchem Objekt der Inhalt der Quellfeldvariable entnommen wird.
🡪 Name: beschreibt aus welchem Attribut des Herkunftobjekts der Inhalt der Quellfeldvariable entnommen wird.
Innerhalb der Verarbeitung wird jede Quellfeldvariable zunächst mit dem jeweiligen Wert ersetzt und dann der komplette „Datensatz“ verarbeitet.
Bsp: [LDAP:sn]
🡪 LDAP entspricht der Herkunft „Active Directory per LDAP“
🡪 sn entspricht dem Active Directory Attribut surname (=Nachname)
Alternativ zu „Herkunft:Name“ können in Quellfeldvariablen auch „$Platzhaltername“ verwendet werden. Diese sind im Folgekapitel beschrieben.
Wenn nicht sichergestellt werden kann, dass über „Herkunft.Name“ ein Feldinhalt ermittelt werden kann, können auch Ersatz-Felder benannt werden. Diese werden mit einem „|“ (Pipe) voneinander getrennt. Es wird dann der Feldinhalt verwendet, der zuerst nicht leer ist. Bsp:
Bsp: xyz =[LDAP:sn]|[LDAP:mail]|[LDAP:sAMAccountName]
🡪 bedeutet, dass der komplette Begriff „[LDAP:sn]|[LDAP:mail]|[LDAP:sAMAccountName]“ mit dem Nachnamen aus dem AD ersetzt wird. Enthält der Nachname im AD keinen Wert, wird die Mailadresse verwendet. Enthält die Mailadresse ebenfalls keinen Wert, wird der Anmeldenamen verwendet, der im AD ein Pflichtfeld ist und immer gefüllt ist. Das Ergebnis wird dann als Wert für das Ziel xyz verwendet.
Allgemein gültige Quellfeldfunktionen:
[OSP:INIT:xxxxx]
OSP:INIT bedeutet, dass xxxxx nur bei Neuanlage des myCMDB-Items mit dem entsprechenden Wert ersetzt werden. Bei Änderungen entspricht dieser Wert stets einer leeren Zeichenkette.
XML-Tags
Ein XML-Tag besitzt immer einen Tagnamen, ein öffnendes Tag und ein schließendes Tag:
<Tagname>Taginhalt</Tagname>
Beim schließenden Tag ist der „/”-Schrägstrich wichtig und zwingend notwendig.
Der Tagname sollte nur aus den Buchstaben von A-Z und Zahlen bestehen.
Mehrere XML-Tags können einfach hintereinandergeschrieben werden, oder auch mit einem Leerzeichen oder einem Zeilenumbruch voneinander getrennt werden.
Bsp:
<ExportPfad>C:\Kundendaten\Personalstamm</ExportPfad>
definiert einen Tag namens ExportPfad mit seinem Inhalt: „C:\Kundendaten\Personalstamm“.