Microsoft Entra Connect Sync: Függvények – referencia
A Microsoft Entra Connectben a függvények az attribútumértékek szinkronizálása során történő módosítására szolgálnak.
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
- Tanúsítvány
- CertExtensionOids
- CertFormat
- CertFriendlyName
- CertHashString
- CertIssuer
- CertIssuerDN
- CertIssuerOid
- CertKeyAlgorithm
- CertKeyAlgorithmParams
- CertNameInfo
- CertNotAfter
- CertNotBefore
- CertPublicKeyOid
- CertPublicKeyParametersOid
- CertSerialNumber
- CertSignatureAlgorithmOid
- CertSubject
- CertSubjectNameDN
- CertSubjectNameOid
- CertThumbprint
- CertVersion
- IsCert
- Konverzió
- Dátum/idő
- Címtár
- Értékelés
- Matek
- Multi*valued
- Programfolyamat
- Szöveg
BitAnd
Leírás:
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
Megjegyzések:
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
Leírás:
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
Megjegyzések:
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
Leírás:
A CBool függvény egy logikai értéket ad vissza a kiértékelt kifejezés alapján
Szintaxis:
bool CBool(exp Expression)
Megjegyzések:
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
Leírás:
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
Megjegyzések:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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: 00001111-aaaa-2222-bbbb-3333cccc4444 vagy {000011111-aaaa-2222-bbbb-3333cccc4444}
Contains
Leírás:
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ó.
Megjegyzések:
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
Leírás:
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
Leírás:
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
Megjegyzések:
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
Leírás:
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
Leírás:
A ConvertToUTF8Hex függvény egy sztringet UTF8 Hex kódolású értékké konvertál.
Szintaxis:
str ConvertToUTF8Hex(str source)
Megjegyzések:
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
Count
Leírás:
A Count függvény egy többértékű attribútum elemeinek számát adja vissza
Szintaxis:
num Count(mvstr attribute)
CNum
Leírás:
A CNum függvény egy sztringet vesz fel, és numerikus adattípust ad vissza.
Szintaxis:
num CNum(str value)
CRef
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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
Leírás:
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.
Megjegyzések:
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
Leírás:
A függvény GUID azonosítója új véletlenszerű GUID-t hoz létre
Szintaxis:
str Guid()
IIF
Leírás:
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
Leírás:
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
Megjegyzések:
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
Leírás:
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
Megjegyzések:
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
Leírás:
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
Leírás:
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)
Megjegyzések:
Annak megállapítására szolgál, hogy a CDate() sikeres lehet-e.
IsCert
Leírás:
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
Leírás:
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
Leírás:
Ha a sztring GUID-ra konvertálható, akkor az IsGuid függvény értéke igaz.
Szintaxis:
bool IsGuid(str GUID)
Megjegyzések:
A GUID a következő minták egyikét követő sztringként van definiálva: 00001111-aaaa-2222-bbbb-3333cccc4444 vagy {00001111-aaaa-2222-bbbb-3333cccc4444}
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
Leírás:
Ha a kifejezés null értékű, akkor az IsNull függvény igaz értéket ad vissza.
Szintaxis:
bool IsNull(var Expression)
Megjegyzések:
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
Leírás:
Ha a kifejezés null vagy üres sztring, akkor az IsNullOrEmpty függvény igaz értéket ad vissza.
Szintaxis:
bool IsNullOrEmpty(var Expression)
Megjegyzések:
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
Leírás:
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)
Megjegyzések:
Annak meghatározására szolgál, hogy a CNum() sikeres lehet-e a kifejezés elemzéséhez.
IsString
Leírás:
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)
Megjegyzések:
Annak megállapítására szolgál, hogy a CStr() sikeres lehet-e a kifejezés elemzéséhez.
IsPresent
Leírás:
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)
Megjegyzések:
Ennek a függvénynek az inverze isNullOrEmpty.
Példa:
Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director])
Elem
Leírás:
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.
Megjegyzések:
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
Leírás:
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.
Megjegyzések:
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
Leírás:
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.
Megjegyzések
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
Leírás:
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
Leírás:
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
Megjegyzések:
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
Leírás:
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
Leírás:
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
Leírás:
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
Megjegyzések:
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
Leírás:
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
Leírás:
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
Leírás:
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
Megjegyzések:
- 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
Leírás:
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
Megjegyzések:
- 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
Leírás:
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)
Megjegyzések:
- 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
Leírás:
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
Leírás:
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
Leírás:
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.
Megjegyzések:
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
Leírás:
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.
Megjegyzések:
- 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.
Right
Leírás:
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
Megjegyzések:
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
Leírás:
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.
Kijelölés
Leírás:
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
Példák:
Select($item,[otherPhone],Replace($item,"-",""))
A kötőjelek (-) eltávolítása után adja vissza az egyébPhone többértékű attribútum összes értékét.
Split
Leírás:
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
Leírás:
A StringFromGuid függvény egy bináris GUID-t vesz igénybe, és sztringgé alakítja
Szintaxis:
str StringFromGuid(bin GUID)
StringFromSid
Leírás:
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
Leírás:
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.
Megjegyzések:
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
Leírás:
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
Leírás:
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.
Where
Leírás:
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
Leírás:
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
Leírás:
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
Megjegyzések:
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
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: