> Source: https://docs.cyberelements.io/identity/7.1/fr/UserDocumentation/AutomaticProvisioningConnectorsManagement/KeywordsInOperations/CharacterStrings/

# Chaînes de caractères

## UPPER

Modifie un texte pour le passer tout en majuscule.

**Syntaxe de la fonction :**

<UPPER:[Expression]>

**Mode d'utilisation :**

- Le mot-clé UPPER peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression évaluée peut contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

## LOWER

Modifie un texte pour le passer tout en minuscule.

**Syntaxe de la fonction :**

<LOWER:[Expression]>

**Mode d'utilisation :**

- Le mot-clé LOWER peut être utilisé dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression évaluée peut contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

## LEFT

**Syntaxe de la fonction :**

<LEFT:[Nombre_caractères]:[Expression]>

**Mode d'utilisation :**

- Le mot-clé LEFT peut être utilisé dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression évaluée peut contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

## TOKLEFT

Récupère le énième objet compté à partir de la gauche.

**Syntaxe de la fonction :**

<TOKLEFT:[séparateur]:[Nombre_objet]:[Expression]>

Un objet est compris entre 2 séparateurs. Il n’est pas nécessaire de mettre un séparateur en début et fin de chaîne de l’expression.

**Mode d'utilisation :**

- Le mot-clé TOKLEFT peut être utilisé dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression évaluée peut contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

**Exemples de configuration :**

- Exemple :
    - <TOKLEFT:/:3:Niveau 1/Niveau 2/Niveau 3/Niveau 4/ Niveau 5>
    - Résultat renvoyé : Niveau 3

## RIGHT

Récupère un nombre de caractères à partir de la droite d’une valeur.

**Syntaxe de la fonction :**

<RIGHT:[Nombre_caractères]:[Expression]>

**Mode d'utilisation :**

- Le mot-clé RIGHT peut être utilisé dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression évaluée peut contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

## SHA256

Permet de chiffrer une chaîne de caractère en SHA256.

**Syntaxe de la fonction :**

<SHA256:[encodage_chaine]:[Hex_B64]:[Expression]>

Avec :

- [encodage_chaine] : « UTF8 » ou « UTF16 ». Encodage à spécifier selon le format attendu par l’application cible. Il convient d’utiliser UTF8 dans la majorité des cas.
- [Hex_B64] : « HEX » ou « B64 » pour choisir le format de la chaîne. HEX pour hexadécimal, B64 pour base 64.

**Mode d'utilisation :**

- Le mot-clé SHA256 peut être utilisé dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression évaluée peut contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

## TOKRIGHT

Récupère une partie d’une chaîne de caractère à partir énième objet compté à partir de la droite.

**Syntaxe de la fonction :**

<TOKRIGHT:[séparateur]:[Nombre_objet]:[Expression]>

Un objet est compris entre 2 séparateurs. Il n’est pas nécessaire de mettre un séparateur en début et fin de chaîne de l’expression.

**Mode d'utilisation :**

- Le mot-clé TOKRIGHT peut être utilisé dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression évaluée peut contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

**Exemples de configuration :**

- Exemple :
    - <TOKLEFT:/:2:Niveau 1/Niveau 2/Niveau 3/Niveau 4/ Niveau 5>
    - Résultat renvoyé : Niveau 4/ Niveau 5

## CENTER

Récupère les caractères du centre en supprimant un nombre de caractères à gauche et à droite.

**Syntaxe de la fonction :**

<CENTER:[Nombre_caract_gauche_à_supp]:[Nombre_caract_droite_à_supp]:[Expression]>

**Mode d'utilisation :**

- Le mot-clé CENTER peut être utilisé dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression évaluée peut contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

## REWRITEURL

Ré-écriture d’une url.

**Syntaxe de la fonction :**

<REWRITEURL:[url]>

**Mode d'utilisation :**

- Le mot-clé REWRITEURL peut être utilisé dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.

**Exemples de configuration :** - Exemple :

```
1
2
```

## GEN_PASSWORD

Génération d’un mot de passe en fonction d’un masque et avec le support des caractères spéciaux définis dans les paramètres.

**Syntaxe de la fonction :**

<GEN_PASSWORD:[format_pwd]:[caractères_spéciaux]>

Le format du mot de passe doit être défini avec les éléments suivants :

- U Une lettre majuscule
- L Une lettre minuscule
- A Une lettre minuscule ou majuscule
- N Un chiffre
- S Un caractère spécial de la liste [caractères_spéciaux]
- X Un caractère de l’ensemble (U+L+N+S)

**Mode d'utilisation :**

- Le mot-clé GEN_PASSWORD peut être utilisé dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.

