Hivatkozás attribútumleképezések kifejezéseinek írásához a Microsoft Entra ID-ban

  • Cikk

Ha saaS-alkalmazáshoz konfigurálja a kiépítést, az attribútumleképezések egyik típusa a kifejezésleképezés. Ezekhez a leképezésekhez olyan szkriptszerű kifejezést kell írnia, amely lehetővé teszi a felhasználók adatainak az SaaS-alkalmazás számára elfogadhatóbb formátumokká való átalakítását.

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ények szempontjából kell definiálni, amelyek egy névből állnak, amelyet zárójelben lévő argumentumok követnek: FunctionName(<<argument 1>>;<<argument N>>)

  • Függvényeket egymásba ágyazhat. Például: FunctionOne(FunctionTwo(<<argument1>>))

  • Három különböző típusú argumentumot adhat át a függvényeknek:

    1. Attribútumok, amelyeket szögletes zárójelek közé kell tenni. Például: [attributeName]
    2. Sztringállandók, amelyeket idézőjelek közé kell tenni. Például: "Egyesült Államok"
    3. 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\""

  • A szintaxis megkülönbözteti a kis- és nagybetűket, amelyeket sztringekként kell begépelni egy függvénybe, és közvetlenül innen kell beilleszteni őket.

Függvények listája

AppendAppRoleAssignmentsComplexBitAndCBoolCDateCoalesceConvertToBase64ConvertToUTF8HexCountCStrDateAddDateDiffDateFromNumFormatDateTimeGuidIgnoreFlowIfNullOrEmptyIIFInStrIsNull IsNullOrEmptyIsPresentIsStringElemillesztésbalközépenNormalizeDiacriticsNotNowNumFromDatePCaseRandomStringRedactRemoveDuplicatesReplaceSelectUniqueValueSingleAppRoleAssignmentSplitStripSpacesSwitchToLowerToUpper Word

Hozzáfűzés

Függvény: Hozzáfűzés(forrás, utótag)

Leírás: 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.

Állandó utótag hozzáfűzése a felhasználónévhez

Példa: Ha Salesforce tesztkörnyezetet használ, előfordulhat, hogy a szinkronizálás előtt hozzá kell fűznie egy másik utótagot az összes felhasználónevehöz.

Kifejezés:Append([userPrincipalName], ".test")

Minta bemenet/kimenet:

  • BEMENET: (userPrincipalName): "John.Doe@contoso.com"
  • KIMENET: "John.Doe@contoso.com.test"

AppRoleAssignmentsComplex

Függvény: AppRoleAssignmentsComplex([appRoleAssignments])

Leírás: Több szerepkör konfigurálására szolgál egy felhasználó számára. A részletes használatért tekintse meg a Microsoft Entra ID-ban található SaaS-alkalmazások felhasználói kiépítési attribútumleképezéseinek testreszabása című oktatóanyagot.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
[appRoleAssignments] Szükséges Sztring [appRoleAssignments] Objektum.

BitAnd

Függvény: BitAnd(érték1; érték2)

Leírás: 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.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
érték1 Szükséges Szám Numerikus érték, amelyet az AND érték2 értékkel kell megadni
érték2 Szükséges Szám Számérték, amelyet az AND érték1 értékkel kell megadni

Példa:BitAnd(&HF, &HF7)

11110111 ÉS 00000111 = 00000111 így BitAnd 7 értéket ad vissza, a 00000111 bináris értékét.

CBool

Funkció:CBool(Expression)

Leírás:CBool egy logikai értéket ad vissza a kiértékelt kifejezés alapján. Ha a kifejezés nem nulla értéket ad vissza, akkor CBool Igaz értéket ad vissza, máskülönben Hamis értéket ad vissza.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Kifejezés Szükséges Kifejezés Bármely érvényes kifejezés

Példa:CBool([attribute1] = [attribute2])
Igaz értéket ad vissza, ha mindkét attribútum értéke megegyezik.

CDate

Funkció:
CDate(expression)

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, de olyan dátumfüggvények között használható, mint a FormatDateTime és a DateAdd.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Kifejezés Szükséges Kifejezés Bármely érvényes sztring, amely dátumot/időt jelöl. A támogatott formátumokért tekintse meg a .NET egyéni dátum- és időformátum-sztringeket.

Megjegyzések:
A visszaadott sztring mindig UTC-ben van, és az M/d/yyy h:mm:ss tt formátumot követi.

1. példa:
CDate([StatusHireDate])
Minta bemenet/kimenet:

  • INPUT (StatusHireDate): "2020-03-16-07:00"
  • KIMENET: "2020. 03. 16. 07:00:00" <– Figyelje meg, hogy a fenti DateTime utc-megfelelője lesz visszaadva

2. példa:
CDate("2021-06-30+08:00")
Minta bemenet/kimenet:

  • BEMENET: "2021-06-30+08:00"
  • KIMENET: "2021.06.29. 16:00:00" <– Figyelje meg, hogy a fenti DateTime utc megfelelője lesz visszaadva

3. példa:
CDate("2009-06-15T01:45:30-07:00")
Minta bemenet/kimenet:

  • BEMENET: "2009-06-15T01:45:30-07:00"
  • KIMENET: "2009.06.15. 08:45:30" <– Figyelje meg, hogy a fenti DateTime utc-ekvivalensét adja vissza

Coalesce

Függvény: Coalesce(source1; source2; ..., defaultValue)

Leírás: Az első forrásértéket adja vissza, amely nem NULL. Ha minden argumentum NULL értékű, és a defaultValue jelen van, a rendszer az alapértelmezett Érték értéket adja vissza. Ha minden argumentum NULL értékű, és a defaultValue nem jelenik meg, a Coalesce null értéket ad vissza.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
forrás1 ... sourceN Szükséges Sztring Kötelező, változó számú alkalommal. Az attribútum neve általában a forrásobjektumból származik.
defaultValue Választható Sztring Alapértelmezett érték, amelyet akkor kell használni, ha az összes forrásérték NULL. Lehet üres sztring ("").

Flow mail value if not NULL, egyébként flow userPrincipalName

