> Source: https://docs.cyberelements.io/identity/7.0/ro/UserDocumentation/AutomaticProvisioningConnectorsManagement/KeywordsInOperations/CharacterStrings/

# Șiruri de caractere

## UPPER

Convertește un șir de text în majuscule.

**Sintaxa funcției:**

<UPPER:[Expression]>

**Mod de utilizare:**

- Cuvântul-cheie UPPER poate fi utilizat în toate câmpurile de tip „expression”, precum operațiunile de tip COPY, MODVALUE etc.
- Expresia evaluată poate conține cuvinte-cheie pentru a recupera valori de atribute, de exemplu SyncAttSrc sau SyncAttDst.

## LOWER

Convertește un șir de text în minuscule.

**Sintaxa funcției:**

<LOWER:[Expression]>

**Mod de utilizare:**

- Cuvântul-cheie LOWER poate fi utilizat în toate câmpurile de tip „expression”, precum operațiunile de tip COPY, MODVALUE etc.
- Expresia evaluată poate conține cuvinte-cheie pentru a recupera valori de atribute, de exemplu SyncAttSrc sau SyncAttDst.

## LEFT

**Sintaxa funcției:**

<LEFT:[Character_number]:[Expression]>

**Mod de utilizare:**

- Cuvântul-cheie LEFT poate fi utilizat în toate câmpurile de tip „expression”, precum operațiunile de tip COPY, MODVALUE etc.
- Expresia evaluată poate conține cuvinte-cheie pentru a recupera valori de atribute, de exemplu SyncAttSrc sau SyncAttDst.

## TOKLEFT

Recuperează al n-lea obiect numărat de la stânga.

**Sintaxa funcției:**

<TOKLEFT:[separator]:[Object_number]:[Expression]>

Un obiect este cuprins între doi separatori. Nu este necesar să plasați un separator la începutul și la sfârșitul șirului expresiei.

**Mod de utilizare:**

- Cuvântul-cheie TOKLEFT poate fi utilizat în toate câmpurile de tip „expression”, precum operațiunile de tip COPY, MODVALUE etc.
- Expresia evaluată poate conține cuvinte-cheie pentru a recupera valori de atribute, de exemplu SyncAttSrc sau SyncAttDst.

**Exemple de configurare:**

- Exemplu:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Rezultat returnat: Level 3

## RIGHT

Recuperează un număr de caractere de la dreapta unei valori.

**Sintaxa funcției:**

<RIGHT:[Character_number]:[Expression]>

**Mod de utilizare:**

- Cuvântul-cheie RIGHT poate fi utilizat în toate câmpurile de tip „expression”, precum operațiunile de tip COPY, MODVALUE etc.
- Expresia evaluată poate conține cuvinte-cheie pentru a recupera valori de atribute, de exemplu SyncAttSrc sau SyncAttDst.

## SHA256

Criptează un șir de caractere în SHA256.

**Sintaxa funcției:**

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

Cu:

- [string_encoding]: „UTF8” sau „UTF16”. Codificarea trebuie indicată în funcție de formatul așteptat de aplicația de destinație. UTF8 trebuie utilizat în majoritatea cazurilor.
- [Hex_B64]: „HEX” sau „B64” pentru a alege formatul șirului. HEX pentru hexazecimal, B64 pentru baza 64.

**Mod de utilizare:**

- Cuvântul-cheie SHA256 poate fi utilizat în toate câmpurile de tip „expression”, precum operațiunile COPY, MODVALUE etc.
- Expresia evaluată poate conține cuvinte-cheie pentru a recupera valori de atribute, de exemplu SyncAttSrc sau SyncAttDst.

## TOKRIGHT

Recuperează o parte a unui șir de caractere începând de la al n-lea obiect numărat de la dreapta.

**Sintaxa funcției:**

<TOKRIGHT:[separator]:[Object_number]:[Expression]>

Un obiect este cuprins între doi separatori. Nu este necesar să plasați un separator la începutul și la sfârșitul șirului expresiei.

**Mod de utilizare:**

- Cuvântul-cheie TOKRIGHT poate fi utilizat în toate câmpurile de tip „expression”, precum COPY, MODVALUE etc.
- Expresia evaluată poate conține cuvinte-cheie pentru a recupera valori de atribute, de exemplu SyncAttSrc sau SyncAttDst.

**Exemple de configurare:**

- Exemplu:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Rezultat returnat: Level 4/ Level 5

## CENTER

Recuperează caracterele din mijloc prin ștergerea unui număr de caractere la stânga și la dreapta.

**Sintaxa funcției:**

<CENTER:[Number_of_characters_to_the_left_to_delete]:[Number_of_characters_to_the_right_to_delete]:[Expression]>

**Mod de utilizare:**

- Cuvântul-cheie CENTER poate fi utilizat în toate câmpurile de tip „expression”, precum operațiunile de tip COPY, MODVALUE etc.
- Expresia evaluată poate conține cuvinte-cheie pentru a recupera valori de atribute, de exemplu SyncAttSrc sau SyncAttDst.

## REWRITEURL

Rescrierea unei adrese URL.

**Sintaxa funcției:**

<REWRITEURL:[url]>

**Mod de utilizare:**

- Cuvântul-cheie REWRITEURL poate fi utilizat în toate câmpurile de tip „expression”, precum COPY, MODVALUE etc.

**Exemple de configurare:**

- Exemplu:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Rezultat returnat: http://www.avencis.net

## GEN_PASSWORD