**Exemples de configuration :**

- Exemple :
    - <GEN_PASSWORD:ULNXXXXXXX:,$£!§&#>

## B64ENCODEASCII

Convertit une expression en ASCII puis renvoie la chaîne encodée en B64.

**Syntaxe de la fonction :**

<B64ENCODEASCII:[Expression]>

**Mode d'utilisation :**

- Le mot-clé B64ENCODEASCII peut être utilisé dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression évaluée peut contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

## B64SID2STRING

Convertit un SID en Base64 et renvoie la chaîne au format unicode.

**Syntaxe de la fonction :**

<B64SID2STRING:[Expression]>

**Mode d'utilisation :**

- Le mot-clé B64SID2STRING peut être utilisé dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression évaluée peut contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

## FIND

Fonction qui permet de trouver la position d'une chaîne de caractère dans une autre chaîne de caractère. Elle renvoie l’index de la position (commence à l'index 0) si la chaîne est trouvée, sinon elle renvoie la longueur de la chaîne.

**Syntaxe de la fonction :**

<FIND:[chaîne_recherchée]:[chaîne_initiale]:[index_de_départ]>

L'index commence à la position 0.

**Mode d'utilisation :**

- L'opération FIND peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- Les différentes chaînes utilisées dans l’expression peuvent contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

**Exemples de configuration :**

- Exemple 1 :
    - <FIND:E:<SyncAttSrc:PRENOM>:0> avec <SyncAttSrc:PRENOM> = Emilie
    - Résultat = 0
- Exemple 2 :
    - <FIND:I:<SyncAttSrc:PRENOM>:0> avec <SyncAttSrc:PRENOM> = Emilie
    - Résultat = 2
- Exemple 3 :
    - <FIND:E:<SyncAttSrc:PRENOM>:0> avec <SyncAttSrc:PRENOM> = Paul
    - Résultat = 4

## SUBSTRING

Fonction qui permet d'extraire une chaîne de caractère à partir d'une autre chaîne de caractère. Elle renvoie la chaîne de caractères si les paramètres passés sont valides sinon, elle renvoie vide. **Syntaxe de la fonction :**

<SUBSTRING:[chaîne_initiale]:[index_début]:[longueur_chaîne]>

L'index commence à la position 0.

**Mode d'utilisation :**

- L'opération SUBSTRING peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- Les différentes chaînes utilisées dans l’expression peuvent contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

**Exemples de configuration :** - Exemple 1 : * <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> avec <SyncAttSrc:DisplayName> = Carine HOPFNER * Résultat = Carine

## LEN

Fonction qui renvoie la longueur d'une chaîne de caractère. La fonction renvoie 0 si une erreur est présente dans la configuration.

**Syntaxe de la fonction :**

<LEN:[chaîne_initiale]>

**Mode d'utilisation :**

- L'opération LEN peut être utilisée dans tous les champs de type « expression » comme par exemple les opérations de type COPY, MODVALUE, etc.
- Les différentes chaînes utilisées dans l’expression peuvent contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

**Exemples de configuration :**

- Exemple 1 :
    - <LEN:<SyncAttSrc:DisplayName>> avec <SyncAttSrc:DisplayName> = Emilie Paris
    - Résultat = 12

## REPLACE

Disponible à partir de la version 7.0. Fonction qui remplace la chaîne de caractère « chaîne_à_remplacer » dans une chaîne donnée « chaîne_initiale » par la chaîne « chaîne_destination ». Renvoie la chaîne de caractère modifiée. La fonction est case sensitive.

**Syntaxe de la fonction :**

<REPLACE:[chaîne_initiale]:[chaîne_à_remplacer]:[chaîne_destination]:[Boolean_toute_ou_première]>

Boolean_toute_ou_première : peut prendre les valeurs 0 ou 1. Si 0, alors uniquement la première occurrence trouvée est remplacée, si 1, alors toutes les occurrences trouvées sont remplacées. Le paramètre est facultatif, la valeur par défaut est 0.

Chaîne_destination peut être vide : dans ce cas la chaîne à remplacer est tout simplement supprimée.

**Mode d'utilisation :**

- L'opération REPLACE peut être utilisée dans tous les champs de type « expression » comme par exemple les opérations de type COPY, MODVALUE, etc.
- Les différentes chaînes utilisées dans l’expression peuvent contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

**Exemples de configuration :**

- <REPLACE:XXXstringXXX:string:newString> renvoie XXXnewStringXXX
- <REPLACE:XXXstringXXX:X::0> renvoie XXstringXXX
- <REPLACE:XXXstringXXX:X::1> renvoie string
- <REPLACE:XXXstringXXX:X:A:1> renvoie AAAstringAAA