Példa: Ha jelen van, a levelezési attribútumot szeretné átfolyni. Ha nem, akkor inkább a userPrincipalName értékét szeretné átfolyni.

Kifejezés:Coalesce([mail],[userPrincipalName])

Minta bemenet/kimenet:

  • BEMENET (e-mail): NULL
  • INPUT (userPrincipalName): "John.Doe@contoso.com"
  • KIMENET: "John.Doe@contoso.com"

ConvertToBase64

Függvény: ConvertToBase64(forrás)

Leírás: A ConvertToBase64 függvény unicode base64 sztringgé konvertál egy sztringet.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Forrás Szükséges Sztring A 64-es alapra konvertálandó sztring

Példa:ConvertToBase64("Hello world!")

A "SABlAGwAbABvACAAdwBvAHIAbABkACEA" értéket adja vissza

ConvertToUTF8Hex

Függvény: ConvertToUTF8Hex(forrás)

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

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Forrás Szükséges Sztring UTF8 hexává konvertálandó sztring

Példa:ConvertToUTF8Hex("Hello world!")

A 48656C6C6F20776F726C6421 értéket adja vissza

Gróf

Függvény: Darabszám(attribútum)

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

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Attribútum Szükséges attribútum Többértékű attribútum, amely az elemeket megszámolja

CStr

Függvény: CStr(érték)

Leírás: A CStr függvény egy értéket sztring adattípussá alakít át.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
value Szükséges numerikus, hivatkozási vagy logikai Lehet numerikus érték, referenciaattribútum vagy logikai érték.

Példa:CStr([dn])

A "cn=Joe,dc=contoso,dc=com" értéket adja vissza.

DateAdd

Funkció:
DateAdd(interval, value, dateTime)

Leírás:
Egy dátum/idő sztringet ad vissza, amely egy megadott időintervallum hozzáadásának dátumát jelöli. A visszaadott dátum formátuma: M/d/yyyyy h:mm:ss tt.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
interval Szükséges Sztring A hozzáadni kívánt időintervallum. Lásd a táblázat alatti elfogadott értékeket.
value Szükséges Szám 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).
Datetime Szükséges Dátum/idő Dátum/idő, amely az időköz hozzáadásának dátumát jelöli.

Ha dátumsztringet ad át bemenetként, használja a CDate függvényt a datetime sztring körbefuttatásához. A rendszeridő UTC-ben való lekéréséhez használja a Now függvényt.

Az intervallumsztringnek az alábbi értékek egyikével kell rendelkeznie:

  • yyyy year
  • m hónap
  • d nap
  • ww hét
  • h Óra
  • n perc
  • s második

1. példa: Dátumérték létrehozása a bejövő StatusHireDate alapján a Workdayből
DateAdd("d", 7, CDate([StatusHireDate]))

Példa interval Érték dateTime (a StatusHireDate változó értéke) output
7 nap hozzáadása a felvétel dátumához "d" 7 2012-03-16-07:00 2012.03.23. 07:00:00
Dátum lekérése tíz nappal a felvétel dátuma előtt "d" -10 2012-03-16-07:00 2012.03.06. 07:00:00
Két hét hozzáadása a felvétel dátumához "ww" 2 2012-03-16-07:00 2012.03.30. 07:00:00
10 hónap hozzáadása a felvétel dátumához "m" 10 2012-03-16-07:00 2013.01.16. 07:00:00
Két év hozzáadása a felvétel dátumához "yyyy" 2 2012-03-16-07:00 2014.03.16. 07:00:00

Datediff

Funkció:
DateDiff(interval, date1, date2)

Leírás:
Ez a függvény az intervallum paraméterrel a két bemeneti dátum közötti különbséget jelző számot adja vissza. Visszaadja

  • pozitív szám, ha dátum2 > dátum1,
  • negatív szám, ha dátum2 < dátum1,
  • 0 ha dátum2 == dátum1

Paraméterek:

Név Kötelező/nem kötelező Típus szerint Jegyzetek
interval Szükséges Sztring A különbség kiszámításához használandó időintervallum.
dátum1 Szükséges Dátum/idő Dátum/idő érvényes dátumot jelöl.
dátum2 Szükséges Dátum/idő Dátum/idő érvényes dátumot jelöl.

Ha dátumsztringet ad át bemenetként, használja a CDate függvényt a datetime sztring körbefuttatásához. A rendszeridő UTC-ben való lekéréséhez használja a Now függvényt.

Az intervallumsztringnek az alábbi értékek egyikével kell rendelkeznie:

  • yyyy year
  • m hónap
  • d nap
  • ww hét
  • h Óra
  • n perc
  • s második

1. példa: Az aktuális dátum és a workday-beli felvételi dátum összehasonlítása különböző időközökkel
DateDiff("d", Now(), CDate([StatusHireDate]))

Példa interval date1 date2 output
Pozitív különbség a napok között két dátum között d 2021-08-18+08:00 2021-08-31+08:00 13
Negatív különbség a napok között két dátum között d 2021. 08. 25. 17:41:18 2012-03-16-07:00 -3449
Két dátum közötti hetek közötti különbség ww 2021. 08. 25. 17:41:18 2012-03-16-07:00 -493
Két dátum közötti hónapok közötti különbség p 2021. 08. 25. 17:41:18 2012-03-16-07:00 -113
Két dátum közötti évek közötti különbség Éééé 2021. 08. 25. 17:41:18 2012-03-16-07:00 -9
Különbség, ha mindkét dátum azonos d 2021-08-31+08:00 2021-08-31+08:00 0
Két dátum közötti óraeltolódás ó 2021-08-24 2021-08-25 24
Percek különbsége két dátum között n 2021-08-24 2021-08-25 1440
Két dátum közötti különbség másodpercben s 2021-08-24 2021-08-25 86400

2. példa: A DateDiff és az IIF függvény kombinálása attribútumérték beállításához
Ha egy fiók aktív a Workdayben, csak akkor állítsa a felhasználó accountEnabled attribútumát True (Igaz) értékre, ha a kölcsönzés dátuma a következő öt napon belül van.

