Microsoft Entra Verbinding maken Sync: Functions Reference

  • Artikel

In Microsoft Entra Verbinding maken worden functies gebruikt om een kenmerkwaarde tijdens de synchronisatie te bewerken.
De syntaxis van de functies wordt uitgedrukt met de volgende indeling:
<output type> FunctionName(<input type> <position name>, ..)

Als een functie overbelast is en meerdere syntaxis accepteert, worden alle geldige syntaxis weergegeven.
De functies zijn sterk getypt en controleren of het doorgegeven type overeenkomt met het gedocumenteerde type.
Als het type niet overeenkomt, wordt er een fout gegenereerd.

De typen worden uitgedrukt met de volgende syntaxis:

  • bin – Binair
  • bool - Booleaanse waarde
  • dt – UTC-datum/tijd
  • opsomming : opsomming van bekende constanten
  • exp – Expressie, die naar verwachting resulteert in een Booleaanse waarde
  • mvbin – Multi-Valued Binary
  • mvstr – Tekenreeks met meerdere waarden
  • mvref – Verwijzing naar meerdere waarden
  • getal – numeriek
  • ref – Naslaginformatie
  • str – Tekenreeks
  • var – Een variant van (bijna) elk ander type
  • void – retourneert geen waarde

De functies met de typen mvbin, mvstr en mvref kunnen alleen werken aan kenmerken met meerdere waarden. Functies met bin-, str- en ref-bewerkingen werken op kenmerken met één waarde en meerdere waarden.

Functieverwijzing

BitAnd

Beschrijving:
De functie BitAnd stelt opgegeven bits in op een waarde.

Syntaxis:
num BitAnd(num value1, num value2)

  • waarde1, waarde2: numerieke waarden die samen AND'ed moeten zijn

Opmerkingen:
Met deze functie worden beide parameters geconverteerd naar de binaire weergave en wordt een bit ingesteld op:

  • 0: als een of beide van de bijbehorende bits in waarde1 en waarde2 0 zijn
  • 1 - als beide corresponderende bits 1 zijn.

Met andere woorden, de functie retourneert 0 in alle gevallen, behalve wanneer de corresponderende bits van beide parameters 1 zijn.

Voorbeeld:
BitAnd(&HF, &HF7)
Retourneert 7 omdat hexadecimale "F" EN "F7" resulteert in deze waarde.

BitOr

Beschrijving:
De BitOr-functie stelt opgegeven bits in op een waarde.

Syntaxis:
num BitOr(num value1, num value2)

  • waarde1, waarde2: numerieke waarden die samen OR'ed moeten zijn

Opmerkingen:
Met deze functie worden beide parameters geconverteerd naar de binaire weergave en wordt een bit ingesteld op 1 als een of beide van de bijbehorende bits in masker en vlag 1 zijn, en naar 0 als beide overeenkomende bits 0 zijn. Met andere woorden, het retourneert 1 in alle gevallen, behalve wanneer de bijbehorende bits van beide parameters 0 zijn.

CBool

Beschrijving:
De functie CBool retourneert een Booleaanse waarde op basis van de geëvalueerde expressie

Syntaxis:
bool CBool(exp Expression)

Opmerkingen:
Als de expressie resulteert in een niet-nulwaarde, retourneert CBool Waar, anders retourneert CBool False.

Voorbeeld:
CBool([attrib1] = [attrib2])

Retourneert Waar als beide kenmerken dezelfde waarde hebben.

CDate

Beschrijving:
De functie CDate retourneert een UTC DateTime uit een tekenreeks. DateTime is geen systeemeigen kenmerktype in Sync, maar wordt door sommige functies gebruikt.

Syntaxis:
dt CDate(str value)

  • Waarde: Een tekenreeks met een datum, tijd en eventueel een tijdzone

Opmerkingen:
De geretourneerde tekenreeks bevindt zich altijd in UTC.

Voorbeeld:
CDate([employeeStartTime])
Retourneert een datum/tijd op basis van de begintijd van de werknemer

CDate("2013-01-10 4:00 PM -8")
Retourneert een datum/tijd die '2013-01-11 12:00 uur' aangeeft

CertExtensionOids

Beschrijving:
Retourneert de Oid-waarden van alle kritieke extensies van een certificaatobject.

