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 over die transformaties
Syntaxisoverzicht
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"
- Overige functies. Bijvoorbeeld: FunctionOne(
<<argument1>>, FunctionTwo(<<argument2>>))
Als u voor tekenreeksconstanten een backslash (\) of aanhalingsteken (") in de tekenreeks nodig hebt, moeten deze worden ge-escaped met het backslashteken (\). 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. |
| Tellen | 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. |
| Artikel | De functie Item retourneert één item van een tekenreeks/kenmerk met meerdere waarden. |
| Join | Join() is vergelijkbaar met Append(), behalve dat deze meerdere brontekenreekswaarden kan combineren tot één tekenreeks en elke waarde wordt gescheiden door een scheidingstekenreeks . |
| Left | 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 een deel van de tekens van de brontekenreeks bevat. |
| NormalizeDiacritics | Hiervoor is één tekenreeksargument vereist. Retourneert de tekenreeks, maar met diakritische tekens vervangen door gelijkwaardige niet-diakritische tekens. |
| Not | Hiermee wordt de Booleaanse waarde van de bron gespiegeld. Als de bronwaarde 'Waar' is, wordt 'Onwaar' geretourneerd. Anders wordt 'Waar' geretourneerd. |
| RemoveDuplicates | De functie RemoveDuplicates gebruikt een tekenreeks met meerdere waarden en zorgt ervoor dat elke waarde uniek is. |
| Replace | 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 gegenereerde waarde op uniekheid in de doel-app/-directory. |
| SingleAppRoleAssignment | Retourneert één appRoleAssignment uit de lijst met alle appRoleAssignments die zijn toegewezen aan een gebruiker voor een bepaalde toepassing. |
| Split | 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. |
| Switch | Wanneer de bronwaarde overeenkomt met een sleutel, retourneert u de waarde voor die sleutel. |
| ToLower | Neemt een brontekenreekswaarde en converteert deze naar kleine letters met behulp van de cultuurregels die zijn opgegeven. |
| Toupper | Neemt een brontekenreekswaarde en converteert deze naar hoofdletters met behulp van de cultuurregels die zijn opgegeven. |
| Trim | 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 | Opmerkingen |
|---|---|---|---|
| bron | Vereist | String | Gewoonlijk de naam van het kenmerk van het bron-object. |
| achtervoegsel | Vereist | String | 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 corresponderende bits 1 zijn.
Met andere woorden, de functie retourneert 0 in alle gevallen, behalve wanneer de corresponderende bits van beide parameters 1 zijn.
Voorbeeld:
BitAnd(&HF, &HF7)
Retourneert 7 omdat hexadecimale "F" EN "F7" resulteert in deze waarde.
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 voor codering
str ConvertFromBase64(str source, enum Encoding)
- bron: Met Base64 gecodeerde tekenreeks
- Codering: Unicode, ASCII, UTF8
Voorbeeld
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!")
Retourneert 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:
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")
Evalues tot 5
InStr("repEated","e",3,vbBinaryCompare)
Levert 7 op
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 zou dit resulteren in Waar als het kenmerk afwezig is of aanwezig is, maar een lege tekenreeks is.
De omgekeerde versie 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 omgekeerde versie 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.
Deelnemen
Functie:
Join(scheidingsteken, bron1, bron2, ...)
Beschrijving:
Join() is vergelijkbaar met Append(), behalve dat deze meerdere brontekenreekswaarden kan combineren tot één tekenreeks en elke waarde wordt gescheiden door een scheidingstekenreeks .
Als een van de bronwaarden een kenmerk met meerdere waarden is, worden alle waarden in dat kenmerk samengevoegd, gescheiden door de scheidingstekenwaarde.
Parameters:
| Naam | Vereist/herhalend | Type | Opmerkingen |
|---|---|---|---|
| scheidingsteken | Vereist | String | Tekenreeks die wordt gebruikt om bronwaarden te scheiden wanneer ze worden samengevoegd tot één tekenreeks. Mag "" zijn als geen scheidingsteken is vereist. |
| bron1 … bronN | Vereist, variabel aantal keren | String | Samen te voegen tekenreekswaarden. |
Left
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 aantalTekens = 0, retourneer lege tekenreeks.
- Als aantalTekens < 0, retourneer invoertekenreeks.
- Als tekenreeks null is, retourneer lege tekenreeks.
Als de tekenreeks minder tekens bevat dan het getal dat is opgegeven in aantalTekens, wordt een tekenreeks identiek aan tekenreeks (dat wil zeggen, met alle tekens in parameter 1) geretourneerd.
Voorbeeld:
Left("John Doe", 3)
Retourneert Joh.
Mid
Functie:
Mid(bron, begin, lengte)
Beschrijving:
Retourneert een subtekenreeks van de bronwaarde. Een subtekenreeks is een tekenreeks die slechts een deel van de tekens van de brontekenreeks bevat.
Parameters:
| Naam | Vereist/herhalend | Type | Opmerkingen |
|---|---|---|---|
| bron | Vereist | String | Gewoonlijk de naam van het kenmerk. |
| start | Vereist | geheel getal | Index in de bron-tekenreeks waar de subtekenreeks moet beginnen. Het eerste teken in de tekenreeks heeft de index 1, het tweede teken heeft de index 2, enzovoort. |
| length | Vereist | geheel getal | Lengte van de subtekenreeks. Als de lengte buiten de brontekenreeks eindigt, retourneert de functie de subtekenreeks van de beginindex tot het einde van de brontekenreeks. |
NormalizeDiacritics
Functie:
NormalizeDiacritics(source)
Beschrijving:
Hiervoor is één tekenreeksargument vereist. Retourneert de tekenreeks, maar met diakritische tekens vervangen door gelijkwaardige niet-diakritische tekens. Gewoonlijk gebruikt om voor- en achternamen met diakritische tekens (accenten) te converteren naar geldige waarden die kunnen worden gebruikt in verschillende gebruikers-id's, zoals user principal names, SAM-accountnamen en e-mailadressen.
Parameters:
| Naam | Vereist/herhalend | Type | Opmerkingen |
|---|---|---|---|
| bron | Vereist | String | Gewoonlijk een voor- of achternaamkenmerk. |
Not
Functie:
Not(bron)
Beschrijving:
Hiermee wordt de Booleaanse waarde van de bron gespiegeld. Als de bronwaarde 'Waar' is, wordt 'Onwaar' geretourneerd. Anders wordt 'Waar' geretourneerd.
Parameters:
| Naam | Vereist/herhalend | Type | Opmerkingen |
|---|---|---|---|
| bron | Vereist | Booleaanse tekenreeks | Verwachte bron-waarden zijn 'Waar' of 'Onwaar'. |
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.
Replace
Functie:
Replace(source, oldValue, regexPattern, regexGroupName, replacementValue, replacementAttributeName, template)
Beschrijving:
Vervangt waarden in een tekenreeks. Dit werkt anders, afhankelijk van de opgegeven parameters:
Wanneer oudeWaarde en vervangendeWaarde worden opgegeven:
- Vervangt alle exemplaren van oudeWaarde in de bron door vervangendeWaarde
Wanneer oudeWaarde en sjabloon worden opgegeven:
- Vervangt alle exemplaren van oudeWaarde in het sjabloon door de bron-waarde
Wanneer regexPatroon en vervangendeWaarde worden opgegeven:
- De functie past het regexPatroon toe op de bron-tekenreeks en u kunt de regexgroepsnamen gebruiken om de tekenreeks te construeren voor vervangendeWaarde
Wanneer regexPatroon, regexGroepsnaam en vervangendeWaarde worden opgegeven:
- De functie past het regexPatroon toe op de bron-tekenreeks en vervangt alle waarden die overeenkomen met regexGroepsnaam door vervangendeWaarde
Wanneer regexPatroon, regexGroepsnaam en naamVervangendKenmerk worden opgegeven:
- Als de bron geen waarde heeft, wordt de bron geretourneerd
- Als de bron een waarde heeft, past de functie regexPatterntoe op de brontekenreeks en vervangt deze alle waarden die overeenkomen met regexGroupName door de waarde die is gekoppeld aan replaceAttributeName
Parameters:
| Naam | Vereist/herhalend | Type | Opmerkingen |
|---|---|---|---|
| bron | Vereist | String | Gewoonlijk de naam van het kenmerk van het bron-object. |
| oudeWaarde | Optioneel | String | Waarde die moet worden vervangen in bron of sjabloon. |
| regexPatroon | Optioneel | String | Regexpatroon voor de waarde die moet worden vervangen in bron. Of, wanneer replacementPropertyName wordt gebruikt, patroon voor het extraheren van waarde uit replacementPropertyName. |
| regexGroepsnaam | Optioneel | String | Naam van de groep in regexPatroon. Alleen wanneer replacementPropertyName wordt gebruikt, wordt de waarde van deze groep geëxtraheerd als replacementValue van replacementPropertyName. |
| vervangendeWaarde | Optioneel | String | Nieuwe waarde om de oude door vervangen. |
| naamVervangendKenmerk | Optioneel | String | Naam van het kenmerk dat moet worden gebruikt als vervangende waarde |
| sjabloon | Optioneel | String | Wanneer sjabloon wordt opgegeven, wordt oudeWaarde gezocht in het sjabloon en vervangen door de bron-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 gegenereerde waarde op uniekheid in de doel-app/-directory. De eerste unieke waarde die wordt gevonden, is de waarde die wordt geretourneerd. Als alle waarden al aanwezig zijn in het doel, wordt de vermelding in bewaring geplaatst en wordt de reden geregistreerd 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 gelijke prioriteit.
- Deze functie is alleen bedoeld voor het maken van vermeldingen. Als de functie wordt gebruikt met een kenmerk, stel dan de eigenschap Toewijzing toepassen in op Alleen tijdens het maken van een object.
- Deze functie wordt momenteel alleen ondersteund voor 'Workday en SuccessFactors to Active Directory User Provisioning'. De functie kan niet worden gebruikt voor andere inrichtingstoepassingen.
Parameters:
| Naam | Vereist/herhalend | Type | Opmerkingen |
|---|---|---|---|
| uniekeWaardeRegel1 … uniekeWaardeRegelN | Ten minste 2 zijn vereist, geen bovengrens | String | Lijst van te evalueren regels voor het genereren van unieke waarden. |
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 approltoewijzingenobject 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 | Opmerkingen |
|---|---|---|---|
| [appRoleAssignments] | Vereist | String | [appRoleAssignments]-object. |
Split
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 | Opmerkingen |
|---|---|---|---|
| bron | Vereist | String | bron-waarde die moet worden bijgewerkt. |
| scheidingsteken | Vereist | String | Geeft het teken aan dat moet worden 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 | Opmerkingen |
|---|---|---|---|
| bron | Vereist | String | bron-waarde die moet worden bijgewerkt. |
Switch
Functie:
Switch(bron, defaultValue, key1, value1, key2, value2, ...)
Beschrijving:
Wanneer de bronwaarde overeenkomt met een sleutel, retourneert u de waarde voor die sleutel. Als de bron-waarde niet overeenkomt met een van de sleutels, wordt de standaardwaarde geretourneerd. Sleutel- en waarde-parameters moeten altijd in paren worden opgegeven. De functie verwacht altijd een even aantal parameters.
Parameters:
| Naam | Vereist/herhalend | Type | Opmerkingen |
|---|---|---|---|
| bron | Vereist | String | De bronwaarde die moet worden gecontroleerd. |
| standaardwaarde | Optioneel | String | De te gebruiken standaardwaarde wanneer de bron niet overeenkomt met een van de sleutels. Mag een lege tekenreeks ("") zijn. |
| key | Vereist | String | Sleutel om de bron-waarde mee te vergelijken. |
| value | Vereist | String | Vervangingswaarde voor de bron behorende bij de sleutel. |
ToLower
Functie:
ToLower(bron, cultuur)
Beschrijving:
Neemt een brontekenreekswaarde en converteert deze naar kleine letters met behulp van de cultuurregels die zijn opgegeven. Als er geen cultuur-informatie is opgegeven, wordt de cultuur Invariant gebruikt.
Parameters:
| Naam | Vereist/herhalend | Type | Opmerkingen |
|---|---|---|---|
| bron | Vereist | String | Gewoonlijk de naam van het kenmerk van het bronobject. |
| cultuur | Optioneel | String | De notatie van de cultuurnaam op basis van RFC 4646 is taalcode2-land/regiocode2, waarbij languagecode2 de tweeletterige taalcode is en land/regiocode2 de tweeletterige subcultuurcode is. Voorbeelden zijn ja-JP voor Japans (Japan) en en-US voor Engels (Verenigde Staten). In gevallen waarin er geen tweeletterige taalcode beschikbaar is, wordt een drieletterige code gebruikt die is afgeleid van ISO 639-2. |
ToUpper
Functie:
ToUpper(bron, cultuur)
Beschrijving:
Neemt een brontekenreekswaarde en converteert deze naar hoofdletters met behulp van de cultuurregels die zijn opgegeven. Als er geen cultuur-informatie is opgegeven, wordt de cultuur Invariant gebruikt.
Parameters:
| Naam | Vereist/herhalend | Type | Opmerkingen |
|---|---|---|---|
| bron | Vereist | String | Gewoonlijk de naam van het kenmerk van het bron-object. |
| cultuur | Optioneel | String | De notatie van de cultuurnaam op basis van RFC 4646 is taalcode2-land/regiocode2, waarbij languagecode2 de tweeletterige taalcode is en land/regiocode2 de tweeletterige subcultuurcode is. Voorbeelden zijn ja-JP voor Japans (Japan) en en-US voor Engels (Verenigde Staten). In gevallen waarin er geen tweeletterige taalcode beschikbaar is, wordt een drieletterige code gebruikt die is afgeleid van ISO 639-2. |
Trim
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.
Word
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 een woord:
- Als getal < 1, retourneer lege string.
- Als tekenreeks null is, retourneer lege tekenreeks.
Als de tekenreeks minder dan het aantal woorden bevat of als de tekenreeks geen woorden bevat geïdentificeerd door de 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 strippen
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:
Expression:
Replace([mail], "@contoso.com", , ,"", ,)
Voorbeeldinvoer/-uitvoer:
- INPUT (e-mail): "john.doe@contoso.com"
- UITVOER: "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.
Expression:
Append([userPrincipalName], ".test")
Voorbeeldinvoer/-uitvoer:
- INVOER: (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.
Expression:
Append(Mid([givenName], 1, 3), Mid([surname], 1, 5))
Voorbeeldinvoer/-uitvoer:
- INVOER (givenName): "John"
- INVOER (surname): "Doe"
- UITVOER: "JohDoe"
Diakritische tekens verwijderen uit een tekenreeks
U moet tekens met accentmarkeringen vervangen door gelijkwaardige tekens die geen accentmarkeringen bevatten.
Expression:
NormalizeDiacritics([givenName])
Voorbeeldinvoer/-uitvoer:
- INVOER (voornaam): "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.
Expression:
Split([extensionAttribute5], ",")
Voorbeeldinvoer/-uitvoer:
- INVOER (extensionAttribute5): "MachtigingenSetEen, MachtigingenSetTwee"
- UITVOER: ["MachtigingenSetEen", "MachtigingenSetTwee"]
Uitvoerdatum als tekenreeks in een bepaalde notatie
U wilt datums verzenden naar een SaaS-toepassing in een bepaalde indeling.
U wilt bijvoorbeeld datums opmaken voor ServiceNow.
Expression:
FormatDateTime([extensionAttribute1], "yyyyMMddHHmmss.fZ", "yyyy-MM-dd")
Voorbeeldinvoer/-uitvoer:
- INVOER (extensionAttribute1): "20150123105347.1Z"
- UITVOER: "2015-01-23"
Een waarde vervangen op basis van een 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, moet de standaardwaarde 'Australië/Sydney' worden gebruikt.
Expression:
Switch([state], "Australia/Sydney", "NSW", "Australia/Sydney","QLD", "Australia/Brisbane", "SA", "Australia/Adelaide")
Voorbeeldinvoer/-uitvoer:
- INVOER (staat): "QLD"
- UITVOER: "Australië/Brisbane"
Tekens vervangen met een reguliere expressie
U moet tekens zoeken die overeenkomen met een reguliere expressiewaarde en deze verwijderen.
Expression:
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:
- INVOER (PreferredFirstName): "John"
- INVOER (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.
Expression:
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:
- INVOER (PreferredFirstName): "John"
- INVOER (PreferredLastName): "Smith"
- UITVOER: "John.Smith@contoso.com" als de UPN-waarde John.Smith@contoso.com nog niet bestaat in de directory
- UITVOER: "J.Smith@contoso.com" als de UPN-waarde John.Smith@contoso.com al bestaat in de directory
- UITVOER: "Jo.Smith@contoso.com" als de twee bovenstaande UPN-waarden al bestaan in de directory