Switch([Active], , 
  "1", IIF(DateDiff("d", Now(), CDate([StatusHireDate])) > 5, "False", "True"), 
  "0", "False")

DateFromNum

Függvény: DateFromNum(érték)

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

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
value Szükséges Dátum Dátum/idő típusúvá konvertálandó AD-dátum

Példa:DateFromNum([lastLogonTimestamp])

DateFromNum(129699324000000000)

2012. január 1-jét 11:00-kor jelölő DateTime értéket ad vissza.

FormatDateTime

Függvény: FormatDateTime(forrás, dateTimeStyles, inputFormat, outputFormat)

Leírás: Egy dátumsztringet egy formátumból készít, és egy másik formátumba alakítja át.

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.
dateTimeStyles Választható Sztring Ezzel a paraméterrel megadhatja azokat a formázási beállításokat, amelyek bizonyos dátum- és időelemzési metódusokhoz testre szabják a sztring elemzését. A támogatott értékekért tekintse meg a DateTimeStyles dokumentumot. Ha üres marad, a használt alapértelmezett érték a DateTimeStyles.RoundtripKind, DateTimeStyles.AllowLeadingWhite, DateTimeStyles.AllowTrailingWhite
inputFormat Szükséges Sztring A forrásérték várt formátuma. A támogatott formátumokat a .NET egyéni dátum- és időformátum-sztringjeiben talál.
outputFormat Szükséges Sztring A kimeneti dátum formátuma.

Kimeneti dátum sztringként egy adott formátumban

Példa: Dátumokat szeretne küldeni egy SaaS-alkalmazásnak, például a ServiceNow-nak egy bizonyos formátumban. A következő kifejezést használhatja.

Kifejezés:

FormatDateTime([extensionAttribute1], , "yyyyMMddHHmmss.fZ", "yyyy-MM-dd")

Minta bemenet/kimenet:

  • INPUT (extensionAttribute1): "20150123105347.1Z"
  • KIMENET: "2015-01-23"

GUID

Függvény: Guid()

Leírás: A guid függvény új véletlenszerű GUID-t hoz létre

Példa:
Guid()
Mintakimenet: "1088051a-cd4b-4288-84f8-e02042ca72bc"

IgnoreFlowIfNullOrEmpty

Függvény: IgnoreFlowIfNullOrEmpty(kifejezés)

Leírás: Az IgnoreFlowIfNullOrEmpty függvény arra utasítja a kiépítési szolgáltatást, hogy hagyja figyelmen kívül az attribútumot, és dobja el a folyamatból, ha a zárt függvény vagy attribútum NULL vagy üres.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Kifejezés Szükséges Kifejezés Kiértékelendő kifejezés

1. példa: Ne áramoljon attribútum, ha null értékű
IgnoreFlowIfNullOrEmpty([department])
A fenti kifejezés elveti a részlegattribútumot a kiépítési folyamatból, ha null értékű vagy üres.

2. példa: Ne áramoljon attribútum, ha a kifejezésleképezés üres sztringet vagy null értéket ad vissza
Tegyük fel, hogy a SuccessFactors attribútum előtagja a helyi Active Directory personalTitle attribútumra van leképezve a következő kifejezésleképezéssel:
IgnoreFlowIfNullOrEmpty(Switch([prefix], "", "3443", "Dr.", "3444", "Prof.", "3445", "Prof. Dr."))
A fenti kifejezés először kiértékeli a Switch függvényt. Ha az előtagattribútum nem tartalmazza a Kapcsoló függvényben felsorolt értékeket, a Switch egy üres sztringet ad vissza, és a personalTitle attribútum nem lesz belefoglalva a helyi Active Directory kiépítési folyamatába.

IIF

Függvény: IIF(condition;valueIfTrue;valueIfFalse)

Leírás: Az IIF függvény egy adott feltételen alapuló lehetséges értékek egyikét adja vissza.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Feltétel Szükséges Változó vagy kifejezés Bármely érték vagy kifejezés, amely igaz vagy hamis értékre értékelhető ki.
valueIfTrue Szükséges Változó vagy sztring Ha a feltétel értéke igaz, a visszaadott érték.
valueIfFalse Szükséges Változó vagy sztring Ha a feltétel értéke hamis, akkor a visszaadott érték.

A feltételben a következő összehasonlító operátorok használhatók:

  • Egyenlő (=) és nem egyenlő (<>)
  • Nagyobb mint (>) és nagyobb, mint egyenlő (>=)
  • Kisebb mint (<) és kisebb, mint egyenlő (<=)

Példa: Állítsa a célattribútum értékét forrás ország attribútumra, ha country="USA", máskülönben állítsa a célattribútum értékét a forrásosztály attribútumára. IIF([country]="USA",[country],[department])

Ismert korlátozások

Ez a szakasz az IIF-függvényre vonatkozó korlátozásokat és kerülő megoldásokat tartalmazza. A felhasználólétrehozási problémák elhárításáról további információt a null/üres értékek miatti létrehozás meghiúsulása című témakörben talál.

  • Az IIF függvény jelenleg nem támogatja az AND és OR logikai operátorokat.
  • Az AND logika implementálásához használja a trueValue elérési út mentén láncolt beágyazott IIF-utasítást. Példa: Ha country="USA" és state="CA", akkor a "True" értéket adja vissza, más esetben a "False" értéket. IIF([country]="USA",IIF([state]="CA","True","False"),"False")
  • Az OR logika implementálásához használja a falseValue elérési út mentén láncolt beágyazott IIF-utasítást. Példa: Ha country="USA" vagy state="CA", akkor a "True" értéket adja vissza, más esetben a "False" értéket. IIF([country]="USA","True",IIF([state]="CA","True","False"))
  • Ha az IIF függvényben használt forrásattribútum üres vagy null értékű, a feltétel ellenőrzése sikertelen.
    • Nem támogatott IIF-kifejezési példák:
      • IIF([country]="","Other",[country])
      • IIF(IsNullOrEmpty([country]),"Other",[country])
      • IIF(IsPresent([country]),[country],"Other")
    • Javasolt áthidaló megoldás: A Kapcsoló függvénnyel ellenőrizze az üres/null értékeket. Példa: Ha az országattribútum üres, állítsa be az "Egyéb" értéket. Ha jelen van, adja át az országattribútum értékét a célattribútumnak.
      • Switch([country],[country],"","Other")

