Microsoft Entra Connect Sync: Funktionsreferenz
In Microsoft Entra Connect werden Funktionen verwendet, um einen Attributwert während der Synchronisierung zu ändern.
Die Syntax der Funktionen wird im folgenden Format ausgedrückt:
<output type> FunctionName(<input type> <position name>, ..)
Wenn eine Funktion überladen ist und mehrere Syntaxen akzeptiert, werden alle gültigen Syntaxen aufgeführt.
Die Funktionen sind stark typisiert und überprüfen, ob der übergebene Typ dem dokumentierten Typ entspricht.
Stimmt der Typ nicht überein, tritt ein Fehler auf.
Die Typen werden mit der folgenden Syntax ausgedrückt:
- bin – binär
- bool – boolesch
- dt – UTC-Datum/-Uhrzeit
- enum – Enumeration von bekannten Konstanten
- exp – Ausdruck, der zu einem booleschen Wert ausgewertet werden soll
- mvbin – mehrwertiger Binärwert
- mvstr – mehrwertige Zeichenfolge
- mvref – mehrwertiger Verweis
- num – numerisch
- ref – Verweis
- str – Zeichenfolge
- var – eine Variante (fast) jedes anderen Typs
- void – gibt keinen Wert zurück
Funktionen mit den Typen mvbin, mvstr und mvref können nur für mehrwertige Attribute verwendet werden. Funktionen mit bin, str und ref können sowohl für einwertige als auch für mehrwertige Attribute verwendet werden.
Funktionsreferenz
- Certificate
- CertExtensionOids
- CertFormat
- CertFriendlyName
- CertHashString
- CertIssuer
- CertIssuerDN
- CertIssuerOid
- CertKeyAlgorithm
- CertKeyAlgorithmParams
- CertNameInfo
- CertNotAfter
- CertNotBefore
- CertPublicKeyOid
- CertPublicKeyParametersOid
- CertSerialNumber
- CertSignatureAlgorithmOid
- CertSubject
- CertSubjectNameDN
- CertSubjectNameOid
- CertThumbprint
- CertVersion
- IsCert
- Konvertierung
- Datum/Uhrzeit
- Verzeichnis
- Auswertung
- Mathematisch
- Multi*valued
- Programmablauf
- Text
BitAnd
Beschreibung:
Die BitAnd-Funktion legt angegebene Bits auf einen Wert fest.
Syntax:
num BitAnd(num value1, num value2)
- value1, value2: Numerische Werte, die mit AND verknüpft werden sollen
Hinweise:
Diese Funktion konvertiert beide Parameter in die binäre Darstellung und legt ein Bit auf Folgendes fest:
- 0 – wenn mindestens eines der entsprechenden Bits in value1 und value2 den Wert „0“ aufweist
- 1 – wenn beide entsprechenden Bits 1 sind.
Anders gesagt: sie gibt in allen Fällen 0 zurück, außer wenn die entsprechenden Bits beider Parameter 1 sind.
Beispiel:
BitAnd(&HF, &HF7)
Gibt 7 zurück, da durch die Verknüpfung mit AND die Hexadezimalwerte „F“ und „F7“ zu diesem Wert ausgewertet werden.
BitOr
Beschreibung:
Die BitOr-Funktion legt angegebene Bits auf einen Wert fest.
Syntax:
num BitOr(num value1, num value2)
- value1, value2: Numerische Werte, die mit OR verknüpft werden sollen.
Hinweise:
Diese Funktion konvertiert beide Parameter in die binäre Darstellung und legt ein Bit auf 1 fest, wenn mindestens eins der entsprechenden Bits in „mask“ und „flag“ 1 ist, und auf 0, wenn beide entsprechenden Bits 0 sind. Anders gesagt gibt sie in allen Fällen 1 zurück, außer wenn die entsprechenden Bits der beiden Parameter 0 sind.
ZBool
Beschreibung:
Die CBool-Funktion gibt einen booleschen Wert zurück, der auf dem ausgewerteten Ausdruck basiert.
Syntax:
bool CBool(exp Expression)
Hinweise:
Wenn die Auswertung des Ausdrucks einen Wert ungleich null ergibt, gibt CBool TRUE zurück. Andernfalls wird FALSE zurückgegeben.
Beispiel:
CBool([attrib1] = [attrib2])
Gibt True zurück, wenn beide Attribute den gleichen Wert haben.
ZDate
Beschreibung:
Die CDate-Funktion gibt einen UTC-DateTime-Wert aus einer Zeichenfolge zurück. "DateTime" ist kein synchronisierungsspezifischer Attributtyp, wird jedoch von einigen Funktionen verwendet.
Syntax:
dt CDate(str value)
- Wert: Eine Zeichenfolge mit Datum, Uhrzeit und optional einer Zeitzone
Hinweise:
Die zurückgegebene Zeichenfolge ist immer ein UTC-Wert.
Beispiel:
CDate([employeeStartTime])
Gibt einen DateTime-Wert auf Basis der Anfangszeit des Mitarbeiters zurück.
CDate("2013-01-10 4:00 PM -8")
Gibt einen DateTime-Wert zurück, der „2013-01-11 12:00 AM“ darstellt.
CertExtensionOids
Beschreibung:
Gibt die OID-Werte aller kritischen Erweiterungen eines Zertifikatobjekts zurück
Syntax:
mvstr CertExtensionOids(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertFormat
Beschreibung:
Gibt den Formatnamen dieses X.509v3-Zertifikats zurück
Syntax:
str CertFormat(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertFriendlyName
Beschreibung:
Gibt den zugeordneten Alias eines Zertifikats zurück
Syntax:
str CertFriendlyName(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertHashString
Beschreibung:
Gibt den SHA1-Hashwert des X. 509v3-Zertifikats als hexadezimale Zeichenfolge zurück
Syntax:
str CertHashString(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertIssuer
Beschreibung:
Gibt den Namen der Zertifizierungsstelle zurück, die das X.509v3-Zertifikat ausgestellt hat
Syntax:
str CertIssuer(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertIssuerDN
Beschreibung:
Gibt den Distinguished Name des Zertifikatausstellers zurück
Syntax:
str CertIssuerDN(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertIssuerOid
Beschreibung:
Gibt die OID des Zertifikatausstellers zurück
Syntax:
str CertIssuerOid(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertKeyAlgorithm
Beschreibung:
Gibt die Schlüsselalgorithmusinformationen zu diesem X.509v3-Zertifikat als Zeichenfolge zurück
Syntax:
str CertKeyAlgorithm(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertKeyAlgorithmParams
Beschreibung:
Gibt die Schlüsselalgorithmusparameter für das X.509v3-Zertifikat als hexadezimale Zeichenfolge zurück
Syntax:
str CertKeyAlgorithm(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertNameInfo
Beschreibung:
Gibt die Namen des Antragstellers und des Ausstellers aus einem Zertifikat zurück
Syntax:
str CertNameInfo(binary certificateRawData, str x509NameType, bool includesIssuerName)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
- X509NameType: Der X509NameType-Wert des Antragstellers.
- includesIssuerName: TRUE, um den Ausstellernamen einzuschließen, andernfalls FALSE
CertNotAfter
Beschreibung:
Gibt das Uhrzeit (Ortszeit) zurück, zu der das Zertifikat abläuft
Syntax:
dt CertNotAfter(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertNotBefore
Beschreibung:
Gibt die Uhrzeit (Ortszeit) zurück, zu der ein Zertifikat gültig wird
Syntax:
dt CertNotBefore(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertPublicKeyOid
Beschreibung:
Gibt die OID des öffentlichen Schlüssels für das X.509v3-Zertifikat zurück
Syntax:
str CertKeyAlgorithm(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertPublicKeyParametersOid
Beschreibung:
Gibt die OID der Parameter des öffentlichen Schlüssels für das X.509v3-Zertifikat zurück
Syntax:
str CertPublicKeyParametersOid(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertSerialNumber
Beschreibung:
Gibt die Seriennummer des X.509v3-Zertifikats zurück
Syntax:
str CertSerialNumber(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertSignatureAlgorithmOid
Beschreibung:
Gibt die OID des Algorithmus zurück, mit dem die Signatur eines Zertifikats erstellt wurde
Syntax:
str CertSignatureAlgorithmOid(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertSubject
Beschreibung:
Ruft den Distinguished Name des Antragstellers für das Zertifikat ab
Syntax:
str CertSubject(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertSubjectNameDN
Beschreibung:
Gibt den Distinguished Name des Antragstellers für das Zertifikat zurück
Syntax:
str CertSubjectNameDN(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertSubjectNameOid
Beschreibung:
Gibt die OID des Antragstellernamens aus einem Zertifikat zurück
Syntax:
str CertSubjectNameOid(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertThumbprint
Beschreibung:
Gibt den Fingerabdruck eines Zertifikats zurück
Syntax:
str CertThumbprint(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CertVersion
Beschreibung:
Gibt die X.509-Formatversion eines Zertifikats zurück
Syntax:
str CertThumbprint(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
CGuid
Beschreibung:
Die CGuid-Funktion konvertiert die Zeichenfolgendarstellung einer GUID in ihre binäre Darstellung.
Syntax:
bin CGuid(str GUID)
- Eine nach diesem Muster formatierte Zeichenfolge: 00001111-aaaa-2222-bbbb-3333cccc4444 or {00001111-aaaa-2222-bbbb-3333cccc4444}
Contains
Beschreibung:
Die Contains-Funktion sucht in einem mehrwertigen Attribut nach einer Zeichenfolge.
Syntax:
num Contains (mvstring attribute, str search)
(mit Berücksichtigung der Groß-/Kleinschreibung)
num Contains (mvstring attribute, str search, enum Casetype)
num Contains (mvref attribute, str search)
(mit Berücksichtigung der Groß-/Kleinschreibung)
- attribute: Das zu durchsuchende mehrwertige Attribut.
- search: Die im Attribut zu suchende Zeichenfolge.
- Casetype: „CaseInsensitive“ (ohne Berücksichtigung der Groß-/Kleinschreibung) oder „CaseSensitive“ (mit Berücksichtigung der Groß-/Kleinschreibung).
Gibt den Index in dem mehrwertigen Attribut zurück, in dem die Zeichenfolge gefunden wurde. Wenn die Zeichenfolge nicht gefunden wird, wird 0 zurückgegeben.
Hinweise:
Bei mehrwertigen Zeichenfolgenattributen werden in den Werten Teilzeichenfolgen gefunden.
Für Verweisattribute muss die Suchzeichenfolge genau mit dem Wert übereinstimmen, der als Übereinstimmung betrachtet wird.
Beispiel:
IIF(Contains([proxyAddresses],"SMTP:")>0,[proxyAddresses],Error("No primary SMTP address found."))
Wenn das proxyAddresses-Attribut eine primäre E-Mail-Adresse besitzt (angegeben durch „SMTP:“ [in Großbuchstaben]), wird das proxyAddresses-Attribut zurückgegeben. Andernfalls wird ein Fehler zurückgegeben.
ConvertFromBase64
Beschreibung:
Die ConvertFromBase64-Funktion konvertiert den angegebenen Base64-codierten Wert in eine reguläre Zeichenfolge.
Syntax:
str ConvertFromBase64(str source)
– setzt Unicode-Codierung voraus
str ConvertFromBase64(str source, enum Encoding)
- source: Base64-codierte Zeichenfolge
- Codierung: Unicode, ASCII, UTF8
Beispiel
ConvertFromBase64("SABlAGwAbABvACAAdwBvAHIAbABkACEA")
ConvertFromBase64("SGVsbG8gd29ybGQh", UTF8)
Beide Beispiele geben "Hello world! " zurück.
ConvertFromUTF8Hex
Beschreibung:
Die ConvertFromUTF8Hex-Funktion konvertiert den angegebenen UTF8-Hex-codierten Wert in eine Zeichenfolge.
Syntax:
str ConvertFromUTF8Hex(str source)
- source: UTF8-2-Byte-codierte Zeichenfolge
Hinweise:
Der Unterschied zwischen dieser Funktion und „ConvertFromBase64([],UTF8)“ besteht darin, dass das Ergebnis vom DN-Attribut verwertet werden kann.
Dieses Format wird von Microsoft Entra ID als DN verwendet.
Beispiel:
ConvertFromUTF8Hex("48656C6C6F20776F726C6421")
GibtHello world! zurück.
ConvertToBase64
Beschreibung:
Die ConvertToBase64-Funktion konvertiert eine Zeichenfolge in eine Unicode-Base64-Zeichenfolge.
Konvertiert den Wert eines Arrays von ganzen Zahlen in die entsprechende mit Base64-Ziffern codierte Zeichenfolgendarstellung.
Syntax:
str ConvertToBase64(str source)
Beispiel:
ConvertToBase64("Hello world!")
Gibt „SABlAGwAbABvACAAdwBvAHIAbABkACEA“ zurück.
ConvertToUTF8Hex
Beschreibung:
Die ConvertToUTF8Hex-Funktion konvertiert eine Zeichenfolge in einen hexadezimal-codierten UTF8-Wert.
Syntax:
str ConvertToUTF8Hex(str source)
Hinweise:
Das Ausgabeformat dieser Funktion wird von Microsoft Entra ID als DN-Attributformat verwendet.
Beispiel:
ConvertToUTF8Hex("Hello world!")
Gibt „48656C6C6F20776F726C6421“ zurück.
Anzahl
Beschreibung:
Die Count-Funktion gibt die Anzahl von Elementen in einem mehrwertigen Attribut zurück.
Syntax:
num Count(mvstr attribute)
CNum
Beschreibung:
Die CNum-Funktion nimmt eine Zeichenfolge entgegen und gibt einen numerischen Datentyp zurück.
Syntax:
num CNum(str value)
CRef
Beschreibung:
Konvertiert eine Zeichenfolge in ein Verweisattribut.
Syntax:
ref CRef(str value)
Beispiel:
CRef("CN=LC Services,CN=Microsoft,CN=lcspool01,CN=Pools,CN=RTC Service," & %Forest.LDAP%)
CStr
Beschreibung:
Die CStr-Funktion konvertiert in einen Zeichenfolgendatentyp.
Syntax:
str CStr(num value)
str CStr(ref value)
str CStr(bool value)
- value: Kann ein numerischer Wert, ein Verweisattribut oder ein boolescher Wert sein.
Beispiel:
CStr([dn])
Könnte „cn=Joe,dc=contoso,dc=com“ zurückgeben.
DateAdd
Beschreibung:
Gibt einen Datumswert zurück, der ein Datum enthält, zu dem ein angegebenes Zeitintervall addiert wurde.
Syntax:
dt DateAdd(str interval, num value, dt date)
- interval: Zeichenfolgenausdruck, der das Zeitintervall angibt, das hinzugefügt werden soll. Die Zeichenfolge muss einen der folgenden Werte aufweisen:
- yyyy: Jahr
- q: Quartal
- m: Monat
- y: Tag des Jahres
- d: Tag
- w: Wochentag
- ww: Woche
- h: Stunde
- n: Minute
- s: Sekunde
- value: Die Anzahl der Einheiten, die Sie hinzufügen möchten. Der Wert kann positiv (für Datumsangaben in der Zukunft) oder negativ (für Datumsangaben in der Vergangenheit) sein.
- date: DateTime-Wert, der das Datum darstellt, dem das Intervall hinzugefügt wird.
Beispiel:
DateAdd("m", 3, CDate("2001-01-01"))
Addiert drei Monate und gibt einen DateTime-Wert zurück, der „2001-04-01“ darstellt.
DateFromNum
Beschreibung:
Die DateFromNum-Funktion konvertiert einen Wert im AD-Datumsformat in einen DateTime-Typ.
Syntax:
dt DateFromNum(num value)
Beispiel:
DateFromNum([lastLogonTimestamp])
DateFromNum(129699324000000000)
Gibt einen DateTime-Wert zurück, der „2012-01-01 23:00:00“ darstellt.
DNComponent
Beschreibung:
Die DNComponent-Funktion gibt den Wert einer angegebenen DN-Komponente von links beginnend zurück.
Syntax:
str DNComponent(ref dn, num ComponentNumber)
- dn: Das zu interpretierende Verweisattribut
- ComponentNumber: Die Komponente im zurückzugebenden DN
Beispiel:
DNComponent(CRef([dn]),1)
Falls der DN „cn=Joe,ou=…“ lautet, wird „Joe“ zurückgegeben.
DNComponentRev
Beschreibung:
Die DNComponentRev-Funktion gibt den Wert einer angegebenen DN-Komponente von rechts beginnend (also vom Ende her) zurück.
Syntax:
str DNComponentRev(ref dn, num ComponentNumber)
str DNComponentRev(ref dn, num ComponentNumber, enum Options)
- dn: Das zu interpretierende Verweisattribut
- ComponentNumber: Die Komponente im zurückzugebenden DN
- Optionen: DC – alle Komponenten mit „dc=“ ignorieren
Beispiel:
Falls der DN „cn=Joe,ou=Atlanta,ou=GA,ou=US, dc=contoso,dc=com“ lautet, geben beide
DNComponentRev(CRef([dn]),3)
DNComponentRev(CRef([dn]),1,"DC")
„US“ zurück.
Fehler
Beschreibung:
Die Error-Funktion wird verwendet, um einen benutzerdefinierten Fehler zurückzugeben.
Syntax:
void Error(str ErrorMessage)
Beispiel:
IIF(IsPresent([accountName]),[accountName],Error("AccountName is required"))
Wenn das accountName-Attribut nicht vorhanden ist, wird ein Fehler für das Objekt ausgegeben.
EscapeDNComponent
Beschreibung:
Die EscapeDNComponent-Funktion versieht eine Komponente eines DN mit Escapezeichen, sodass sie im LDAP dargestellt werden kann.
Syntax:
str EscapeDNComponent(str value)
Beispiel:
EscapeDNComponent("cn=" & [displayName]) & "," & %ForestLDAP%)
Stellt sicher, dass das Objekt in einem LDAP-Verzeichnis erstellt werden kann, auch wenn das displayName-Attribut Zeichen enthält, die in LDAP mit Escapezeichen versehen werden müssen.
FormatDatumZeit
Beschreibung:
Die FormatDateTime-Funktion wird verwendet, um einen DateTime-Wert in eine Zeichenfolge in einem angegebenen Format zu formatieren.
Syntax:
str FormatDateTime(dt value, str format)
- value: Ein Wert im DateTime-Format
- format: Eine Zeichenfolge, die das Format darstellt, in das konvertiert werden soll.
Hinweise:
Die möglichen Werte für das Format finden Sie hier: Benutzerdefinierte Datums- und Uhrzeitformate für die FORMAT-Funktion.
Beispiel:
FormatDateTime(CDate("12/25/2007"),"yyyy-MM-dd")
Ergibt „2007-12-25“.
FormatDateTime(DateFromNum([pwdLastSet]),"yyyyMMddHHmmss.0Z")
Kann „20140905081453.0Z“ ergeben.
Guid
Beschreibung:
Die Guid-Funktion generiert eine neue GUID nach dem Zufallsprinzip.
Syntax:
str Guid()
IIF
Beschreibung:
Die IIF-Funktion gibt basierend auf einer angegebenen Bedingung einen Wert aus einem Satz möglicher Werte zurück.
Syntax:
var IIF(exp condition, var valueIfTrue, var valueIfFalse)
- condition: Ein beliebiger Wert oder Ausdruck, der als True oder False ausgewertet werden kann.
- valueIfTrue: Der zurückgegebene Wert, wenn die Bedingung als „True“ ausgewertet wird.
- valueIfFalse: Der zurückgegebene Wert, wenn die Bedingung als „False“ ausgewertet wird.
Beispiel:
IIF([employeeType]="Intern","t-" & [alias],[alias])
Gibt bei Praktikanten den Alias eines Benutzers mit einem vorangestellten „t-“ zurück. Andernfalls wird der unveränderte Alias des Benutzers zurückgegeben.
InStr
Beschreibung:
Die InStr-Funktion sucht nach dem ersten Vorkommen einer Teilzeichenfolge in einer Zeichenfolge.
Syntax:
num InStr(str stringcheck, str stringmatch)
num InStr(str stringcheck, str stringmatch, num start)
num InStr(str stringcheck, str stringmatch, num start, enum compare)
- stringcheck: Zu durchsuchende Zeichenfolge
- stringmatch: Zu findende Zeichenfolge
- start: Startposition zum Finden der Teilzeichenfolge
- compare: VbTextCompare oder VbBinaryCompare
Hinweise:
Gibt die Position zurück, an der die Teilzeichenfolge gefunden wurde (oder 0, wenn sie nicht gefunden wurde).
Beispiel:
InStr("The quick brown fox","quick")
Wird als 5 ausgewertet
InStr("repEated","e",3,vbBinaryCompare)
Wird als 7 ausgewertet.
InStrRev
Beschreibung:
Die InStrRev-Funktion sucht nach dem letzten Vorkommen einer Teilzeichenfolge in einer Zeichenfolge.
Syntax:
num InstrRev(str stringcheck, str stringmatch)
num InstrRev(str stringcheck, str stringmatch, num start)
num InstrRev(str stringcheck, str stringmatch, num start, enum compare)
- stringcheck: Zu durchsuchende Zeichenfolge
- stringmatch: Zu findende Zeichenfolge
- start: Startposition zum Finden der Teilzeichenfolge
- compare: VbTextCompare oder VbBinaryCompare
Hinweise:
Gibt die Position zurück, an der die Teilzeichenfolge gefunden wurde (oder 0, wenn sie nicht gefunden wurde).
Beispiel:
InStrRev("abbcdbbbef","bb")
Gibt 7 zurück.
IsBitSet
Beschreibung:
Die IsBitSet-Funktion testet, ob ein Bit festgelegt ist.
Syntax:
bool IsBitSet(num value, num flag)
- value: Ein numerischer Wert, der ausgewertet wird. flag: Ein numerischer Wert, der das Bit angibt, das ausgewertet werden soll.
Beispiel:
IsBitSet(&HF,4)
Gibt „True“ zurück, da Bit 4 auf den Hexadezimalwert „F“ festgelegt ist.
IsDate
Beschreibung:
Die IsDate-Funktion wird als „True“ ausgewertet, wenn der Ausdruck als DateTime-Typ ausgewertet werden kann.
Syntax:
bool IsDate(var Expression)
Hinweise:
Wird verwendet, um zu bestimmen, ob „CDate()“ erfolgreich sein kann.
IsCert
Beschreibung:
Gibt TRUE zurück, wenn die Rohdaten in ein .NET X509Certificate2-Zertifikatobjekt serialisiert werden können
Syntax:
bool CertThumbprint(binary certificateRawData)
- certificateRawData: Darstellung eines Bytearrays eines X.509-Zertifikats. Das Bytearray kann aus binär (DER) codierten oder Base64-codierten X.509-Daten bestehen.
IsEmpty
Beschreibung:
Die IsEmpty-Funktion wird als „True“ ausgewertet, wenn das Attribut in CS oder MV vorhanden ist, jedoch zu einer leeren Zeichenfolge ausgewertet wird.
Syntax:
bool IsEmpty(var Expression)
IsGuid
Beschreibung:
Die IsGuid-Funktion wird als „True“ ausgewertet, wenn die Zeichenfolge in eine GUID konvertiert werden kann.
Syntax:
bool IsGuid(str GUID)
Hinweise:
Eine GUID wird als Zeichenfolge definiert, die einem dieser Muster folgt: 00001111-aaaa-2222-bbbb-3333cccc4444 or {00001111-aaaa-2222-bbbb-3333cccc4444}
Wird verwendet, um zu bestimmen, ob „CGuid()“ erfolgreich sein kann.
Beispiel:
IIF(IsGuid([strAttribute]),CGuid([strAttribute]),NULL)
Wenn „StrAttribute“ ein GUID-Format besitzt, wird die binäre Darstellung zurückgegeben. Andernfalls wird ein Nullwert zurückgegeben.
IsNull
Beschreibung:
Die IsNull-Funktion gibt „True“ zurück, wenn die Auswertung des Ausdrucks einen Nullwert ergibt.
Syntax:
bool IsNull(var Expression)
Hinweise:
Für ein Attribut wird ein Nullwert durch die Abwesenheit des Attributs ausgedrückt.
Beispiel:
IsNull([displayName])
Gibt „True“ zurück, wenn das Attribut nicht in CS oder MV vorhanden ist.
IsNullOrEmpty
Beschreibung:
Die IsNullOrEmpty-Funktion gibt „True“ zurück, wenn der Ausdruck einem Nullwert oder einer leeren Zeichenfolge entspricht.
Syntax:
bool IsNullOrEmpty(var Expression)
Hinweise:
Wird für ein Attribut als „True“ ausgewertet, wenn das Attribut nicht vorhanden oder zwar vorhanden, aber eine leere Zeichenfolge ist.
Die Umkehrung dieser Funktion heißt "IsPresent".
Beispiel:
IsNullOrEmpty([displayName])
Gibt „True“ zurück, wenn das Attribut in CS oder MV nicht vorhanden oder eine leere Zeichenfolge ist.
IsNumeric
Beschreibung:
Die IsNumeric-Funktion gibt einen booleschen Wert zurück, der angibt, ob ein Ausdruck als Zahlentyp ausgewertet werden kann.
Syntax:
bool IsNumeric(var Expression)
Hinweise:
Wird verwendet, um zu bestimmen, ob „CNum()“ erfolgreich zum Analysieren des Ausdrucks verwendet werden kann.
IsString
Beschreibung:
Die IsString-Funktion wird als „True“ ausgewertet, wenn der Ausdruck als Zeichenfolgentyp ausgewertet werden kann.
Syntax:
bool IsString(var expression)
Hinweise:
Wird verwendet, um zu bestimmen, ob „CStr()“ erfolgreich zum Analysieren des Ausdrucks verwendet werden kann.
IsPresent
Beschreibung:
Die IsPresent-Funktion gibt „True“ zurück, wenn der Ausdruck zu einer Zeichenfolge ausgewertet wird, die kein Nullwert und nicht leer ist.
Syntax:
bool IsPresent(var expression)
Hinweise:
Die umgekehrte Funktion heißt „IsNullOrEmpty“.
Beispiel:
Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director])
Element
Beschreibung:
Die Item-Funktion gibt ein Element aus einer mehrwertigen Zeichenfolge oder einem mehrwertigen Attribut zurück.
Syntax:
var Item(mvstr attribute, num index)
- attribute: Mehrwertiges Attribut
- index: Index für ein Element in der mehrwertigen Zeichenfolge
Hinweise:
Die Item-Funktion lässt sich mit der Contains-Funktion kombinieren, da letztere den Index für ein Element im mehrwertigen Attribut zurückgibt.
Gibt einen Fehler aus, wenn der Index außerhalb des gültigen Bereichs liegt.
Beispiel:
Mid(Item([proxyAddresses],Contains([proxyAddresses], "SMTP:")),6)
Gibt die primäre E-Mail-Adresse zurück.
ItemOrNull
Beschreibung:
Die ItemOrNull-Funktion gibt ein Element aus einer mehrwertigen Zeichenfolge/einem mehrwertigen Attribut zurück.
Syntax:
var ItemOrNull(mvstr attribute, num index)
- attribute: Mehrwertiges Attribut
- index: Index für ein Element in der mehrwertigen Zeichenfolge
Hinweise:
Die ItemOrNull-Funktion lässt sich mit der Contains-Funktion kombinieren, da letztere den Index für ein Element im mehrwertigen Attribut zurückgibt.
Liegt der Index außerhalb des gültigen Bereichs, wird ein Nullwert zurückgegeben.
Join
Beschreibung:
Die Join-Funktion akzeptiert eine Zeichenfolge mit mehreren Werten und gibt eine einwertige Zeichenfolge zurück, zwischen deren einzelnen Elementen das angegebene Trennzeichen eingefügt ist.
Syntax:
str Join(mvstr attribute)
str Join(mvstr attribute, str Delimiter)
- Attribut: Mehrwertiges Attribut mit Zeichenfolgen, die verknüpft werden sollen.
- delimiter: Eine beliebige Zeichenfolge, die die Teilzeichenfolgen in der zurückgegebenen Zeichenfolge trennt. Wenn nicht angegeben, wird das Leerzeichen (" ") verwendet. Wenn "delimiter" eine Zeichenfolge der Länge 0 ("") oder "Nothing" ist, werden alle Elemente in der Liste ohne Trennzeichen verkettet.
Anmerkungen
Zwischen den Funktionen „Join“ und „Split“ besteht Parität. Die Funktion "Join" nimmt ein Array von Zeichenfolgen entgegen, verknüpft sie mit einer Trennzeichenfolge und gibt eine einzige Zeichenfolge zurück. Die Funktion "Split" nimmt eine Zeichenfolge entgegen, trennt sie mit dem Trennzeichen und gibt ein Array von Zeichenfolgen zurück. Ein wichtiger Unterschied ist jedoch, dass "Join" Zeichenfolgen mit einer beliebigen Trennzeichenfolge verketten kann, "Split" aber nur Zeichenfolgen mit einem einzigen Trennzeichen trennen kann.
Beispiel:
Join([proxyAddresses],",")
Könnte „SMTP:john.doe@contoso.com,smtp:jd@contoso.com“ zurückgeben.
Kleinbst
Beschreibung:
Die LCase-Funktion konvertiert alle Zeichen in einer Zeichenfolge in Kleinbuchstaben.
Syntax:
str LCase(str value)
Beispiel:
LCase("TeSt")
Gibt „test“ zurück.
Left
Beschreibung:
Die Left-Funktion gibt eine angegebene Anzahl von Zeichen von der linken Seite einer Zeichenfolge zurück.
Syntax:
str Left(str string, num NumChars)
- string: Zeichenfolge, aus der Zeichen zurückgegeben werden
- numChars: Diese Zahl gibt die Anzahl der Zeichen an, die vom Anfang der Zeichenfolge (links) zurückgeben werden
Hinweise:
Eine Zeichenfolge, die die ersten durch „numChars“ angegebenen Zeichen in der Zeichenfolge enthält:
- Wenn "numChars" = 0, wird eine leere Zeichenfolge zurückgegeben.
- Wenn "numChars" < 0, wird die Eingabezeichenfolge zurückgegeben.
- Wenn die Zeichenfolge einen Nullwert aufweist, wird eine leere Zeichenfolge zurückgegeben.
Wenn die Zeichenfolge weniger Zeichen enthält als in „numChars“ angegeben, wird eine identische Zeichenfolge (also eine Zeichenfolge, die alle in Parameter 1 enthaltenen Zeichen enthält) zurückgegeben.
Beispiel:
Left("John Doe", 3)
Gibt „Joh“ zurück.
Len
Beschreibung:
Die Len-Funktion gibt die Anzahl von Zeichen in einer Zeichenfolge zurück.
Syntax:
num Len(str value)
Beispiel:
Len("John Doe")
Gibt „8“ zurück.
LGlätten
Beschreibung:
Die LTrim-Funktion entfernt führende Leerzeichen aus einer Zeichenfolge.
Syntax:
str LTrim(str value)
Beispiel:
LTrim(" Test ")
Gibt „Test “ zurück.
Mid
Beschreibung:
Die Mid-Funktion gibt eine bestimmte Anzahl von Zeichen ab einer bestimmten Position in einer Zeichenfolge zurück.
Syntax:
str Mid(str string, num start, num NumChars)
- string: Zeichenfolge, aus der Zeichen zurückgegeben werden
- start: Eine Zahl zur Angabe der Ausgangsposition in der Zeichenfolge, ab der Zeichen zurückgegeben werden
- numChars: Eine Zahl zur Angabe der Zeichen, die ab der Position in der Zeichenfolge zurückgegeben werden
Hinweise:
Gibt die durch „numChars“ angegebene Anzahl von Zeichen ab der Ausgangsposition in der Zeichenfolge zurück.
Eine Zeichenfolge, die "numChars" Zeichen ab der Ausgangsposition in der Zeichenfolge enthält:
- Wenn "numChars" = 0, wird eine leere Zeichenfolge zurückgegeben.
- Wenn "numChars" < 0, wird die Eingabezeichenfolge zurückgegeben.
- Wenn "start" > Länge der Zeichenfolge, wird die Eingabezeichenfolge zurückgegeben.
- Wenn "start" <= 0, wird die Eingabezeichenfolge zurückgegeben.
- Wenn die Zeichenfolge einen Nullwert aufweist, wird eine leere Zeichenfolge zurückgegeben.
Wenn in der Zeichenfolge nicht so viele Zeichen ab der Ausgangsposition enthalten sind wie durch „numChars“ angegeben, werden so viele Zeichen wie möglich zurückgegeben.
Beispiel:
Mid("John Doe", 3, 5)
Gibt „hn Do“ zurück.
Mid("John Doe", 6, 999)
Gibt „Doe“ zurück.
jetzt
Beschreibung:
Die Now-Funktion gibt einen DateTime-Wert zurück, der das aktuelle Datum und die aktuelle Uhrzeit gemäß Systemdatum und -uhrzeit Ihres Computers angibt.
Syntax:
dt Now()
NumFromDate
Beschreibung:
Die NumFromDate-Funktion gibt ein Datum im AD-Datumsformat zurück.
Syntax:
num NumFromDate(dt value)
Beispiel:
NumFromDate(CDate("2012-01-01 23:00:00"))
Gibt „129699324000000000“ zurück.
PadLeft
Beschreibung:
Die PadLeft-Funktion füllt eine Zeichenfolge nach links bis zu einer bestimmten Länge mit einem bestimmten Auffüllzeichen auf.
Syntax:
str PadLeft(str string, num length, str padCharacter)
- string: Die aufzufüllende Zeichenfolge.
- length: Eine ganze Zahl, die die gewünschte Länge der Zeichenfolge angibt.
- padCharacter: Eine Zeichenfolge, die aus einem einzelnen Zeichen besteht, das als Auffüllzeichen verwendet werden soll
Hinweise:
- Wenn die Länge der Zeichenfolge "length" unterschreitet, wird "padCharacter" wiederholt an den Anfang der Zeichenfolge (links) gesetzt, bis ihre Länge "length" entspricht.
- "padCharacter" kann ein Leerzeichen sein, jedoch kein Nullwert.
- Wenn die Länge der Zeichenfolge gleich oder größer als "length" ist, wird die Zeichenfolge unverändert zurückgegeben.
- Wenn die Länge der Zeichenfolge größer als oder gleich "length" ist, wird eine zur Zeichenfolge identische Zeichenfolge zurückgegeben.
- Wenn die Länge der Zeichenfolge kleiner als "length" ist, wird eine neue Zeichenfolge in gewünschter Länge zurückgegeben, die die mit "padCharacter" aufgefüllte Zeichenfolge enthält.
- Wenn die Zeichenfolge einen Nullwert aufweist, gibt die Funktion eine leere Zeichenfolge zurück.
Beispiel:
PadLeft("User", 10, "0")
Gibt „000000User“ zurück.
PadRight
Beschreibung:
Die PadRight-Funktion füllt eine Zeichenfolge nach rechts bis zu einer bestimmten Länge mit einem bestimmten Auffüllzeichen auf.
Syntax:
str PadRight(str string, num length, str padCharacter)
- string: Die aufzufüllende Zeichenfolge.
- length: Eine ganze Zahl, die die gewünschte Länge der Zeichenfolge angibt.
- padCharacter: Eine Zeichenfolge, die aus einem einzelnen Zeichen besteht, das als Auffüllzeichen verwendet werden soll
Hinweise:
- Wenn die Länge der Zeichenfolge kleiner als "length" ist, wird "padCharacter" wiederholt an das Ende der Zeichenfolge (rechts) gesetzt, bis ihre Länge "length" entspricht.
- "padCharacter" kann ein Leerzeichen sein, jedoch kein Nullwert.
- Wenn die Länge der Zeichenfolge gleich oder größer als "length" ist, wird die Zeichenfolge unverändert zurückgegeben.
- Wenn die Länge der Zeichenfolge größer als oder gleich "length" ist, wird eine zur Zeichenfolge identische Zeichenfolge zurückgegeben.
- Wenn die Länge der Zeichenfolge kleiner als "length" ist, wird eine neue Zeichenfolge in gewünschter Länge zurückgegeben, die die mit "padCharacter" aufgefüllte Zeichenfolge enthält.
- Wenn die Zeichenfolge einen Nullwert aufweist, gibt die Funktion eine leere Zeichenfolge zurück.
Beispiel:
PadRight("User", 10, "0")
Gibt „User000000“ zurück.
PCase
Beschreibung:
Die PCase-Funktion konvertiert das erste Zeichen jedes durch Leerzeichen getrennten Worts in einer Zeichenfolge in einen Großbuchstaben und alle anderen Zeichen in Kleinbuchstaben.
Syntax:
String PCase(string)
Hinweise:
- Mit dieser Funktion können vollständig aus Großbuchstaben bestehende Wörter (etwa Akronyme) nicht in Wörter mit korrekter Groß-/Kleinschreibung umgewandelt werden.
Beispiel:
PCase("TEsT")
Gibt „test“ zurück.
PCase(LCase("TEST"))
Gibt „Test“ zurück.
RandomNum
Beschreibung:
Die RandomNum-Funktion gibt eine Zufallszahl innerhalb eines bestimmten Intervalls zurück.
Syntax:
num RandomNum(num start, num end)
- start: Eine Zahl, die die untere Grenze des zu generierenden Zufallswerts angibt
- end: Eine Zahl, die die obere Grenze des zu generierenden Zufallswerts angibt
Beispiel:
Random(100,999)
Kann „734“ zurückgeben.
RemoveDuplicates
Beschreibung:
Die RemoveDuplicates-Funktion stellt sicher, dass in einer übergebenen mehrwertigen Zeichenfolge jeder Wert eindeutig ist.
Syntax:
mvstr RemoveDuplicates(mvstr attribute)
Beispiel:
RemoveDuplicates([proxyAddresses])
Gibt ein bereinigtes proxyAddress-Attribut zurück, aus dem alle doppelten Werte entfernt wurden.
Replace
Beschreibung:
Die Replace-Funktion ersetzt alle Vorkommen einer Zeichenfolge durch eine andere Zeichenfolge.
Syntax:
str Replace(str string, str OldValue, str NewValue)
- string: Eine Zeichenfolge, in der Werte ersetzt werden sollen
- OldValue: Die Zeichenfolge, die gesucht und ersetzt werden soll
- NewValue: Die Zeichenfolge, die die gesuchte Zeichenfolge ersetzen soll
Hinweise:
Die Funktion erkennt die folgenden speziellen Moniker:
- \n – neue Zeile
- \r – Wagenrücklauf
- \t – Tabulator
Beispiel:
Replace([address],"\r\n",", ")
Ersetzt CRLF durch ein Komma und ein Leerzeichen, was etwa wie folgt aussehen kann: „One Microsoft Way, Redmond, WA, USA“.
ReplaceChars
Beschreibung:
Die ReplaceChars-Funktion ersetzt alle Vorkommen von Zeichen, die in der ReplacePattern-Zeichenfolge gefunden werden.
Syntax:
str ReplaceChars(str string, str ReplacePattern)
- string: Eine Zeichenfolge, in der Zeichen ersetzt werden sollen
- ReplacePattern: Eine Zeichenfolge, die ein Wörterbuch mit zu ersetzenden Zeichen enthält
Das Format lautet "{source1}:{target1},{source2}:{target2},{sourceN},{targetN}", wobei "source" das zu findende Zeichen und "target" die Zeichenfolge ist, durch die es ersetzt wird.
Hinweise:
- Die Funktion ersetzt alle Vorkommen von definierten Quellen durch die Ziele.
- Die Quelle muss genau ein Zeichen (Unicode) sein.
- Die Quelle kann nicht leer sein oder mehrere Zeichen enthalten (Analysefehler).
- Das Ziel kann mehrere Zeichen enthalten, etwa ö:oe, β:ss.
- Das Ziel kann leer sein, um anzugeben, dass das Zeichen entfernt werden soll.
- Bei der Quelle wird die Groß-/Kleinschreibung beachtet, und es muss eine genaue Übereinstimmung vorliegen.
- Die reservierten Zeichen "," (Komma) und ":" (Doppelpunkt) können mit dieser Funktion nicht ersetzt werden.
- Leerzeichen und andere Whitespaces in der Zeichenfolge "ReplacePattern" werden ignoriert.
Beispiel:
%ReplaceString% = ’:,Å:A,Ä:A,Ö:O,å:a,ä:a,ö,o
ReplaceChars("Räksmörgås",%ReplaceString%)
Gibt „Raksmorgas“ zurück.
ReplaceChars("O’Neil",%ReplaceString%)
Gibt „ONeil“ zurück. (Der Apostroph wird entfernt.)
Right
Beschreibung:
Die Right-Funktion gibt eine bestimmte Anzahl von Zeichen von der rechten Seite einer Zeichenfolge (also vom Ende her) zurück.
Syntax:
str Right(str string, num NumChars)
- string: Zeichenfolge, aus der Zeichen zurückgegeben werden
- numChars: Diese Zahl gibt die Anzahl der Zeichen an, die vom Ende der Zeichenfolge (rechts) zurückgeben werden
Hinweise:
Die durch „numChars“ angegebene Anzahl von Zeichen wird ab der letzten Position der Zeichenfolge zurückgegeben.
Eine Zeichenfolge, die die letzten "numChars" Zeichen in der Zeichenfolge enthält:
- Wenn "numChars" = 0, wird eine leere Zeichenfolge zurückgegeben.
- Wenn "numChars" < 0, wird die Eingabezeichenfolge zurückgegeben.
- Wenn die Zeichenfolge einen Nullwert aufweist, wird eine leere Zeichenfolge zurückgegeben.
Wenn die Zeichenfolge weniger Zeichen enthält als in "numChars" angegeben, wird eine identische Zeichenfolge zurückgegeben.
Beispiel:
Right("John Doe", 3)
Gibt „Doe“ zurück.
RGlätten
Beschreibung:
Die RTrim-Funktion entfernt nachfolgende Leerzeichen aus einer Zeichenfolge.
Syntax:
str RTrim(str value)
Beispiel:
RTrim(" Test ")
Gibt „ Test“ zurück.
Select
Beschreibung:
Verarbeitet alle Werte in einem mehrwertigen Attribut (oder der Ausgabe eines Ausdrucks), basierend auf der angegebenen Funktion
Syntax:
mvattr Select(variable item, mvattr attribute, func function)
mvattr Select(variable item, exp expression, func function)
- item: Stellt ein Element im mehrwertigen Attribut dar
- attribute: Das mehrwertige Attribut
- expression: Ein Ausdruck, der eine Sammlung von Werten zurückgibt
- condition: Jede Funktion, die ein Element im Attribut verarbeiten kann
Beispiele:
Select($item,[otherPhone],Replace($item,"-",""))
Gibt alle Werte im mehrwertigen Attribut „otherPhone“ zurück, nachdem Bindestriche (-) entfernt wurden
Split
Beschreibung:
Die Split-Funktion nimmt eine durch Trennzeichen getrennte Zeichenfolge entgegen und wandelt sie in eine mehrwertige Zeichenfolge um.
Syntax:
mvstr Split(str value, str delimiter)
mvstr Split(str value, str delimiter, num limit)
- value: Die Zeichenfolge mit Trennzeichen
- delimiter: Einzelnes Zeichen, das als Trennzeichen verwendet werden soll
- limit: Maximale Anzahl von Werten, die zurückgegeben werden kann
Beispiel:
Split("SMTP:john.doe@contoso.com,smtp:jd@contoso.com",",")
Gibt eine mehrwertige Zeichenfolge mit zwei Elementen zurück, die für das proxyAddress-Attribut nützlich sind.
StringFromGuid
Beschreibung:
Die StringFromGuid-Funktion nimmt eine binäre GUID entgegen und konvertiert sie in eine Zeichenfolge.
Syntax:
str StringFromGuid(bin GUID)
StringFromSid
Beschreibung:
Die StringFromSid-Funktion konvertiert ein Bytearray mit einer enthaltenen Sicherheits-ID in eine Zeichenfolge.
Syntax:
str StringFromSid(bin ObjectSID)
Schalter
Beschreibung:
Mit der Switch-Funktion wird ein einzelner Wert auf der Grundlage ausgewerteter Bedingungen zurückgegeben.
Syntax:
var Switch(exp expr1, var value1[, exp expr2, var value … [, exp expr, var valueN]])
- expr: Variantenausdruck, den Sie auswerten möchten
- value: Wert, der zurückgegeben werden soll, wenn der entsprechende Ausdruck True ergibt
Hinweise:
Die Argumentliste der Switch-Funktion setzt sich aus Ausdrucks- und Wertpaaren zusammen. Die Ausdrücke werden von links nach rechts ausgewertet, und der Wert, der mit dem ersten als True ausgewerteten Ausdruck verknüpft ist, wird zurückgegeben. Wenn die Teile nicht richtig paarweise angegeben werden, tritt ein Laufzeitfehler auf.
Wenn z. B. "expr1" True ist, gibt "Switch" "value1" zurück. Wenn "expr-1" False, aber "expr-2" True ist, gibt "Switch" "value-2" zurück usw.
Switch gibt nichts zurück, wenn:
- Keiner der Ausdrücke TRUE ist.
- Der erste als TRUE ausgewertete Ausdruck über einen zugehörigen Wert verfügt, der Null ist.
„Switch“ wertet alle Ausdrücke aus, auch wenn die Funktion nur einen von ihnen zurückgibt. Aus diesem Grund sollten Sie auf unerwünschte Nebeneffekte achten. Wenn z. B. die Berechnung eines beliebigen Ausdrucks zu einer Division durch 0 führt, tritt ein Fehler auf.
„value“ kann auch die Error-Funktion sein. In diesem Fall würde dann eine benutzerdefinierte Zeichenfolge zurückgegeben.
Beispiel:
Switch([city] = "London", "English", [city] = "Rome", "Italian", [city] = "Paris", "French", True, Error("Unknown city"))
Gibt die Sprache zurück, die in einigen Großstädten gesprochen wird. Andernfalls wird ein Fehler zurückgegeben.
Glätten
Beschreibung:
Die Trim-Funktion entfernt führende und nachfolgende Leerzeichen aus einer Zeichenfolge.
Syntax:
str Trim(str value)
Beispiel:
Trim(" Test ")
Gibt „test“ zurück.
Trim([proxyAddresses])
Entfernt führende und nachfolgende Leerzeichen für jeden Wert im proxyAddress-Attribut.
Großbst
Beschreibung:
Die UCase-Funktion konvertiert alle Zeichen in einer Zeichenfolge in Großbuchstaben.
Syntax:
str UCase(str string)
Beispiel:
UCase("TeSt")
Gibt „test“ zurück.
Hierbei gilt:
Beschreibung:
Gibt eine Teilmenge von Werten aus einem mehrwertigen Attribut (oder die Ausgabe eines Ausdrucks) zurück, basierend auf der spezifischen Bedingung
Syntax:
mvattr Where(variable item, mvattr attribute, exp condition)
mvattr Where(variable item, exp expression, exp condition)
- item: Stellt ein Element im mehrwertigen Attribut dar
- attribute: Das mehrwertige Attribut
- condition: Ein beliebiger Ausdruck, der als TRUE oder FALSE ausgewertet werden kann
- expression: Ein Ausdruck, der eine Sammlung von Werten zurückgibt
Beispiel:
Where($item,[userCertificate],CertNotAfter($item)>Now())
Gibt die Zertifikatwerte im mehrwertigen Attribut „userCertificate“ zurück, die nicht abgelaufen sind
With
Beschreibung:
Die With-Funktion stellt eine Möglichkeit zum Vereinfachen eines komplexen Ausdrucks mithilfe einer Variablen bereit. Dabei wird ein Teilausdruck dargestellt, der mindestens im komplexen Ausdruck angezeigt wird.
Syntax:With(var variable, exp subExpression, exp complexExpression)
- variable: Stellt den Teilausdruck dar
- subExpression: Der durch eine Variable dargestellte Teilausdruck
- complexExpression: Ein komplexer Ausdruck
Beispiel:
With($unExpiredCerts,Where($item,[userCertificate],CertNotAfter($item)>Now()),IIF(Count($unExpiredCerts)>0,$unExpiredCerts,NULL))
Ist funktionell gleichwertig mit:
IIF (Count(Where($item,[userCertificate],CertNotAfter($item)>Now()))>0, Where($item,[userCertificate],CertNotAfter($item)>Now()),NULL)
Hiermit werden nur nicht abgelaufene Zertifikatwerte aus dem Attribut „userCertificate“ zurückgegeben.
Wort
Beschreibung:
Die Word-Funktion gibt ein in einer Zeichenfolge enthaltenes Wort auf der Grundlage von Parametern zurück, die die zu verwendenden Trennzeichen und die Nummer des zurückzugebenden Worts beschreiben.
Syntax:
str Word(str string, num WordNumber, str delimiters)
- string: Zeichenfolge, aus der ein Wort zurückgegeben wird
- WordNumber: Eine Zahl, die die Nummer des zurückzugebenden Worts angibt
- delimiters: Eine Zeichenfolge, die das/die Trennzeichen angibt, das/die verwendet werden soll(en), um Wörter zu identifizieren
Hinweise:
Alle Folgen von Zeichen in einer Zeichenfolge, die durch eines der in „delimiters“ enthaltenen Zeichen getrennt werden, werden als Wörter behandelt:
- Wenn die Zahl < 1 ist, wird eine leere Zeichenfolge zurückgegeben.
- Wenn "string" einen Nullwert hat, wird eine leere Zeichenfolge zurückgegeben
Falls „string“ weniger Wörter enthält als für „WordNumber“ angegeben, wird eine leere Zeichenfolge zurückgegeben. Dies gilt auch, wenn „string“ keine durch Trennzeichen identifizierten Wörter enthält.
Beispiel:
Word("The quick brown fox",3," ")
Gibt „brown“ zurück.
Word("This,string!has&many separators",3,",!&#")
Gibt „has“ zurück.