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

# Karakterláncok

## UPPER

Nagybetűssé alakít egy szöveges karakterláncot.

**A függvény szintaxisa:**

<UPPER:[Expression]>

**Használati mód:**

- Az UPPER kulcsszó minden „expression” típusú mezőben használható, például a COPY, MODVALUE stb. típusú műveletekben.
- A kiértékelt kifejezés kulcsszavakat tartalmazhat az attribútumértékek lekéréséhez, például SyncAttSrc vagy SyncAttDst.

## LOWER

Kisbetűssé alakít egy szöveges karakterláncot.

**A függvény szintaxisa:**

<LOWER:[Expression]>

**Használati mód:**

- A LOWER kulcsszó minden „expression” típusú mezőben használható, például a COPY, MODVALUE stb. típusú műveletekben.
- A kiértékelt kifejezés kulcsszavakat tartalmazhat az attribútumértékek lekéréséhez, például SyncAttSrc vagy SyncAttDst.

## LEFT

**A függvény szintaxisa:**

<LEFT:[Character_number]:[Expression]>

**Használati mód:**

- A LEFT kulcsszó minden „expression” típusú mezőben használható, például a COPY, MODVALUE stb. típusú műveletekben.
- A kiértékelt kifejezés kulcsszavakat tartalmazhat az attribútumértékek lekéréséhez, például SyncAttSrc vagy SyncAttDst.

## TOKLEFT

Lekéri a balról számított n-edik objektumot.

**A függvény szintaxisa:**

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

Az objektum két elválasztó karakter között áll. A kifejezés karakterláncának elején és végén nem szükséges elválasztó karaktert elhelyezni.

**Használati mód:**

- A TOKLEFT kulcsszó minden „expression” típusú mezőben használható, például a COPY, MODVALUE stb. típusú műveletekben.
- A kiértékelt kifejezés kulcsszavakat tartalmazhat az attribútumértékek lekéréséhez, például SyncAttSrc vagy SyncAttDst.

**Konfigurációs példák:**

- Példa:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Visszaadott eredmény: Level 3

## RIGHT

Egy érték jobb oldaláról lekér adott számú karaktert.

**A függvény szintaxisa:**

<RIGHT:[Character_number]:[Expression]>

**Használati mód:**

- A RIGHT kulcsszó minden „expression” típusú mezőben használható, például a COPY, MODVALUE stb. típusú műveletekben.
- A kiértékelt kifejezés kulcsszavakat tartalmazhat az attribútumértékek lekéréséhez, például SyncAttSrc vagy SyncAttDst.

## SHA256

SHA256 algoritmussal titkosít egy karakterláncot.

**A függvény szintaxisa:**

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

Ahol:

- [string_encoding]: „UTF8” vagy „UTF16”. A kódolást a célalkalmazás által várt formátumnak megfelelően kell megadni. A legtöbb esetben az UTF8 kódolást kell használni.
- [Hex_B64]: „HEX” vagy „B64” a karakterlánc formátumának kiválasztásához. HEX: hexadecimális, B64: base 64.

**Használati mód:**

- Az SHA256 kulcsszó minden „expression” típusú mezőben használható, például a COPY, MODVALUE stb. műveletekben.
- A kiértékelt kifejezés kulcsszavakat tartalmazhat az attribútumértékek lekéréséhez, például SyncAttSrc vagy SyncAttDst.

## TOKRIGHT

Lekéri egy karakterlánc részét a jobbról számított n-edik objektumtól kezdve.

**A függvény szintaxisa:**

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

Az objektum két elválasztó karakter között áll. A kifejezés karakterláncának elején és végén nem szükséges elválasztó karaktert elhelyezni.

**Használati mód:**

- A TOKRIGHT kulcsszó minden „expression” típusú mezőben használható, például COPY, MODVALUE stb.
- A kiértékelt kifejezés kulcsszavakat tartalmazhat az attribútumértékek lekéréséhez, például SyncAttSrc vagy SyncAttDst.

**Konfigurációs példák:**

- Példa:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Visszaadott eredmény: Level 4/ Level 5

## CENTER

Lekéri a középső karaktereket úgy, hogy a bal és a jobb oldalon adott számú karaktert töröl.

**A függvény szintaxisa:**

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

**Használati mód:**

- A CENTER kulcsszó minden „expression” típusú mezőben használható, például a COPY, MODVALUE stb. típusú műveletekben.
- A kiértékelt kifejezés kulcsszavakat tartalmazhat az attribútumértékek lekéréséhez, például SyncAttSrc vagy SyncAttDst.

## REWRITEURL

Egy URL átírása.

**A függvény szintaxisa:**

<REWRITEURL:[url]>

**Használati mód:**

- A REWRITEURL kulcsszó minden „expression” típusú mezőben használható, például COPY, MODVALUE stb.

**Konfigurációs példák:**

- Példa:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Visszaadott eredmény: http://www.avencis.net

## GEN_PASSWORD

Jelszó generálása maszk alapján, a beállításokban meghatározott különleges karakterek támogatásával.

**A függvény szintaxisa:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

A jelszó formátumát a következő elemekkel kell meghatározni:

- U Egy nagybetű
- L Egy kisbetű
- A Egy nagy- vagy kisbetű
- N Egy számjegy
- S Egy különleges karakter a [special_characters] listából
- X Bármely karakter (U+L+N+S)

**Használati mód:**