InStr

Függvény: InStr(value1, value2, start, compareType)

Leírás: Az InStr függvény megkeresi egy sztringben az alsztring első előfordulását

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
érték1 Szükséges Sztring Keresendő sztring
érték2 Szükséges Sztring A keresett sztring
start Választható Egész Az alsztring megkeresésének kezdőpozíciója
compareType Választható Enum Lehet vbTextCompare vagy vbBinaryCompare

Példa:InStr("The quick brown fox","quick")

Kiértékelése: 5

InStr("repEated","e",3,vbBinaryCompare)

Kiértékelése: 7

IsNull

Függvény: IsNull(Kifejezés)

Leírás: Ha a kifejezés null értékű, akkor az IsNull függvény igaz értéket ad vissza. Egy attribútum esetében a null értéket az attribútum hiánya fejezi ki.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Kifejezés Szükséges Kifejezés Kiértékelendő kifejezés

Példa:IsNull([displayName])

Igaz értéket ad vissza, ha az attribútum nem található.

IsNullorEmpty

Függvény: IsNullOrEmpty(Kifejezés)

Leírás: Ha a kifejezés null vagy üres sztring, akkor az IsNullOrEmpty függvény igaz értéket ad vissza. 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.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Kifejezés Szükséges Kifejezés Kiértékelendő kifejezés

Példa:IsNullOrEmpty([displayName])

Igaz értéket ad vissza, ha az attribútum nem található, vagy üres sztring.

IsPresent

Függvény: IsPresent(Kifejezés)

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. Ennek a függvénynek az inverze isNullOrEmpty.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Kifejezés Szükséges Kifejezés Kiértékelendő kifejezés

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

IsString

Függvény: IsString(Kifejezés)

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.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Kifejezés Szükséges Kifejezés Kiértékelendő kifejezés

Tétel

Függvény: Item(attribútum, index)

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

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Attribútum Szükséges Attribútum Keresendő többértékű attribútum
Index Szükséges Egész Indexelés egy elemhez a többértékű sztringben

Példa:Item([proxyAddresses], 1) a többértékű attribútum első elemét adja vissza. A 0 indexet nem szabad használni.

Csatlakozás

Függvény: Join(elválasztó, source1, source2, ...)

Leírás: A Join() hasonló az 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.

Bal

Függvény: Left(Sztring; NumChars)

Leírás: A Bal függvény megadott számú karaktert ad vissza egy sztring bal oldalán. 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).

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Sztring Szükséges Attribútum Az a sztring, amelyből karaktereket ad vissza
NumChars Szükséges Egész A sztring elejéről (balról) visszaadandó karakterek számát azonosító szám

Példa:Left("John Doe", 3)

A "Joh" értéket adja vissza.

Mid

Függvény: Közép(forrás, kezdés, hossz)

Leírás: A forrásérték részszúrá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 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 A részszúrás hossza. Ha a hossz a forrássztringen kívül végződik, a függvény a kezdő indextől a forrássztring végéig visszafelé tartó részsztringet ad vissza.

NormalizeDiacritics

Függvény: NormalizeDiacritics(source)

Leírás: Egy karakterlánc argumentumot igényel. Visszaadja a sztringet, de az esetleges ékezetes karaktereket egyenértékű nemdiakritikus karakterekre cseréli. Á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.
Karakter diakritikussal Normalizált karakter Karakter diakritikussal Normalizált karakter
ä, à, â, ã, å, á, ą, ă, ā, ā́, ā̀, ā̂, ā̃, ǟ, ā̈, ǡ, a̱, å̄ a Ä, À, Â, Ã, Å, Á, Ą, Ă, Ā, Ā́, Ā̀, Ā̂, Ā̃, Ǟ, Ā̈, Ǡ, A̱, Å̄ A
æ, ǣ Ae Æ, Ǣ AE
ç, č, ć, c̄, c̱ c Ç, Č, Ć, C̄, C̱ K
ď, d̄, ḏ d Ď, D̄, Ḏ T
ë, è, é, ê, ę, ě, ė, ē, ḗ, ḕ, ē̂, ē̃, ê̄, e̱, ë̄, e̊̄ e Ë, È, É, Ê, Ę, Ě, Ė, Ē, Ḗ, Ḕ, Ē̂, Ē̃, Ê̄, E̱, Ë̄, E̊̄ E
ğ, ḡ, g̱ g Ğ, Ḡ, G̱ G
ï, î, ì, í, ı, ī, ī́, ī̀, ī̂, ī̃, i̱ i Ï, Î, Ì, Í, İ, Ī, Ī́, Ī̀, Ī̂, Ī̃, I̱ d
ľ, ł, l̄, ḹ, ḻ l Ł, Ľ, L̄, Ḹ, Ḻ L
ñ, ń, ň, n̄, ṉ n Ñ, Ń, Ň, N̄, Ṉ N
ö, ò, ő, õ, ô, ó, ō, ṓ, ṑ, ō̂, ō̃, ȫ, ō̈, ǭ, ȭ, ȱ, o̱ o Ö, Ò, Ő, Õ, Ô, Ó, Ō, Ṓ, Ṑ, Ō̂, Ō̃, Ȫ, Ō̈, Ǭ, Ȭ, Ȱ, O̱ O
ø, ø̄, œ̄ Oe Ø, Ø̄, Œ̄ OE
ř, r̄, ṟ, ṝ r Ř, R̄, Ṟ, Ṝ R
ß Ss
š, ś, ș, ş, s̄, s̱ s Š, Ś, Ș, Ş, S̄, S̱ V
ť, ț, t̄, ṯ t Ť, Ț, T̄, Ṯ T
ü, ù, û, ú, ů, ű, ū, ū́, ū̀, ū̂, ū̃, u̇̄, ǖ, ṻ, ṳ̄, u̱ u Ü, Ù, Û, Ú, Ů, Ű, Ū, Ū́, Ū̀, Ū̂, Ū̃, U̇̄, Ǖ, Ṻ, Ṳ̄, U̱ U
ÿ, ý, ȳ, ȳ́, ȳ̀, ȳ̃, y̱ y Ÿ, Ý, Ȳ, Ȳ́, Ȳ̀, Ȳ̃, Y̱ I
ź, ž, ż, z̄, ẕ z Ź, Ž, Ż, Z̄, Ẕ Z

