Écriture d'expressions pour les mappages d'attributs dans Microsoft Entra ID
Lors de la configuration de la synchronisation cloud, parmi les types de mappages d’attributs que l’on peut spécifier figure le mappage d’expression.
Le mappage d’expression vous permet de personnaliser des attributs à l’aide d’une expression de type script. Cela vous permet de transformer les données locales en une valeur nouvelle ou différente. Par exemple, vous pouvez combiner deux attributs en un seul parce que cet attribut unique est utilisé par l’une de vos applications cloud.
Le document suivant couvre les expressions de type script utilisées pour transformer les données. Cela ne constitue qu’une partie du processus. Ensuite, vous devez utiliser cette expression et la placer dans une requête web adressée à votre locataire. Pour plus d’informations, consultez Transformations.
Vue d’ensemble de la syntaxe
La syntaxe des expressions pour les mappages d’attributs rappelle celle des fonctions Visual Basic pour Applications (VBA).
L’expression entière doit être définie en termes de fonctions, qui sont constituées d’un nom suivi d’arguments entre parenthèses :
FunctionName(<<argument 1>>,<<argument N>>)Vous pouvez imbriquer des fonctions dans d’autres. Par exemple :
FunctionOne(FunctionTwo(<<argument1>>))Vous pouvez passer trois différents types d’arguments dans des fonctions :
- Des attributs, qui doivent être placés entre crochets. Par exemple : [nom_attribut]
- Des constantes de chaîne, qui doivent être placées entre des guillemets doubles. Par exemple : « États-Unis »
- D’autres fonctions. Par exemple : FunctionOne(
<<argument1>>, FunctionTwo(<<argument2>>))
Pour les constantes de chaîne, si vous avez besoin d’une barre oblique inverse (\) ou d’un guillemet (") dans la chaîne, vous devez le faire précéder du symbole de barre oblique inverse (\). Par exemple : « Nom de la société : \"Contoso\"" »
Liste des fonctions
| Liste des fonctions | Description |
|---|---|
| Append | prend une valeur de chaîne source et ajoute le suffixe à la fin de celle-ci. |
| BitAnd | la fonction BitAnd définit des bits spécifiés sur une valeur. |
| CBool | La fonction CBool renvoie une valeur booléenne basée sur l’expression évaluée. |
| ConvertFromBase64 | La fonction ConvertFromBase64 convertit la valeur encodée en base64 en chaîne régulière. |
| ConvertToBase64 | La fonction ConvertToBase64 convertit une chaîne en chaîne Unicode base64. |
| ConvertToUTF8Hex | La fonction ConvertToUTF8Hex convertit une chaîne en valeur hexadécimale encodée UTF8. |
| Count | La fonction Count renvoie le nombre d’éléments dans un attribut à valeurs multiples. |
| Cstr | La fonction CStr convertit en un type de données de chaîne. |
| DateFromNum | La fonction DateFromNum convertit une valeur au format de date AD en un type DateTime. |
| DNComponent | La fonction DNComponent renvoie la valeur d’un composant de nom de domaine spécifié en partant de la gauche. |
| Error | La fonction Error sert à renvoyer une erreur personnalisée. |
| FormatDateTime | prend une chaîne de date dans un format et la convertit dans un autre format. |
| GUID | La fonction Guid génère un nouveau GUID aléatoire. |
| IIF | La fonction IIF renvoie une valeur parmi un ensemble de valeurs possibles en fonction d’une condition spécifiée. |
| InStr | La fonction InStr recherche la première occurrence d’une sous-chaîne dans une chaîne. |
| IsNull | La fonction IsNull renvoie true si l’expression correspond à la valeur Null. |
| IsNullOrEmpty | La fonction IsNullOrEmpty renvoie la valeur true si l’expression a pour valeur Null ou s’il s’agit d’une chaîne vide. |
| IsPresent | La fonction IsPresent renvoie true si l’expression correspond à une chaîne qui n’a pas la valeur Null et n’est pas vide. |
| IsString | La fonction IsString prend la valeur True si l’expression peut être évaluée en tant que type de chaîne. |
| Item | La fonction Item renvoie un élément à partir d’une chaîne/d’un attribut à valeurs multiples. |
| Join | Join() est similaire à Append(), mais elle peut combiner plusieurs valeurs de chaîne sources dans une même chaîne et chaque valeur sera séparée par une chaîne de séparation. |
| Left | La fonction Left renvoie un nombre spécifié de caractères en partant de la gauche d’une chaîne. |
| Mid | retourne une sous-chaîne de la valeur source. Une sous-chaîne est une chaîne qui ne contient que certains des caractères de la chaîne source. |
| NormalizeDiacritics | Nécessite un argument de chaîne. Retourne la chaîne, où les caractères diacritiques ont été remplacés par leurs équivalents non diacritiques. |
| Not | inverse la valeur booléenne de la source. Si la valeur source est « True », cette fonction retourne «False ». Sinon, elle retourne «True». |
| RemoveDuplicates | La fonction RemoveDuplicates prend une chaîne à valeurs multiples et vérifie que chaque valeur est unique. |
| Replace | Remplace les valeurs dans une chaîne. |
| SelectUniqueValue | Nécessite un minimum de deux arguments, qui sont définis à l’aide d’expressions de règles de génération de valeur unique. La fonction évalue chaque règle, puis vérifie la valeur générée pour l’unicité dans le répertoire/application cible. |
| SingleAppRoleAssignment | Retourne un appRoleAssignment unique parmi la liste de tous les appRoleAssignments affectés à un utilisateur pour une application donnée. |
| Split | Fractionne une chaîne en un tableau à plusieurs valeurs, en utilisant le caractère délimiteur spécifié. |
| StringFromSID | La fonction StringFromSid convertit en chaîne un tableau d’octets contenant un identificateur de sécurité. |
| StripSpaces | supprime tous les caractères d’espacement (" ") de la chaîne source. |
| Switch | quand la valeur source correspond à une clé, retourne la valeur de cette clé. |
| ToLower | prend une valeur de la chaîne source et la convertit en minuscules à l’aide des règles de culture spécifiées. |
| ToUpper | prend une valeur de la chaîne source et la convertit en majuscule à l’aide des règles de culture spécifiées. |
| Trim | La fonction Trim supprime les espaces blancs situés au début et à la fin d’une chaîne. |
| Word | La fonction Word retourne un mot contenu dans une chaîne, en fonction des paramètres qui décrivent les délimiteurs à utiliser et le nombre de mots à retourner. |
Ajouter
Fonction :
Append(source, suffixe)
Description :
prend une valeur de chaîne source et ajoute le suffixe à la fin de celle-ci.
Paramètres :
| Nom | Requis / Répétition | Type | Notes |
|---|---|---|---|
| source | Obligatoire | String | Généralement le nom de l’attribut de l’objet source. |
| suffix | Obligatoire | String | Chaîne que vous souhaitez ajouter à la fin de la valeur source. |
BitAnd
Description :
la fonction BitAnd définit des bits spécifiés sur une valeur.
Syntaxe :
num BitAnd(num value1, num value2)
- value1, value2 : valeurs numériques qui doivent être liées par AND.
Remarques :
Cette fonction convertit les deux paramètres de la représentation binaire et définit un bit sur :
- 0 - si un des bits, ou les deux bits correspondants dans value1 et value2 ont pour valeur 0
- 1 - si les deux bits correspondants sont définis sur 1.
En d’autres termes, elle renvoie 0 dans tous les cas, sauf si les bits correspondants de ces deux paramètres sont définis sur 1.
Exemple :
BitAnd(&HF, &HF7)
Renvoie 7, car les valeurs hexadécimales « F » ET « F7 » donnent cette valeur.
CBool
Description :
La fonction CBool renvoie une valeur booléenne basée sur l’expression évaluée.
Syntaxe :
bool CBool(exp Expression)
Remarques :
Si l’expression renvoie une valeur autre que zéro, CBool renvoie la valeur True, sinon elle renvoie False.
Exemple :
CBool([attrib1] = [attrib2])
Retourne True si les attributs ont la même valeur.
ConvertFromBase64
Description :
La fonction ConvertFromBase64 convertit la valeur encodée en base64 en chaîne régulière.
Syntaxe :
str ConvertFromBase64(str source) - part du principe que l’encodage utilisé est Unicode
str ConvertFromBase64(str source, enum Encoding)
- source : Chaîne encodée Base64
- Encodage : Unicode, ASCII, UTF8
Exemple
ConvertFromBase64("SABlAGwAbABvACAAdwBvAHIAbABkACEA")
ConvertFromBase64("SGVsbG8gd29ybGQh", UTF8)
Les deux exemples renvoient «Hello world! »
ConvertToBase64
Description :
La fonction ConvertToBase64 convertit une chaîne en chaîne Unicode base64.
Convertit la valeur d’un tableau d’entiers en sa représentation sous forme de chaîne équivalente encodée avec des chiffres en base 64.
Syntaxe :
str ConvertToBase64(str source)
Exemple :
ConvertToBase64("Hello world!")
Renvoie « SABlAGwAbABvACAAdwBvAHIAbABkACEA ».
ConvertToUTF8Hex
Description :
La fonction ConvertToUTF8Hex convertit une chaîne en valeur hexadécimale encodée UTF8.
Syntaxe :
str ConvertToUTF8Hex(str source)
Remarques :
Le format de sortie de cette fonction est utilisé par Microsoft Entra ID en tant que format d’attribut de nom de domaine.
Exemple :
ConvertToUTF8Hex("Hello world!")
Renvoie 48656C6C6F20776F726C6421.
Count
Description :
La fonction Count renvoie le nombre d’éléments dans un attribut à valeurs multiples.
Syntaxe :
num Count(mvstr attribute)
CChaîne
Description :
La fonction CStr convertit en un type de données de chaîne.
Syntaxe :
str CStr(num value)
str CStr(ref value)
str CStr(bool value)
- value : Peut être une valeur numérique, un attribut de référence ou une valeur booléenne.
Exemple :
CStr([dn])
Peut renvoyer « cn=Joe,dc=contoso,dc=com ».
DateFromNum
Description :
La fonction DateFromNum convertit une valeur au format de date AD en un type DateTime.
Syntaxe :
dt DateFromNum(num value)
Exemple :
DateFromNum([lastLogonTimestamp])
DateFromNum(129699324000000000)
Renvoie une valeur DateTime représentant 2012-01-01 23:00:00.
DNComponent
Description :
La fonction DNComponent renvoie la valeur d’un composant de nom de domaine spécifié en partant de la gauche.
Syntaxe :
str DNComponent(ref dn, num ComponentNumber)
- dn : attribut de référence à interpréter
- ComponentNumber : Composant du nom de domaine à retourner
Exemple :
DNComponent(CRef([dn]),1)
Si dn est « cn=Joe,ou=… », la fonction renvoie Joe.
Error
Description :
La fonction Error sert à renvoyer une erreur personnalisée.
Syntaxe :
void Error(str ErrorMessage)
Exemple :
IIF(IsPresent([accountName]),[accountName],Error("AccountName is required"))
Si l’attribut accountName n’est pas présent, renvoie une erreur sur l’objet.
FormatDateTime
Fonction :
FormatDateTime(source, inputFormat, outputFormat)
Description :
prend une chaîne de date dans un format et la convertit dans un autre format.
Paramètres :
| Nom | Requis / Répétition | Type | Notes |
|---|---|---|---|
| source | Obligatoire | String | Généralement le nom de l’attribut de l’objet source. |
| inputFormat | Obligatoire | String | Format attendu de la valeur source. Pour les formats pris en charge, consultez /dotnet/standard/base-types/custom-date-and-time-format-strings. |
| outputFormat | Obligatoire | String | Format de la date de sortie. |
Guid
Description :
La fonction Guid génère un nouveau GUID aléatoire.
Syntaxe :
str Guid()
IIF
Description :
La fonction IIF renvoie une valeur parmi un ensemble de valeurs possibles en fonction d’une condition spécifiée.
Syntaxe :
var IIF(exp condition, var valueIfTrue, var valueIfFalse)
- condition : toute valeur ou expression qui peut être évaluée à true ou false.
- valueIfTrue : La valeur renvoyée si la condition prend la valeur true.
- valueIfFalse : La valeur renvoyée si la condition prend la valeur false.
Exemple :
IIF([employeeType]="Intern","t-" & [alias],[alias])
Renvoie l’alias d’un utilisateur avec le préfixe « t- » si l’utilisateur est stagiaire. Sinon, l’alias reste inchangé.
InStr
Description :
La fonction InStr recherche la première occurrence d’une sous-chaîne dans une chaîne.
Syntaxe :
num InStr(str stringcheck, str stringmatch)
num InStr(str stringcheck, str stringmatch, num start)
num InStr(str stringcheck, str stringmatch, num start, enum compare)
- stringcheck : chaîne à rechercher
- stringmatch : chaîne à trouver
- start : position de départ pour trouver la sous-chaîne
- compare : vbTextCompare ou vbBinaryCompare
Remarques :
Renvoie la position à laquelle la sous-chaîne a été trouvée, ou 0 si elle est introuvable.
Exemple :
InStr("The quick brown fox","quick")
Prend la valeur 5.
InStr("repEated","e",3,vbBinaryCompare)
Prend la valeur 7.
IsNull
Description :
La fonction IsNull renvoie true si l’expression correspond à la valeur Null.
Syntaxe :
bool IsNull(var Expression)
Remarques :
Dans le cas d’un attribut, la valeur Null est exprimée par l’absence de ce dernier.
Exemple :
IsNull([displayName])
Renvoie True si l’attribut est absent dans CS ou MV.
IsNullOrEmpty
Description :
La fonction IsNullOrEmpty renvoie la valeur true si l’expression a pour valeur Null ou s’il s’agit d’une chaîne vide.
Syntaxe :
bool IsNullOrEmpty(var Expression)
Remarques :
Dans le cas d’un attribut, cela donne la valeur True si l’attribut est absent ou est présent mais qu’il s’agit d’une chaîne vide.
L’inverse de cette fonction est nommé IsPresent.
Exemple :
IsNullOrEmpty([displayName])
Renvoie True si l’attribut est absent dans CS ou MV ou s’il s’agit d’une chaîne vide.
IsPresent
Description :
La fonction IsPresent renvoie true si l’expression correspond à une chaîne qui n’a pas la valeur Null et n’est pas vide.
Syntaxe :
bool IsPresent(var expression)
Remarques :
L’inverse de cette fonction est appelé IsNullOrEmpty.
Exemple :
Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director])
Élément
Description :
La fonction Item renvoie un élément à partir d’une chaîne/d’un attribut à valeurs multiples.
Syntaxe :
var Item(mvstr attribute, num index)
- attribute : attribut à valeurs multiples
- index : index vers un élément dans la chaîne à valeurs multiples.
Remarques :
la fonction Item est utile si utilisée avec la fonction Contains, car cette dernière renvoie l’index à un élément de l’attribut à valeurs multiples.
Génère une erreur si l’index est hors limites.
Exemple :
Mid(Item([proxyAddresses],Contains([proxyAddresses], "SMTP:")),6)
Renvoie l’adresse de messagerie principale.
IsString
Description :
La fonction IsString prend la valeur True si l’expression peut être évaluée en tant que type de chaîne.
Syntaxe :
bool IsString(var expression)
Remarques :
Permet de déterminer si CStr() peut parvenir à analyser l’expression.
Join
Fonction :
Join(séparateur, source1, source2, …)
Description :
Join() est similaire à Append(), mais elle peut combiner plusieurs valeurs de chaîne sources dans une même chaîne et chaque valeur sera séparée par une chaîne de séparation.
Si l’une des valeurs sources est un attribut à valeurs multiples, toutes les valeurs de cet attribut seront jointes, séparées par la valeur de séparation.
Paramètres :
| Nom | Requis / Répétition | Type | Notes |
|---|---|---|---|
| separator | Obligatoire | String | Chaîne utilisée pour séparer les valeurs sources quand elles sont concaténées en une seule chaîne. Peut être "" si aucun séparateur n’est requis. |
| source1 … sourceN | Requis, nombre de fois variable | String | Valeurs de chaîne à joindre ensemble. |
Gauche
Description :
La fonction Left renvoie un nombre spécifié de caractères en partant de la gauche d’une chaîne.
Syntaxe :
str Left(str string, num NumChars)
- string : chaîne à partir de laquelle les caractères sont renvoyés
- NumChars : nombre identifiant le nombre de caractères à retourner du début (à gauche) de la chaîne
Remarques :
Chaîne contenant les numChars premiers caractères de la chaîne :
- Si numChars = 0, retourne une chaîne vide.
- Si numChars < 0, retourne une chaîne d’entrée.
- Si la chaîne est null, retourne une chaîne vide.
Si la chaîne contient moins de caractères que le nombre spécifié dans numChars, une chaîne identique à la chaîne (c’est-à-dire, contenant tous les caractères du paramètre 1) est renvoyée.
Exemple :
Left("John Doe", 3)
Retourne Joh.
ExtracChaîne
Fonction :
Mid(source, début, longueur)
Description :
retourne une sous-chaîne de la valeur source. Une sous-chaîne est une chaîne qui ne contient que certains des caractères de la chaîne source.
Paramètres :
| Nom | Requis / Répétition | Type | Notes |
|---|---|---|---|
| source | Obligatoire | String | Généralement le nom de l’attribut. |
| start | Obligatoire | entier | Index dans la chaîne source où la sous-chaîne doit commencer. Le premier caractère dans la chaîne aura l’index 1, le deuxième caractère aura l’index 2, et ainsi de suite. |
| length | Obligatoire | entier | Longueur de la sous-chaîne. Si la longueur se termine à l’extérieur de la chaîne source, la fonction retourne la sous-chaîne de l’index start jusqu’à la fin de l’index source. |
NormalizeDiacritics
Fonction :
NormalizeDiacritics(source)
Description :
Nécessite un argument de chaîne. Retourne la chaîne, où les caractères diacritiques ont été remplacés par leurs équivalents non diacritiques. Généralement utilisé pour convertir les prénoms et les noms contenant des caractères diacritiques (accents) en valeurs autorisées pouvant être utilisées dans différents identificateurs d’utilisateurs, tels que les noms d’utilisateurs principaux, les noms de compte SAM et les adresses e-mail.
Paramètres :
| Nom | Requis / Répétition | Type | Notes |
|---|---|---|---|
| source | Obligatoire | String | Généralement un attribut de nom ou de prénom. |
Not
Fonction :
Not(source)
Description :
inverse la valeur booléenne de la source. Si la valeur source est « True », cette fonction retourne «False ». Sinon, elle retourne «True».
Paramètres :
| Nom | Requis / Répétition | Type | Notes |
|---|---|---|---|
| source | Obligatoire | Chaîne de type Boolean | Les valeurs sources attendues sont « True » ou « False ». |
RemoveDuplicates
Description :
La fonction RemoveDuplicates prend une chaîne à valeurs multiples et vérifie que chaque valeur est unique.
Syntaxe :
mvstr RemoveDuplicates(mvstr attribute)
Exemple :
RemoveDuplicates([proxyAddresses])
Renvoie un attribut proxyAddress expurgé duquel toutes les valeurs en double ont été supprimées.
Replace
Fonction :
Remplacer (source, oldValue, regexPattern, regexGroupName, replacementValue, replacementAttributeName, template)
Description :
Remplace les valeurs dans une chaîne. Elle fonctionne différemment selon les paramètres fournis :
Quand oldValue et replacementValue sont fournis :
- Remplace toutes les occurrences d’oldValue dans la source par replacementValue
Quand oldValue et template sont fournis :
- Remplace toutes les occurrences d’oldValue dans le template par la valeur source.
Quand regexPattern et replacementValue sont fournis :
- La fonction applique regexPattern à la chaîne source et vous pouvez utiliser les noms de groupes regex pour construire la chaîne pour replacementValue.
Quand regexPattern, regexGroupName et replacementValue sont fournis :
- La fonction applique regexPattern à la chaîne source et remplace toutes les valeurs correspondant à regexGroupName par replacementValue.
Quand regexPattern, regexGroupName et replacementAttributeName sont fournis :
- Si source n’a pas de valeur, source est retourné
- Si source a une valeur, la fonction applique regexPattern à la chaîne source et remplace toutes les valeurs correspondant à regexGroupName par la valeur associée à replacementAttributeName.
Paramètres :
| Nom | Requis / Répétition | Type | Notes |
|---|---|---|---|
| source | Obligatoire | String | Généralement, nom de l’attribut de l’objet source. |
| oldValue | Facultatif | String | Valeur à remplacer dans source ou template. |
| regexPattern | Facultatif | String | Modèle d’expression régulière pour la valeur à remplacer dans source. Ou, quand replacementPropertyName est utilisé, modèle pour extraire la valeur de replacementPropertyName. |
| regexGroupName | Facultatif | String | Nom du groupe à l’intérieur de regexPattern. Nous extrayons la valeur de ce groupe en tant que replacementValue à partir de replacementPropertyName uniquement quand replacementPropertyName est utilisé. |
| replacementValue | Facultatif | String | Nouvelle valeur par laquelle remplacer l’ancienne. |
| replacementAttributeName | Facultatif | String | Nom de l’attribut à utiliser pour la valeur de remplacement. |
| template | Facultatif | String | Lorsque la valeur template est fournie, nous recherchons la valeur oldValue dans le modèle et la remplaçons par la valeur source. |
SelectUniqueValue
Fonction :
SelectUniqueValue(uniqueValueRule1, uniqueValueRule2, uniqueValueRule3, …)
Description :
Nécessite un minimum de deux arguments, qui sont définis à l’aide d’expressions de règles de génération de valeur unique. La fonction évalue chaque règle, puis vérifie la valeur générée pour l’unicité dans le répertoire/application cible. La première valeur unique trouvée est celle retournée. Si toutes les valeurs existent déjà dans la cible, l’entrée sera déposée et le motif de cette action consigné dans les journaux d’audit. Il n’existe aucune limite supérieure au nombre d’arguments qui peuvent être fournis.
Notes
- Il s’agit d’une fonction de niveau supérieur, vous ne pouvez donc pas l’imbriquer.
- Cette fonction ne peut pas s’appliquer à des attributs qui ont une priorité de correspondance.
- Cette fonction est uniquement destinée à être utilisée pour les créations d’entrées. Lorsque vous l’utilisez avec un attribut, définissez la propriété Appliquer le mappage sur Uniquement durant la création d’objet.
- Cette fonction est actuellement prise en charge uniquement pour le « provisionnement d’utilisateurs de Workday et SuccessFactors vers Active Directory ». Elle ne peut pas être utilisée avec d’autres applications de provisionnement.
Paramètres :
| Nom | Requis / Répétition | Type | Notes |
|---|---|---|---|
| uniqueValueRule1 … uniqueValueRuleN | Au moins 2 requis, aucune limite supérieure | String | Liste des règles de génération de valeur unique à évaluer. |
SingleAppRoleAssignment
Fonction :
SingleAppRoleAssignment([appRoleAssignments])
Description :
Retourne un appRoleAssignment unique parmi la liste de tous les appRoleAssignments affectés à un utilisateur pour une application donnée. Cette fonction est nécessaire pour convertir l’objet appRoleAssignments en une chaîne de nom de rôle unique. Notez que la bonne pratique consiste à s’assurer qu’un seul appRoleAssignment est attribué à un seul utilisateur à la fois, et si plusieurs rôles sont attribués, la chaîne de rôle retournée ne doit pas être prévisible.
Paramètres :
| Nom | Requis / Répétition | Type | Notes |
|---|---|---|---|
| [appRoleAssignments] | Obligatoire | String | Objet [appRoleAssignments] . |
Split
Fonction :
Split (source, délimiteur)
Description :
Fractionne une chaîne en un tableau à plusieurs valeurs, en utilisant le caractère délimiteur spécifié.
Paramètres :
| Nom | Requis / Répétition | Type | Notes |
|---|---|---|---|
| source | Obligatoire | String | source à mettre à jour. |
| délimiteur | Obligatoire | String | Spécifie le caractère qui sera utilisé pour fractionner la chaîne (exemple : « , ») |
StringFromSid
Description :
La fonction StringFromSid convertit en chaîne un tableau d’octets contenant un identificateur de sécurité.
Syntaxe :
str StringFromSid(bin ObjectSID)
StripSpaces
Fonction :
StripSpaces(source)
Description :
supprime tous les caractères d’espacement (" ") de la chaîne source.
Paramètres :
| Nom | Requis / Répétition | Type | Notes |
|---|---|---|---|
| source | Obligatoire | String | source à mettre à jour. |
Commutateur
Fonction :
Switch(source, defaultValue, key1, value1, key2, value2, …)
Description :
quand la valeur source correspond à une clé, retourne la valeur de cette clé. Si la valeur source ne correspond à aucune clé, retourne defaultValue. Les paramètres key et value doivent toujours être fournis par paires. La fonction attend toujours un nombre pair de paramètres.
Paramètres :
| Nom | Requis / Répétition | Type | Notes |
|---|---|---|---|
| source | Obligatoire | String | Valeur source à vérifier. |
| defaultValue | Facultatif | String | Valeur par défaut à utiliser quand la source ne correspond à aucune clé. Peut être une chaîne vide (""). |
| key | Obligatoire | String | Key avec laquelle comparer la valeur source. |
| value | Obligatoire | String | Valeur de remplacement pour la source correspondant à la clé. |
ToLower
Fonction :
ToLower(source, culture)
Description :
prend une valeur de la chaîne source et la convertit en minuscules à l’aide des règles de culture spécifiées. Si aucune information de culture n'est spécifiée, une culture invariante est utilisée.
Paramètres :
| Nom | Requis / Répétition | Type | Notes |
|---|---|---|---|
| source | Obligatoire | String | Généralement le nom de l’attribut de l’objet source |
| culture | Facultatif | String | Le format du nom de culture basé sur RFC 4646 est languagecode2-country/regioncode2, où languagecode2 correspond au code de langue à deux lettres et country/regioncode2 au code de sous-culture à deux lettres, par exemple, ja-JP pour le japonais (Japon) et en-US pour l’anglais (États-Unis). Si un code de langue à deux lettres n'est pas disponible, un code à trois lettres dérivé de la norme ISO 639-2 est utilisé. |
ToUpper
Fonction :
ToUpper(source, culture)
Description :
prend une valeur de la chaîne source et la convertit en majuscule à l’aide des règles de culture spécifiées. Si aucune information de culture n'est spécifiée, une culture invariante est utilisée.
Paramètres :
| Nom | Requis / Répétition | Type | Notes |
|---|---|---|---|
| source | Obligatoire | String | Généralement le nom de l’attribut de l’objet source. |
| culture | Facultatif | String | Le format du nom de culture basé sur RFC 4646 est languagecode2-country/regioncode2, où languagecode2 correspond au code de langue à deux lettres et country/regioncode2 au code de sous-culture à deux lettres, par exemple, ja-JP pour le japonais (Japon) et en-US pour l’anglais (États-Unis). Si un code de langue à deux lettres n'est pas disponible, un code à trois lettres dérivé de la norme ISO 639-2 est utilisé. |
SupprEspace
Description :
La fonction Trim supprime les espaces blancs situés au début et à la fin d’une chaîne.
Syntaxe :
str Trim(str value)
Exemple :
Trim(" Test ")
Renvoie « test ».
Trim([proxyAddresses])
Supprime les espaces blancs de début et de fin pour chaque valeur contenue dans l’attribut proxyAddress.
Word
Description :
La fonction Word retourne un mot contenu dans une chaîne, en fonction des paramètres qui décrivent les délimiteurs à utiliser et le nombre de mots à retourner.
Syntaxe :
str Word(str string, num WordNumber, str delimiters)
- string : chaîne à partir de laquelle le mot est renvoyé.
- WordNumber : nombre identifiant le nombre de mots à renvoyer.
- delimiters : chaîne représentant le ou les délimiteur(s) à utiliser pour identifier les mots
Remarques :
Chaque chaîne de caractères contenue dans la chaîne séparée par l’un des caractères figurant dans delimiters est identifiée en tant que mot :
- Si number < 1, retourne une chaîne vide.
- Si string a la valeur null, renvoie une chaîne vide.
Si la chaîne contient moins de mots ou ne contient pas les mots identifiés par les séparateurs, une chaîne vide est renvoyée.
Exemple :
Word("The quick brown fox",3," ")
Retourne « brown ».
Word("This,string!has&many separators",3,",!&#")
Retourne « has ».
Exemples
Supprimer un nom de domaine connu
Vous devez supprimer un nom de domaine connu de l’adresse de messagerie d’un utilisateur pour obtenir un nom d’utilisateur.
Par exemple, si le domaine est « contoso.com », vous pouvez utiliser l’expression suivante :
Expression :
Replace([mail], "@contoso.com", , ,"", ,)
Exemple d’entrée/sortie :
- ENTRÉE (e-mail) : "john.doe@contoso.com"
- SORTIE: « john.doe »
Ajouter un suffixe de constante à un nom d’utilisateur
Si vous utilisez un Sandbox Salesforce, vous devrez peut-être ajouter un suffixe supplémentaire à tous les noms d’utilisateurs avant de les synchroniser.
Expression :
Append([userPrincipalName], ".test")
Exemple d’entrée/sortie :
- ENTRÉE : (userPrincipalName) : "John.Doe@contoso.com"
- SORTIE : "John.Doe@contoso.com.test"
Générer des alias d’utilisateurs en concaténant des parties du prénom et du nom
Vous devez générer un alias d’utilisateur en prenant les trois premières lettres du prénom de l’utilisateur et les cinq premières lettres de son nom de famille.
Expression :
Append(Mid([givenName], 1, 3), Mid([surname], 1, 5))
Exemple d’entrée/sortie :
- ENTRÉE (givenName) : "John"
- ENTRÉE (surname) : "Doe"
- SORTIE: « JohDoe »
Supprimer les signes diacritiques d’une chaîne
Vous devez remplacer les caractères accentués par leurs équivalents non accentués.
Expression :
NormalizeDiacritics([givenName])
Exemple d’entrée/sortie :
- ENTRÉE (givenName) : "Zoë"
- SORTIE : « Zoe »
Fractionner une chaîne en un tableau à valeurs multiples
Vous devez prendre une liste de chaînes délimitées par des virgules, et la fractionner en un tableau pouvant être raccordé à un attribut à valeurs multiples comme l’attribut PermissionSets de Salesforce. Dans cet exemple, une liste des jeux d’autorisations a été remplie dans extensionAttribute5 dans Microsoft Entra ID.
Expression :
Split([extensionAttribute5], ",")
Exemple d’entrée/sortie :
- INPUT (extensionAttribute5): "PermissionSetOne, PermissionSetTwo"
- SORTIE : ["PermissionSetOne", "PermissionSetTwo"]
Sortir une date sous la forme d’une chaîne dans un certain format
Vous souhaitez envoyer des dates à une application SaaS dans un format donné.
Par exemple, vous souhaitez mettre en forme des dates pour ServiceNow.
Expression :
FormatDateTime([extensionAttribute1], "yyyyMMddHHmmss.fZ", "yyyy-MM-dd")
Exemple d’entrée/sortie :
- ENTRÉE (extensionAttribute1) : "20150123105347.1Z"
- SORTIE: « 2015-01-23 »
Remplacer une valeur en fonction d’un ensemble d’options prédéfini
Vous devez définir le fuseau horaire de l’utilisateur en fonction du code d’état stocké dans Microsoft Entra ID.
Si le code d’état ne correspond à aucune des options prédéfinies, utilisez la valeur par défaut « Australia/Sydney ».
Expression :
Switch([state], "Australia/Sydney", "NSW", "Australia/Sydney","QLD", "Australia/Brisbane", "SA", "Australia/Adelaide")
Exemple d’entrée/sortie :
- ENTRÉE (état) : "QLD"
- SORTIE : "Australia/Brisbane"
Remplacer des caractères à l’aide d’une expression régulière
Vous devez rechercher des caractères correspondant à une valeur d’expression régulière et les supprimer.
Expression :
Replace([mailNickname], , "[a-zA-Z_]*", , "", , )
Exemple d’entrée/sortie :
- ENTRÉE (mailNickname: "john_doe72"
- SORTIE : "72"
Convertir la valeur userPrincipalName (UPN) générée en minuscules
Dans l’exemple ci-dessous, la valeur UPN est générée en concaténant les champs sources PreferredFirstName et PreferredLastName, et la fonction ToLower agit sur la chaîne générée pour convertir tous les caractères en minuscules.
ToLower(Join("@", NormalizeDiacritics(StripSpaces(Join(".", [PreferredFirstName], [PreferredLastName]))), "contoso.com"))
Exemple d’entrée/sortie :
- ENTRÉE (PreferredFirstName) : "John"
- ENTRÉE (PreferredLastName) : "Smith"
- SORTIE : "john.smith@contoso.com"
Générer une valeur unique pour l’attribut userPrincipalName (UPN)
En fonction du prénom, du deuxième prénom et du nom de famille de l’utilisateur, vous devez générer une valeur pour l’attribut UPN et vérifier son caractère unique dans le répertoire AD cible avant d’attribuer la valeur à l’attribut UPN.
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")
)
Exemple d’entrée/sortie :
- ENTRÉE (PreferredFirstName) : "John"
- ENTRÉE (PreferredLastName) : "Smith"
- SORTIE : « John.Smith@contoso.com » si la valeur UPN de John.Smith@contoso.com n’existe pas déjà dans le répertoire
- SORTIE : « J.Smith@contoso.com » si la valeur UPN de John.Smith@contoso.com existe déjà dans le répertoire
- SORTIE : « Jo.Smith@contoso.com » si les deux valeurs UPN précédentes existent déjà dans le répertoire
Étapes suivantes
Commentaires
Prochainement : Tout au long de l'année 2024, nous supprimerons progressivement les GitHub Issues en tant que mécanisme de retour d'information pour le contenu et nous les remplacerons par un nouveau système de retour d'information. Pour plus d’informations, voir: https://aka.ms/ContentUserFeedback.
Soumettre et afficher des commentaires pour