Syntaxis:
mvstr CertExtensionOids(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertFormat

Beschrijving:
Retourneert de naam van de indeling van dit X.509v3-certificaat.

Syntaxis:
str CertFormat(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertFriendlyName

Beschrijving:
Retourneert de bijbehorende alias voor een certificaat.

Syntaxis:
str CertFriendlyName(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertHashString

Beschrijving:
Retourneert de SHA1-hashwaarde voor het X.509v3-certificaat als een hexadecimale tekenreeks.

Syntaxis:
str CertHashString(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertIssuer

Beschrijving:
Retourneert de naam van de certificeringsinstantie die het X.509v3-certificaat heeft uitgegeven.

Syntaxis:
str CertIssuer(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertIssuerDN

Beschrijving:
Retourneert de DN-naam van de certificaatverlener.

Syntaxis:
str CertIssuerDN(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertIssuerOid

Beschrijving:
Retourneert de Oid van de certificaatverlener.

Syntaxis:
str CertIssuerOid(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertKeyAlgorithm

Beschrijving:
Retourneert de sleutelalgoritmen voor dit X.509v3-certificaat als een tekenreeks.

Syntaxis:
str CertKeyAlgorithm(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertKeyAlgorithmParams

Beschrijving:
Retourneert de sleutelalgoritmeparameters voor het X.509v3-certificaat als een hexadecimale tekenreeks.

Syntaxis:
str CertKeyAlgorithm(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertNameInfo

Beschrijving:
Retourneert de namen van het onderwerp en de verlener van een certificaat.

Syntaxis:
str CertNameInfo(binary certificateRawData, str x509NameType, bool includesIssuerName)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.
  • X509NameType: De X509NameType-waarde voor het onderwerp.
  • includesIssuerName: true to include the issuer name; anders, onwaar.

CertNotAfter

Beschrijving:
Retourneert de datum in de lokale tijd waarna een certificaat niet meer geldig is.

Syntaxis:
dt CertNotAfter(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertNotBefore

Beschrijving:
Retourneert de datum in de lokale tijd waarop een certificaat geldig wordt.

Syntaxis:
dt CertNotBefore(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertPublicKeyOid

Beschrijving:
Retourneert de Oid van de openbare sleutel voor het X.509v3-certificaat.

Syntaxis:
str CertKeyAlgorithm(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertPublicKeyParametersOid

Beschrijving:
Retourneert de Oid van de parameters voor de openbare sleutel voor het X.509v3-certificaat.

Syntaxis:
str CertPublicKeyParametersOid(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertSerialNumber

Beschrijving:
Retourneert het serienummer van het X.509v3-certificaat.

Syntaxis:
str CertSerialNumber(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertSignatureAlgorithmOid

Beschrijving:
Retourneert de Oid van het algoritme dat wordt gebruikt om de handtekening van een certificaat te maken.

Syntaxis:
str CertSignatureAlgorithmOid(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertSubject

Beschrijving:
Hiermee haalt u de DN-naam van het onderwerp op van een certificaat.

Syntaxis:
str CertSubject(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertSubjectNameDN

Beschrijving:
Retourneert de DN-naam van het onderwerp van een certificaat.

Syntaxis:
str CertSubjectNameDN(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertSubjectNameOid

Beschrijving:
Retourneert de Oid van de onderwerpnaam van een certificaat.

Syntaxis:
str CertSubjectNameOid(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertThumbprint

Beschrijving:
Retourneert de vingerafdruk van een certificaat.

Syntaxis:
str CertThumbprint(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CertVersion

Beschrijving:
Retourneert de X.509-indelingsversie van een certificaat.

Syntaxis:
str CertThumbprint(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

CGuid

Beschrijving:
De functie CGuid converteert de tekenreeksweergave van een GUID naar de binaire weergave.

Syntaxis:
bin CGuid(str GUID)

  • Een tekenreeks die is opgemaakt in dit patroon: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx of {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}

Bevat

Beschrijving:
De functie Contains zoekt een tekenreeks in een kenmerk met meerdere waarden

Syntaxis:
num Contains (mvstring attribute, str search) -Hoofdlettergevoelig
num Contains (mvstring attribute, str search, enum Casetype)
num Contains (mvref attribute, str search) -Hoofdlettergevoelig

  • kenmerk: het kenmerk met meerdere waarden om te zoeken.
  • search: string to find in the attribute.
  • Casetype: CaseInsensitive of CaseSensitive.

Retourneert een index in het kenmerk met meerdere waarden waar de tekenreeks is gevonden. 0 wordt geretourneerd als de tekenreeks niet wordt gevonden.

Opmerkingen:
Voor tekenreekskenmerken met meerdere waarden vindt de zoekopdracht subtekenreeksen in de waarden.
Voor verwijzingskenmerken moet de gezochte tekenreeks exact overeenkomen met de waarde die moet worden beschouwd als een overeenkomst.

Voorbeeld:
IIF(Contains([proxyAddresses],"SMTP:")>0,[proxyAddresses],Error("No primary SMTP address found."))
Als het kenmerk proxyAddresses een primair e-mailadres heeft (aangegeven met de hoofdletter SMTP:), retourneert u het kenmerk proxyAddress, anders wordt er een fout geretourneerd.

ConvertFromBase64

Beschrijving:
Met de functie ConvertFromBase64 wordt de opgegeven base64-gecodeerde waarde geconverteerd naar een reguliere tekenreeks.

Syntaxis:
str ConvertFromBase64(str source) - gaat ervan uit dat Unicode voor codering
str ConvertFromBase64(str source, enum Encoding)

  • bron: Met Base64 gecodeerde tekenreeks
  • Codering: Unicode, ASCII, UTF8

Voorbeeld
ConvertFromBase64("SABlAGwAbABvACAAdwBvAHIAbABkACEA")
ConvertFromBase64("SGVsbG8gd29ybGQh", UTF8)

Beide voorbeelden retourneren 'Hallo wereld!'

ConvertFromUTF8Hex

Beschrijving:
De functie ConvertFromUTF8Hex converteert de opgegeven UTF8 Hex-gecodeerde waarde naar een tekenreeks.

Syntaxis:
str ConvertFromUTF8Hex(str source)

  • bron: UTF8 2-byte gecodeerde sting

Opmerkingen:
Het verschil tussen deze functie en ConvertFromBase64([],UTF8) is dat het resultaat vriendelijk is voor het DN-kenmerk.
Deze indeling wordt gebruikt door Microsoft Entra ID als DN.

Voorbeeld:
ConvertFromUTF8Hex("48656C6C6F20776F726C6421")
Geeft als resultaat 'Hallo wereld!'

ConvertToBase64

Beschrijving:
De functie ConvertToBase64 converteert een tekenreeks naar een Unicode-base64-tekenreeks.
Converteert de waarde van een matrix met gehele getallen naar de equivalente tekenreeksweergave die is gecodeerd met base-64 cijfers.

Syntaxis:
str ConvertToBase64(str source)

Voorbeeld:
ConvertToBase64("Hello world!")
Retourneert 'SABlAGwAbABvACAAdwBvAHIAbABkACEA'

ConvertToUTF8Hex

Beschrijving:
Met de functie ConvertToUTF8Hex wordt een tekenreeks geconverteerd naar een UTF8 Hex-gecodeerde waarde.

Syntaxis:
str ConvertToUTF8Hex(str source)

Opmerkingen:
De uitvoerindeling van deze functie wordt gebruikt door Microsoft Entra ID als DN-kenmerkindeling.

Voorbeeld:
ConvertToUTF8Hex("Hello world!")
Retourneert 48656C6C6F20776F726C6421

Tellen

Beschrijving:
De functie Aantal retourneert het aantal elementen in een kenmerk met meerdere waarden

Syntaxis:
num Count(mvstr attribute)

CNum

Beschrijving:
De functie CNum neemt een tekenreeks en retourneert een numeriek gegevenstype.

Syntaxis:
num CNum(str value)

Cref

Beschrijving:
Converteert een tekenreeks naar een verwijzingskenmerk

Syntaxis:
ref CRef(str value)

Voorbeeld:
CRef("CN=LC Services,CN=Microsoft,CN=lcspool01,CN=Pools,CN=RTC Service," & %Forest.LDAP%)

CStr

Beschrijving:
De functie CStr wordt geconverteerd naar een gegevenstype tekenreeks.

Syntaxis:
str CStr(num value)
str CStr(ref value)
str CStr(bool value)

  • waarde: kan een numerieke waarde, verwijzingskenmerk of Booleaanse waarde zijn.

Voorbeeld:
CStr([dn])
Kan "cn=Joe,dc=contoso,dc=com" retourneren

DateAdd

Beschrijving:
Retourneert een datum die een datum bevat waaraan een opgegeven tijdsinterval is toegevoegd.

Syntaxis:
dt DateAdd(str interval, num value, dt date)

  • interval: Tekenreeksexpressie die het tijdsinterval is dat u wilt toevoegen. De tekenreeks moet een van de volgende waarden hebben:
    • yyyy jaar
    • q Quarter
    • m maand
    • y Dag van het jaar
    • d dag
    • w Weekdag
    • ww week
    • h uur
    • n minuut
    • s seconde
  • waarde: het aantal eenheden dat u wilt toevoegen. Dit kan positief zijn (om datums in de toekomst te krijgen) of negatief (om datums in het verleden te krijgen).
  • datum: Datum/tijd die de datum aangeeft waarop het interval wordt toegevoegd.

Voorbeeld:
DateAdd("m", 3, CDate("2001-01-01"))
Hiermee wordt 3 maanden toegevoegd en wordt een datum/tijd geretourneerd die '2001-04-01' aangeeft.

DateFromNum

Beschrijving:
De functie DateFromNum converteert een waarde in de datumnotatie van AD naar een datum/tijd-type.

Syntaxis:
dt DateFromNum(num value)

Voorbeeld:
DateFromNum([lastLogonTimestamp])
DateFromNum(129699324000000000)
Retourneert een datum/tijd die 2012-01-01 23:00:00 vertegenwoordigt

DNComponent

Beschrijving:
De functie DNComponent retourneert de waarde van een opgegeven DN-onderdeel dat van links gaat.

Syntaxis:
str DNComponent(ref dn, num ComponentNumber)

  • dn: het verwijzingskenmerk dat moet worden geïnterpreteerd
  • ComponentNumber: het onderdeel in de DN dat moet worden geretourneerd

Voorbeeld:
DNComponent(CRef([dn]),1)
Als dn 'cn=Joe,ou=...' is, wordt Joe geretourneerd

DNComponentRev

Beschrijving:
De functie DNComponentRev retourneert de waarde van een opgegeven DN-onderdeel dat van rechts (het einde) gaat.

Syntaxis:
str DNComponentRev(ref dn, num ComponentNumber)
str DNComponentRev(ref dn, num ComponentNumber, enum Options)

  • dn: het verwijzingskenmerk dat moet worden geïnterpreteerd
  • ComponentNumber : het onderdeel in de DN dat moet worden geretourneerd
  • Opties: DC : alle onderdelen negeren met "dc="

Voorbeeld:
Als dn 'cn=Joe,ou=Atlanta,ou=GA,ou=US, dc=contoso,dc=com' is, dan
DNComponentRev(CRef([dn]),3)
DNComponentRev(CRef([dn]),1,"DC")
Beide retourneren ONS.

Fout

Beschrijving:
De functie Fout wordt gebruikt om een aangepaste fout te retourneren.

Syntaxis:
void Error(str ErrorMessage)

Voorbeeld:
IIF(IsPresent([accountName]),[accountName],Error("AccountName is required"))
Als de kenmerkaccountName niet aanwezig is, genereert u een fout op het object.

EscapeDNComponent

Beschrijving:
De functie EscapeDNComponent neemt één onderdeel van een DN en escapet deze zodat deze kan worden weergegeven in LDAP.

Syntaxis:
str EscapeDNComponent(str value)

Voorbeeld:
EscapeDNComponent("cn=" & [displayName]) & "," & %ForestLDAP%)
Zorg ervoor dat het object kan worden gemaakt in een LDAP-directory, zelfs als het kenmerk displayName tekens bevat die moeten worden ontsnapt in LDAP.

FormatDateTime

Beschrijving:
De functie FormatDateTime wordt gebruikt om een datum/tijd op te maken in een tekenreeks met een opgegeven indeling

Syntaxis:
str FormatDateTime(dt value, str format)

  • waarde: een waarde in de datum/tijd-indeling
  • notatie: een tekenreeks die de indeling aangeeft waarmee moet worden geconverteerd.

Opmerkingen:
De mogelijke waarden voor de notatie vindt u hier: Aangepaste datum- en tijdnotaties voor de functie FORMAT.

Voorbeeld:

FormatDateTime(CDate("12/25/2007"),"yyyy-MM-dd")
Resultaten in '2007-12-25'.

FormatDateTime(DateFromNum([pwdLastSet]),"yyyyMMddHHmmss.0Z")
Kan resulteren in '20140905081453.0Z'

Guid

Beschrijving:
De functie-GUID genereert een nieuwe willekeurige GUID

Syntaxis:
str Guid()

IIF

Beschrijving:
De functie IIF retourneert een van een set mogelijke waarden op basis van een opgegeven voorwaarde.

Syntaxis:
var IIF(exp condition, var valueIfTrue, var valueIfFalse)

  • voorwaarde: elke waarde of expressie die kan worden geëvalueerd op waar of onwaar.
  • valueIfTrue: Als de voorwaarde waar oplevert, wordt de geretourneerde waarde gebruikt.
  • valueIfFalse: Als de voorwaarde onwaar oplevert, wordt de geretourneerde waarde geretourneerd.

Voorbeeld:
IIF([employeeType]="Intern","t-" & [alias],[alias])
Als de gebruiker een intern is, retourneert u de alias van een gebruiker met 't-' toegevoegd aan het begin ervan, anders wordt de alias van de gebruiker als zodanig geretourneerd.

InStr

Beschrijving:
Met de functie InStr wordt het eerste exemplaar van een subtekenreeks in een tekenreeks gevonden

Syntaxis:

num InStr(str stringcheck, str stringmatch)
num InStr(str stringcheck, str stringmatch, num start)
num InStr(str stringcheck, str stringmatch, num start, enum compare)

  • tekenreekscontrole: tekenreeks die moet worden doorzocht
  • tekenreeksmatch: te vinden tekenreeks
  • start: beginpositie om de subtekenreeks te vinden
  • vergelijken: vbTextCompare of vbBinaryCompare

Opmerkingen:
Retourneert de positie waar de subtekenreeks is gevonden of 0 als deze niet is gevonden.

Voorbeeld:
InStr("The quick brown fox","quick")
Levert 5 op

InStr("repEated","e",3,vbBinaryCompare)
Levert 7 op

Instrrev

Beschrijving:
Met de functie InStrRev wordt het laatste exemplaar van een subtekenreeks in een tekenreeks gevonden

Syntaxis:
num InstrRev(str stringcheck, str stringmatch)
num InstrRev(str stringcheck, str stringmatch, num start)
num InstrRev(str stringcheck, str stringmatch, num start, enum compare)

  • tekenreekscontrole: tekenreeks die moet worden doorzocht
  • tekenreeksmatch: te vinden tekenreeks
  • start: beginpositie om de subtekenreeks te vinden
  • vergelijken: vbTextCompare of vbBinaryCompare

Opmerkingen:
Retourneert de positie waar de subtekenreeks is gevonden of 0 als deze niet is gevonden.

Voorbeeld:
InStrRev("abbcdbbbef","bb")
Geeft als resultaat 7

IsBitSet

Beschrijving:
De functie IsBitSet Tests als een bit is ingesteld of niet

Syntaxis:
bool IsBitSet(num value, num flag)

  • waarde: een numerieke waarde die wordt geëvalueerd.flag: een numerieke waarde met de bit die moet worden geëvalueerd

Voorbeeld:
IsBitSet(&HF,4)
Retourneert Waar omdat bit "4" is ingesteld in de hexadecimale waarde "F"

IsDate

Beschrijving:
Als de expressie kan worden geëvalueerd als een datum/tijd-type, wordt de functie IsDate geëvalueerd op Waar.

Syntaxis:
bool IsDate(var Expression)

Opmerkingen:
Wordt gebruikt om te bepalen of CDate() succesvol kan zijn.

IsCert

Beschrijving:
Retourneert waar als de onbewerkte gegevens kunnen worden geserialiseerd in .NET X509Certificate2-certificaatobject.

Syntaxis:
bool CertThumbprint(binary certificateRawData)

  • certificateRawData: Byte-matrixweergave van een X.509-certificaat. De bytematrix kan binaire (DER) gecodeerde of Base64-gecodeerde X.509-gegevens zijn.

IsEmpty

Beschrijving:
Als het kenmerk aanwezig is in de CS of MV, maar resulteert in een lege tekenreeks, resulteert de functie IsEmpty in Waar.

Syntaxis:
bool IsEmpty(var Expression)

IsGuid

Beschrijving:
Als de tekenreeks kan worden geconverteerd naar een GUID, wordt de functie IsGuid geëvalueerd als waar.

Syntaxis:
bool IsGuid(str GUID)

Opmerkingen:
Een GUID wordt gedefinieerd als een tekenreeks die een van deze patronen volgt: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx of {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}

Wordt gebruikt om te bepalen of CGuid() succesvol kan zijn.

Voorbeeld:
IIF(IsGuid([strAttribute]),CGuid([strAttribute]),NULL)
Als StrAttribute een GUID-indeling heeft, retourneert u een binaire weergave, anders retourneert u een Null.

IsNull

Beschrijving:
Als de expressie null oplevert, retourneert de functie IsNull waar.

Syntaxis:
bool IsNull(var Expression)

Opmerkingen:
Voor een kenmerk wordt een null uitgedrukt door het ontbreken van het kenmerk.

Voorbeeld:
IsNull([displayName])
Retourneert Waar als het kenmerk niet aanwezig is in de CS of MV.

IsNullOrEmpty

Beschrijving:
Als de expressie null of een lege tekenreeks is, retourneert de functie IsNullOrEmpty true.

Syntaxis:
bool IsNullOrEmpty(var Expression)

Opmerkingen:
Voor een kenmerk zou dit resulteren in Waar als het kenmerk afwezig is of aanwezig is, maar een lege tekenreeks is.
De omgekeerde versie van deze functie heet IsPresent.

Voorbeeld:
IsNullOrEmpty([displayName])
Retourneert Waar als het kenmerk niet aanwezig is of een lege tekenreeks is in de CS of MV.

IsNumeric

Beschrijving:
De functie IsNumeric retourneert een Booleaanse waarde die aangeeft of een expressie kan worden geëvalueerd als een getaltype.

Syntaxis:
bool IsNumeric(var Expression)

Opmerkingen:
Wordt gebruikt om te bepalen of CNum() kan worden gebruikt om de expressie te parseren.

IsString

Beschrijving:
Als de expressie kan worden geëvalueerd naar een tekenreekstype, resulteert de functie IsString in Waar.

Syntaxis:
bool IsString(var expression)

Opmerkingen:
Wordt gebruikt om te bepalen of CStr() kan worden gebruikt om de expressie te parseren.

IsPresent

Beschrijving:
Als de expressie resulteert in een tekenreeks die niet Null is en niet leeg is, retourneert de functie IsPresent waar.

Syntaxis:
bool IsPresent(var expression)

Opmerkingen:
De omgekeerde versie van deze functie heet IsNullOrEmpty.

Voorbeeld:
Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director])

Item

Beschrijving:
De functie Item retourneert één item van een tekenreeks/kenmerk met meerdere waarden.

Syntaxis:
var Item(mvstr attribute, num index)

  • kenmerk: kenmerk met meerdere waarden
  • index: indexeren naar een item in de tekenreeks met meerdere waarden.

Opmerkingen:
De functie Item is handig samen met de functie Contains, omdat de laatste functie de index retourneert naar een item in het kenmerk met meerdere waarden.

Genereert een fout als de index buiten de grenzen valt.

Voorbeeld:
Mid(Item([proxyAddresses],Contains([proxyAddresses], "SMTP:")),6)
Retourneert het primaire e-mailadres.

ItemOrNull

Beschrijving:
De functie ItemOrNull retourneert één item uit een tekenreeks/kenmerk met meerdere waarden.

Syntaxis:
var ItemOrNull(mvstr attribute, num index)

  • kenmerk: kenmerk met meerdere waarden
  • index: indexeren naar een item in de tekenreeks met meerdere waarden.

Opmerkingen:
De functie ItemOrNull is handig in combinatie met de functie Contains, omdat de laatste functie de index retourneert naar een item in het kenmerk met meerdere waarden.

Als de index buiten de grenzen valt, retourneert u een Null-waarde.

Deelnemen

Beschrijving:
De join-functie gebruikt een tekenreeks met meerdere waarden en retourneert een tekenreeks met één waarde met een opgegeven scheidingsteken dat tussen elk item is ingevoegd.

Syntaxis:
str Join(mvstr attribute)
str Join(mvstr attribute, str Delimiter)

  • kenmerk: kenmerk met meerdere waarden met tekenreeksen die moeten worden samengevoegd.
  • scheidingsteken: elke tekenreeks die wordt gebruikt om de subtekenreeksen in de geretourneerde tekenreeks te scheiden. Als u dit weglaat, wordt het spatieteken (" ") gebruikt. Als scheidingsteken een tekenreeks met lengte nul ("") of Niets is, worden alle items in de lijst samengevoegd zonder scheidingstekens.

Opmerkingen
Er is pariteit tussen de functies Join en Split. De join-functie gebruikt een matrix met tekenreeksen en voegt deze samen met behulp van een scheidingstekenreeks om één tekenreeks te retourneren. De functie Splitsen neemt een tekenreeks en scheidt deze bij het scheidingsteken om een matrix met tekenreeksen te retourneren. Een belangrijk verschil is echter dat Join tekenreeksen kan samenvoegen met een tekenreeks met scheidingstekens. Split kan alleen tekenreeksen scheiden met behulp van één tekenscheidingsteken.

Voorbeeld:
Join([proxyAddresses],",")
Kan retourneren: 'SMTP:john.doe@contoso.com,smtp:jd@contoso.com'

LCase

Beschrijving:
Met de functie LCase worden alle tekens in een tekenreeks geconverteerd naar kleine letters.

Syntaxis:
str LCase(str value)

Voorbeeld:
LCase("TeSt")
Retourneert 'test'.

Left

Beschrijving:
De functie Links retourneert een opgegeven aantal tekens links van een tekenreeks.

Syntaxis:
str Left(str string, num NumChars)

  • tekenreeks: de tekenreeks waaruit tekens moeten worden geretourneerd
  • NumChars: een getal dat het aantal tekens aangeeft dat moet worden geretourneerd vanaf het begin (links) van de tekenreeks

Opmerkingen:
Een tekenreeks met de eerste numChars-tekens in tekenreeks:

  • Als aantalTekens = 0, retourneer lege tekenreeks.
  • Als aantalTekens < 0, retourneer invoertekenreeks.
  • Als tekenreeks null is, retourneer lege tekenreeks.

Als de tekenreeks minder tekens bevat dan het getal dat is opgegeven in aantalTekens, wordt een tekenreeks identiek aan tekenreeks (dat wil zeggen, met alle tekens in parameter 1) geretourneerd.

Voorbeeld:
Left("John Doe", 3)
Retourneert 'Joh'.

Len

Beschrijving:
De functie Len retourneert het aantal tekens in een tekenreeks.

Syntaxis:
num Len(str value)

Voorbeeld:
Len("John Doe")
Geeft als resultaat 8

LTrim

Beschrijving:
Met de functie LTrim worden voorloopspaties uit een tekenreeks verwijderd.

Syntaxis:
str LTrim(str value)

Voorbeeld:
LTrim(" Test ")
Retourneert "Test"

Mid

Beschrijving:
De functie Mid retourneert een opgegeven aantal tekens van een opgegeven positie in een tekenreeks.

Syntaxis:
str Mid(str string, num start, num NumChars)

  • tekenreeks: de tekenreeks waaruit tekens moeten worden geretourneerd
  • start: een getal dat de beginpositie in de tekenreeks aangeeft waaruit tekens moeten worden geretourneerd
  • NumChars: een getal dat het aantal tekens aangeeft dat moet worden geretourneerd vanuit de positie in de tekenreeks

Opmerkingen:
Retourneert numChars-tekens die beginnen vanaf positie in tekenreeks.
Een tekenreeks met numChars-tekens vanaf positie beginnen in tekenreeks:

  • Als aantalTekens = 0, retourneer lege tekenreeks.
  • Als aantalTekens < 0, retourneer invoertekenreeks.
  • Als u de lengte van de tekenreeks start > , retourneert u de invoertekenreeks.
  • Als begin <= 0, retourneert u invoertekenreeks.
  • Als tekenreeks null is, retourneer lege tekenreeks.

Als er geen numChar-tekens in de tekenreeks vanaf positie beginnen, worden er zoveel mogelijk tekens geretourneerd.

Voorbeeld:
Mid("John Doe", 3, 5)
Retourneert "hn Do".

Mid("John Doe", 6, 999)
Retourneert "Doe"

Nu

Beschrijving:
De functie Now retourneert een datum/tijd die de huidige datum en tijd opgeeft, op basis van de systeemdatum en -tijd van uw computer.

Syntaxis:
dt Now()

NumFromDate

Beschrijving:
De functie NumFromDate retourneert een datum in de datumnotatie van AD.

Syntaxis:
num NumFromDate(dt value)

Voorbeeld:
NumFromDate(CDate("2012-01-01 23:00:00"))
Retourneert 129699324000000000

PadLeft

Beschrijving:
Met de functie PadLeft wordt een tekenreeks naar een opgegeven lengte gelaten met behulp van een opgegeven opvullingsteken.

Syntaxis:
str PadLeft(str string, num length, str padCharacter)

  • tekenreeks: de tekenreeks die moet worden opvulling.
  • lengte: Een geheel getal dat de gewenste lengte van de tekenreeks aangeeft.
  • padCharacter: een tekenreeks die bestaat uit één teken dat moet worden gebruikt als padteken

Opmerkingen:

  • Als de lengte van de tekenreeks kleiner is dan lengte, wordt padCharacter herhaaldelijk toegevoegd aan het begin (links) van de tekenreeks totdat deze een lengte heeft die gelijk is aan lengte.
  • PadCharacter kan een spatieteken zijn, maar het mag geen null-waarde zijn.
  • Als de lengte van de tekenreeks gelijk is aan of groter is dan lengte, wordt de tekenreeks ongewijzigd geretourneerd.
  • Als een tekenreeks een lengte heeft die groter is dan of gelijk is aan de lengte, wordt een tekenreeks geretourneerd die identiek is aan de tekenreeks.
  • Als de lengte van de tekenreeks kleiner is dan de lengte, wordt een nieuwe tekenreeks van de gewenste lengte geretourneerd met een tekenreeks die is opgevuld met een padCharacter.
  • Als de tekenreeks null is, retourneert de functie een lege tekenreeks.

Voorbeeld:
PadLeft("User", 10, "0")
Retourneert '000000User'.

PadRight

Beschrijving:
Met de functie PadRight wordt met de rechtermuisknop een tekenreeks naar een opgegeven lengte gebruikt met behulp van een opgegeven opvullingsteken.

Syntaxis:
str PadRight(str string, num length, str padCharacter)

  • tekenreeks: de tekenreeks die moet worden opvulling.
  • lengte: Een geheel getal dat de gewenste lengte van de tekenreeks aangeeft.
  • padCharacter: een tekenreeks die bestaat uit één teken dat moet worden gebruikt als padteken

Opmerkingen:

  • Als de lengte van de tekenreeks kleiner is dan lengte, wordt padCharacter herhaaldelijk toegevoegd aan het einde (rechts) van de tekenreeks totdat deze een lengte heeft die gelijk is aan lengte.
  • padCharacter kan een spatieteken zijn, maar het mag geen null-waarde zijn.
  • Als de lengte van de tekenreeks gelijk is aan of groter is dan lengte, wordt de tekenreeks ongewijzigd geretourneerd.
  • Als een tekenreeks een lengte heeft die groter is dan of gelijk is aan de lengte, wordt een tekenreeks geretourneerd die identiek is aan de tekenreeks.
  • Als de lengte van de tekenreeks kleiner is dan de lengte, wordt een nieuwe tekenreeks van de gewenste lengte geretourneerd met een tekenreeks die is opgevuld met een padCharacter.
  • Als de tekenreeks null is, retourneert de functie een lege tekenreeks.

Voorbeeld:
PadRight("User", 10, "0")
Retourneert User000000.

PCase

Beschrijving:
Met de functie PCase wordt het eerste teken van elk door spaties gescheiden woord in een tekenreeks geconverteerd naar hoofdletters en worden alle andere tekens geconverteerd naar kleine letters.

Syntaxis:
String PCase(string)

Opmerkingen:

  • Deze functie biedt momenteel geen juiste behuizing om een woord te converteren dat volledig hoofdletters is, zoals een acroniem.

Voorbeeld:
PCase("TEsT")
Retourneert 'Test'.

PCase(LCase("TEST"))
Retourneert 'Test'

RandomNum

Beschrijving:
De functie RandomNum retourneert een willekeurig getal tussen een opgegeven interval.

Syntaxis:
num RandomNum(num start, num end)

  • start: een getal dat de ondergrens van de willekeurige waarde identificeert die moet worden gegenereerd
  • einde: een getal dat de bovengrens van de willekeurige waarde identificeert die moet worden gegenereerd

Voorbeeld:
Random(100,999)
Kan 734 retourneren.

RemoveDuplicates

Beschrijving:
De functie RemoveDuplicates gebruikt een tekenreeks met meerdere waarden en zorgt ervoor dat elke waarde uniek is.

Syntaxis:
mvstr RemoveDuplicates(mvstr attribute)

Voorbeeld:
RemoveDuplicates([proxyAddresses])
Retourneert een opgeschoond proxyAddress-kenmerk waarbij alle dubbele waarden zijn verwijderd.

Replace

Beschrijving:
Met de functie Vervangen worden alle exemplaren van een tekenreeks vervangen door een andere tekenreeks.

Syntaxis:
str Replace(str string, str OldValue, str NewValue)

  • tekenreeks: Een tekenreeks waarin waarden moeten worden vervangen.
  • OldValue: de tekenreeks die moet worden gezocht en vervangen.
  • NewValue: de tekenreeks die moet worden vervangen.

Opmerkingen:
De functie herkent de volgende speciale monikers:

  • \n – Nieuwe regel
  • \r – Regelterugloop
  • \t – Tab

Voorbeeld:
Replace([address],"\r\n",", ")
Vervangt CRLF door een komma en spatie en kan leiden tot "One Microsoft Way, Redmond, WA, USA"

ReplaceChars

Beschrijving:
De functie ReplaceChars vervangt alle tekens die in de tekenreeks ReplacePattern zijn gevonden.

Syntaxis:
str ReplaceChars(str string, str ReplacePattern)

  • tekenreeks: Een tekenreeks waarin tekens moeten worden vervangen.
  • ReplacePattern: een tekenreeks met een woordenlijst met tekens die moeten worden vervangen.

De indeling is {source1}:{target1},{source2}:{target2},{sourceN},{targetN} waarbij de bron het teken is om de tekenreeks te zoeken en te richten die moet worden vervangen.

Opmerkingen:

  • De functie neemt elk exemplaar van gedefinieerde bronnen en vervangt deze door de doelen.
  • De bron moet precies één teken (Unicode) zijn.
  • De bron mag niet leeg of langer zijn dan één teken (parseringsfout).
  • Het doel kan meerdere tekens bevatten, bijvoorbeeld ö:oe, β:ss.
  • Het doel kan leeg zijn om aan te geven dat het teken moet worden verwijderd.
  • De bron is hoofdlettergevoelig en moet een exacte overeenkomst zijn.
  • De tekens , (komma) en : (dubbele punt) zijn gereserveerde tekens en kunnen niet worden vervangen met behulp van deze functie.
  • Spaties en andere witte tekens in de tekenreeks ReplacePattern worden genegeerd.

Voorbeeld:
%ReplaceString% = ’:,Å:A,Ä:A,Ö:O,å:a,ä:a,ö,o

ReplaceChars("Räksmörgås",%ReplaceString%)
Geeft als resultaat Raksmorgas

ReplaceChars("O’Neil",%ReplaceString%)
Retourneert 'ONeil', de enkele maatstreep is gedefinieerd om te worden verwijderd.

Beschrijving:
De functie Rechts retourneert een opgegeven aantal tekens van de rechterkant (einde) van een tekenreeks.

Syntaxis:
str Right(str string, num NumChars)

  • tekenreeks: de tekenreeks waaruit tekens moeten worden geretourneerd
  • NumChars: een getal dat het aantal tekens aangeeft dat moet worden geretourneerd aan het einde (rechts) van de tekenreeks

Opmerkingen:
NumChars-tekens worden geretourneerd vanaf de laatste positie van de tekenreeks.

Een tekenreeks met de laatste numChars-tekens in tekenreeks:

  • Als aantalTekens = 0, retourneer lege tekenreeks.
  • Als aantalTekens < 0, retourneer invoertekenreeks.
  • Als tekenreeks null is, retourneer lege tekenreeks.

Als de tekenreeks minder tekens bevat dan het getal dat is opgegeven in NumChars, wordt een tekenreeks geretourneerd die identiek is aan de tekenreeks.

Voorbeeld:
Right("John Doe", 3)
Retourneert "Doe".

RTrim

Beschrijving:
Met de functie RTrim worden volgspaties uit een tekenreeks verwijderd.

Syntaxis:
str RTrim(str value)

Voorbeeld:
RTrim(" Test ")
Retourneert "Test".

Selecteer

Beschrijving:
Alle waarden in een kenmerk met meerdere waarden (of uitvoer van een expressie) verwerken op basis van de opgegeven functie.

Syntaxis:
mvattr Select(variable item, mvattr attribute, func function)
mvattr Select(variable item, exp expression, func function)

  • item: Vertegenwoordigt een element in het kenmerk met meerdere waarden
  • kenmerk: het kenmerk met meerdere waarden
  • expressie: een expressie die een verzameling waarden retourneert
  • voorwaarde: elke functie die een item in het kenmerk kan verwerken

Voorbeelden:
Select($item,[otherPhone],Replace($item,"-",""))
Hiermee worden alle waarden in het kenmerk met meerdere waarden geretourneerd Telefoon nadat afbreekstreepjes (-) zijn verwijderd.

Split

Beschrijving:
Met de functie Splitsen wordt een tekenreeks gescheiden door een scheidingsteken en wordt deze een tekenreeks met meerdere waarden.

Syntaxis:
mvstr Split(str value, str delimiter)
mvstr Split(str value, str delimiter, num limit)

  • waarde: de tekenreeks met een scheidingsteken dat moet worden gescheiden.
  • scheidingsteken: één teken dat moet worden gebruikt als scheidingsteken.
  • limiet: maximum aantal waarden dat kan worden geretourneerd.

Voorbeeld:
Split("SMTP:john.doe@contoso.com,smtp:jd@contoso.com",",")
Retourneert een tekenreeks met meerdere waarden met 2 elementen die nuttig zijn voor het kenmerk proxyAddress.

StringFromGuid

Beschrijving:
De functie StringFromGuid gebruikt een binaire GUID en converteert deze naar een tekenreeks

Syntaxis:
str StringFromGuid(bin GUID)

StringFromSid

Beschrijving:
Met de functie StringFromSid wordt een bytematrix met een beveiligings-id geconverteerd naar een tekenreeks.

Syntaxis:
str StringFromSid(bin ObjectSID)

Switch

Beschrijving:
De functie Schakelen wordt gebruikt om één waarde te retourneren op basis van geëvalueerde voorwaarden.

Syntaxis:
var Switch(exp expr1, var value1[, exp expr2, var value … [, exp expr, var valueN]])

  • expr: Variantexpressie die u wilt evalueren.
  • waarde: de waarde die moet worden geretourneerd als de bijbehorende expressie Waar is.

Opmerkingen:
De lijst met functieargumenten schakelen bestaat uit paren expressies en waarden. De expressies worden van links naar rechts geëvalueerd en de waarde die is gekoppeld aan de eerste expressie om waar te evalueren, wordt geretourneerd. Als de onderdelen niet goed zijn gekoppeld, treedt er een runtimefout op.

Als expr1 bijvoorbeeld Waar is, retourneert Switch waarde1. Als expr-1 Onwaar is, maar expr-2 Waar is, retourneert Switch waarde-2, enzovoort.

Schakeloptie retourneert een niets als:

  • Geen van de expressies is Waar.
  • De eerste True-expressie heeft een overeenkomende waarde die Null is.

Schakeloptie evalueert alle expressies, ook al retourneert deze slechts één expressie. Daarom moet u letten op ongewenste bijwerkingen. Als de evaluatie van een expressie bijvoorbeeld resulteert in een deling door nul, treedt er een fout op.

Waarde kan ook de functie Fout zijn, die een aangepaste tekenreeks retourneert.

Voorbeeld:
Switch([city] = "London", "English", [city] = "Rome", "Italian", [city] = "Paris", "French", True, Error("Unknown city"))
Retourneert de taal die in sommige grote steden wordt gesproken, anders wordt een fout geretourneerd.

Trim

Beschrijving:
Met de functie Knippen worden voorloop- en volgspaties uit een tekenreeks verwijderd.

Syntaxis:
str Trim(str value)

Voorbeeld:
Trim(" Test ")
Retourneert 'Test'.

Trim([proxyAddresses])
Hiermee verwijdert u voorloop- en volgspaties voor elke waarde in het kenmerk proxyAddress.

UCase

Beschrijving:
Met de functie UCase worden alle tekens in een tekenreeks geconverteerd naar hoofdletters.

Syntaxis:
str UCase(str string)

Voorbeeld:
UCase("TeSt")
Retourneert 'TEST'.

Waar

Beschrijving:
Retourneert een subset waarden van een kenmerk met meerdere waarden (of uitvoer van een expressie) op basis van een specifieke voorwaarde.

Syntaxis:
mvattr Where(variable item, mvattr attribute, exp condition)
mvattr Where(variable item, exp expression, exp condition)

  • item: Vertegenwoordigt een element in het kenmerk met meerdere waarden
  • kenmerk: het kenmerk met meerdere waarden
  • voorwaarde: elke expressie die kan worden geëvalueerd op waar of onwaar
  • expressie: een expressie die een verzameling waarden retourneert

Voorbeeld:
Where($item,[userCertificate],CertNotAfter($item)>Now())
Retourneer de certificaatwaarden in het kenmerk userCertificate met meerdere waarden die niet zijn verlopen.

With

Beschrijving:
De functie With biedt een manier om een complexe expressie te vereenvoudigen met behulp van een variabele om een subexpressie weer te geven die een of meer keren in de complexe expressie wordt weergegeven.

Syntaxis:With(var variable, exp subExpression, exp complexExpression)

  • variabele: Vertegenwoordigt de subexpressie.
  • subExpressie: subexpressie vertegenwoordigd door variabele.
  • complexExpression: een complexe expressie.

Voorbeeld:
With($unExpiredCerts,Where($item,[userCertificate],CertNotAfter($item)>Now()),IIF(Count($unExpiredCerts)>0,$unExpiredCerts,NULL))
Is functioneel gelijk aan:
IIF (Count(Where($item,[userCertificate],CertNotAfter($item)>Now()))>0, Where($item,[userCertificate],CertNotAfter($item)>Now()),NULL)
Hiermee worden alleen niet-verlopen certificaatwaarden in het kenmerk userCertificate geretourneerd.

Word

Beschrijving:
De functie Word retourneert een woord in een tekenreeks, op basis van parameters die de scheidingstekens beschrijven die moeten worden gebruikt en het woordnummer dat moet worden geretourneerd.

Syntaxis:
str Word(str string, num WordNumber, str delimiters)

  • tekenreeks: de tekenreeks waaruit een woord moet worden geretourneerd.
  • WordNumber: een getal dat aangeeft welk woordnummer moet worden geretourneerd.
  • scheidingstekens: een tekenreeks die de scheidingstekens vertegenwoordigt die moeten worden gebruikt om woorden te identificeren

Opmerkingen:
Elke tekenreeks in tekenreeks, gescheiden door een van de tekens in scheidingstekens, wordt aangeduid als een woord:

  • Als getal < 1, retourneer lege string.
  • Als tekenreeks null is, retourneer lege tekenreeks.

Als de tekenreeks minder dan het aantal woorden bevat of als de tekenreeks geen woorden bevat geïdentificeerd door de scheidingstekens, wordt een lege tekenreeks geretourneerd.

Voorbeeld:
Word("The quick brown fox",3," ")
Geeft als resultaat 'bruin'

Word("This,string!has&many separators",3,",!&#")
Zou 'has' retourneren

Aanvullende resources