Mellékjelek eltávolítása sztringből

Példa: Az ékezetes karaktereket tartalmazó karaktereket cserélje le olyan egyenértékű karakterekre, amelyek nem tartalmaznak jelölőjeleket.

Kifejezés: NormalizeDiacritics([givenName])

Minta bemenet/kimenet:

  • INPUT (givenName): "Zoë"
  • KIMENET: "Zoe"

Nem

Függvény: Nem(forrás)

Leírás: A forrás logikai értékének tükrözése. Ha a forrás értéke Igaz, hamis értéket ad vissza. Ellenkező esetben igaz értéket ad 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).

Most

Függvény: Now()

Leírás:
A Most függvény egy sztringet ad vissza, amely az aktuális UTC DateTime értéket jelöli M/d/yyyy h:mm:ss tt formátumban.

Példa:Now()
Példaérték visszaadva 2021. 07. 02. 15:33:38

NumFromDate

Függvény: NumFromDate(érték)

Leírás: A NumFromDate függvény a DateTime értéket Active Directory-formátummá alakítja, amely az olyan attribútumok beállításához szükséges, mint az accountExpires. Ezzel a függvénnyel konvertálhatja a felhőbeli HR-alkalmazásokból( például a Workdayből és a SuccessFactorsből) kapott DateTime-értékeket a megfelelő AD-megjelenítésre.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
value Szükséges Sztring Dátum-idő sztring ISO 8601 formátumban. Ha a dátumváltozó más formátumban van, a FormatDateTime függvény használatával konvertálja a dátumot ISO 8601 formátumra.

Példa:

  • Workday-példa Feltéve, hogy a ContractEndDate attribútumot a Workdayből szeretné leképezni, amely 2020-12-31-08:00formátumban van az AD AccountExpires mezőjében, az alábbi módon használhatja ezt a függvényt, és módosíthatja az időzóna eltolását a területi beállításnak megfelelően. NumFromDate(Join("", FormatDateTime([ContractEndDate], ,"yyyy-MM-ddzzz", "yyyy-MM-dd"), " 23:59:59-08:00"))

  • SuccessFactors-példa Feltéve, hogy le szeretné képezni az endDate attribútumot a SuccessFactorsból, amely M/d/yyy hh:mm:ss tt to accountExpires mező az AD-ben, az alábbi módon használhatja ezt a függvényt, és módosíthatja az időzóna eltolását a területi beállításnak megfelelően. NumFromDate(Join("",FormatDateTime([endDate], ,"M/d/yyyy hh:mm:ss tt","yyyy-MM-dd")," 23:59:59-08:00"))

PCase

Függvény: PCase(forrás, wordSeparators)

Leírás: A PCase függvény a sztringben szereplő egyes szavak első karakterét nagybetűssé alakítja, a többi karaktert pedig kisbetűssé alakítja.

Paraméterek:

Név Kötelező/nem kötelező Típus szerint Jegyzetek
Forrás Szükséges Sztring forrásérték a megfelelő esetté alakításához.
wordSeparators Választható Sztring Adjon meg egy olyan karakterkészletet, amelyet szóelválasztóként használnak (például: " ,-'")

Megjegyzések:

  • Ha a wordSeparators paraméter nincs megadva, akkor a PCase belsőleg meghívja a .NET függvényt ToTitleCase-ra , hogy a forrássztringet megfelelő esetté konvertálja. A .NET ToTitleCase függvény támogatja a Unicode-karakterkategóriák szóelválasztóként való átfogó készletét.
    • Szóköz karakter
    • Új vonal karakter
    • Vezérlőkarakterek , például CRLF
    • Vezérlőkarakterek formázása
    • Csatlakozás orPunctuation karakterek, például aláhúzásjel
    • DashPunctuation karakterek, például kötőjel és kötőjel (beleértve az olyan karaktereket, mint az En Dash, Em Dash, dupla kötőjel stb.)
    • OpenPunctuation és ClosePunctuation karakterek, amelyek olyan párokban fordulnak elő, mint a zárójel, a szögletes zárójel, a szögletes zárójel stb.
    • InitialQuotePunctuation és FinalQuotePunctuation karakterek, például egyszeri idézőjelek, dupla idézőjelek és szögletes idézőjelek.
    • Egyéb írásjelek , például felkiáltójel, számjel, százalékjel, ampersand, csillag, vessző, teljes leállítás, kettőspont, pontosvessző stb.
    • MathSymbol karakterek, mint a pluszjel, kisebb és nagyobb, mint jel, függőleges vonal, tilde, egyenlő jel, stb.
    • CurrencySymbol karakterek, mint a dollárjel, cent jel, font jel, euró jel, stb.
    • ModifierSymbol karakterek, például macron, ékezetek, nyílfejek stb.
    • EgyébSymbol karakterek, mint a szerzői jogi jel, fokjel, regisztrált jel, stb.
  • Ha a wordSeparators paraméter meg van adva, akkor a PCase csak a szóelválasztóként megadott karaktereket használja.

Példa:

Tegyük fel, hogy a firstName és a lastName attribútumokat az SAP SuccessFactorstól származtatja, a HR-ben pedig mindkét attribútum nagybetűs. A PCase függvénnyel a nevet megfelelő kisbetűssé alakíthatja az alábbiak szerint.

