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

# Reťazce znakov

## UPPER

Prevedie textový reťazec na veľké písmená.

**Syntax funkcie:**

<UPPER:[Expression]>

**Spôsob použitia:**

- Kľúčové slovo UPPER možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Vyhodnocovaný výraz môže obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

## LOWER

Prevedie textový reťazec na malé písmená.

**Syntax funkcie:**

<LOWER:[Expression]>

**Spôsob použitia:**

- Kľúčové slovo LOWER možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Vyhodnocovaný výraz môže obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

## LEFT

**Syntax funkcie:**

<LEFT:[Character_number]:[Expression]>

**Spôsob použitia:**

- Kľúčové slovo LEFT možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Vyhodnocovaný výraz môže obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

## TOKLEFT

Získa n-tý objekt počítaný zľava.

**Syntax funkcie:**

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

Objekt je ohraničený dvoma oddeľovačmi. Na začiatok a koniec reťazca výrazu nie je potrebné umiestniť oddeľovač.

**Spôsob použitia:**

- Kľúčové slovo TOKLEFT možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Vyhodnocovaný výraz môže obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

**Príklady konfigurácie:**

- Príklad:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Vrátený výsledok: Level 3

## RIGHT

Získa určitý počet znakov sprava z hodnoty.

**Syntax funkcie:**

<RIGHT:[Character_number]:[Expression]>

**Spôsob použitia:**

- Kľúčové slovo RIGHT možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Vyhodnocovaný výraz môže obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

## SHA256

Zašifruje reťazec znakov pomocou SHA256.

**Syntax funkcie:**

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

Kde:

- [string_encoding]: „UTF8“ alebo „UTF16“. Kódovanie sa určuje podľa formátu, ktorý očakáva cieľová aplikácia. Vo väčšine prípadov by sa malo použiť UTF8.
- [Hex_B64]: „HEX“ alebo „B64“ na výber formátu reťazca. HEX pre šestnástkový, B64 pre base 64.

**Spôsob použitia:**

- Kľúčové slovo SHA256 možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách COPY, MODVALUE atď.
- Vyhodnocovaný výraz môže obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

## TOKRIGHT

Získa časť reťazca znakov od n-tého objektu počítaného sprava.

**Syntax funkcie:**

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

Objekt je ohraničený dvoma oddeľovačmi. Na začiatok a koniec reťazca výrazu nie je potrebné umiestniť oddeľovač.

**Spôsob použitia:**

- Kľúčové slovo TOKRIGHT možno použiť vo všetkých poliach typu „expression“, napríklad COPY, MODVALUE atď.
- Vyhodnocovaný výraz môže obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

**Príklady konfigurácie:**

- Príklad:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Vrátený výsledok: Level 4/ Level 5

## CENTER

Získa znaky zo stredu odstránením určitého počtu znakov vľavo a vpravo.

**Syntax funkcie:**

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

**Spôsob použitia:**

- Kľúčové slovo CENTER možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Vyhodnocovaný výraz môže obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

## REWRITEURL

Prepísanie adresy URL.

**Syntax funkcie:**

<REWRITEURL:[url]>

**Spôsob použitia:**

- Kľúčové slovo REWRITEURL možno použiť vo všetkých poliach typu „expression“, napríklad COPY, MODVALUE atď.

**Príklady konfigurácie:**

- Príklad:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Vrátený výsledok: http://www.avencis.net

## GEN_PASSWORD

Generovanie hesla na základe masky s podporou špeciálnych znakov definovaných v nastaveniach.

**Syntax funkcie:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Formát hesla musí byť definovaný pomocou nasledujúcich prvkov:

- U Veľké písmeno
- L Malé písmeno
- A Veľké alebo malé písmeno
- N Číslica
- S Špeciálny znak zo zoznamu [special_characters]
- X Všetky znaky (U+L+N+S)

**Spôsob použitia:**

- Kľúčové slovo GEN_PASSWORD možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách COPY, MODVALUE atď.

**Príklady konfigurácie:**

- Príklad:
    - <GEN_PASSWORD:ULNXXXXXXX:,$£!§&#>

## B64ENCODEASCII

Prevedie výraz na ASCII a potom vráti reťazec zakódovaný v B64.

