Verwendung der $-Notation
Die $-Notation wird im verwendet, um auf die Eigenschaften von Objekten zuzugreifen.
Syntax
$<Definition>:<Datentyp>{<Format>}$
Bei Verwendung der $-Notation ist darauf zu achten, dass der Wert den korrekten Datentyp erhält. Die $-Notation liefert als Standard den Typ String zurück.
Als Datentypen sind zulässig:
Binary
Bool
Byte
Date
Decimal
Double
Int
Long
Short
String (Standard)
Text
Die Formatangabe ist optional. Wenn das Format angegeben wird, ist der Zieltyp des Ausdrucks ein String. Wird das Format nicht angegeben, ist es der angegebene Datentyp.
Die Formatangaben entsprechen den Formatzeichenfolgen der Funktion String.Format für die einzelnen Typen. Ausführliche Informationen zu den Formatzeichenfolgen finden Sie unter https://docs.microsoft.com/en-us/dotnet/standard/base-types/composite-formatting#format-string-component.
Beispiele:
$MaxValidDays:Int{000}$
ergibt für den Wert 42 die Ausgabe "042"
$XDateUpdated:Date{t}$
ergibt "11:16"
Hinweis: Wenn Sie in Skripten ein $-Zeichen verwenden möchten, ohne das es den Zugriff auf einen Spaltennamen repräsentieren soll, dann müssen Sie dieses Zeichen durch Verdopplung maskieren.
Beispiel:
In Windows PowerShell Skripten ist statt
theScript.AppendLine("foreach ($Domain in $Domains)")
Folgendes zu verwenden:
theScript.AppendLine("foreach ($$Domain in $$Domains)")
Detaillierte Informationen zum Thema
Zugriff auf Spalten des lokalen Objektes
Syntax
$<Spaltenname>:<Datentyp>{<Format>}$
Beispiele zur Verwendung in Bildungsregeln
Der Anzeigename eines Active Directory Benutzers soll aus dem Vornamen und dem Nachnamen des Active Directory Benutzers gebildet werden. Die Bildungsregel auf ADSAccount.Displayname lautet:
If $Givenname$<>"" And $Surname$<>"" Then
Value = $Surname$ & " " & $Givenname$
ElseIf $Givenname$<>"" Then
ElseIf $Surname$<>"" then
End If
Wird eine Identität deaktiviert, so soll das Austrittsdatum der Identität gesetzt werden. Die Bildungsregel auf Person.Exitdate lautet:
If $IsInActive:bool$ Then
End If
Verwandte Themen
Zugriff auf Spalten eines über eine Beziehung verbundenen Objektes
Derzeit ist als Beziehung nur die Fremdschlüsselbeziehung zugelassen.
Syntax
$FK(<Fremdschlüsselspalte>).<Spaltenname>:<Datentyp>{<Format>}$
Beispiel zur Verwendung in Bildungsregeln
Der Vorname eines Active Directory Benutzers soll aus dem Vornamen der zugeordneten Identität gebildet werden. Die Bildungsregel auf ADSAccount.Givenname lautet:
Value = $FK(UID_Person).Firstname$
Verwandte Themen
Zugriff auf den alten Wert einer Spalte
Syntax
$Spaltenname[o]$
Beispiel zur Verwendung in den Parametern der Prozessschritte
Optionale Parameter von Prozessschritten werden nicht generiert, wenn der Wert auf Nothing gesetzt wird oder in der Wertvorlage nicht zugewiesen wird. Damit ist es möglich die Parameterzahl bei Zielsystem-Komponenten einzuschränken. Soll ein solcher Wert geleert werden, ist statt Nothing ein Leerstring zu übergeben.
Eine Wertvorlage könnte beispielsweise so aussehen:
If $Lastname[o]$ <> $Lastname$ Then
End If
HINWEIS: Für einige der Standardspalten wie beispielsweise XDateInserted, XDateUpdated, XUserInserted, XUserUpdated, XOrigin, XIsInEffect und XMarkedForDeletion werden die neuen Werte erst nach dem Speichern des Objektes gebildet. Damit ist während der Verarbeitung der Bildungsregeln der neue Wert der Spalten immer gleich dem alten Wert (beispielsweise $XDateUpdated[o]$ = $XDateUpdated$).
Verwandte Themen