Kifejezés Bevitel Hozam Jegyzetek
PCase([firstName]) firstName = "PABLO GONSALVES (Standard kiadás COND)" "Pablo Gonsalves (Második)" Mivel a wordSeparators paraméter nincs megadva, a PCase függvény az alapértelmezett szóelválasztó karakterkészletet használja.
PCase([lastName]," '-") lastName = "PINTO-DE'SILVA" "Pinto-De'Silva" A PCase függvény a wordSeparators paraméterben szereplő karaktereket használja a szavak azonosításához és megfelelő esetté alakításához.
PCase(Join(" ",[firstName],[lastName])) firstName = GREGORY, lastName = "JAMES" "Gregory James" Az Illesztés függvényt a PCaseben ágyazhatja be. Mivel a wordSeparators paraméter nincs megadva, a PCase függvény az alapértelmezett szóelválasztó karakterkészletet használja.

RandomString

Függvény: RandomString(Length, MinimumNumbers, MinimumSpecialCharacters, MinimumCapital, MinimumLowerCase, CharactersToAvoid)

Leírás: A RandomString függvény véletlenszerű sztringet hoz létre a megadott feltételek alapján. Itt azonosíthatók az engedélyezett karakterek.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Hossz Szükséges Szám A véletlenszerű sztring teljes hossza. Ennek nagyobbnak vagy egyenlőnek kell lennie a MinimumNumbers, a MinimumSpecialCharacters és a MinimumCapital összegénél. Legfeljebb 256 karakter.
Minimális számértékek Szükséges Szám Minimális számok a véletlenszerű sztringben.
MinimumSpecialCharacters Szükséges Szám A speciális karakterek minimális száma.
Minimális feltőkésítés Szükséges Szám A véletlenszerű sztringben lévő nagybetűk minimális száma.
MinimumLowerCase Szükséges Szám Kisbetűk minimális száma a véletlenszerű sztringben.
CharactersToAvoid Választható Sztring A véletlenszerű sztring létrehozásakor kizárandó karakterek.

1. példa: – Véletlenszerű sztring létrehozása speciális karakterkorlátozások nélkül: RandomString(6,3,0,0,3) Véletlenszerű sztringet hoz létre 6 karakterből. A sztring 3 számot és 3 kisbetűt (1a73qt) tartalmaz.

2. példa: – Véletlenszerű sztring létrehozása speciális karakterkorlátozásokkal: RandomString(10,2,2,2,1,"?,") Véletlenszerű sztringet hoz létre 10 karakterből. A sztring legalább 2 számot, 2 speciális karaktert, 2 nagybetűt, 1 kisbetűt tartalmaz, és kizárja a "?" és "" karaktereket (1@!2BaRg53).

Redact

Függvény: Redact()

Leírás: A Redact függvény az attribútum értékét a kiépítési naplók "[Redact]" sztringkonstansára cseréli.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
attribútum/érték Szükséges Sztring Adja meg a naplókból kinyerni kívánt attribútumot vagy állandót/sztringet.

1. példa: Attribútum újrakódosítása: Redact([userPrincipalName]) Eltávolítja a userPrincipalName nevet a kiépítési naplókból.

2. példa: Sztring újrakódosítása: Redact("StringToBeRedacted") Eltávolít egy állandó sztringet a kiépítési naplókból.

3. példa: Véletlenszerű sztring újbóli létrehozása: Redact(RandomString(6,3,0,0,3)) Eltávolítja a véletlenszerű sztringet a kiépítési naplókból.

RemoveDuplicates

Függvény: RemoveDuplicates(attribútum)

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

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Attribútum Szükséges Többértékű attribútum Többértékű attribútum, amely ismétlődő elemeket távolít el

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

Csere

Függvény: Replace(source, oldValue, regexPattern, regexGroupName, replacementValue, replacementAttributeName, template)

Leírás: A sztringen belüli értékeket kis- és nagybetűk megkülönböztetésével cseréli le. A függvény a megadott paraméterektől függően eltérően viselkedik:

  • 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

Feljegyzés

A regex csoportosítási szerkezetekről és az elnevezett alkifejezésekről további információt a Reguláris kifejezések szerkezeteinek csoportosítása című témakörben talál.

  • 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 értéke van, a rendszer visszaadja a forrást
    • Ha a forrásnak nincs értéke, a függvény a regexPattern értéket alkalmazza a csereAttributeName értékre, és visszaadja a regexGroupName értéknek megfelelő értéket.

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. A csereAttributeName használata esetén a regexPattern a csereAttributeName értékének kinyerésére lesz alkalmazva.
regexGroupName Választható Sztring A regexPatternben lévő csoport neve. A névvel ellátott csereAttributeName használata esetén kinyerjük a névvel ellátott regex csoport értékét a csereAttributeName névből, és visszaadjuk helyettesítő értékként.
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.

Karakterek cseréje normál kifejezéssel

1. példa: Az oldValue és a replaceValue használatával cserélje le a teljes forrássztringet egy másik sztringre.

Tegyük fel, hogy a HR-rendszer rendelkezik attribútummal BusinessTitle. A legutóbbi beosztásváltozások részeként a vállalata a "Product Developer" (Termékfejlesztő) üzleti címmel rendelkező felhasználókat "Szoftvermérnök" névre szeretné frissíteni. Ebben az esetben az alábbi kifejezést használhatja az attribútumleképezésben.

Replace([BusinessTitle],"Product Developer", , , "Software Engineer", , )

  • forrás: [BusinessTitle]
  • oldValue: "Termékfejlesztő"
  • replacementValue: "Szoftvermérnök"
  • Kifejezés kimenete: Szoftvermérnök

2. példa: Az oldValue és a sablon használatával szúrja be a forrássztringet egy másik templatizált sztringbe.

Ebben a forgatókönyvben az oldValue paraméter hibás. Valójában ez az az érték, amelyet lecserélnek.
Tegyük fel, hogy mindig a formátumban <username>@contoso.comszeretné létrehozni a bejelentkezési azonosítót. Van egy UserID nevű forrásattribútum, és azt szeretné, hogy ezt az értéket használja a <username> bejelentkezési azonosító egy részére. Ebben az esetben az alábbi kifejezést használhatja az attribútumleképezésben.

