Kifejezések írása attribútumleképezésekhez a Microsoft Entra-azonosítóban
A felhőszinkronizálás konfigurálásakor az attribútumleképezések egyik típusa egy kifejezésleképezés.
A kifejezésleképezés lehetővé teszi az attribútumok szkriptszerű kifejezéssel való testreszabását. Ez lehetővé teszi, hogy a helyszíni adatokat új vagy eltérő értékké alakítsa. Előfordulhat például, hogy két attribútumot egyetlen attribútumba szeretne egyesíteni, mert ezt az egyetlen attribútumot az egyik felhőalkalmazás használja.
Az alábbi dokumentum az adatok átalakításához használt szkriptszerű kifejezéseket ismerteti. Ez csak a folyamat része. Ezután ezt a kifejezést kell használnia, és el kell helyeznie egy webes kérelemben a bérlőnek. További információ erről: Átalakítások
Szintaxis áttekintése
Az attribútumleképezések kifejezéseinek szintaxisa a Visual Basic for Applications (VBA) függvényekre emlékeztet.
A teljes kifejezést függvényekben kell definiálni, amelyek egy névből és zárójelben lévő argumentumokból állnak:
FunctionName(<<argument 1>>
;<<argument N>>
)Függvényeket egymásba ágyazhat. For example:
FunctionOne(FunctionTwo(<<argument1>>
))Három különböző típusú argumentumot adhat át a függvényeknek:
- Attribútumok, amelyeket szögletes zárójelek közé kell tenni. Például: [attributeName]
- Sztringállandók, amelyeket idézőjelek közé kell tenni. Például: "Egyesült Államok"
- Egyéb függvények. Például: FunctionOne(
<<argument1>>
, FunctionTwo(<<argument2>>
))
Sztringállandók esetén, ha a sztringben fordított perjelre ( \ ) vagy idézőjelre ( " ) van szüksége, akkor a sztringet a fordított perjel ( \ ) szimbólummal kell feloldani. Például: "Cégnév: \"Contoso\""
Függvénylista
Függvénylista | Leírás |
---|---|
Append | Egy forrás sztringértéket vesz fel, és hozzáfűzi az utótagot a végéhez. |
BitAnd | A BitAnd függvény megadott biteket állít be egy értéken. |
CBool | A CBool függvény egy logikai értéket ad vissza a kiértékelt kifejezés alapján |
ConvertFromBase64 | A ConvertFromBase64 függvény a megadott base64 kódolású értéket normál sztringgé alakítja. |
ConvertToBase64 | A ConvertToBase64 függvény unicode base64 sztringgé alakít át egy sztringet. |
ConvertToUTF8Hex | A ConvertToUTF8Hex függvény egy sztringet UTF8 Hex kódolású értékké konvertál. |
Gróf | A Count függvény egy többértékű attribútum elemeinek számát adja vissza |
Cstr | A CStr függvény sztring adattípussá alakul. |
DateFromNum | A DateFromNum függvény az AD dátumformátumában szereplő értéket DateTime típussá alakítja. |
DNComponent | A DNComponent függvény egy megadott DN-összetevő balról érkező értékét adja vissza. |
Hiba | A Hiba függvénnyel egyéni hibát ad vissza. |
FormatDateTime | Egy dátumsztringet egy formátumból, majd egy másik formátumba konvertálja. |
GUID | A guid függvény új véletlenszerű GUID-t hoz létre. |
IIF | Az IIF függvény egy adott feltételen alapuló lehetséges értékek egyikét adja vissza. |
InStr | Az InStr függvény megkeresi egy sztringben az alsztring első előfordulását. |
IsNull | Ha a kifejezés null értékű, akkor az IsNull függvény igaz értéket ad vissza. |
IsNullOrEmpty | Ha a kifejezés null vagy üres sztring, akkor az IsNullOrEmpty függvény igaz értéket ad vissza. |
IsPresent | 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. |
IsString | Ha a kifejezés kiértékelhető egy sztringtípusra, akkor az IsString függvény true (Igaz) értéket ad ki. |
Cikk | Az Elem függvény egy elemet ad vissza egy többértékű sztringből/attribútumból. |
Csatlakozás | A Join() hasonló a Append() függvényhez, azzal a kivételrel, hogy több forrássztring-értéket egyesíthet egyetlen sztringben, és minden értéket elválasztó sztring választ el egymástól. |
Bal | A Bal oldali függvény megadott számú karaktert ad vissza egy sztring bal oldalán. |
Közepén | A forrásérték részszűkítését adja vissza. Az alsztring olyan sztring, amely a forrássztringből csak néhány karaktert tartalmaz. |
NormalizeDiacritics | Egy karakterlánc argumentumot igényel. Visszaadja a sztringet, de minden olyan ékezetes karakterrel, amely egyenértékű nem diakritikus karakterekre cserélődik. |
Nem | A forrás logikai értékének tükrözése. Ha a forrás értéke "Igaz", akkor a "False" értéket adja vissza. Ellenkező esetben a "True" (Igaz) értéket adja vissza. |
RemoveDuplicates | 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. |
Csere | Sztringen belüli értékeket cserél le. |
SelectUniqueValue | Legalább két argumentumot igényel, amelyek kifejezések használatával definiált egyedi értékgenerálási szabályok. A függvény kiértékeli az egyes szabályokat, majd ellenőrzi a létrehozott értéket a célalkalmazásban/könyvtárban az egyediség érdekében. |
SingleAppRoleAssignment | Egyetlen appRoleAssignment értéket ad vissza az adott alkalmazás felhasználóhoz rendelt összes appRoleAssignment listájából. |
Split | Egy sztringet többértékű tömbre osztja a megadott elválasztó karakter használatával. |
StringFromSID | A StringFromSid függvény egy biztonsági azonosítót tartalmazó bájttömböt sztringgé alakít át. |
StripSpaces | Eltávolítja az összes szóköz (" ") karaktert a forrássztringből. |
Switch | Ha a forrás értéke megegyezik egy kulccsal, az adott kulcs értékét adja vissza. |
ToLower | Egy forrássztring-értéket használ, és a megadott kulturális szabályokkal kisbetűssé alakítja. |
ToUpper | Egy forrássztring-értéket használ, és a megadott kulturális szabályokkal nagybetűssé alakítja. |
Berendezés | A Trim függvény eltávolítja a kezdő és záró szóközöket egy sztringből. |
Szó | 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. |
Hozzáfűzés
Funkció:
Hozzáfűzés(forrás, utótag)
Description:
Egy forrás sztringértéket vesz fel, és hozzáfűzi az utótagot a végéhez.
Paraméterek:
Név | Kötelező/ismétlődő | Típus szerint | Jegyzetek |
---|---|---|---|
Forrás | Szükséges | Sztring | Az attribútum neve általában a forrásobjektumból származik. |
Utótag | Szükséges | Sztring | A forrásérték végéhez hozzáfűzni kívánt sztring. |
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.
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.
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.
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)
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"
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
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.
FormatDateTime
Funkció:
FormatDateTime(forrás, inputFormat, outputFormat)
Description:
Egy dátumsztringet egy formátumból, majd egy másik formátumba konvertálja.
Paraméterek:
Név | Kötelező/ismétlődő | Típus szerint | Jegyzetek |
---|---|---|---|
Forrás | Szükséges | Sztring | Az attribútum neve általában a forrásobjektumból származik. |
inputFormat | Szükséges | Sztring | A forrásérték várt formátuma. A támogatott formátumokért lásd: /dotnet/standard/base-types/custom-date-and-time-format-strings. |
outputFormat | Szükséges | Sztring | A kimeneti dátum formátuma. |
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")
Evalues to 5
InStr("repEated","e",3,vbBinaryCompare)
Kiértékelése: 7
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.
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.
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.
Csatlakozás
Funkció:
Join(elválasztó, source1, source2, ...)
Description:
A Join() hasonló a Append() függvényhez, azzal a kivételrel, hogy több forrássztring-értéket egyesíthet egyetlen sztringben, és minden értéket elválasztó sztring választ el egymástól.
Ha a forrásértékek egyike többértékű attribútum, akkor az attribútum minden értéke össze lesz osztva az elválasztó értékkel.
Paraméterek:
Név | Kötelező/ismétlődő | Típus szerint | Jegyzetek |
---|---|---|---|
Elválasztó | Szükséges | Sztring | A forrásértékek elválasztására használt sztring, ha egy sztringbe vannak összefűzve. "" lehet, ha nincs szükség elválasztójelre. |
forrás1 ... sourceN | Kötelező, változó számú alkalommal | Sztring | Az összefűzendő sztringértékek. |
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 visszaadott érték.Joh
Mid
Funkció:
Közép(forrás, kezdés, hossz)
Description:
A forrásérték részszűkítését adja vissza. Az alsztring olyan sztring, amely a forrássztringből csak néhány karaktert tartalmaz.
Paraméterek:
Név | Kötelező/ismétlődő | Típus szerint | Jegyzetek |
---|---|---|---|
Forrás | Szükséges | Sztring | Általában az attribútum neve. |
start | Szükséges | egész szám | Index a forrássztringben , ahol a részsztringnek el kell kezdődnie. A sztring első karakterének indexe 1, a második karakter indexe 2, és így tovább. |
length (hossz) | Szükséges | egész szám | A részszúrás hossza. Ha a hossz a forrássztringen kívül ér véget, a függvény a kezdőindextőla forrássztring végéig visszaadja a részszúrást. |
NormalizeDiacritics
Funkció:
NormalizeDiacritics(forrás)
Description:
Egy karakterlánc argumentumot igényel. Visszaadja a sztringet, de minden olyan ékezetes karakterrel, amely egyenértékű nem diakritikus karakterekre cserélődik. Általában az ékezetes karaktereket (ékezetjeleket) tartalmazó utóneveket és vezetékneveket jogi értékekké alakítják, amelyek különböző felhasználói azonosítókban, például egyszerű felhasználónevekben, SAM-fióknevekben és e-mail-címekben használhatók.
Paraméterek:
Név | Kötelező/ismétlődő | Típus szerint | Jegyzetek |
---|---|---|---|
Forrás | Szükséges | Sztring | Általában egy utónév vagy vezetéknév attribútum. |
Not
Funkció:
Nem(forrás)
Description:
A forrás logikai értékének tükrözése. Ha a forrás értéke "Igaz", akkor a "False" értéket adja vissza. Ellenkező esetben a "True" (Igaz) értéket adja vissza.
Paraméterek:
Név | Kötelező/ismétlődő | Típus szerint | Jegyzetek |
---|---|---|---|
Forrás | Szükséges | Logikai sztring | A várt forrásértékek a "True" vagy a "False" (Hamis). |
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
Funkció:
Replace(source, oldValue, regexPattern, regexGroupName, replacementValue, replaceAttributeName, template)
Description:
Sztringen belüli értékeket cserél le. A megadott paraméterektől függően eltérően működik:
Az oldValue és a replacementValue megadásakor:
- A forrásban lévő oldValue összes előfordulását lecseréli a replaceValue értékre
Ha az oldValue és a sablon meg van adva:
- A sablonbanlévő oldValue összes előfordulását lecseréli a forrásértékre
RegexPattern és replacementValue megadása esetén:
- A függvény a regexPattern értéket alkalmazza a forrássztringre, és a regex csoportnevek használatával létrehozhatja a sztringet a csereértékhez
RegexPattern, regexGroupName, replacementValue esetén:
- A függvény a regexPattern értéket alkalmazza a forrássztringre, és lecseréli a regexGroupName értéknek megfelelő összes értéket a replaceValue értékre.
RegexPattern, regexGroupName, replacementAttributeName megadása esetén:
- Ha a forrás nem rendelkezik értékkel, a rendszer visszaadja a forrást
- Ha a forrás értéke van, a függvény a regexPattern értéket alkalmazza a forrássztringre, és a regexGroupName értéknek megfelelő összes értéket lecseréli a csereAttributeName értékre
Paraméterek:
Név | Kötelező/ismétlődő | Típus szerint | Jegyzetek |
---|---|---|---|
Forrás | Szükséges | Sztring | Az attribútum neve általában a forrásobjektumból származik. |
oldValue | Választható | Sztring | A forrásban vagy sablonban lecserélendő érték. |
regexPattern | Választható | Sztring | Regex minta a forrásban lecserélendő értékhez. Vagy a cserePropertyName használata esetén a cserePropertyName értékének kinyerésére szolgáló minta. |
regexGroupName | Választható | Sztring | A regexPatternben lévő csoport neve. Csak a cserePropertyName használata esetén nyerjük ki ennek a csoportnak az értékét csereÉrtékértékként a replacementPropertyName-ből. |
replacementValue | Választható | Sztring | Új érték, amellyel lecserélheti a régit. |
replacementAttributeName | Választható | Sztring | A csereértékhez használandó attribútum neve |
sablon | Választható | Sztring | Ha a sablon értéke meg van adva, megkeressük a sablonban lévő oldValue értéket, és lecseréljük a forrásértékre. |
SelectUniqueValue
Funkció:
SelectUniqueValue(uniqueValueRule1, uniqueValueRule2, uniqueValueRule3, ...)
Description:
Legalább két argumentumot igényel, amelyek kifejezések használatával definiált egyedi értékgenerálási szabályok. A függvény kiértékeli az egyes szabályokat, majd ellenőrzi a létrehozott értéket a célalkalmazásban/könyvtárban az egyediség érdekében. Az első egyedi érték a visszaadott érték lesz. Ha az összes érték már létezik a célban, a bejegyzést a rendszer törli, és az ok naplózásra kerül az auditnaplókban. Nincs felső határa a megadható argumentumok számának.
Megjegyzés:
- Ez egy legfelső szintű függvény, nem ágyazható be.
- Ez a függvény nem alkalmazható olyan attribútumokra, amelyek elsőbbséget élveznek.
- Ez a függvény csak bejegyzés-létrehozásokhoz használható. Ha attribútummal használja, állítsa a Leképezés alkalmazása tulajdonságot csak az objektum létrehozása során.
- Ez a függvény jelenleg csak a "Workday és SuccessFactors to Active Directory User Provisioning" esetében támogatott. Más kiépítési alkalmazásokkal nem használható.
Paraméterek:
Név | Kötelező/ismétlődő | Típus szerint | Jegyzetek |
---|---|---|---|
uniqueValueRule1 ... uniqueValueRuleN | Legalább 2 szükséges, nincs felső határ | Sztring | Az értékelendő egyedi értékgenerálási szabályok listája. |
SingleAppRoleAssignment
Funkció:
SingleAppRoleAssignment([appRoleAssignments])
Description:
Egyetlen appRoleAssignment értéket ad vissza az adott alkalmazás felhasználóhoz rendelt összes appRoleAssignment listájából. Ez a függvény az appRoleAssignments objektum egyetlen szerepkörnév-sztringgé alakításához szükséges. Vegye figyelembe, hogy az ajánlott eljárás annak biztosítása, hogy egyszerre csak egy appRoleAssignment legyen hozzárendelve egy felhasználóhoz, és ha több szerepkör van hozzárendelve, előfordulhat, hogy a visszaadott szerepkör-sztring nem kiszámítható.
Paraméterek:
Név | Kötelező/ismétlődő | Típus szerint | Jegyzetek |
---|---|---|---|
[appRoleAssignments] | Szükséges | Sztring | [appRoleAssignments] Objektum. |
Split
Funkció:
Felosztás(forrás, elválasztó)
Description:
Egy sztringet többértékű tömbre osztja a megadott elválasztó karakter használatával.
Paraméterek:
Név | Kötelező/ismétlődő | Típus szerint | Jegyzetek |
---|---|---|---|
Forrás | Szükséges | Sztring | forrásértéket kell frissíteni. |
Határoló | Szükséges | Sztring | A sztring felosztásához használt karaktert adja meg (példa: ",") |
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)
StripSpaces
Funkció:
StripSpaces(forrás)
Description:
Eltávolítja az összes szóköz (" ") karaktert a forrássztringből.
Paraméterek:
Név | Kötelező/ismétlődő | Típus szerint | Jegyzetek |
---|---|---|---|
Forrás | Szükséges | Sztring | forrásértéket kell frissíteni. |
Switch
Funkció:
Switch(source, defaultValue, key1, value1, key2, value2, ...)
Description:
Ha a forrás értéke megegyezik egy kulccsal, az adott kulcs értékét adja vissza. Ha a forrásérték nem egyezik a kulcsokkal, az alapértelmezett Érték értéket adja vissza. A kulcs - és értékparamétereknek mindig párban kell lenniük. A függvény mindig páros számú paramétert vár.
Paraméterek:
Név | Kötelező/ismétlődő | Típus szerint | Jegyzetek |
---|---|---|---|
Forrás | Szükséges | Sztring | Ellenőrizni kívánt forrásérték . |
defaultValue | Választható | Sztring | Alapértelmezett érték, amelyet akkor kell használni, ha a forrás nem egyezik a kulcsokkal. Lehet üres sztring (""). |
key | Szükséges | Sztring | A forrásérték összehasonlításának kulcsa. |
value | Szükséges | Sztring | A kulcsnak megfelelő forrás csereértéke. |
ToLower
Funkció:
ToLower(forrás, kultúra)
Description:
Egy forrássztring-értéket használ, és a megadott kulturális szabályokkal kisbetűssé alakítja. Ha nincs megadva kulturális információ, akkor invariáns kultúrát fog használni.
Paraméterek:
Név | Kötelező/ismétlődő | Típus szerint | Jegyzetek |
---|---|---|---|
Forrás | Szükséges | Sztring | Az attribútum neve általában a forrásobjektumból |
Kultúra | Választható | Sztring | Az RFC 4646-on alapuló kulturális név formátuma languagecode2-country/regioncode2, ahol a languagecode2 a kétbetűs nyelvi kód, a country/regioncode2 pedig a kétbetűs szubkultúrás kód. Ilyen például a ja-JP japán (Japán) és az en-US for English (Egyesült Államok). Ha nem áll rendelkezésre kétbetűs nyelvi kód, akkor az ISO 639-2-ből származó hárombetűs kódot kell használni. |
ToUpper
Funkció:
ToUpper(forrás, kultúra)
Description:
Egy forrássztring-értéket használ, és a megadott kulturális szabályokkal nagybetűssé alakítja. Ha nincs megadva kulturális információ, akkor invariáns kultúrát fog használni.
Paraméterek:
Név | Kötelező/ismétlődő | Típus szerint | Jegyzetek |
---|---|---|---|
Forrás | Szükséges | Sztring | Az attribútum neve általában a forrásobjektumból származik. |
Kultúra | Választható | Sztring | Az RFC 4646-on alapuló kulturális név formátuma languagecode2-country/regioncode2, ahol a languagecode2 a kétbetűs nyelvi kód, a country/regioncode2 pedig a kétbetűs szubkultúrás kód. Ilyen például a ja-JP japán (Japán) és az en-US for English (Egyesült Államok). Ha nem áll rendelkezésre kétbetűs nyelvi kód, akkor az ISO 639-2-ből származó hárombetűs kódot kell használni. |
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.
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
Példák
Ismert tartománynév csíkozása
A felhasználónév beszerzéséhez le kell vennie egy ismert tartománynevet a felhasználó e-mail-címéről.
Ha például a tartomány "contoso.com", akkor a következő kifejezést használhatja:
Kifejezés:
Replace([mail], "@contoso.com", , ,"", ,)
Mintabemenet/kimenet:
- INPUT (mail): "john.doe@contoso.com"
- KIMENET: "john.doe"
Állandó utótag hozzáfűzése a felhasználónévhez
Ha Salesforce tesztkörnyezetet használ, előfordulhat, hogy a szinkronizálás előtt hozzá kell fűznie egy további utótagot az összes felhasználónévhez.
Kifejezés:
Append([userPrincipalName], ".test")
Minta bemenet/kimenet:
- BEMENET: (userPrincipalName): "John.Doe@contoso.com"
- KIMENET: "John.Doe@contoso.com.test"
Felhasználói alias létrehozása az utónév és a vezetéknév egyes részeinek összefűzésével
Létre kell hoznia egy felhasználói aliast a felhasználó vezetéknevének első 3 betűje és a felhasználó vezetéknevének első 5 betűje alapján.
Kifejezés:
Append(Mid([givenName], 1, 3), Mid([surname], 1, 5))
Minta bemenet/kimenet:
- INPUT (givenName): "John"
- INPUT (vezetéknév): "Doe"
- KIMENET: "JohDoe"
Mellékjelek eltávolítása sztringből
Az ékezetjeleket tartalmazó karaktereket olyan egyenértékű karakterekre kell cserélni, amelyek nem tartalmaznak jelölőjeleket.
Kifejezés:
NormalizeDiacritics([givenName])
Minta bemenet/kimenet:
- INPUT (givenName): "Zoë"
- KIMENET: "Zoe"
Sztring felosztása többértékű tömbre
A sztringek vesszővel tagolt listáját kell felvennie, és fel kell osztania őket egy tömbre, amely csatlakoztatható egy többértékű attribútumhoz, például a Salesforce PermissionSets attribútumához. Ebben a példában a Microsoft Entra ID-ban az ExtensionAttribute5 kiterjesztésben ki lett töltve egy engedélykészletek listája.
Kifejezés:
Split([extensionAttribute5]; ";")
Minta bemenet/kimenet:
- INPUT (extensionAttribute5): "PermissionSetOne, PermissionSetTwo"
- KIMENET: ["PermissionSetOne", "PermissionSetTwo"]
Kimeneti dátum sztringként egy adott formátumban
Dátumokat szeretne küldeni egy SaaS-alkalmazásnak egy bizonyos formátumban.
Például a ServiceNow dátumait szeretné formázni.
Kifejezés:
FormatDateTime([extensionAttribute1], "yyyyMMddHHmmss.fZ", "yyyy-MM-dd")
Minta bemenet/kimenet:
- INPUT (extensionAttribute1): "20150123105347.1Z"
- KIMENET: "2015-01-23"
Érték cseréje előre definiált beállítások alapján
Meg kell határoznia a felhasználó időzónáját a Microsoft Entra ID azonosítójában tárolt állapotkód alapján.
Ha az állapotkód nem felel meg az előre definiált beállítások egyikének sem, használja az "Ausztrália/Sydney" alapértelmezett értékét.
Kifejezés:
Switch([state], "Australia/Sydney", "NSW", "Australia/Sydney","QLD", "Australia/Brisbane", "SA", "Australia/Adelaide")
Minta bemenet/kimenet:
- INPUT (state): "QLD"
- KIMENET: "Ausztrália/Brisbane"
Karakterek cseréje normál kifejezéssel
Meg kell keresnie a normál kifejezésértéknek megfelelő karaktereket, és el kell távolítania őket.
Kifejezés:
Replace([mailNickname], ; "[a-zA-Z_]*", , "", , )
Minta bemenet/kimenet:
- INPUT (mailNickname: "john_doe72"
- KIMENET: "72"
Generált userPrincipalName (UPN) érték konvertálása kisbetűssé
Az alábbi példában az UPN-érték a PreferredFirstName és a PreferredLastName forrásmező összefűzésével jön létre, a ToLower függvény pedig a létrehozott sztringen működik, hogy az összes karaktert kisbetűssé konvertálja.
ToLower(Join("@", NormalizeDiacritics(StripSpaces(Join(".", [PreferredFirstName], [PreferredLastName]))), "contoso.com"))
Minta bemenet/kimenet:
- INPUT (PreferredFirstName): "John"
- INPUT (PreferredLastName): "Smith"
- KIMENET: "john.smith@contoso.com"
Egyedi érték létrehozása a userPrincipalName (UPN) attribútumhoz
A felhasználó utóneve, középső neve és vezetékneve alapján létre kell hoznia egy értéket az UPN attribútumhoz, és ellenőriznie kell annak egyediségét a cél AD-címtárban, mielőtt hozzárendeli az értéket az UPN attribútumhoz.
Kifejezés:
SelectUniqueValue(
Join("@", NormalizeDiacritics(StripSpaces(Join(".", [PreferredFirstName], [PreferredLastName]))), "contoso.com"),
Join("@", NormalizeDiacritics(StripSpaces(Join(".", Mid([PreferredFirstName], 1, 1), [PreferredLastName]))), "contoso.com"),
Join("@", NormalizeDiacritics(StripSpaces(Join(".", Mid([PreferredFirstName], 1, 2), [PreferredLastName]))), "contoso.com")
)
Minta bemenet/kimenet:
- INPUT (PreferredFirstName): "John"
- INPUT (PreferredLastName): "Smith"
- KIMENET: "John.Smith@contoso.com", ha az John.Smith@contoso.com UPN értéke még nem létezik a könyvtárban
- KIMENET: "J.Smith@contoso.com" ha már létezik UPN-érték John.Smith@contoso.com a könyvtárban
- KIMENET: "Jo.Smith@contoso.com" ha a fenti két UPN-érték már létezik a könyvtárban
További lépések
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: