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

# Řetězce znaků

## UPPER

Převede textový řetězec na velká písmena.

**Syntaxe funkce:**

<UPPER:[Expression]>

**Způsob použití:**

- Klíčové slovo UPPER lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Vyhodnocovaný výraz může obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

## LOWER

Převede textový řetězec na malá písmena.

**Syntaxe funkce:**

<LOWER:[Expression]>

**Způsob použití:**

- Klíčové slovo LOWER lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Vyhodnocovaný výraz může obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

## LEFT

**Syntaxe funkce:**

<LEFT:[Character_number]:[Expression]>

**Způsob použití:**

- Klíčové slovo LEFT lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Vyhodnocovaný výraz může obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

## TOKLEFT

Načte n-tý objekt počítaný zleva.

**Syntaxe funkce:**

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

Objekt je uzavřen mezi dvěma oddělovači. Na začátek a konec řetězce výrazu není nutné oddělovač umisťovat.

**Způsob použití:**

- Klíčové slovo TOKLEFT lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Vyhodnocovaný výraz může obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

**Příklady konfigurace:**

- Příklad:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Vrácený výsledek: Level 3

## RIGHT

Načte určitý počet znaků z pravé strany hodnoty.

**Syntaxe funkce:**

<RIGHT:[Character_number]:[Expression]>

**Způsob použití:**

- Klíčové slovo RIGHT lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Vyhodnocovaný výraz může obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

## SHA256

Zašifruje řetězec znaků algoritmem SHA256.

**Syntaxe funkce:**

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

Kde:

- [string_encoding]: „UTF8“ nebo „UTF16“. Kódování se zadává podle formátu, který očekává cílová aplikace. Ve většině případů je vhodné použít UTF8.
- [Hex_B64]: „HEX“ nebo „B64“ pro volbu formátu řetězce. HEX pro šestnáctkový formát, B64 pro base 64.

**Způsob použití:**

- Klíčové slovo SHA256 lze použít ve všech polích typu „expression“, například v operacích COPY, MODVALUE atd.
- Vyhodnocovaný výraz může obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

## TOKRIGHT

Načte část řetězce znaků od n-tého objektu počítaného zprava.

**Syntaxe funkce:**

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

Objekt je uzavřen mezi dvěma oddělovači. Na začátek a konec řetězce výrazu není nutné oddělovač umisťovat.

**Způsob použití:**

- Klíčové slovo TOKRIGHT lze použít ve všech polích typu „expression“, například COPY, MODVALUE atd.
- Vyhodnocovaný výraz může obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

**Příklady konfigurace:**

- Příklad:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Vrácený výsledek: Level 4/ Level 5

## CENTER

Načte znaky uprostřed tím, že odstraní určitý počet znaků vlevo a vpravo.

**Syntaxe funkce:**

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

**Způsob použití:**

- Klíčové slovo CENTER lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Vyhodnocovaný výraz může obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

## REWRITEURL

Přepsání adresy URL.

**Syntaxe funkce:**

<REWRITEURL:[url]>

**Způsob použití:**

- Klíčové slovo REWRITEURL lze použít ve všech polích typu „expression“, například COPY, MODVALUE atd.

**Příklady konfigurace:**

- Příklad:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Vrácený výsledek: http://www.avencis.net

## GEN_PASSWORD

Generování hesla na základě masky s podporou speciálních znaků definovaných v nastavení.

**Syntaxe funkce:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Formát hesla je nutné definovat pomocí následujících prvků:

- U Velké písmeno
- L Malé písmeno
- A Velké nebo malé písmeno
- N Číslice
- S Speciální znak ze seznamu [special_characters]
- X Všechny znaky (U+L+N+S)

**Způsob použití:**

- Klíčové slovo GEN_PASSWORD lze použít ve všech polích typu „expression“, například v operacích COPY, MODVALUE atd.

**Příklady konfigurace:**

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

## B64ENCODEASCII

Převede výraz na ASCII a poté vrátí řetězec zakódovaný v B64.

**Syntaxe funkce:**

<B64ENCODEASCII:[Expression]>

**Způsob použití:**

- Klíčové slovo B64ENCODEASCII lze použít ve všech polích typu „expression“, například v operacích COPY, MODVALUE atd.
- Vyhodnocovaný výraz může obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

## B64SID2STRING

Převede SID na Base64 a vrátí řetězec ve formátu Unicode.

**Syntaxe funkce:**

<B64SID2STRING:[Expression]>

**Způsob použití:**

- Klíčové slovo B64SID2STRING lze použít ve všech polích typu „expression“, například v operacích COPY, MODVALUE atd.
- Vyhodnocovaný výraz může obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

## FIND

Funkce pro nalezení pozice řetězce znaků v jiném řetězci znaků. Pokud je řetězec nalezen, vrátí index pozice (počínaje indexem 0), jinak vrátí délku řetězce.

**Syntaxe funkce:**

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

Index začíná na pozici 0.

**Způsob použití:**

- Operaci FIND lze použít ve všech polích typu „expression“, například COPY, MODVALUE atd.
- Jednotlivé řetězce použité ve výrazu mohou obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

**Příklady konfigurace:**

- Příklad 1:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> pro <SyncAttSrc:FIRSTNAME> = Emilie
    - Výsledek = 0
- Příklad 2:
    - <FIND:I:<SyncAttSrc:FIRSTNAME>:0> pro <SyncAttSrc:FIRSTNAME> = Emilie
    - Výsledek = 2
- Příklad 3:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> pro <SyncAttSrc:FIRSTNAME> = Paul
    - Výsledek = 4

## SUBSTRING

Funkce, která extrahuje řetězec znaků z jiného řetězce znaků. Pokud jsou předané parametry platné, vrátí řetězec znaků, jinak vrátí prázdnou hodnotu. **Syntaxe funkce:**

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

Index začíná na pozici 0.

**Způsob použití:**

- Operaci SUBSTRING lze použít ve všech polích typu „expression“, například COPY, MODVALUE atd.
- Jednotlivé řetězce použité ve výrazu mohou obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

**Příklady konfigurace:**

- Příklad 1:
    - <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> pro <SyncAttSrc:DisplayName> = Carine HOPFNER
    - Výsledek = Carine

## LEN

Funkce, která vrací délku řetězce znaků. Pokud konfigurace obsahuje chybu, funkce vrátí 0.

**Syntaxe funkce:**

<LEN:[chaîne_initiale]>

**Způsob použití:**

- Operaci LEN lze použít ve všech polích typu „expression“, například COPY, MODVALUE atd.
- Jednotlivé řetězce použité ve výrazu mohou obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

**Příklady konfigurace:**

- Příklad 1:
    - <LEN:<SyncAttSrc:DisplayName>> pro <SyncAttSrc:DisplayName> = Emilie Paris
    - Výsledek = 12

## REPLACE

K dispozici od verze 7.0. Funkce, která v daném řetězci „initial_string“ nahradí řetězec znaků „string_to_replace“ řetězcem „destination_string“. Vrací upravený řetězec znaků. Funkce rozlišuje velká a malá písmena.

**Syntaxe funkce:**

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

Boolean_all_or_first: může nabývat hodnot 0 nebo 1. Při hodnotě 0 se nahradí pouze první nalezený výskyt; při hodnotě 1 se nahradí všechny nalezené výskyty. Parametr je volitelný; výchozí hodnota je 0.

Destination_string může být prázdný: v takovém případě se nahrazovaný řetězec jednoduše odstraní.

**Způsob použití:**

- Operaci REPLACE lze použít ve všech polích typu „expression“, například COPY, MODVALUE atd.
- Jednotlivé řetězce použité ve výrazu mohou obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

**Příklady konfigurace:**

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