Replace([UserID],"<username>", , , , , "<username>@contoso.com")

  • forrás:[UserID] = "jsmith"
  • oldValue: "<username>"
  • sablon: "<username>@contoso.com"
  • Kifejezés kimenete: "jsmith@contoso.com"

3. példa: RegexPattern és replaceValue használatával kinyerheti a forrássztring egy részét, és lecserélheti egy üres sztringre vagy egy regex minták vagy regex-csoportnevek alapján létrehozott egyéni értékre.

Tegyük fel, hogy rendelkezik egy forrásattribútummal telephoneNumber , amely összetevőket country code tartalmaz, és phone number szóköz karakterrel van elválasztva. Ebben az esetben például +91 9998887777 az alábbi kifejezést használhatja az attribútumleképezésben a 10 jegyű telefonszám kinyeréséhez.

Replace([telephoneNumber], , "\\+(?<isdCode>\\d* )(?<phoneNumber>\\d{10})", , "${phoneNumber}", , )

  • forrás:[telephoneNumber] = "+91 9998887777"
  • regexPattern: "\\+(?<isdCode>\\d* )(?<phoneNumber>\\d{10})"
  • replacementValue: "${phoneNumber}"
  • Kifejezéskimenet: 9998887777

Ezzel a mintával is eltávolíthat karaktereket, és összecsukhat egy sztringet. Az alábbi kifejezés például eltávolítja a zárójeleket, a kötőjeleket és a szóköz karaktereket a mobilszám sztringben, és csak számjegyeket ad vissza.

Replace([mobile], , "[()\\s-]+", , "", , )

  • Forrás:[mobile] = "+1 (999) 888-7777"
  • regexPattern: "[()\\s-]+"
  • replacementValue: "" (üres sztring)
  • Kifejezéskimenet: 19998887777

4. példa: A regexPattern, a regexGroupName és a replaceValue használatával kinyerheti a forrássztring egy részét, és lecserélheti egy másik literálértékre vagy üres sztringre.

Tegyük fel, hogy a forrásrendszer egy AddressLineData attribútummal rendelkezik, két összetevő utcaszámmal és utcanévvel. Egy legutóbbi lépés részeként tegyük fel, hogy a cím utcaszáma megváltozott, és csak a címsor utcaszámrészét szeretné frissíteni. Ebben az esetben az alábbi kifejezést használhatja az attribútumleképezésben az utcaszám kinyeréséhez.

Replace([AddressLineData], ,"(?<streetNumber>^\\d*)","streetNumber", "888", , )

  • forrás:[AddressLineData] = "545 Tremont Street"
  • regexPattern: "(?<streetNumber>^\\d*)"
  • regexGroupName: "streetNumber"
  • replacementValue: "888"
  • Kifejezés kimenete: 888 Tremont Street

Íme egy másik példa, amikor az UPN-ből származó tartomány utótagját egy üres sztringre cseréli a bejelentkezési azonosító tartományi utótag nélkül történő létrehozásához.

Replace([userPrincipalName], , "(?<Suffix>@(.)*)", "Suffix", "", , )

  • forrás:[userPrincipalName] = "jsmith@contoso.com"
  • regexPattern: "(?<Suffix>@(.)*)"
  • regexGroupName: "Utótag"
  • replacementValue: "" (üres sztring)
  • Kifejezéskimenet: jsmith

5. példa: RegexPattern, regexGroupName és replacementAttributeName használata a forrásattribútum üres vagy érték nélküli forgatókönyveinek kezeléséhez.

Tegyük fel, hogy a forrásrendszer egy telephoneNumber attribútummal rendelkezik. Ha a telephoneNumber üres, a mobilszám attribútum 10 számjegyét szeretné kinyerni. Ebben az esetben az alábbi kifejezést használhatja az attribútumleképezésben.

Replace([telephoneNumber], , "\\+(?<isdCode>\\d* )(?<phoneNumber>\\d{10})", "phoneNumber" , , [mobile], )

  • forrás:[telephoneNumber] = "" (üres sztring)
  • regexPattern: "\\+(?<isdCode>\\d* )(?<phoneNumber>\\d{10})"
  • regexGroupName: "phoneNumber"
  • replacementAttributeName:[mobile] = "+91 8887779999"
  • Kifejezéskimenet: 8887779999

6. példa: Meg kell keresnie a normál kifejezésértéknek megfelelő karaktereket, és el kell távolítania őket.

Replace([mailNickname], , "[a-zA-Z_]*", , "", , )

  • forrás [mailNickname]
  • oldValue: "john_doe72"
  • replaceValue: ""
  • Kifejezés kimenete: 72

SelectUniqueValue

Függvény: SelectUniqueValue(uniqueValueRule1, uniqueValueRule2, uniqueValueRule3, ...)

Leírás: 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.

  • Ennek a függvénynek a legfelső szinten kell lennie, és 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 to Active Directory User Provisioning" és a "SuccessFactors to Active Directory User Provisioning" esetében támogatott. Más kiépítési alkalmazásokkal nem használható.
  • Az LDAP-keresés, amelyet a SelectUniqueValue függvény hajt végre helyi Active Directory nem menekül a speciális karakterekből, például az ékírásból. Ha egy speciális karaktert tartalmazó "Jéssica Smith" sztringet ad át, feldolgozási hibákba ütközik. A NormalizeDiacritics függvényt az alábbi példában látható módon ágyazhatja be a speciális karakterek normalizálásához.

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.

Egyedi érték létrehozása a userPrincipalName (UPN) attribútumhoz

Példa: 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 az értéket az UPN attribútumhoz rendelené.

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

SingleAppRoleAssignment

Függvény: SingleAppRoleAssignment([appRoleAssignments])

Leírás: 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. Az ajánlott eljárás annak biztosítása, hogy egyszerre csak egy appRoleAssignment legyen hozzárendelve egy felhasználóhoz. Ez a függvény nem támogatott olyan esetekben, amikor a felhasználók több alkalmazásszerepkör-hozzárendeléssel rendelkeznek.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
[appRoleAssignments] Szükséges Sztring [appRoleAssignments] Objektum.

Felosztás

