Microsoft Entra Csatlakozás Sync: Függvények referenciája

  • Cikk

A Microsoft Entra Csatlakozás függvényekkel manipulálhat egy attribútumértéket a szinkronizálás során.
A függvények szintaxisa a következő formátumban van kifejezve:
<output type> FunctionName(<input type> <position name>, ..)

Ha egy függvény túlterhelt, és több szintaxist is elfogad, az összes érvényes szintaxis megjelenik a listában.
A függvények erősen vannak begépelve, és ellenőrzik, hogy a megadott típus megfelel-e a dokumentált típusnak.
Ha a típus nem egyezik, hibaüzenet jelenik meg.

A típusok a következő szintaxissal vannak kifejezve:

  • bin – Bináris
  • bool – Logikai
  • dt – UTC dátum/idő
  • enum – Ismert állandók számbavétele
  • exp – Kifejezés, amely várhatóan logikai értékre lesz kiértékelve
  • mvbin – Többértékű bináris
  • mvstr – Többértékű sztring
  • mvref – Többértékű referencia
  • szám – Numerikus
  • ref – Referencia
  • str – Sztring
  • var – Bármilyen más típusú (majdnem) variáns
  • void – nem ad vissza értéket

Az mvbin, mvstr és mvref típusú függvények csak többértékű attribútumokon működnek. A bin, str és ref függvények egy- és többértékű attribútumokon is működnek.

Functions – referencia

BitAnd

Description:
A BitAnd függvény megadott biteket állít be egy értéken.

Szintaxis:
num BitAnd(num value1, num value2)

  • value1, value2: numerikus értékek, amelyeket együtt kell MEGADNI

Remarks:
Ez a függvény mindkét paramétert bináris reprezentációvá alakítja, és egy kicsit a következőre állítja:

  • 0 – ha az 1 és az érték2 megfelelő bitjei közül az egyik vagy mindkettő 0
  • 1 – ha mindkét megfelelő bit 1.

Más szóval minden esetben 0 értéket ad vissza, kivéve, ha mindkét paraméter megfelelő bitjei 1.

Példa
BitAnd(&HF, &HF7)
7 értéket ad vissza, mert a hexadecimális "F" ÉS az "F7" kiértékelése erre az értékre történik.

Bitor

Description:
A BitOr függvény megadott biteket állít be egy értéken.

Szintaxis:
num BitOr(num value1, num value2)

  • value1, value2: numerikus értékek, amelyeket együtt kell megadni VAGY

Remarks:
Ez a függvény mindkét paramétert bináris reprezentációvá alakítja, és egy bitet 1-re állít be, ha a maszkban és a jelölőben lévő megfelelő bitek egyike vagy mindkettő 1, és 0 értékre, ha mindkét megfelelő bit 0. Más szóval minden esetben 1 értéket ad vissza, kivéve, ha mindkét paraméter megfelelő bitjei 0.

CBool

Description:
A CBool függvény egy logikai értéket ad vissza a kiértékelt kifejezés alapján

Szintaxis:
bool CBool(exp Expression)

Remarks:
Ha a kifejezés nem nulla értéket ad vissza, akkor a CBool igaz értéket ad vissza, máskülönben Hamis értéket ad vissza.

Példa
CBool([attrib1] = [attrib2])

Igaz értéket ad vissza, ha mindkét attribútum értéke megegyezik.

CDate

Description:
A CDate függvény egy sztring UTC DateTime értékét adja vissza. A DateTime nem natív attribútumtípus a Syncben, de egyes függvények használják.

Szintaxis:
dt CDate(str value)

  • Érték: Dátumot, időt és opcionálisan időzónát tartalmazó sztring

Remarks:
A visszaadott sztring mindig UTC-ben van.

Példa
CDate([employeeStartTime])
DateTime értéket ad vissza az alkalmazott kezdési ideje alapján

CDate("2013-01-10 4:00 PM -8")
Egy "2013.01.11. 12:00" dátumot ad vissza.

CertExtensionOids

Description:
Egy tanúsítványobjektum összes kritikus bővítményének Oid értékeit adja vissza.