Generarea unei parole pe baza unei măști și cu suport pentru caracterele speciale definite în setări.

**Sintaxa funcției:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Formatul parolei trebuie definit cu următoarele elemente:

- U O literă majusculă
- L O literă minusculă
- A O literă majusculă sau minusculă
- N O cifră
- S Un caracter special din lista [special_characters]
- X Toate caracterele (U+L+N+S)

**Mod de utilizare:**

- Cuvântul-cheie GEN_PASSWORD poate fi utilizat în toate câmpurile de tip „expression”, precum operațiunile COPY, MODVALUE etc.

**Exemple de configurare:**

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

## B64ENCODEASCII

Convertește o expresie în ASCII, apoi returnează șirul codificat în B64.

**Sintaxa funcției:**

<B64ENCODEASCII:[Expression]>

**Mod de utilizare:**

- Cuvântul-cheie B64ENCODEASCII poate fi utilizat în toate câmpurile de tip „expression”, precum operațiunile COPY, MODVALUE etc.
- Expresia evaluată poate conține cuvinte-cheie pentru a recupera valori de atribute, de exemplu SyncAttSrc sau SyncAttDst.

## B64SID2STRING

Convertește un SID în Base64 și returnează șirul în format Unicode.

**Sintaxa funcției:**

<B64SID2STRING:[Expression]>

**Mod de utilizare:**

- Cuvântul-cheie B64SID2STRING poate fi utilizat în toate câmpurile de tip „expression”, precum operațiunile COPY, MODVALUE etc.
- Expresia evaluată poate conține cuvinte-cheie pentru a recupera valori de atribute, de exemplu SyncAttSrc sau SyncAttDst.

## FIND

Funcție pentru găsirea poziției unui șir de caractere în interiorul altui șir de caractere. Returnează indexul poziției (începând cu indexul 0) dacă șirul este găsit; în caz contrar, returnează lungimea șirului.

**Sintaxa funcției:**

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

Indexul începe la poziția 0.

**Mod de utilizare:**

- Operațiunea FIND poate fi utilizată în toate câmpurile de tip „expression”, precum COPY, MODVALUE etc.
- Diferitele șiruri utilizate în expresie pot conține cuvinte-cheie pentru a recupera valori de atribute, de exemplu SyncAttSrc sau SyncAttDst.

**Exemple de configurare:**

- Exemplul 1:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> cu <SyncAttSrc:FIRSTNAME> = Emilie
    - Rezultat = 0
- Exemplul 2:
    - <FIND:I:<SyncAttSrc:FIRSTNAME>:0> cu <SyncAttSrc:FIRSTNAME> = Emilie
    - Rezultat = 2
- Exemplul 3:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> cu <SyncAttSrc:FIRSTNAME> = Paul
    - Rezultat = 4

## SUBSTRING

Funcție care extrage un șir de caractere dintr-un alt șir de caractere. Returnează șirul de caractere dacă parametrii transmiși sunt valizi; în caz contrar, returnează gol. **Sintaxa funcției:**

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

Indexul începe la poziția 0.

**Mod de utilizare:**

- Operațiunea SUBSTRING poate fi utilizată în toate câmpurile de tip „expression”, precum COPY, MODVALUE etc.
- Diferitele șiruri utilizate în expresie pot conține cuvinte-cheie pentru a recupera valori de atribute, de exemplu SyncAttSrc sau SyncAttDst.

**Exemple de configurare:**

- Exemplul 1:
    - <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> cu <SyncAttSrc:DisplayName> = Carine HOPFNER
    - Rezultat = Carine

## LEN

Funcție care returnează lungimea unui șir de caractere. Funcția returnează 0 dacă există o eroare în configurare.

**Sintaxa funcției:**

<LEN:[chaîne_initiale]>

**Mod de utilizare:**

- Operațiunea LEN poate fi utilizată în toate câmpurile de tip „expression”, precum COPY, MODVALUE etc.
- Diferitele șiruri utilizate în expresie pot conține cuvinte-cheie pentru a recupera valori de atribute, de exemplu SyncAttSrc sau SyncAttDst.

**Exemple de configurare:**

- Exemplul 1:
    - <LEN:<SyncAttSrc:DisplayName>> cu <SyncAttSrc:DisplayName> = Emilie Paris
    - Rezultat = 12

## REPLACE

Disponibilă începând cu versiunea 7.0. Funcție care înlocuiește șirul de caractere „string_to_replace” într-un șir dat „initial_string” cu șirul „destination_string”. Returnează șirul de caractere modificat. Funcția este sensibilă la majuscule și minuscule.

**Sintaxa funcției:**

<REPLACE:[initial_string]:[string_to_replace]:[destination_string]:[Boolean_all_or_first]>

Boolean_all_or_first: poate lua valorile 0 sau 1. Dacă este 0, se înlocuiește numai prima ocurență găsită; dacă este 1, se înlocuiesc toate ocurențele găsite. Parametrul este opțional; valoarea implicită este 0.

Destination_string poate fi gol: în acest caz, șirul care trebuie înlocuit este pur și simplu șters.

**Mod de utilizare:**

- Operațiunea REPLACE poate fi utilizată în toate câmpurile de tip „expression”, precum COPY, MODVALUE etc.
- Diferitele șiruri utilizate în expresie pot conține cuvinte-cheie pentru a recupera valori de atribute, de exemplu SyncAttSrc sau SyncAttDst.

**Exemple de configurare:**

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