Expressies schrijven voor kenmerktoewijzingen in Microsoft Entra-id
Wanneer u cloudsynchronisatie configureert, is een van de typen kenmerktoewijzingen die u kunt opgeven een expressietoewijzing.
Met de expressietoewijzing kunt u kenmerken aanpassen met behulp van een scriptachtige expressie. Hiermee kunt u de on-premises gegevens transformeren in een nieuwe of andere waarde. U kunt bijvoorbeeld twee kenmerken combineren tot één kenmerk, omdat dit kenmerk wordt gebruikt door een van uw cloudtoepassingen.
In het volgende document worden de scriptachtige expressies behandeld die worden gebruikt om de gegevens te transformeren. Dit is slechts een onderdeel van het proces. Vervolgens moet u deze expressie gebruiken en in een webaanvraag naar uw tenant plaatsen. Zie Transformaties voor meer informatie hierover
Overzicht van syntaxis
De syntaxis voor expressies voor kenmerktoewijzingen doet denken aan VBA-functies (Visual Basic for Applications).
De volledige expressie moet worden gedefinieerd in termen van functies, die bestaan uit een naam gevolgd door argumenten tussen haakjes:
FunctionName(<<argument 1>>,<<argument N>>)U kunt functies binnen elkaar nesten. Bijvoorbeeld:
FunctionOne(FunctionTwo(<<argument1>>))U kunt drie verschillende typen argumenten doorgeven aan functies:
- Kenmerken, die tussen vierkante haken moeten worden geplaatst. Bijvoorbeeld: [attributeName]
- Tekenreeksconstanten, die tussen dubbele aanhalingstekens moeten worden geplaatst. Bijvoorbeeld: 'Verenigde Staten'
- Andere functies. Bijvoorbeeld: FunctionOne(
<<argument1>>, FunctionTwo(<<argument2>>))
Als u voor tekenreeksconstanten een backslash ( \ ) of aanhalingsteken (" ) in de tekenreeks nodig hebt, moet deze worden escaped met het teken backslash ( \ ) . Bijvoorbeeld: "Bedrijfsnaam: \"Contoso\""
Lijst met functies
| Lijst met functies | Beschrijving |
|---|---|
| toevoegen | Neemt een brontekenreekswaarde en voegt het achtervoegsel toe aan het einde ervan. |
| BitAnd- | De functie BitAnd stelt opgegeven bits in op een waarde. |
| CBool- | De functie CBool retourneert een Booleaanse waarde op basis van de geëvalueerde expressie |
| ConvertFromBase64- | Met de functie ConvertFromBase64 wordt de opgegeven base64-gecodeerde waarde geconverteerd naar een reguliere tekenreeks. |
| ConvertToBase64- | De functie ConvertToBase64 converteert een tekenreeks naar een Unicode-base64-tekenreeks. |
| ConvertToUTF8Hex- | Met de functie ConvertToUTF8Hex wordt een tekenreeks geconverteerd naar een UTF8 Hex-gecodeerde waarde. |
| Count | De functie Aantal retourneert het aantal elementen in een kenmerk met meerdere waarden |
| Cstr- | De functie CStr wordt geconverteerd naar een gegevenstype tekenreeks. |
| DateFromNum- | De functie DateFromNum converteert een waarde in de datumnotatie van AD naar een datum/tijd-type. |
| DNComponent- | De functie DNComponent retourneert de waarde van een opgegeven DN-onderdeel dat van links gaat. |
| Fout | De functie Fout wordt gebruikt om een aangepaste fout te retourneren. |
| FormatDateTime- | Neemt een datumtekenreeks uit één indeling en converteert deze naar een andere indeling. |
| GUID- | De functie-GUID genereert een nieuwe willekeurige GUID. |
| IIF- | De functie IIF retourneert een van een set mogelijke waarden op basis van een opgegeven voorwaarde. |
| InStr- | Met de functie InStr wordt het eerste exemplaar van een subtekenreeks in een tekenreeks gevonden. |
| IsNull- | Als de expressie null oplevert, retourneert de functie IsNull waar. |
| IsNullOrEmpty- | Als de expressie null of een lege tekenreeks is, retourneert de functie IsNullOrEmpty true. |
| IsPresent | Als de expressie resulteert in een tekenreeks die niet Null is en niet leeg is, retourneert de functie IsPresent waar. |
| IsString- | Als de expressie kan worden geëvalueerd naar een tekenreekstype, resulteert de functie IsString in Waar. |
| item | De functie Item retourneert één item van een tekenreeks/kenmerk met meerdere waarden. |
| deelnemen aan | Join() is vergelijkbaar met Append(), behalve dat deze meerdere bron- tekenreekswaarden in één tekenreeks kan combineren. Elke waarde wordt gescheiden door een scheidingsteken tekenreeks. |
| linker | De functie Links retourneert een opgegeven aantal tekens links van een tekenreeks. |
| mid- | Retourneert een subtekenreeks van de bronwaarde. Een subtekenreeks is een tekenreeks die slechts enkele tekens uit de brontekenreeks bevat. |
| NormalizeDiacritics | Hiervoor is één tekenreeksargument vereist. Retourneert de tekenreeks, maar door diakritische tekens vervangen door gelijkwaardige niet-diakritische tekens. |
| Niet | Hiermee wordt de Booleaanse waarde van de brongespiegeld. Als bronwaarde 'Waar' is, retourneertFalse'. Anders wordt 'True' geretourneerd. |
| RemoveDuplicates | De functie RemoveDuplicates gebruikt een tekenreeks met meerdere waarden en zorgt ervoor dat elke waarde uniek is. |
| vervangen | Vervangt waarden in een tekenreeks. |
| SelectUniqueValue- | Hiervoor zijn minimaal twee argumenten vereist. Dit zijn regels voor het genereren van unieke waarden die zijn gedefinieerd met behulp van expressies. De functie evalueert elke regel en controleert vervolgens de waarde die is gegenereerd op uniekheid in de doel-app/map. |
| SingleAppRoleAssignment- | Retourneert één appRoleAssignment uit de lijst met alle appRoleAssignments die zijn toegewezen aan een gebruiker voor een bepaalde toepassing. |
| splitsen | Splitst een tekenreeks in een matrix met meerdere waarden, met behulp van het opgegeven scheidingsteken. |
| StringFromSID- | Met de functie StringFromSid wordt een bytematrix met een beveiligings-id geconverteerd naar een tekenreeks. |
| StripSpaces | Hiermee verwijdert u alle spaties (" ") tekens uit de brontekenreeks. |
| schakelen tussen | Wanneer bronwaarde overeenkomt met een sleutel, wordt waarde geretourneerd voor die sleutel. |
| ToLower- | Neemt een bron- tekenreekswaarde en converteert deze naar kleine letters met behulp van de opgegeven cultuurregels. |
| ToUpper- | Neemt een bron- tekenreekswaarde en converteert deze naar hoofdletters met behulp van de cultuurregels die zijn opgegeven. |
| knippen | Met de functie Knippen worden voorloop- en volgspaties uit een tekenreeks verwijderd. |
| Word- | De functie Word retourneert een woord in een tekenreeks, op basis van parameters die de scheidingstekens beschrijven die moeten worden gebruikt en het woordnummer dat moet worden geretourneerd. |
Toevoegen
functie:
Append(source, achtervoegsel)
Beschrijving:
Neemt een brontekenreekswaarde en voegt het achtervoegsel toe aan het einde ervan.
parameters:
| Naam | Vereist/herhalend | Type | Notities |
|---|---|---|---|
| bron | Vereist | Snaar | Meestal de naam van het kenmerk van het bronobject. |
| achtervoegsel | Vereist | Snaar | De tekenreeks die u wilt toevoegen aan het einde van de bronwaarde. |
BitAnd
Beschrijving:
De functie BitAnd stelt opgegeven bits in op een waarde.
syntaxis:
num BitAnd(num value1, num value2)
- waarde1, waarde2: numerieke waarden die samen AND'ed moeten zijn
opmerkingen:
Met deze functie worden beide parameters geconverteerd naar de binaire weergave en wordt een bit ingesteld op:
- 0: als een of beide van de bijbehorende bits in waarde1 en waarde2 0 zijn
- 1- als beide overeenkomende bits 1 zijn.
Met andere woorden, het retourneert 0 in alle gevallen, behalve wanneer de bijbehorende bits van beide parameters 1 zijn.
voorbeeld:
BitAnd(&HF, &HF7)
geeft als resultaat 7 omdat hexadecimale "F" EN "F7" deze waarde oplevert.
CBool
Beschrijving:
De functie CBool retourneert een Booleaanse waarde op basis van de geëvalueerde expressie
syntaxis:
bool CBool(exp Expression)
opmerkingen:
Als de expressie resulteert in een niet-nulwaarde, retourneert CBool Waar, anders retourneert CBool False.
voorbeeld:
CBool([attrib1] = [attrib2])
Retourneert Waar als beide kenmerken dezelfde waarde hebben.
ConvertFromBase64
Beschrijving:
Met de functie ConvertFromBase64 wordt de opgegeven base64-gecodeerde waarde geconverteerd naar een reguliere tekenreeks.
syntaxis:
str ConvertFromBase64(str source) - gaat ervan uit dat Unicode moet worden gecodeerd
str ConvertFromBase64(str source, enum Encoding)
- bron: Met Base64 gecodeerde tekenreeks
- Codering: Unicode, ASCII, UTF8
voorbeeld van
ConvertFromBase64("SABlAGwAbABvACAAdwBvAHIAbABkACEA")
ConvertFromBase64("SGVsbG8gd29ybGQh", UTF8)
Beide voorbeelden retourneren "Hallo wereld!"
ConvertToBase64
Beschrijving:
De functie ConvertToBase64 converteert een tekenreeks naar een Unicode-base64-tekenreeks.
Converteert de waarde van een matrix met gehele getallen naar de equivalente tekenreeksweergave die is gecodeerd met base-64 cijfers.
syntaxis:
str ConvertToBase64(str source)
voorbeeld:
ConvertToBase64("Hello world!")
Retourneert "SABlAGwAbABvACAAdwBvAHIAbABkACEA"
ConvertToUTF8Hex
Beschrijving:
Met de functie ConvertToUTF8Hex wordt een tekenreeks geconverteerd naar een UTF8 Hex-gecodeerde waarde.
syntaxis:
str ConvertToUTF8Hex(str source)
opmerkingen:
De uitvoerindeling van deze functie wordt gebruikt door Microsoft Entra ID als DN-kenmerkindeling.
voorbeeld:
ConvertToUTF8Hex("Hello world!")
Geeft als resultaat 48656C6C6F20776F726C6421
Tellen
Beschrijving:
De functie Aantal retourneert het aantal elementen in een kenmerk met meerdere waarden
syntaxis:
num Count(mvstr attribute)
CStr
Beschrijving:
De functie CStr wordt geconverteerd naar een gegevenstype tekenreeks.
syntaxis:
str CStr(num value)
str CStr(ref value)
str CStr(bool value)
- waarde: kan een numerieke waarde, verwijzingskenmerk of Booleaanse waarde zijn.
voorbeeld:
CStr([dn])
Kan "cn=Joe,dc=contoso,dc=com" retourneren
DateFromNum
Beschrijving:
De functie DateFromNum converteert een waarde in de datumnotatie van AD naar een datum/tijd-type.
syntaxis:
dt DateFromNum(num value)
voorbeeld:
DateFromNum([lastLogonTimestamp])
DateFromNum(129699324000000000)
Retourneert een datum/tijd die 2012-01-01 23:00:00 vertegenwoordigt
DNComponent
Beschrijving:
De functie DNComponent retourneert de waarde van een opgegeven DN-onderdeel dat van links gaat.
syntaxis:
str DNComponent(ref dn, num ComponentNumber)
- dn: het verwijzingskenmerk dat moet worden geïnterpreteerd
- ComponentNumber: het onderdeel in de DN dat moet worden geretourneerd
voorbeeld:
DNComponent(CRef([dn]),1)
Als dn 'cn=Joe,ou=...' is, wordt Joe geretourneerd
Fout
Beschrijving:
De functie Fout wordt gebruikt om een aangepaste fout te retourneren.
syntaxis:
void Error(str ErrorMessage)
voorbeeld:
IIF(IsPresent([accountName]),[accountName],Error("AccountName is required"))
Als de kenmerkaccountName niet aanwezig is, genereert u een fout op het object.
FormatDateTime
functie:
FormatDateTime(bron, inputFormat, outputFormat)
Beschrijving:
Neemt een datumtekenreeks uit één indeling en converteert deze naar een andere indeling.
parameters:
| Naam | Vereist/herhalend | Type | Notities |
|---|---|---|---|
| bron | Vereist | Snaar | Meestal de naam van het kenmerk van het bronobject. |
| inputFormat- | Vereist | Snaar | Verwachte notatie van de bronwaarde. Zie /dotnet/standard/base-types/custom-date-and-time-format-stringsvoor ondersteunde indelingen. |
| outputFormat | Vereist | Snaar | Indeling van de uitvoerdatum. |
Guid
Beschrijving:
De functie-GUID genereert een nieuwe willekeurige GUID
syntaxis:
str Guid()
IIF
Beschrijving:
De functie IIF retourneert een van een set mogelijke waarden op basis van een opgegeven voorwaarde.
syntaxis:
var IIF(exp condition, var valueIfTrue, var valueIfFalse)
- voorwaarde: elke waarde of expressie die kan worden geëvalueerd op waar of onwaar.
- valueIfTrue: Als de voorwaarde waar oplevert, wordt de geretourneerde waarde gebruikt.
- valueIfFalse: Als de voorwaarde onwaar oplevert, wordt de geretourneerde waarde geretourneerd.
voorbeeld:
IIF([employeeType]="Intern","t-" & [alias],[alias])
Als de gebruiker een intern is, retourneert u de alias van een gebruiker met 't-' toegevoegd aan het begin ervan, anders wordt de alias van de gebruiker als zodanig geretourneerd.
Instr
Beschrijving:
Met de functie InStr wordt het eerste exemplaar van een subtekenreeks in een tekenreeks gevonden
syntaxis:
num InStr(str stringcheck, str stringmatch)
num InStr(str stringcheck, str stringmatch, num start)
num InStr(str stringcheck, str stringmatch, num start, enum compare)
- tekenreekscontrole: tekenreeks die moet worden doorzocht
- tekenreeksmatch: te vinden tekenreeks
- start: beginpositie om de subtekenreeks te vinden
- vergelijken: vbTextCompare of vbBinaryCompare
opmerkingen:
Retourneert de positie waar de subtekenreeks is gevonden of 0 als deze niet is gevonden.
voorbeeld:
InStr("The quick brown fox","quick")
Evalueert naar 5
InStr("repEated","e",3,vbBinaryCompare)
Evalueert tot 7
IsNull
Beschrijving:
Als de expressie null oplevert, retourneert de functie IsNull waar.
syntaxis:
bool IsNull(var Expression)
opmerkingen:
Voor een kenmerk wordt een Null uitgedrukt door het ontbreken van het kenmerk.
voorbeeld:
IsNull([displayName])
Retourneert Waar als het kenmerk niet aanwezig is in de CS of MV.
IsNullOrEmpty
Beschrijving:
Als de expressie null of een lege tekenreeks is, retourneert de functie IsNullOrEmpty true.
syntaxis:
bool IsNullOrEmpty(var Expression)
opmerkingen:
Voor een kenmerk resulteert dit in Waar als het kenmerk afwezig is of aanwezig is, maar een lege tekenreeks is.
De inverse van deze functie heet IsPresent.
voorbeeld:
IsNullOrEmpty([displayName])
Retourneert Waar als het kenmerk niet aanwezig is of een lege tekenreeks is in de CS of MV.
IsPresent
Beschrijving:
Als de expressie resulteert in een tekenreeks die niet Null is en niet leeg is, retourneert de functie IsPresent waar.
syntaxis:
bool IsPresent(var expression)
opmerkingen:
De inverse van deze functie heet IsNullOrEmpty.
voorbeeld:
Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director])
Item
Beschrijving:
De functie Item retourneert één item van een tekenreeks/kenmerk met meerdere waarden.
syntaxis:
var Item(mvstr attribute, num index)
- kenmerk: kenmerk met meerdere waarden
- index: indexeren naar een item in de tekenreeks met meerdere waarden.
opmerkingen:
De functie Item is handig samen met de functie Contains, omdat de laatste functie de index retourneert naar een item in het kenmerk met meerdere waarden.
Genereert een fout als de index buiten de grenzen valt.
voorbeeld:
Mid(Item([proxyAddresses],Contains([proxyAddresses], "SMTP:")),6)
Retourneert het primaire e-mailadres.
IsString
Beschrijving:
Als de expressie kan worden geëvalueerd naar een tekenreekstype, resulteert de functie IsString in Waar.
syntaxis:
bool IsString(var expression)
opmerkingen:
Wordt gebruikt om te bepalen of CStr() kan worden gebruikt om de expressie te parseren.
Verbinden
functie:
Join(scheidingsteken, bron1, bron2, ...)
Beschrijving:
Join() is vergelijkbaar met Append(), behalve dat deze meerdere bron- tekenreekswaarden in één tekenreeks kan combineren. Elke waarde wordt gescheiden door een scheidingsteken tekenreeks.
Als een van de bronwaarden een kenmerk met meerdere waarden is, wordt elke waarde in dat kenmerk samengevoegd, gescheiden door de scheidingstekenwaarde.
parameters:
| Naam | Vereist/herhalend | Type | Notities |
|---|---|---|---|
| scheidingsteken | Vereist | Snaar | Tekenreeks die wordt gebruikt om bronwaarden te scheiden wanneer ze worden samengevoegd tot één tekenreeks. Kan '' zijn als er geen scheidingsteken is vereist. |
| bron1 ... sourceN | Vereist, variabel aantal keren | Snaar | Tekenreekswaarden die moeten worden samengevoegd. |
Links
Beschrijving:
De functie Links retourneert een opgegeven aantal tekens links van een tekenreeks.
syntaxis:
str Left(str string, num NumChars)
- tekenreeks: de tekenreeks waaruit tekens moeten worden geretourneerd
- NumChars: een getal dat het aantal tekens aangeeft dat moet worden geretourneerd vanaf het begin (links) van de tekenreeks
opmerkingen:
Een tekenreeks met de eerste numChars-tekens in tekenreeks:
- Als numChars = 0, retourneert u een lege tekenreeks.
- Als numChars < 0, retourneert u de invoertekenreeks.
- Als tekenreeks null is, retourneert u een lege tekenreeks.
Als een tekenreeks minder tekens bevat dan het getal dat is opgegeven in numChars, wordt een tekenreeks geretourneerd die identiek is aan tekenreeks (dat alle tekens in parameter 1 bevat).
voorbeeld:
Left("John Doe", 3)
Retourneert Joh.
Midden
functie:
Mid(bron, begin, lengte)
Beschrijving:
Retourneert een subtekenreeks van de bronwaarde. Een subtekenreeks is een tekenreeks die slechts enkele tekens uit de brontekenreeks bevat.
parameters:
| Naam | Vereist/herhalend | Type | Notities |
|---|---|---|---|
| bron | Vereist | Snaar | Meestal de naam van het kenmerk. |
| starten | Vereist | geheel getal | Index in de bron tekenreeks waar de subtekenreeks moet beginnen. Het eerste teken in de tekenreeks heeft een index van 1, het tweede teken heeft index 2, enzovoort. |
| lengte | Vereist | geheel getal | Lengte van de subtekenreeks. Als de lengte buiten de tekenreeks eindigt, retourneert de functie de subtekenreeks van begin van index tot het einde van tekenreeks. |
NormalizeDiacritics
functie:
NormalizeDiacritics(source)
Beschrijving:
Hiervoor is één tekenreeksargument vereist. Retourneert de tekenreeks, maar door diakritische tekens vervangen door gelijkwaardige niet-diakritische tekens. Wordt meestal gebruikt om voornamen en achternamen met diakritische tekens (accentmarkeringen) te converteren naar juridische waarden die kunnen worden gebruikt in verschillende gebruikers-id's, zoals user principal names, SAM-accountnamen en e-mailadressen.
parameters:
| Naam | Vereist/herhalend | Type | Notities |
|---|---|---|---|
| bron | Vereist | Snaar | Meestal een voornaam of achternaamkenmerk. |
Niet
functie:
Not(bron)
Beschrijving:
Hiermee wordt de Booleaanse waarde van de brongespiegeld. Als bronwaarde 'Waar' is, retourneertFalse'. Anders wordt 'True' geretourneerd.
parameters:
| Naam | Vereist/herhalend | Type | Notities |
|---|---|---|---|
| bron | Vereist | Booleaanse tekenreeks | Verwachte bron waarden waar of Onwaar zijn. |
RemoveDuplicates
Beschrijving:
De functie RemoveDuplicates gebruikt een tekenreeks met meerdere waarden en zorgt ervoor dat elke waarde uniek is.
syntaxis:
mvstr RemoveDuplicates(mvstr attribute)
voorbeeld:
RemoveDuplicates([proxyAddresses])
Retourneert een opgeschoond proxyAddress-kenmerk waarbij alle dubbele waarden zijn verwijderd.
Vervangen
functie:
Replace(source, oldValue, regexPattern, regexGroupName, replacementValue, replacementAttributeName, template)
Beschrijving:
Vervangt waarden in een tekenreeks. Dit werkt anders, afhankelijk van de opgegeven parameters:
Wanneer oldValue en replacementValue worden opgegeven:
- Vervangt alle exemplaren van oldValue in de bron door replacementValue
Wanneer oldValue en sjabloon worden opgegeven:
- Vervangt alle exemplaren van de oldValue- in de -sjabloon door de bronwaarde
Wanneer regexPattern en replacementValue worden opgegeven:
- De functie past de regexPattern- toe op de bron- tekenreeks en u kunt de regex-groepsnamen gebruiken om de tekenreeks samen te stellen voor replacementValue-
Wanneer regexPattern, regexGroupName, worden replacementValue- opgegeven:
- De functie past de regexPattern- toe op de brontekenreeks en vervangt alle waarden die overeenkomen met regexGroupName- door replacementValue-
Wanneer regexPattern, regexGroupName, replacementAttributeName worden opgegeven:
- Als bron geen waarde heeft, wordt bron- geretourneerd
- Als bron- een waarde heeft, past de functie de regexPattern- toe op de bron- tekenreeks en vervangt deze alle waarden die overeenkomen met regexGroupName- met de waarde die is gekoppeld aan replacementAttributeName
parameters:
| Naam | Vereist/herhalend | Type | Notities |
|---|---|---|---|
| bron | Vereist | Snaar | Meestal de naam van het kenmerk uit het bronobject. |
| oldValue- | Facultatief | Snaar | De waarde die moet worden vervangen in bronsjabloon of sjabloon. |
| regexPattern- | Facultatief | Snaar | Regex-patroon voor de waarde die moet worden vervangen in bron. Of, wanneer replacementPropertyName wordt gebruikt, patroon voor het extraheren van waarde uit replacementPropertyName. |
| regexGroupName- | Facultatief | Snaar | Naam van de groep in regexPattern-. Alleen wanneer replacementPropertyName wordt gebruikt, wordt de waarde van deze groep geëxtraheerd als replacementValue uit replacementPropertyName. |
| replacementValue | Facultatief | Snaar | Nieuwe waarde om oude te vervangen door. |
| replacementAttributeName | Facultatief | Snaar | Naam van het kenmerk dat moet worden gebruikt voor vervangingswaarde |
| sjabloon | Facultatief | Snaar | Wanneer sjabloon waarde is opgegeven, zoeken we naar oudewaarde in de sjabloon en vervangen door bronwaarde waarde. |
SelectUniqueValue
functie:
SelectUniqueValue(uniqueValueRule1, uniqueValueRule2, uniqueValueRule3, ...)
Beschrijving:
Hiervoor zijn minimaal twee argumenten vereist. Dit zijn regels voor het genereren van unieke waarden die zijn gedefinieerd met behulp van expressies. De functie evalueert elke regel en controleert vervolgens de waarde die is gegenereerd op uniekheid in de doel-app/map. De eerste unieke waarde die wordt gevonden, is de waarde die wordt geretourneerd. Als alle waarden al in het doel aanwezig zijn, wordt de vermelding ge borgd en wordt de reden vastgelegd in de auditlogboeken. Er is geen bovengrens aan het aantal argumenten dat kan worden opgegeven.
Notitie
- Dit is een functie op het hoogste niveau, deze kan niet worden genest.
- Deze functie kan niet worden toegepast op kenmerken met een overeenkomende prioriteit.
- Deze functie is alleen bedoeld om te worden gebruikt voor het maken van vermeldingen. Wanneer u deze gebruikt met een kenmerk, stelt u de eigenschap Toewijzing toepassen op Alleen tijdens het maken van het object.
- Deze functie wordt momenteel alleen ondersteund voor 'Workday en SuccessFactors to Active Directory User Provisioning'. Het kan niet worden gebruikt met andere inrichtingstoepassingen.
parameters:
| Naam | Vereist/herhalend | Type | Notities |
|---|---|---|---|
| uniqueValueRule1 ... uniqueValueRuleN | Minimaal 2 zijn vereist, geen bovengrens | Snaar | Lijst met regels voor het genereren van unieke waarden die moeten worden geëvalueerd. |
SingleAppRoleAssignment
functie:
SingleAppRoleAssignment([appRoleAssignments])
Beschrijving:
Retourneert één appRoleAssignment uit de lijst met alle appRoleAssignments die zijn toegewezen aan een gebruiker voor een bepaalde toepassing. Deze functie is vereist om het object appRoleAssignments te converteren naar één rolnaamtekenreeks. Houd er rekening mee dat de aanbevolen procedure is ervoor te zorgen dat slechts één appRoleAssignment wordt toegewezen aan één gebruiker tegelijk en als aan meerdere rollen de geretourneerde rolreeks mogelijk niet voorspelbaar is.
parameters:
| Naam | Vereist/herhalend | Type | Notities |
|---|---|---|---|
| [appRoleAssignments] | Vereist | Snaar | [appRoleAssignments] object. |
Splijten
functie:
Split(bron, scheidingsteken)
Beschrijving:
Splitst een tekenreeks in een matrix met meerdere waarden, met behulp van het opgegeven scheidingsteken.
parameters:
| Naam | Vereist/herhalend | Type | Notities |
|---|---|---|---|
| bron | Vereist | Snaar | bronwaarde bijwerken. |
| scheidingsteken | Vereist | Snaar | Hiermee geeft u het teken op dat wordt gebruikt om de tekenreeks te splitsen (bijvoorbeeld: ",") |
StringFromSid
Beschrijving:
Met de functie StringFromSid wordt een bytematrix met een beveiligings-id geconverteerd naar een tekenreeks.
syntaxis:
str StringFromSid(bin ObjectSID)
StripSpaces
functie:
StripSpaces(bron)
Beschrijving:
Hiermee verwijdert u alle spaties (" ") tekens uit de brontekenreeks.
parameters:
| Naam | Vereist/herhalend | Type | Notities |
|---|---|---|---|
| bron | Vereist | Snaar | bronwaarde bijwerken. |
Schakelaar
functie:
Switch(bron, defaultValue, key1, value1, key2, value2, ...)
Beschrijving:
Wanneer bronwaarde overeenkomt met een sleutel, wordt waarde geretourneerd voor die sleutel. Als bronwaarde niet overeenkomt met sleutels, wordt defaultValue-geretourneerd.
sleutel- en waarde parameters altijd in paren moeten worden geleverd. De functie verwacht altijd een even aantal parameters.
parameters:
| Naam | Vereist/herhalend | Type | Notities |
|---|---|---|---|
| bron | Vereist | Snaar | bronwaarde om te controleren. |
| defaultValue- | Facultatief | Snaar | Standaardwaarde die moet worden gebruikt wanneer de bron niet overeenkomt met sleutels. Kan een lege tekenreeks zijn (""). |
| sleutel | Vereist | Snaar | Sleutel om bronwaarde te vergelijken. |
| waarde | Vereist | Snaar | Vervangingswaarde voor de bron overeenkomen met de sleutel. |
ToLower
functie:
ToLower(bron, cultuur)
Beschrijving:
Neemt een bron- tekenreekswaarde en converteert deze naar kleine letters met behulp van de opgegeven cultuurregels. Als er geen cultuur is opgegeven, wordt de invariante cultuur gebruikt.
parameters:
| Naam | Vereist/herhalend | Type | Notities |
|---|---|---|---|
| bron | Vereist | Snaar | Meestal de naam van het kenmerk van het bronobject |
| cultuur | Facultatief | Snaar | De indeling voor de cultuurnaam op basis van RFC 4646 is languagecode2-country/regioncode2, waarbij languagecode2 de tweeletterige taalcode is en land/regiocode2 de subcultuurcode van twee letters is. Voorbeelden hiervan zijn ja-JP voor Japans (Japan) en en-US voor Engels (Verenigde Staten). In gevallen waarin er geen tweeletterige taalcode beschikbaar is, wordt een code van drie letters gebruikt die is afgeleid van ISO 639-2. |
ToUpper
functie:
ToUpper(bron, cultuur)
Beschrijving:
Neemt een bron- tekenreekswaarde en converteert deze naar hoofdletters met behulp van de cultuurregels die zijn opgegeven. Als er geen cultuur is opgegeven, wordt de invariante cultuur gebruikt.
parameters:
| Naam | Vereist/herhalend | Type | Notities |
|---|---|---|---|
| bron | Vereist | Snaar | Meestal de naam van het kenmerk van het bronobject. |
| cultuur | Facultatief | Snaar | De indeling voor de cultuurnaam op basis van RFC 4646 is languagecode2-country/regioncode2, waarbij languagecode2 de tweeletterige taalcode is en land/regiocode2 de subcultuurcode van twee letters is. Voorbeelden hiervan zijn ja-JP voor Japans (Japan) en en-US voor Engels (Verenigde Staten). In gevallen waarin er geen tweeletterige taalcode beschikbaar is, wordt een code van drie letters gebruikt die is afgeleid van ISO 639-2. |
Bijknippen
Beschrijving:
Met de functie Knippen worden voorloop- en volgspaties uit een tekenreeks verwijderd.
syntaxis:
str Trim(str value)
voorbeeld:
Trim(" Test ")
Retourneert 'Test'.
Trim([proxyAddresses])
Hiermee verwijdert u voorloop- en volgspaties voor elke waarde in het kenmerk proxyAddress.
Woord
Beschrijving:
De functie Word retourneert een woord in een tekenreeks, op basis van parameters die de scheidingstekens beschrijven die moeten worden gebruikt en het woordnummer dat moet worden geretourneerd.
syntaxis:
str Word(str string, num WordNumber, str delimiters)
- tekenreeks: de tekenreeks waaruit een woord moet worden geretourneerd.
- WordNumber: een getal dat aangeeft welk woordnummer moet worden geretourneerd.
- scheidingstekens: een tekenreeks die de scheidingstekens vertegenwoordigt die moeten worden gebruikt om woorden te identificeren
opmerkingen:
Elke tekenreeks in tekenreeks, gescheiden door een van de tekens in scheidingstekens, wordt aangeduid als woorden:
- Als getal < 1, wordt een lege tekenreeks geretourneerd.
- Als tekenreeks null is, retourneert u een lege tekenreeks.
Als een tekenreeks minder dan numerieke woorden bevat of als een tekenreeks geen woorden bevat die worden geïdentificeerd door scheidingstekens, wordt een lege tekenreeks geretourneerd.
voorbeeld:
Word("The quick brown fox",3," ")
Geeft als resultaat 'bruin'
Word("This,string!has&many separators",3,",!&#")
Zou 'has' retourneren
Voorbeelden
Bekende domeinnaam stripen
U moet een bekende domeinnaam verwijderen uit het e-mailadres van een gebruiker om een gebruikersnaam te verkrijgen.
Als het domein bijvoorbeeld 'contoso.com' is, kunt u de volgende expressie gebruiken:
Expressie:
Replace([mail], "@contoso.com", , ,"", ,)
voorbeeldinvoer/-uitvoer:
- INPUT (e-mail): "john.doe@contoso.com"
- OUTPUT: "john.doe"
Constant achtervoegsel toevoegen aan gebruikersnaam
Als u een Salesforce Sandbox gebruikt, moet u mogelijk een extra achtervoegsel toevoegen aan al uw gebruikersnamen voordat u ze synchroniseert.
Expressie:
Append([userPrincipalName], ".test")
voorbeeldinvoer/uitvoer:
- INPUT: (userPrincipalName): "John.Doe@contoso.com"
- UITVOER: "John.Doe@contoso.com.test"
Gebruikersalias genereren door delen van voor- en achternaam samen te voegen
U moet een gebruikersalias genereren door de eerste 3 letters van de voornaam van de gebruiker en de eerste 5 letters van de achternaam van de gebruiker te gebruiken.
Expressie:
Append(Mid([givenName], 1, 3), Mid([surname], 1, 5))
voorbeeldinvoer/uitvoer:
- INPUT (givenName): "John"
- INPUT (achternaam): "Doe"
- UITVOER: "JohDoe"
Diakritische tekens uit een tekenreeks verwijderen
U moet tekens met accentmarkeringen vervangen door gelijkwaardige tekens die geen accentmarkeringen bevatten.
Expressie:
NormalizeDiacritics([givenName])
voorbeeldinvoer/uitvoer:
- INPUT (givenName): "Zoë"
- UITVOER: "Zoe"
Een tekenreeks splitsen in een matrix met meerdere waarden
U moet een door komma's gescheiden lijst met tekenreeksen nemen en deze splitsen in een matrix die kan worden aangesloten op een kenmerk met meerdere waarden, zoals het kenmerk PermissionSets van Salesforce. In dit voorbeeld is een lijst met machtigingensets ingevuld in extensionAttribute5 in Microsoft Entra-id.
Expressie:
Split([extensionAttribute5], ",")
voorbeeldinvoer/uitvoer:
- INPUT (extensionAttribute5): "PermissionSetOne, PermissionSetTwo"
- OUTPUT: ["PermissionSetOne", "PermissionSetTwo"]
Uitvoerdatum als een tekenreeks in een bepaalde indeling
U wilt datums verzenden naar een SaaS-toepassing in een bepaalde indeling.
U wilt bijvoorbeeld datums opmaken voor ServiceNow.
Expressie:
FormatDateTime([extensionAttribute1], "yyyyMMddHHmmss.fZ", "yyyy-MM-dd")
voorbeeldinvoer/uitvoer:
- INPUT (extensionAttribute1): "20150123105347.1Z"
- UITVOER: "2015-01-23"
Een waarde vervangen op basis van vooraf gedefinieerde set opties
U moet de tijdzone van de gebruiker definiëren op basis van de statuscode die is opgeslagen in Microsoft Entra-id.
Als de statuscode niet overeenkomt met een van de vooraf gedefinieerde opties, gebruikt u de standaardwaarde 'Australië/Sydney'.
Expressie:
Switch([state], "Australia/Sydney", "NSW", "Australia/Sydney","QLD", "Australia/Brisbane", "SA", "Australia/Adelaide")
voorbeeldinvoer/uitvoer:
- INPUT (status): "QLD"
- OUTPUT: "Australia/Brisbane"
Tekens vervangen met behulp van een reguliere expressie
U moet tekens zoeken die overeenkomen met een reguliere expressiewaarde en deze verwijderen.
Expressie:
Replace([mailNickname], "[a-zA-Z_]*", "", "", , )
voorbeeldinvoer/uitvoer:
- INPUT- (mailNickname: "john_doe72"
- UITVOER: "72"
Gegenereerde UPN-waarde (UserPrincipalName) converteren naar kleine letters
In het onderstaande voorbeeld wordt de UPN-waarde gegenereerd door de bronvelden PreferredFirstName en PreferredLastName samen te voegen en de functie ToLower werkt op de gegenereerde tekenreeks om alle tekens te converteren naar kleine letters.
ToLower(Join("@", NormalizeDiacritics(StripSpaces(Join(".", [PreferredFirstName], [PreferredLastName]))), "contoso.com"))
voorbeeldinvoer/uitvoer:
- INPUT (PreferredFirstName): "John"
- INPUT (PreferredLastName): "Smith"
- UITVOER: "john.smith@contoso.com"
Unieke waarde genereren voor het kenmerk userPrincipalName (UPN)
Op basis van de voornaam, de achternaam en de achternaam van de gebruiker moet u een waarde voor het UPN-kenmerk genereren en controleren op de uniekheid ervan in de doel-AD-directory voordat u de waarde toewijst aan het UPN-kenmerk.
Expressie:
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")
)
voorbeeldinvoer/uitvoer:
- INPUT (PreferredFirstName): "John"
- INPUT (PreferredLastName): "Smith"
- UITVOER: 'John.Smith@contoso.com' als de UPN-waarde van John.Smith@contoso.com nog niet bestaat in de map
- OUTPUT-: 'J.Smith@contoso.com' als de UPN-waarde van John.Smith@contoso.com al in de map bestaat
- OUTPUT-: 'Jo.Smith@contoso.com' als de bovenstaande twee UPN-waarden al bestaan in de map