Szintaxis:
mvstr CertExtensionOids(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertFormat

Description:
Az X.509v3-tanúsítvány formátumának nevét adja vissza.

Szintaxis:
str CertFormat(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertFriendlyName

Description:
Egy tanúsítvány társított aliasát adja vissza.

Szintaxis:
str CertFriendlyName(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertHashString

Description:
Az X.509v3 tanúsítvány SHA1 kivonatértékét adja vissza hexadecimális sztringként.

Szintaxis:
str CertHashString(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertIssuer

Description:
Az X.509v3 tanúsítványt kiállító hitelesítésszolgáltató nevét adja vissza.

Szintaxis:
str CertIssuer(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertIssuerDN

Description:
A tanúsítványkibocsátó megkülönböztető nevét adja vissza.

Szintaxis:
str CertIssuerDN(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertIssuerOid

Description:
A tanúsítványkibocsátó objektumát adja vissza.

Szintaxis:
str CertIssuerOid(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertKeyAlgorithm

Description:
Sztringként adja vissza az X.509v3-tanúsítvány fő algoritmusadatait.

Szintaxis:
str CertKeyAlgorithm(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertKeyAlgorithmParams

Description:
Az X.509v3 tanúsítvány kulcsalgoritmus-paramétereit adja vissza hexadecimális sztringként.

Szintaxis:
str CertKeyAlgorithm(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertNameInfo

Description:
Egy tanúsítvány tulajdonosi és kiállítói nevét adja vissza.

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

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.
  • X509NameType: A tárgy X509NameType értéke.
  • includeIssuerName: true to include the issuer name; ellenkező esetben hamis.

CertNotAfter

Description:
Azt a dátumot adja vissza helyi idő szerint, amely után a tanúsítvány már nem érvényes.

Szintaxis:
dt CertNotAfter(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertNotBefore

Description:
Azt a dátumot adja vissza helyi idő szerint, amikor a tanúsítvány érvényessé válik.

Szintaxis:
dt CertNotBefore(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertPublicKeyOid

Description:
Az X.509v3 tanúsítvány nyilvános kulcsának Oid értékét adja vissza.

Szintaxis:
str CertKeyAlgorithm(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertPublicKeyParametersOid

Description:
Az X.509v3 tanúsítvány nyilvános kulcsparamétereinek Oid értékét adja vissza.

Szintaxis:
str CertPublicKeyParametersOid(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertSerialNumber

Description:
Az X.509v3 tanúsítvány sorozatszámát adja vissza.

Szintaxis:
str CertSerialNumber(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertSignatureAlgorithmOid

Description:
A tanúsítvány aláírásának létrehozásához használt algoritmus Oid értékét adja vissza.

Szintaxis:
str CertSignatureAlgorithmOid(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertSubject

Description:
Lekéri a tulajdonos megkülönböztető nevét egy tanúsítványból.

Szintaxis:
str CertSubject(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertSubjectNameDN

Description:
A tulajdonos megkülönböztető nevét adja vissza egy tanúsítványtól.

Szintaxis:
str CertSubjectNameDN(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertSubjectNameOid

Description:
A tulajdonos nevének Oid értékét adja vissza egy tanúsítványból.

Szintaxis:
str CertSubjectNameOid(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertThumbprint

Description:
Egy tanúsítvány ujjlenyomatát adja vissza.

Szintaxis:
str CertThumbprint(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CertVersion

Description:
A tanúsítvány X.509 formátumú verzióját adja vissza.

Szintaxis:
str CertThumbprint(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

CGuid

Description:
A CGuid függvény a GUID sztring-ábrázolását bináris reprezentációvá alakítja.

Szintaxis:
bin CGuid(str GUID)

  • Ebben a mintában formázott sztring: xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx vagy {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}

Contains

Description:
A Contains függvény egy sztringet keres egy többértékű attribútumon belül

Szintaxis:
num Contains (mvstring attribute, str search) - kis- és nagybetűk megkülönböztetése
num Contains (mvstring attribute, str search, enum Casetype)
num Contains (mvref attribute, str search) - kis- és nagybetűk megkülönböztetése

  • attribútum: a keresendő többértékű attribútum.
  • keresés: az attribútumban keresendő sztring.
  • Casetype: CaseInsensitive vagy CaseSensitive.

Indexet ad vissza abban a többértékű attribútumban, amelyben a sztring található. 0 értéket ad vissza, ha a sztring nem található.

Remarks:
Többértékű sztringattribútumok esetén a keresés megkeresi az értékekben lévő részsztringeket.
Referenciaattribútumok esetén a keresett sztringnek pontosan meg kell egyeznie az egyezésnek tekinthető értékkel.

Példa
IIF(Contains([proxyAddresses],"SMTP:")>0,[proxyAddresses],Error("No primary SMTP address found."))
Ha a proxyAddresses attribútum elsődleges e-mail-címmel rendelkezik (nagybetűs "SMTP:"), akkor adja vissza a proxyAddress attribútumot, máskülönben hibát ad vissza.

ConvertFromBase64

Description:
A ConvertFromBase64 függvény a megadott base64 kódolású értéket normál sztringgé alakítja.

Szintaxis:
str ConvertFromBase64(str source) - Unicode kódolást feltételez
str ConvertFromBase64(str source, enum Encoding)

  • forrás: Base64 kódolású sztring
  • Kódolás: Unicode, ASCII, UTF8

Példa
ConvertFromBase64("SABlAGwAbABvACAAdwBvAHIAbABkACEA")
ConvertFromBase64("SGVsbG8gd29ybGQh", UTF8)

Mindkét példa a "Hello world!"-t adja vissza.

ConvertFromUTF8Hex

Description:
A ConvertFromUTF8Hex függvény a megadott UTF8 Hex kódolt értéket sztringgé alakítja.

Szintaxis:
str ConvertFromUTF8Hex(str source)

  • forrás: UTF8 2 bájtos kódolású csípés

Remarks:
A függvény és a ConvertFromBase64([],UTF8) közötti különbség abban az esetben, ha az eredmény a DN attribútum számára felhasználóbarát.
Ezt a formátumot a Microsoft Entra ID használja DN-ként.

Példa
ConvertFromUTF8Hex("48656C6C6F20776F726C6421")
A "Hello world!" értéket adja vissza

ConvertToBase64

Description:
A ConvertToBase64 függvény unicode base64 sztringgé alakít át egy sztringet.
Az egész számok tömbjének értékét az azzal egyenértékű sztringre alakítja át, amely alap-64 számjegyekkel van kódolva.

Szintaxis:
str ConvertToBase64(str source)

Példa
ConvertToBase64("Hello world!")
A "SABlAGwAbABvACAAdwBvAHIAbABkACEA" értéket adja vissza

ConvertToUTF8Hex

Description:
A ConvertToUTF8Hex függvény egy sztringet UTF8 Hex kódolású értékké konvertál.

Szintaxis:
str ConvertToUTF8Hex(str source)

Remarks:
A függvény kimeneti formátumát a Microsoft Entra ID használja DN attribútumformátumként.

Példa
ConvertToUTF8Hex("Hello world!")
A 48656C6C6F20776F726C6421 értéket adja vissza

Gróf

Description:
A Count függvény egy többértékű attribútum elemeinek számát adja vissza

Szintaxis:
num Count(mvstr attribute)

CNum

Description:
A CNum függvény egy sztringet vesz fel, és numerikus adattípust ad vissza.

Szintaxis:
num CNum(str value)

CRef

Description:
Sztring átalakítása referenciaattribútummá

Szintaxis:
ref CRef(str value)

Példa
CRef("CN=LC Services,CN=Microsoft,CN=lcspool01,CN=Pools,CN=RTC Service," & %Forest.LDAP%)

CStr

Description:
A CStr függvény sztring adattípussá alakul.

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

  • érték: Lehet numerikus érték, referenciaattribútum vagy logikai érték.

Példa
CStr([dn])
Visszaadható a "cn=Joe,dc=contoso,dc=com"

DateAdd

Description:
Egy dátumot ad vissza, amely egy megadott időintervallumot adott hozzá.

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

  • intervallum: Sztringkifejezés, amely a hozzáadni kívánt időintervallum. A sztringnek a következő értékek egyikével kell rendelkeznie:
    • yyyy year
    • q quarter
    • m hónap
    • y Az év napja
    • d nap
    • w Hétköznap
    • ww hét
    • h Óra
    • n perc
    • s második
  • érték: A hozzáadni kívánt egységek száma. Lehet pozitív (a jövőbeli dátumok lekérése) vagy negatív (a múltbeli dátumok lekéréséhez).
  • dátum: Dátum/idő, amely az időköz hozzáadásának dátumát jelöli.

Példa
DateAdd("m", 3, CDate("2001-01-01"))
3 hónapot ad hozzá, és egy "2001-04-01" dátumot ad vissza.

DateFromNum

Description:
A DateFromNum függvény az AD dátumformátumában szereplő értéket DateTime típussá alakítja.

Szintaxis:
dt DateFromNum(num value)

Példa
DateFromNum([lastLogonTimestamp])
DateFromNum(129699324000000000)
2012.01.01. 23:00:00 dátumot ad vissza.

DNComponent

Description:
A DNComponent függvény egy megadott DN-összetevő balról érkező értékét adja vissza.

Szintaxis:
str DNComponent(ref dn, num ComponentNumber)

  • dn: az értelmezendő referenciaattribútum
  • ComponentNumber: A DN-ben visszaadandó összetevő

Példa
DNComponent(CRef([dn]),1)
Ha a dn a "cn=Joe,ou=...", akkor Joe-t adja vissza

DNComponentRev

Description:
A DNComponentRev függvény egy adott DN-összetevő értékét adja vissza, amely jobbra (a végétől) halad.

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

  • dn: az értelmezendő referenciaattribútum
  • ComponentNumber – A DN visszaadandó összetevője
  • Beállítások: DC – Az összes összetevő figyelmen kívül hagyása a "dc=" értékkel

Példa
Ha a dn "cn=Joe,ou=Atlanta,ou=GA,ou=US, dc=contoso,dc=com" akkor
DNComponentRev(CRef([dn]),3)
DNComponentRev(CRef([dn]),1,"DC")
Mindkettő az USA-t adja vissza.

Hiba

Description:
A Hiba függvénnyel egyéni hibát ad vissza.

Szintaxis:
void Error(str ErrorMessage)

Példa
IIF(IsPresent([accountName]),[accountName],Error("AccountName is required"))
Ha az accountName attribútum nem található, hibaüzenetet jelenítsen meg az objektumon.

EscapeDNComponent

Description:
Az EscapeDNComponent függvény egy DN egyik összetevőjét veszi fel, és feloldja, hogy az LDAP-ban ábrázolható legyen.

Szintaxis:
str EscapeDNComponent(str value)

Példa
EscapeDNComponent("cn=" & [displayName]) & "," & %ForestLDAP%)
Gondoskodik arról, hogy az objektum létrehozható egy LDAP-könyvtárban, még akkor is, ha a displayName attribútum olyan karaktereket tartalmaz, amelyeket meg kell szökni az LDAP-ban.

FormatDateTime

Description:
A FormatDateTime függvény a DateTime egy megadott formátumú sztringre való formázására szolgál

Szintaxis:
str FormatDateTime(dt value, str format)

  • érték: dátum/idő formátumú érték
  • formátum: a konvertálni kívánt formátumot képviselő sztring.

Remarks:
A formátum lehetséges értékei itt találhatók: A FORMAT függvény egyéni dátum- és időformátumai.

Példa

FormatDateTime(CDate("12/25/2007"),"yyyy-MM-dd")
Eredmény: "2007-12-25".

FormatDateTime(DateFromNum([pwdLastSet]),"yyyyMMddHHmmss.0Z")
A következőt eredményezheti: "20140905081453.0Z"

GUID

Description:
A függvény GUID azonosítója új véletlenszerű GUID-t hoz létre

Szintaxis:
str Guid()

IIF

Description:
Az IIF függvény egy adott feltételen alapuló lehetséges értékek egyikét adja vissza.

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

  • feltétel: bármely érték vagy kifejezés, amely igaz vagy hamis értékre értékelhető ki.
  • valueIfTrue: Ha a feltétel értéke igaz, a visszaadott érték.
  • valueIfFalse: Ha a feltétel értéke hamis, a visszaadott érték.

Példa
IIF([employeeType]="Intern","t-" & [alias],[alias])
Ha a felhasználó gyakornok, akkor a felhasználó aliasát adja vissza, amelynek elejéhez "t-" van hozzáadva, máskülönben a felhasználó aliasát adja vissza.

InStr

Description:
Az InStr függvény megkeresi egy sztringben a részstring első előfordulását

Szintaxis:

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: keresendő sztring
  • sztringmatch: a keresett sztring
  • start: start position to find the substring
  • összehasonlítás: vbTextCompare vagy vbBinaryCompare

Remarks:
Azt a pozíciót adja vissza, ahol az összevonás található, vagy 0 értéket, ha nem található.

Példa
InStr("The quick brown fox","quick")
Kiértékelése: 5

InStr("repEated","e",3,vbBinaryCompare)
Kiértékelése: 7

InStrRev

Description:
Az InStrRev függvény megkeresi egy sztringben lévő részstring utolsó előfordulását

Szintaxis:
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: keresendő sztring
  • sztringmatch: a keresett sztring
  • start: start position to find the substring
  • összehasonlítás: vbTextCompare vagy vbBinaryCompare

Remarks:
Azt a pozíciót adja vissza, ahol az összevonás található, vagy 0 értéket, ha nem található.

Példa
InStrRev("abbcdbbbef","bb")
7-et ad vissza

IsBitSet

Description:
Az IsBitSet függvény tesztelése, ha egy bit be van állítva vagy nincs

Szintaxis:
bool IsBitSet(num value, num flag)

  • value: a evaluated.flag numerikus érték: a kiértékelendő bitet tartalmazó numerikus érték

Példa
IsBitSet(&HF,4)
Igaz értéket ad vissza, mert a "4" bit az "F" hexadecimális értékben van beállítva

IsDate

Description:
Ha a kifejezés kiértékelhető DateTime-típusként, akkor az IsDate függvény true (Igaz) értéket ad ki.

Szintaxis:
bool IsDate(var Expression)

Remarks:
Annak megállapítására szolgál, hogy a CDate() sikeres lehet-e.

IsCert

Description:
Igaz értéket ad vissza, ha a nyers adatok szerializálhatók .NET X509Certificate2 tanúsítványobjektummá.

Szintaxis:
bool CertThumbprint(binary certificateRawData)

  • certificateRawData: X.509-tanúsítvány bájttömb-ábrázolása. A bájttömb lehet bináris (DER) kódolású vagy Base64 kódolású X.509-adat.

IsEmpty

Description:
Ha az attribútum megtalálható a CS-ben vagy az MV-ben, de üres sztringre értékeli ki, akkor az IsEmpty függvény true (Igaz) értéket ad ki.

Szintaxis:
bool IsEmpty(var Expression)

IsGuid

Description:
Ha a sztring GUID-ra konvertálható, akkor az IsGuid függvény értéke igaz.

Szintaxis:
bool IsGuid(str GUID)

Remarks:
A GUID a következő minták egyikét követő sztringként van definiálva: xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx vagy {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}

Annak megállapítására szolgál, hogy a CGuid() sikeres lehet-e.

Példa
IIF(IsGuid([strAttribute]),CGuid([strAttribute]),NULL)
Ha a StrAttribute GUID formátumú, bináris reprezentációt ad vissza, ellenkező esetben null értéket ad vissza.

IsNull

Description:
Ha a kifejezés null értékű, akkor az IsNull függvény igaz értéket ad vissza.

Szintaxis:
bool IsNull(var Expression)

Remarks:
Egy attribútum esetében a null értéket az attribútum hiánya fejezi ki.

Példa
IsNull([displayName])
Igaz értéket ad vissza, ha az attribútum nincs jelen a CS-ben vagy az MV-ben.

IsNullOrEmpty

Description:
Ha a kifejezés null vagy üres sztring, akkor az IsNullOrEmpty függvény igaz értéket ad vissza.

Szintaxis:
bool IsNullOrEmpty(var Expression)

Remarks:
Egy attribútum esetében ez igaz értéket ad, ha az attribútum hiányzik vagy jelen van, de üres sztring.
Ennek a függvénynek az inverze isPresent.

Példa
IsNullOrEmpty([displayName])
Igaz értéket ad vissza, ha az attribútum nincs jelen, vagy üres sztring a CS-ben vagy az MV-ben.

IsNumeric

Description:
Az IsNumeric függvény logikai értéket ad vissza, amely azt jelzi, hogy egy kifejezés számtípusként értékelhető-e ki.

Szintaxis:
bool IsNumeric(var Expression)

Remarks:
Annak meghatározására szolgál, hogy a CNum() sikeres lehet-e a kifejezés elemzéséhez.

IsString

Description:
Ha a kifejezés kiértékelhető egy sztringtípusra, akkor az IsString függvény true (Igaz) értéket ad ki.

Szintaxis:
bool IsString(var expression)

Remarks:
Annak megállapítására szolgál, hogy a CStr() sikeres lehet-e a kifejezés elemzéséhez.

IsPresent

Description:
Ha a kifejezés nem null értékű, és nem üres sztringet ad vissza, akkor az IsPresent függvény igaz értéket ad vissza.

Szintaxis:
bool IsPresent(var expression)

Remarks:
Ennek a függvénynek az inverze isNullOrEmpty.

Példa
Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director])

Tétel

Description:
Az Elem függvény egy elemet ad vissza egy többértékű sztringből/attribútumból.

Szintaxis:
var Item(mvstr attribute, num index)

  • attribútum: többértékű attribútum
  • index: indexelés egy elemhez a többértékű sztringben.

Remarks:
Az Elem függvény a Contains függvénnyel együtt hasznos, mivel az utóbbi függvény az indexet a többértékű attribútum egyik eleméhez adja vissza.

Hibát jelez, ha az index nincs határban.

Példa
Mid(Item([proxyAddresses],Contains([proxyAddresses], "SMTP:")),6)
Az elsődleges e-mail-címet adja vissza.

ItemOrNull

Description:
Az ItemOrNull függvény egy elemet ad vissza egy többértékű sztringből/attribútumból.

Szintaxis:
var ItemOrNull(mvstr attribute, num index)

  • attribútum: többértékű attribútum
  • index: indexelés egy elemhez a többértékű sztringben.

Remarks:
Az ItemOrNull függvény a Contains függvénnyel együtt hasznos, mivel az utóbbi függvény az indexet a többértékű attribútum egy eleméhez adja vissza.

Ha az index túllépi a határokat, akkor null értéket ad vissza.

Csatlakozás

Description:
Az Illesztés függvény egy többértékű sztringet használ, és egy egyértékű sztringet ad vissza az egyes elemek közé beszúrt elválasztójellel.

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

  • attribútum: Többértékű attribútum, amely az összekapcsolandó sztringeket tartalmazza.
  • elválasztó: Bármely sztring, amely a visszaadott sztring részsztringjeinek elválasztására szolgál. Ha nincs megadva, a rendszer a szóköz karaktert (" ") használja. Ha a határoló egy nulla hosszúságú sztring ("") vagy Semmi, a lista összes eleme össze van fűzve elválasztójelek nélkül.

Remarks
Az Illesztés és a Felosztás függvény között paritás van. Az Illesztés függvény sztringek tömbjéből álló tömböt használ, és határoló sztringgel összekapcsolja őket, és egyetlen sztringet ad vissza. A Felosztás függvény egy sztringet vesz fel, és elválasztja a határolótól, hogy sztringtömböt adjon vissza. A fő különbség azonban az, hogy az Illesztés bármilyen elválasztó sztringgel összefűzheti a sztringeket, a Felosztás csak egyetlen karakterelválasztóval tudja elválasztani a sztringeket.

Példa
Join([proxyAddresses],",")
Visszaadható: "SMTP:john.doe@contoso.com,smtp:jd@contoso.com"

LCase

Description:
Az LCase függvény a sztringben szereplő összes karaktert kisbetűssé alakítja.

Szintaxis:
str LCase(str value)

Példa
LCase("TeSt")
A "teszt" értéket adja vissza.

Left

Description:
A Bal oldali függvény megadott számú karaktert ad vissza egy sztring bal oldalán.

Szintaxis:
str Left(str string, num NumChars)

  • sztring: az a sztring, amelyből karaktereket ad vissza
  • NumChars: a karakterlánc elejétől (balra) visszaadandó karakterek számát azonosító szám

Remarks:
A sztring első numChars karaktereit tartalmazó karakterlánc:

  • Ha numChars = 0, üres sztringet ad vissza.
  • Ha numChars < 0, adja vissza a bemeneti sztringet.
  • Ha a sztring null, üres sztringet ad vissza.

Ha a sztring kevesebb karaktert tartalmaz, mint a numCharsban megadott szám, a függvény egy sztringgel azonos karakterláncot ad vissza (azaz az 1. paraméterben szereplő összes karaktert tartalmazza).

Példa
Left("John Doe", 3)
A "Joh" értéket adja vissza.

Len

Description:
A Len függvény egy sztringben szereplő karakterek számát adja vissza.

Szintaxis:
num Len(str value)

Példa
Len("John Doe")
8-at ad vissza

LTrim

Description:
Az LTrim függvény eltávolítja a kezdő fehér szóközöket egy sztringből.

Szintaxis:
str LTrim(str value)

Példa
LTrim(" Test ")
A "Test" értéket adja vissza

Mid

Description:
A Mid függvény megadott számú karaktert ad vissza egy sztring adott pozíciójából.

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

  • sztring: az a sztring, amelyből karaktereket ad vissza
  • start: a sztring kezdő pozícióját azonosító szám, amelyből karaktereket ad vissza
  • NumChars: a sztringben lévő pozícióból visszaadandó karakterek számát azonosító szám

Remarks:
NumChars karaktereket ad vissza a sztringben a pozíciótól kezdve.
Sztring, amely numChars karaktereket tartalmaz a pozíciótól kezdve a sztringben:

  • Ha numChars = 0, üres sztringet ad vissza.
  • Ha numChars < 0, adja vissza a bemeneti sztringet.
  • Ha elindítja > a karakterlánc hosszát, adja vissza a bemeneti sztringet.
  • Ha a kezdő <= 0, adja vissza a bemeneti sztringet.
  • Ha a sztring null, üres sztringet ad vissza.

Ha a sztringben nem található számkarakter a kezdő pozíciótól kezdve, a lehető legtöbb karakter lesz visszaadva.

Példa
Mid("John Doe", 3, 5)
A "hn Do" értéket adja vissza.

Mid("John Doe", 6, 999)
A "Doe" értéket adja vissza

Now

Description:
A Now függvény egy DateTime értéket ad vissza, amely a számítógép rendszerdátuma és ideje szerint adja meg az aktuális dátumot és időt.

Szintaxis:
dt Now()

NumFromDate

Description:
A NumFromDate függvény egy dátumot ad vissza az AD dátumformátumában.

Szintaxis:
num NumFromDate(dt value)

Példa
NumFromDate(CDate("2012-01-01 23:00:00"))
Visszaadja 129699324000000000

PadLeft

Description:
A PadLeft függvény egy megadott hosszúságú sztringet ad meg egy megadott kitöltési karakterrel.

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

  • sztring: a beszúrni kívánt sztring.
  • hossz: A sztring kívánt hosszát jelölő egész szám.
  • padCharacter: Egy karakterből álló sztring, amelyet a pad karakterként használnak

Remarks:

  • Ha a sztring hossza kisebb, mint a hossza, akkor a padCharacter a sztring elejéhez (bal oldalán) többször hozzáfűzve lesz, amíg a hossza nem egyenlő.
  • A PadCharacter lehet szóköz karakter, de nem lehet null értékű.
  • Ha a sztring hossza egyenlő vagy nagyobb, mint a hossz, a sztring változatlanul lesz visszaadva.
  • Ha a sztring hossza nagyobb vagy egyenlő, a karakterlánccal azonos sztring lesz visszaadva.
  • Ha a sztring hossza kisebb, mint a hossz, akkor a rendszer egy új, a kívánt hosszúságú sztringet ad vissza, amely egy padCharacterrel ellátott sztringet tartalmaz.
  • Ha a sztring null, a függvény egy üres sztringet ad vissza.

Példa
PadLeft("User", 10, "0")
A "000000User" értéket adja vissza.

PadRight

Description:
A PadRight függvény egy megadott hosszúságú sztringet ad meg egy megadott kitöltési karakterrel.

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

  • sztring: a beszúrni kívánt sztring.
  • hossz: A sztring kívánt hosszát jelölő egész szám.
  • padCharacter: Egy karakterből álló sztring, amelyet a pad karakterként használnak

Remarks:

  • Ha a sztring hossza kisebb, mint a hossz, akkor a padCharacter ismételten hozzá van fűzve a sztring végéhez (jobbra), amíg a hossza nem egyenlő.
  • a padCharacter szóköz karakter lehet, de nem lehet null értékű.
  • Ha a sztring hossza egyenlő vagy nagyobb, mint a hossz, a sztring változatlanul lesz visszaadva.
  • Ha a sztring hossza nagyobb vagy egyenlő, a karakterlánccal azonos sztring lesz visszaadva.
  • Ha a sztring hossza kisebb, mint a hossz, akkor a rendszer egy új, a kívánt hosszúságú sztringet ad vissza, amely egy padCharacterrel ellátott sztringet tartalmaz.
  • Ha a sztring null, a függvény egy üres sztringet ad vissza.

Példa
PadRight("User", 10, "0")
A "User000000" értéket adja vissza.

PCase

Description:
A PCase függvény a sztringben lévő szóközzel tagolt szavak első karakterét nagybetűssé alakítja, és az összes többi karaktert kisbetűssé alakítja.

Szintaxis:
String PCase(string)

Remarks:

  • Ez a függvény jelenleg nem biztosít megfelelő burkolatot egy teljes egészében nagybetűs szó, például egy betűszó konvertálásához.

Példa
PCase("TEsT")
A "Teszt" értéket adja vissza.

PCase(LCase("TEST"))
"Teszt" értéket ad vissza

RandomNum

Description:
A RandomNum függvény egy véletlenszerű számot ad vissza egy megadott intervallum között.

Szintaxis:
num RandomNum(num start, num end)

  • kezdés: a létrehozandó véletlenszerű érték alsó határát azonosító szám
  • vége: a létrehozandó véletlenszerű érték felső határát azonosító szám

Példa
Random(100,999)
Visszaadhatja a 734-et.

RemoveDuplicates

Description:
A RemoveDuplicates függvény egy többértékű sztringet vesz fel, és győződjön meg arról, hogy minden érték egyedi.

Szintaxis:
mvstr RemoveDuplicates(mvstr attribute)

Példa
RemoveDuplicates([proxyAddresses])
Egy olyan megtisztított proxyAddress attribútumot ad vissza, amelyben az összes ismétlődő érték el lett távolítva.

Replace

Description:
A Csere függvény egy sztring összes előfordulását egy másik sztringre cseréli.

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

  • sztring: Értékeket lecserélő karakterlánc.
  • OldValue: A keresendő és lecserélendő sztring.
  • NewValue: A lecserélendő sztring.

Remarks:
A függvény a következő speciális monikereket ismeri fel:

  • \n – Új sor
  • \r – Kocsivissza
  • \t – Tab

Példa
Replace([address],"\r\n",", ")
A CRLF vesszővel és szóközzel helyettesíthető, és a "One Microsoft Way, Redmond, WA, USA" kifejezéshez vezethet.

Cserediagramok

Description:
A ReplaceChars függvény a ReplacePattern sztringben található karakterek összes előfordulását lecseréli.

Szintaxis:
str ReplaceChars(str string, str ReplacePattern)

  • sztring: A karaktereket lecserélő karakterlánc.
  • ReplacePattern: egy szótárt tartalmazó sztring, amely karaktereket tartalmaz.

A formátum a következő: {source1}:{target1},{source2}:{target2},{sourceN},{targetN}, ahol a forrás a lecserélendő sztring megkereséséhez és megcélzásához használt karakter.

Remarks:

  • A függvény a definiált források minden előfordulását átveszi, és a célokkal helyettesíti őket.
  • A forrásnak pontosan egy (Unicode) karakternek kell lennie.
  • A forrás nem lehet üres vagy hosszabb egy karakternél (elemzési hiba).
  • A cél több karakterből állhat, például ö:oe, β:ss.
  • A cél üres lehet, ami azt jelzi, hogy a karaktert el kell távolítani.
  • A forrás megkülönbözteti a kis- és nagybetűt, és pontos egyezésnek kell lennie.
  • A , (vessző) és : (kettőspont) fenntartott karakterek, és ez a függvény nem helyettesíthető.
  • A ReplacePattern sztringben lévő szóközök és egyéb fehér karakterek figyelmen kívül lesznek hagyva.

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

ReplaceChars("Räksmörgås",%ReplaceString%)
Raksmorgas értéket ad vissza

ReplaceChars("O’Neil",%ReplaceString%)
Az "ONeil" értéket adja vissza, az egyetlen osztásjelet pedig el kell távolítani.

Description:
A Jobb függvény megadott számú karaktert ad vissza egy sztring jobb oldaláról (végéből).

Szintaxis:
str Right(str string, num NumChars)

  • sztring: az a sztring, amelyből karaktereket ad vissza
  • NumChars: a karakterlánc végétől (jobbra) visszaadandó karakterek számát azonosító szám

Remarks:
A NumChars karakterek a sztring utolsó pozíciójából lesznek visszaadva.

A sztring utolsó numChars karaktereit tartalmazó karakterlánc:

  • Ha numChars = 0, üres sztringet ad vissza.
  • Ha numChars < 0, adja vissza a bemeneti sztringet.
  • Ha a sztring null, üres sztringet ad vissza.

Ha a sztring kevesebb karaktert tartalmaz, mint a NumCharsban megadott szám, a sztringgel azonos sztring lesz visszaadva.

Példa
Right("John Doe", 3)
A "Doe" értéket adja vissza.

RTrim

Description:
Az RTrim függvény eltávolítja a sztringből a záró fehér szóközöket.

Szintaxis:
str RTrim(str value)

Példa
RTrim(" Test ")
A "Teszt" értéket adja vissza.

Válassza ezt:

Description:
Többértékű attribútum (vagy kifejezés kimenete) összes értékének feldolgozása a megadott függvény alapján.

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

  • elem: A többértékű attribútum egyik elemét jelöli
  • attribútum: a többértékű attribútum
  • kifejezés: értékgyűjteményt visszaadó kifejezés
  • condition: bármely függvény, amely képes feldolgozni egy elemet az attribútumban

Examples:
Select($item,[otherPhone],Replace($item,"-",""))
Adja vissza a többértékű attribútum összes értékét Telefon a kötőjelek (-) eltávolítása után.

Split

Description:
A Felosztás függvény egy elválasztójellel elválasztott sztringet használ, és többértékű sztringté teszi.

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

  • érték: az elválasztandó elválasztó karakterrel rendelkező sztring.
  • elválasztó: elválasztó karakterként használandó egykarakter.
  • korlát: a visszaadható értékek maximális száma.

Példa
Split("SMTP:john.doe@contoso.com,smtp:jd@contoso.com",",")
Egy többértékű sztringet ad vissza, amelynek 2 eleme hasznos a proxyAddress attribútumhoz.

StringFromGuid

Description:
A StringFromGuid függvény egy bináris GUID-t vesz igénybe, és sztringgé alakítja

Szintaxis:
str StringFromGuid(bin GUID)

StringFromSid

Description:
A StringFromSid függvény egy biztonsági azonosítót tartalmazó bájttömböt sztringgé alakít át.

Szintaxis:
str StringFromSid(bin ObjectSID)

Switch

Description:
A Kapcsoló függvény egyetlen értéket ad vissza a kiértékelt feltételek alapján.

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

  • expr: Kiértékelni kívánt variánskifejezés.
  • érték: A visszaadandó érték, ha a megfelelő kifejezés Igaz.

Remarks:
A Kapcsoló függvény argumentumlistája kifejezéspárokból és értékekből áll. A kifejezések kiértékelése balról jobbra történik, és a rendszer visszaadja az első igaz értéket kiértékelni kívánt kifejezéshez társított értéket. Ha az alkatrészek nincsenek megfelelően párosítva, futásidejű hiba történik.

Ha például az expr1 értéke Igaz, a Kapcsoló érték1 értéket ad vissza. Ha az expr-1 hamis, de az expr-2 igaz, akkor a Kapcsoló a-2 értéket adja vissza, és így tovább.

A kapcsoló a Semmi értéket adja vissza, ha:

  • Egyik kifejezés sem igaz.
  • Az első Igaz kifejezésnek null értékű megfelelő értéke van.

A Kapcsoló az összes kifejezést kiértékeli, annak ellenére, hogy csak az egyiket adja vissza. Ezért figyelnie kell a nemkívánatos mellékhatásokat. Ha például egy kifejezés kiértékelése nulla hiba szerinti osztást eredményez, hiba történik.

Az érték lehet a Hiba függvény is, amely egy egyéni sztringet ad vissza.

Példa
Switch([city] = "London", "English", [city] = "Rome", "Italian", [city] = "Paris", "French", True, Error("Unknown city"))
A nagyobb városokban beszélt nyelvet adja vissza, ellenkező esetben hibaüzenetet ad vissza.

Trim

Description:
A Trim függvény eltávolítja a kezdő és záró szóközöket egy sztringből.

Szintaxis:
str Trim(str value)

Példa
Trim(" Test ")
A "Teszt" értéket adja vissza.

Trim([proxyAddresses])
Eltávolítja a proxyAddress attribútum minden egyes értékéhez tartozó kezdő és záró szóközöket.

Ucase

Description:
Az UCase függvény a sztringben szereplő összes karaktert nagybetűssé alakítja.

Szintaxis:
str UCase(str string)

Példa
UCase("TeSt")
A "TEST" értéket adja vissza.

Ahol

Description:
Egy többértékű attribútum (vagy kifejezés kimenete) értékeinek egy részhalmazát adja vissza adott feltétel alapján.

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

  • elem: A többértékű attribútum egyik elemét jelöli
  • attribútum: a többértékű attribútum
  • feltétel: minden olyan kifejezés, amely igaz vagy hamis értékre értékelhető
  • kifejezés: értékgyűjteményt visszaadó kifejezés

Példa
Where($item,[userCertificate],CertNotAfter($item)>Now())
Adja vissza a többértékű userCertificate attribútum azon tanúsítványértékét, amely nem járt le.

With

Description:
A With függvény lehetővé teszi egy összetett kifejezés egyszerűsítését egy változó használatával, amely egy olyan alexpressziót jelöl, amely egy vagy több alkalommal jelenik meg az összetett kifejezésben.

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

  • változó: A szubexpressziót jelöli.
  • subExpression: a változó által képviselt szubexpresszió.
  • complexExpression: Egy összetett kifejezés.

Példa
With($unExpiredCerts,Where($item,[userCertificate],CertNotAfter($item)>Now()),IIF(Count($unExpiredCerts)>0,$unExpiredCerts,NULL))
Funkcionálisan egyenértékű a következő értékeket:
IIF (Count(Where($item,[userCertificate],CertNotAfter($item)>Now()))>0, Where($item,[userCertificate],CertNotAfter($item)>Now()),NULL)
Ez csak a userCertificate attribútumban nem szereplő tanúsítványértékeket adja vissza.

Word

Description:
A Word függvény egy sztringben található szót a használandó elválasztójeleket leíró paraméterek és a visszaadandó szószám alapján ad vissza.

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

  • sztring: az a sztring, amelyből egy szót vissza szeretne adni.
  • WordNumber: az a szám, amely meghatározza, hogy melyik szószámot adja vissza.
  • elválasztójelek: a szavak azonosításához használandó elválasztójel(ek) sztringje

Remarks:
A sztring minden karaktersorozatát a határolójelek egyikével elválasztva a rendszer szavakként azonosítja:

  • Ha az 1-es szám < , üres sztringet ad vissza.
  • Ha a karakterlánc null, üres sztringet ad vissza.

Ha a sztring kisebb számú szót tartalmaz, vagy a sztring nem tartalmaz elválasztójelek által azonosított szavakat, a függvény üres sztringet ad vissza.

Példa
Word("The quick brown fox",3," ")
"barna" értéket ad vissza

Word("This,string!has&many separators",3,",!&#")
"van" értéket ad vissza

További források