- A GEN_PASSWORD kulcsszó minden „expression” típusú mezőben használható, például a COPY, MODVALUE stb. műveletekben.

**Konfigurációs példák:**

- Példa:
    - <GEN_PASSWORD:ULNXXXXXXX:,$£!§&#>

## B64ENCODEASCII

ASCII-re alakít egy kifejezést, majd B64 kódolással visszaadja a karakterláncot.

**A függvény szintaxisa:**

<B64ENCODEASCII:[Expression]>

**Használati mód:**

- A B64ENCODEASCII kulcsszó minden „expression” típusú mezőben használható, például a COPY, MODVALUE stb. műveletekben.
- A kiértékelt kifejezés kulcsszavakat tartalmazhat az attribútumértékek lekéréséhez, például SyncAttSrc vagy SyncAttDst.

## B64SID2STRING

Base64 formátumra alakít egy SID-t, és Unicode formátumban adja vissza a karakterláncot.

**A függvény szintaxisa:**

<B64SID2STRING:[Expression]>

**Használati mód:**

- A B64SID2STRING kulcsszó minden „expression” típusú mezőben használható, például a COPY, MODVALUE stb. műveletekben.
- A kiértékelt kifejezés kulcsszavakat tartalmazhat az attribútumértékek lekéréséhez, például SyncAttSrc vagy SyncAttDst.

## FIND

Függvény egy karakterlánc egy másik karakterláncon belüli pozíciójának megkereséséhez. Ha a karakterlánc megtalálható, a pozíció indexét adja vissza (a 0. indextől kezdve), ellenkező esetben a karakterlánc hosszát.

**A függvény szintaxisa:**

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

Az index a 0. pozíciótól kezdődik.

**Használati mód:**

- A FIND művelet minden „expression” típusú mezőben használható, például COPY, MODVALUE stb.
- A kifejezésben használt különböző karakterláncok kulcsszavakat tartalmazhatnak az attribútumértékek lekéréséhez, például SyncAttSrc vagy SyncAttDst.

**Konfigurációs példák:**

- Első példa:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> ahol <SyncAttSrc:FIRSTNAME> = Emilie
    - Eredmény = 0
- Második példa:
    - <FIND:I:<SyncAttSrc:FIRSTNAME>:0> ahol <SyncAttSrc:FIRSTNAME> = Emilie
    - Eredmény = 2
- Harmadik példa:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> ahol <SyncAttSrc:FIRSTNAME> = Paul
    - Eredmény = 4

## SUBSTRING

Függvény, amely egy karakterláncból kinyer egy másik karakterláncot. Ha az átadott paraméterek érvényesek, a karakterláncot adja vissza, ellenkező esetben üres értéket. **A függvény szintaxisa:**

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

Az index a 0. pozíciótól kezdődik.

**Használati mód:**

- A SUBSTRING művelet minden „expression” típusú mezőben használható, például COPY, MODVALUE stb.
- A kifejezésben használt különböző karakterláncok kulcsszavakat tartalmazhatnak az attribútumértékek lekéréséhez, például SyncAttSrc vagy SyncAttDst.

**Konfigurációs példák:**

- Első példa:
    - <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> ahol <SyncAttSrc:DisplayName> = Carine HOPFNER
    - Eredmény = Carine

## LEN

Függvény, amely egy karakterlánc hosszát adja vissza. Ha a konfiguráció hibát tartalmaz, a függvény 0 értéket ad vissza.

**A függvény szintaxisa:**

<LEN:[chaîne_initiale]>

**Használati mód:**

- A LEN művelet minden „expression” típusú mezőben használható, például COPY, MODVALUE stb.
- A kifejezésben használt különböző karakterláncok kulcsszavakat tartalmazhatnak az attribútumértékek lekéréséhez, például SyncAttSrc vagy SyncAttDst.

**Konfigurációs példák:**

- Első példa:
    - <LEN:<SyncAttSrc:DisplayName>> ahol <SyncAttSrc:DisplayName> = Emilie Paris
    - Eredmény = 12

## REPLACE

A 7.0-s verziótól érhető el. Függvény, amely egy adott „initial_string” karakterláncban a „string_to_replace” karakterláncot a „destination_string” karakterláncra cseréli. A módosított karakterláncot adja vissza. A függvény megkülönbözteti a kis- és nagybetűket.

**A függvény szintaxisa:**

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

Boolean_all_or_first: értéke 0 vagy 1 lehet. 0 esetén csak az első talált előfordulás cserélődik; 1 esetén az összes talált előfordulás cserélődik. A paraméter nem kötelező; az alapértelmezett érték 0.

A Destination_string paraméter üres is lehet: ebben az esetben a cserélendő karakterlánc egyszerűen törlődik.

**Használati mód:**

- A REPLACE művelet minden „expression” típusú mezőben használható, például COPY, MODVALUE stb.
- A kifejezésben használt különböző karakterláncok kulcsszavakat tartalmazhatnak az attribútumértékek lekéréséhez, például SyncAttSrc vagy SyncAttDst.

**Konfigurációs példák:**

- <REPLACE:XXXstringXXX:string:newString> eredménye: XXXnewStringXXX
- <REPLACE:XXXstringXXX:X::0> eredménye: XXstringXXX
- <REPLACE:XXXstringXXX:X::1> eredménye: string
- <REPLACE:XXXstringXXX:X:A:1> eredménye: AAAstringAAA