Függvény: Felosztás(forrás, elválasztó)

Leírás: Egy sztringet többértékű tömbre osztja fel 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: ",")

Sztring felosztása többértékű tömbre

Példa: 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"]

StripSpaces

Függvény: StripSpaces(forrás)

Leírás: 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

Függvény: Switch(source, defaultValue, key1, value1, key2, value2, ...)

Leírás: 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. A függvény nem használható hivatkozási attribútumokhoz, például a kezelőhöz.

Feljegyzés

A Kapcsoló függvény a forrás- és kulcsértékek kis- és nagybetűket megkülönböztető sztring-összehasonlítását hajtja végre. Ha kis- és nagybetűk érzéketlen összehasonlítását szeretné elvégezni, az összehasonlítás előtt normalizálja a forrássztringet egy beágyazott ToLower függvénnyel, és győződjön meg arról, hogy az összes kulcssztring kisbetűt használ. Példa: Switch(ToLower([statusFlag]), "0", "true", "1", "false", "0") Ebben a példában a forrásattribútumnakstatusFlag lehetnek értékei ("True" / "true" / "TRUE"). A Kapcsoló függvény azonban a kulcsparaméterekkel való összehasonlítás előtt mindig kisbetűs "true" sztringgé alakítja át.

Figyelem

A forrásparaméterhez ne használja az IsPresent, az IsNull vagy az IsNullOrEmpty beágyazott függvényeket. Ehelyett használjon egy literális üres sztringet a kulcsértékek egyikeként.
Példa: Switch([statusFlag], "Default Value", "true", "1", "", "0") Ebben a példában, ha a forrásattribútumstatusFlag üres, a Kapcsoló függvény a 0 értéket adja vissza.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Forrás Szükséges Sztring Frissítendő 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.

Érték cseréje előre definiált beállítások alapján

Példa: Határozza meg a felhasználó időzónáját a Microsoft Entra ID-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"

ToLower

Függvény: ToLower(forrás, kultúra)

Leírás: Egy forrássztring-értéket használ, és a megadott kulturális szabályok használatával kisbetűssé alakítja. Ha nincs megadva kulturális információ, akkor invariáns kultúrát fog használni.

Ha a célrendszerben meglévő értékeket kisbetűsre szeretné állítani, frissítse a célalkalmazás sémáját, és állítsa a caseExact tulajdonságot "true" értékre az önt érdeklő attribútumhoz.

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 érhető el kétbetűs nyelvi kód, az ISO 639-2-ből származó hárombetűs kód lesz használva.

Generált userPrincipalName (UPN) érték konvertálása kisbetűssé

Példa: Az UPN-értéket a PreferredFirstName és a PreferredLastName forrásmező összefűzésével és az összes karakter kisbetűssé alakításával szeretné létrehozni.

ToLower(Join("@", NormalizeDiacritics(StripSpaces(Join(".", [PreferredFirstName], [PreferredLastName]))), "contoso.com"))

Minta bemenet/kimenet:

  • INPUT (PreferredFirstName): "John"
  • INPUT (PreferredLastName): "Smith"
  • KIMENET: "john.smith@contoso.com"

ToUpper

Függvény: ToUpper(forrás, kultúra)

Leírás: Egy forrássztring-értéket használ, és a megadott kulturális szabályok használatával nagybetűssé alakítja. Ha nincs megadva kulturális információ, akkor invariáns kultúrát fog használni.

Ha a célrendszerben meglévő értékeket szeretné nagybetűsre állítani, frissítse a célalkalmazás sémáját, és állítsa a caseExact tulajdonságot "true" értékre az önt érdeklő attribútumhoz.

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 érhető el kétbetűs nyelvi kód, az ISO 639-2-ből származó hárombetűs kód lesz használva.

Szó

Függvény: Word(Sztring;WordNumber;Határolójelek)

Leírás: A Word függvény egy sztringben található szót ad vissza a használandó elválasztójeleket leíró paraméterek és a visszaadandó szószám alapján. 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.

Paraméterek:

Név Kötelező/ismétlődő Típus szerint Jegyzetek
Sztring Szükséges Többértékű attribútum Sztring egy szó visszaadásához.
WordNumber Szükséges Egész Szám, amely meghatározza, hogy melyik szószámot kell visszaadni
elválasztójelek Szükséges Sztring A szavak azonosításához használandó elválasztójel(ek) sztringje

Példa:Word("The quick brown fox",3," ")

A "barna" értéket adja vissza.

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

A "has" értéket adja vissza.

Példák

Ez a szakasz további kifejezésfüggvény-használati példákat tartalmaz.

Ismert tartománynév csíkozása

Egy ismert tartománynév lekérése egy felhasználó e-mail-címéről a felhasználónév lekéréséhez. 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"

Felhasználói alias létrehozása az utónév és a vezetéknév egyes részeinek összefűzésével

Hozzon létre egy felhasználói aliast a felhasználó utónevének első három betűje és a felhasználó vezetéknevének első öt 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"

Adjon hozzá vesszőt a vezetéknév és az utónév közé.

Adjon hozzá vesszőt a vezetéknév és az utónév közé.

Kifejezés:Join(", ", "", [surname], [givenName])

Minta bemenet/kimenet:

  • INPUT (givenName): "John"
  • INPUT (vezetéknév): "Doe"
  • KIMENET: "Doe, John"

Hozzon létre egy azonosítót egy felhasználó számára a Microsoft Entra-azonosító objektumazonosítója alapján. Távolítsa el a betűket az azonosítóból, és adja hozzá az 1000-et az elején.

Ez a kifejezés lehetővé teszi, hogy egy 1000-es kezdetű és valószínűleg egyedi felhasználó azonosítót hozzon létre.

Kifejezés: Join("", 1000, Replace(ConvertToUTF8Hex([objectId]), , "[a-zA-Z_]*", , "", , ))

Minta bemenet/kimenet:

  • BEMENET: "d05e47b1-3909-445a-ba5e-ca60cbc0e4b4"
  • KIMENET: "100064303565343762312333930392343435612626135652636136306362633065346234"