Muster, Variablen und Funktionen
Muster können für Personenattribute vom Typ Formatted und für den OU-Pfad von Personen verwendet werden. Das Ziel ist das individuelle Zusammensetzen von Textwerten.
Variablen
Variablen werden innerhalb von zwei Prozentzeichen geschrieben und während dem Import durch den tatsächlichen Wert ersetzt.
Beispiel
Das Muster %FirstName% %LastName% wird während dem Import in den Wert Peter Lustig aufgelöst, wenn der Vorname der Person "Peter" und der Nachname "Lustig" ist.
Erlaubte Variablen
Folgende Personenattribute können als Variablen genutzt werden.
| Variable |
Deutsche Bezeichnung |
Englische Bezeichnung |
| %ThirdPartySystemId% |
Fremdsystem-ID |
Third-Party System ID |
| %Initials% |
Initialen |
Initials |
| %FirstName% |
Vorname |
First Name |
| %FirstNameAlias% |
Alias für Vorname |
First Name Alias |
| %LastName% |
Nachname |
Last Name |
| %LastNameAlias% |
Alias für Nachname |
Last Name Alias |
| %DisplayName% |
Anzeigename |
Display Name |
| %FullName% |
Name |
Object Name |
| %Email% |
E-Mail |
Email |
| %UserPrincipalName% |
User-Principal-Name |
User Principal Name |
| %SamAccountName% |
SAM-Account-Name |
SAM Account Name |
| %Description% |
Beschreibung |
Description |
| %Office% |
Büro |
Office |
| %WebPage% |
Webseite |
Website |
| %Street% |
Strasse |
Street |
| %City% |
Ort |
City |
| %State% |
Staat |
State |
| %Zip% |
Postleitzahl |
Zip |
| %Country% |
Land |
Country |
| %JobTitle% |
Job-Titel |
Job Title |
| %Department% |
Abteilung |
Department |
| %Company% |
Firma |
Company |
| %ProfilePath% |
Profilpfad |
Profile Path |
| %LogonScript% |
Anmeldeskript |
Logon Script |
| %HomeFolderPath% |
Pfad zu Home-Ordner |
Home Folder Path |
| %HomeFolderDriveLetter% |
Laufwerksbuchstabe für Home |
Home Folder Drive Letter |
| %Phone% |
Telefon |
Phone |
| %PhoneHome% |
Telefon Privat |
Home Phone |
| %PhonePager% |
Telefon Pager |
Pager |
| %PhoneMobile% |
Telefon Mobil |
Mobile Phone |
| %PhoneIP% |
Telefon IP |
Phone IP |
| %Fax% |
Fax |
Fax |
| %Class% |
Klasse |
Class |
| %DateOfBirth% |
Geburtsdatum |
Date of Birth |
| %InitialPassword% |
Initialkennwort |
Initial Password |
Note
Der Wert der beiden Variablen "FirstNameAlias" und "LastNameAlias" kann direkt in netUNIMEX gesetzt werden. Wenn kein manuell gesetzter Wert vorhanden ist, dann wird der Wert der Variablen "FirstName" und "LastName" Verwendet.
Individuelle Attribute
Man kann auch mit selbst definierten Attributen arbeiten wie folgt:
- Als Importfeld definieren:
- Als Benutzerdefiniertes Feld hinzufügen:
- Verwenden beim Personentyp:
Funktionen
Funktionen werden verwendet den Wert von Variablen zu verändern. Die verfügbaren Funktionen werden nachfolgend beschrieben.
Replace Special Char
Diese Funktion entfernt alle bekannten Sonderzeichen aus einem Text. Die Sonderzeichen können unter Konfiguration/Sonderzeichen verwaltet werden.
| Syntax |
.ReplaceSpecialChar() |
Beispiel
| Attribut |
Wert |
| Vorname |
Jörg |
| Muster |
Wert |
%FirstName%.ReplaceSpecialChar() |
Joerg |
Remove White Spaces
Diese Funktion entfernt alle Leerzeichen aus einem Text.
| Syntax |
.RemoveWhiteSpaces() |
Beispiel
| Attribut |
Wert |
| Vorname |
Hans Peter |
| Muster |
Wert |
%FirstName%.RemoveWhiteSpaces() |
HansPeter |
Replace
Diese Funktion ersetzt einen Textteil durch einen anderen.
| Syntax |
.RemoveWhiteSpaces(alterText, neuerText) |
Note
Das Komma wird bei dieser Funktion zur Unterteilung der Parameter genutzt. Wenn ein Komma ersetzt werden soll, dann muss der Code , verwendet werden.
Beispiel
| Attribut |
Wert |
| Ort |
Wangen bei Olten |
| Klasse |
INF1a,BM2c |
| Muster |
Wert |
%City%.Replace('bei', 'b.') |
Wangen b. Olten |
%Class%.Replace(',', '-') |
INF1a-BM2c |
Substring
Diese Funktion selektiert einen Teil eines Textes.
| Syntax |
.Substring(startIndex, länge) |
Beispiel
| Attribut |
Wert |
| City |
Wangen bei Olten |
| Muster |
Wert |
%City%.Substring(0, 6) |
Wangen |
%City%.Substring(11, 5) |
Olten |
Split-Take
Diese Funktion teilt einen Text bei einem bestimmten Zeichen (Parameter 1). Der zweite Parameter selektiert die gewünschten Teiltexte und hängt sie aneinander.
| Syntax |
.SplitTake(seperator, splitIndex) |
Note
Das Komma wird bei dieser Funktion zur Unterteilung der Parameter genutzt. Wenn der Text bei einem Komma geteilt werden soll, dann muss der Code , verwendet werden.
Beispiel
| Attribut |
Wert |
| Vorname |
Hans-Peter |
| Klasse |
INF1a,BM2c,GEO3e |
| Muster |
Wert |
%FirstName%.SplitTake(-, 0) |
Hans |
%FirstName%.SplitTake(-, 1) |
Peter |
%FirstName%.SplitTake(-, [0,1]) |
HansPeter |
%Class%.SplitTake(',', [0,2]) |
INF1aGEO3e |
To-Lower
Diese Funktion wandelt alle vorhandenen Buchstaben in Kleinbuchstaben um.
Beispiel
| Attribut |
Wert |
| Vorname |
Peter |
| Nachname |
lustig |
| Klasse |
INF1a |
| Muster |
Wert |
%FirstName%.ToLower() |
peter |
%LastName%.ToLower() |
lustig |
%ClassName%.ToLower() |
inf1a |
To-Upper
Diese Funktion wandelt alle vorhandenen Buchstaben in Grossbuchstaben um.
Beispiel
| Attribut |
Wert |
| Vorname |
Peter |
| Nachname |
LUSTIG |
| Klasse |
INF1a |
| Muster |
Wert |
%FirstName%.ToUpper() |
PETER |
%LastName%.ToUpper() |
LUSTIG |
%ClassName%.ToUpper() |
INF1A |
Anwendung
E-Mail-Adresse / User-Principal-Name
Das nachfolgende Muster wird zum Zusammensetzen einer E-Mail-Adresse oder eines User-Principal-Names verwendet.
- Bei mehrteiligen Vornamen, welche durch Leerzeichen getrennt sind, wird nur der erste Teil verwendet. Bei Bindestrichen wird der Name nicht getrennt. Sonderzeichen werden ersetzt.
- Bei mehrteiligen Nachnamen, welche durch Leerzeichen getrennt sind, werden alle Teile verwendet, wobei die Leerzeichen entfernt werden. Bei einem Bindestrich wird der Rest des Namens ignoriert.
Muster
%FirstNameAlias%.ToLower().SplitTake(' ',0).ReplaceSpecialChar().%LastNameAlias%.ToLower().SplitTake('-',0).RemoveWhiteSpaces().ReplaceSpecialChar()@domain.lan
Beispiele
| Vorname |
Alias für Vorname |
Nachname |
Alias für Nachname |
Wert |
| Jörg Andreas |
|
Müller |
|
joerg.mueller@domain.lan |
| Marie-Louise |
|
Müller |
|
marie-louise.mueller@domain.lan |
| Pedro |
|
Di Santo |
|
pedro.disanto@domain.lan |
| Maria |
|
Muster-Knöpfli |
|
maria.muster@domain.lan |
| Hans Peter |
Hanspeter |
Müller Meyer |
Müller |
hanspeter.mueller@domain.lan |
SAM-Account-Name
Das nachfolgende Muster wird zum Zusammensetzen eines SAM-Account-Names verwendet.
- Bei mehrteiligen Vornamen, welche durch Leerzeichen getrennt sind, wird nur der erste Teil verwendet. Bei Bindestrichen wird der Name nicht getrennt. Sonderzeichen werden ersetzt.
- Bei mehrteiligen Nachnamen, welche durch Leerzeichen getrennt sind, werden alle Teile verwendet, wobei die Leerzeichen entfernt werden. Bei einem Bindestrich wird der Rest des Namens ignoriert.
Muster
%FirstNameAlias%.ToLower().SplitTake(' ',0).ReplaceSpecialChar().%LastNameAlias%.ToLower().SplitTake('-',0).RemoveWhiteSpaces().ReplaceSpecialChar()
Beispiele
| Vorname |
Alias für Vorname |
Nachname |
Alias für Nachname |
Wert |
| Jörg Andreas |
|
Müller |
|
joerg.mueller |
| Marie-Louise |
|
Müller |
|
marie-louise.mueller |
| Pedro |
|
Di Santo |
|
pedro.disanto |
| Maria |
|
Muster-Knöpfli |
|
maria.muster |
| Hans Peter |
Hanspeter |
Müller Meyer |
Müller |
hanspeter.mueller |