**Syntax funkcie:**

<B64ENCODEASCII:[Expression]>

**Spôsob použitia:**

- Kľúčové slovo B64ENCODEASCII možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách COPY, MODVALUE atď.
- Vyhodnocovaný výraz môže obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

## B64SID2STRING

Prevedie SID na Base64 a vráti reťazec vo formáte Unicode.

**Syntax funkcie:**

<B64SID2STRING:[Expression]>

**Spôsob použitia:**

- Kľúčové slovo B64SID2STRING možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách COPY, MODVALUE atď.
- Vyhodnocovaný výraz môže obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

## FIND

Funkcia na vyhľadanie pozície reťazca znakov v inom reťazci znakov. Ak sa reťazec nájde, vráti index pozície (počnúc indexom 0), inak vráti dĺžku reťazca.

**Syntax funkcie:**

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

Index začína na pozícii 0.

**Spôsob použitia:**

- Operáciu FIND možno použiť vo všetkých poliach typu „expression“, napríklad COPY, MODVALUE atď.
- Rôzne reťazce použité vo výraze môžu obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

**Príklady konfigurácie:**

- Príklad 1:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> pre <SyncAttSrc:FIRSTNAME> = Emilie
    - Výsledok = 0
- Príklad 2:
    - <FIND:I:<SyncAttSrc:FIRSTNAME>:0> pre <SyncAttSrc:FIRSTNAME> = Emilie
    - Výsledok = 2
- Príklad 3:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> pre <SyncAttSrc:FIRSTNAME> = Paul
    - Výsledok = 4

## SUBSTRING

Funkcia, ktorá extrahuje reťazec znakov z iného reťazca znakov. Ak sú odovzdané parametre platné, vráti reťazec znakov, inak vráti prázdnu hodnotu. **Syntax funkcie:**

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

Index začína na pozícii 0.

**Spôsob použitia:**

- Operáciu SUBSTRING možno použiť vo všetkých poliach typu „expression“, napríklad COPY, MODVALUE atď.
- Rôzne reťazce použité vo výraze môžu obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

**Príklady konfigurácie:**

- Príklad 1:
    - <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> pre <SyncAttSrc:DisplayName> = Carine HOPFNER
    - Výsledok = Carine

## LEN

Funkcia, ktorá vráti dĺžku reťazca znakov. Ak je v konfigurácii chyba, funkcia vráti 0.

**Syntax funkcie:**

<LEN:[chaîne_initiale]>

**Spôsob použitia:**

- Operáciu LEN možno použiť vo všetkých poliach typu „expression“, napríklad COPY, MODVALUE atď.
- Rôzne reťazce použité vo výraze môžu obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

**Príklady konfigurácie:**

- Príklad 1:
    - <LEN:<SyncAttSrc:DisplayName>> pre <SyncAttSrc:DisplayName> = Emilie Paris
    - Výsledok = 12

## REPLACE

Dostupná od verzie 7.0. Funkcia, ktorá v danom reťazci „initial_string“ nahradí reťazec znakov „string_to_replace“ reťazcom „destination_string“. Vráti upravený reťazec znakov. Funkcia rozlišuje veľké a malé písmená.

**Syntax funkcie:**

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

Boolean_all_or_first: môže nadobúdať hodnoty 0 alebo 1. Pri hodnote 0 sa nahradí iba prvý nájdený výskyt; pri hodnote 1 sa nahradia všetky nájdené výskyty. Parameter je voliteľný; predvolená hodnota je 0.

Destination_string môže byť prázdny: v takom prípade sa nahrádzaný reťazec jednoducho odstráni.

**Spôsob použitia:**

- Operáciu REPLACE možno použiť vo všetkých poliach typu „expression“, napríklad COPY, MODVALUE atď.
- Rôzne reťazce použité vo výraze môžu obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

**Príklady konfigurácie:**

- <REPLACE:XXXstringXXX:string:newString> vráti XXXnewStringXXX
- <REPLACE:XXXstringXXX:X::0> vráti XXstringXXX
- <REPLACE:XXXstringXXX:X::1> vráti string
- <REPLACE:XXXstringXXX:X:A:1> vráti AAAstringAAA
