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

# Simbolių eilutės

## UPPER

Konvertuoja teksto eilutę į didžiąsias raides.

**Funkcijos sintaksė:**

<UPPER:[Expression]>

**Naudojimo būdas:**

- Raktažodį UPPER galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt. tipo operacijose.
- Vertinamoje išraiškoje gali būti raktažodžių, skirtų atributų reikšmėms gauti, pavyzdžiui, SyncAttSrc arba SyncAttDst.

## LOWER

Konvertuoja teksto eilutę į mažąsias raides.

**Funkcijos sintaksė:**

<LOWER:[Expression]>

**Naudojimo būdas:**

- Raktažodį LOWER galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt. tipo operacijose.
- Vertinamoje išraiškoje gali būti raktažodžių, skirtų atributų reikšmėms gauti, pavyzdžiui, SyncAttSrc arba SyncAttDst.

## LEFT

**Funkcijos sintaksė:**

<LEFT:[Character_number]:[Expression]>

**Naudojimo būdas:**

- Raktažodį LEFT galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt. tipo operacijose.
- Vertinamoje išraiškoje gali būti raktažodžių, skirtų atributų reikšmėms gauti, pavyzdžiui, SyncAttSrc arba SyncAttDst.

## TOKLEFT

Gauna n-tąjį objektą, skaičiuojant iš kairės.

**Funkcijos sintaksė:**

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

Objektas yra tarp dviejų skyriklių. Išraiškos eilutės pradžioje ir pabaigoje skyriklio dėti nebūtina.

**Naudojimo būdas:**

- Raktažodį TOKLEFT galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt. tipo operacijose.
- Vertinamoje išraiškoje gali būti raktažodžių, skirtų atributų reikšmėms gauti, pavyzdžiui, SyncAttSrc arba SyncAttDst.

**Konfigūravimo pavyzdžiai:**

- Pavyzdys:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Grąžinamas rezultatas: Level 3

## RIGHT

Gauna nurodytą simbolių skaičių iš reikšmės dešinės.

**Funkcijos sintaksė:**

<RIGHT:[Character_number]:[Expression]>

**Naudojimo būdas:**

- Raktažodį RIGHT galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt. tipo operacijose.
- Vertinamoje išraiškoje gali būti raktažodžių, skirtų atributų reikšmėms gauti, pavyzdžiui, SyncAttSrc arba SyncAttDst.

## SHA256

Užšifruoja simbolių eilutę naudojant SHA256.

**Funkcijos sintaksė:**

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

Čia:

- [string_encoding]: „UTF8“ arba „UTF16“. Koduotė nurodoma pagal tikslinės taikomosios programos laukiamą formatą. Daugeliu atvejų reikėtų naudoti UTF8.
- [Hex_B64]: „HEX“ arba „B64“ eilutės formatui pasirinkti. HEX – šešioliktainis, B64 – base 64.

**Naudojimo būdas:**

- Raktažodį SHA256 galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt. operacijose.
- Vertinamoje išraiškoje gali būti raktažodžių, skirtų atributų reikšmėms gauti, pavyzdžiui, SyncAttSrc arba SyncAttDst.

## TOKRIGHT

Gauna simbolių eilutės dalį nuo n-tojo objekto, skaičiuojant iš dešinės.

**Funkcijos sintaksė:**

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

Objektas yra tarp dviejų skyriklių. Išraiškos eilutės pradžioje ir pabaigoje skyriklio dėti nebūtina.

**Naudojimo būdas:**

- Raktažodį TOKRIGHT galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt.
- Vertinamoje išraiškoje gali būti raktažodžių, skirtų atributų reikšmėms gauti, pavyzdžiui, SyncAttSrc arba SyncAttDst.

**Konfigūravimo pavyzdžiai:**

- Pavyzdys:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Grąžinamas rezultatas: Level 4/ Level 5

## CENTER

Gauna viduryje esančius simbolius, pašalindama nurodytą simbolių skaičių iš kairės ir iš dešinės.

**Funkcijos sintaksė:**

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

**Naudojimo būdas:**

- Raktažodį CENTER galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt. tipo operacijose.
- Vertinamoje išraiškoje gali būti raktažodžių, skirtų atributų reikšmėms gauti, pavyzdžiui, SyncAttSrc arba SyncAttDst.

## REWRITEURL

URL adreso perrašymas.

**Funkcijos sintaksė:**

<REWRITEURL:[url]>

**Naudojimo būdas:**

- Raktažodį REWRITEURL galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt.

**Konfigūravimo pavyzdžiai:**

- Pavyzdys:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Grąžinamas rezultatas: http://www.avencis.net

## GEN_PASSWORD

Slaptažodžio generavimas pagal kaukę, palaikant parametruose apibrėžtus specialiuosius simbolius.

**Funkcijos sintaksė:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Slaptažodžio formatas turi būti apibrėžtas šiais elementais:

- U Didžioji raidė
- L Mažoji raidė
- A Didžioji arba mažoji raidė
- N Skaitmuo
- S Specialusis simbolis iš sąrašo [special_characters]
- X Visi simboliai (U+L+N+S)

**Naudojimo būdas:**

- Raktažodį GEN_PASSWORD galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt. operacijose.

**Konfigūravimo pavyzdžiai:**

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

## B64ENCODEASCII

Konvertuoja išraišką į ASCII ir grąžina B64 formatu užkoduotą eilutę.

**Funkcijos sintaksė:**

<B64ENCODEASCII:[Expression]>

**Naudojimo būdas:**

- Raktažodį B64ENCODEASCII galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt. operacijose.
- Vertinamoje išraiškoje gali būti raktažodžių, skirtų atributų reikšmėms gauti, pavyzdžiui, SyncAttSrc arba SyncAttDst.

## B64SID2STRING

Konvertuoja SID į Base64 ir grąžina eilutę Unicode formatu.

**Funkcijos sintaksė:**

<B64SID2STRING:[Expression]>

**Naudojimo būdas:**

- Raktažodį B64SID2STRING galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt. operacijose.
- Vertinamoje išraiškoje gali būti raktažodžių, skirtų atributų reikšmėms gauti, pavyzdžiui, SyncAttSrc arba SyncAttDst.

## FIND

Funkcija, skirta simbolių eilutės padėčiai kitoje simbolių eilutėje rasti. Jei eilutė randama, grąžinamas padėties indeksas (pradedant nuo indekso 0), priešingu atveju grąžinamas eilutės ilgis.

**Funkcijos sintaksė:**

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

Indeksavimas pradedamas nuo padėties 0.

**Naudojimo būdas:**

- Operaciją FIND galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt.
- Išraiškoje naudojamose eilutėse gali būti raktažodžių, skirtų atributų reikšmėms gauti, pavyzdžiui, SyncAttSrc arba SyncAttDst.

**Konfigūravimo pavyzdžiai:**

- 1 pavyzdys:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> kai <SyncAttSrc:FIRSTNAME> = Emilie
    - Rezultatas = 0
- 2 pavyzdys:
    - <FIND:I:<SyncAttSrc:FIRSTNAME>:0> kai <SyncAttSrc:FIRSTNAME> = Emilie
    - Rezultatas = 2
- 3 pavyzdys:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> kai <SyncAttSrc:FIRSTNAME> = Paul
    - Rezultatas = 4

## SUBSTRING

Funkcija, kuri išskiria simbolių eilutę iš kitos simbolių eilutės. Jei perduoti parametrai galioja, grąžinama simbolių eilutė, priešingu atveju grąžinama tuščia reikšmė. **Funkcijos sintaksė:**

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

Indeksavimas pradedamas nuo padėties 0.

**Naudojimo būdas:**

- Operaciją SUBSTRING galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt.
- Išraiškoje naudojamose eilutėse gali būti raktažodžių, skirtų atributų reikšmėms gauti, pavyzdžiui, SyncAttSrc arba SyncAttDst.

**Konfigūravimo pavyzdžiai:**

- 1 pavyzdys:
    - <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> kai <SyncAttSrc:DisplayName> = Carine HOPFNER
    - Rezultatas = Carine

## LEN

Funkcija, grąžinanti simbolių eilutės ilgį. Jei konfigūracijoje yra klaida, funkcija grąžina 0.

**Funkcijos sintaksė:**

<LEN:[chaîne_initiale]>

**Naudojimo būdas:**

- Operaciją LEN galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt.
- Išraiškoje naudojamose eilutėse gali būti raktažodžių, skirtų atributų reikšmėms gauti, pavyzdžiui, SyncAttSrc arba SyncAttDst.

**Konfigūravimo pavyzdžiai:**

- 1 pavyzdys:
    - <LEN:<SyncAttSrc:DisplayName>> kai <SyncAttSrc:DisplayName> = Emilie Paris
    - Rezultatas = 12

## REPLACE

Pasiekiama nuo 7.0 versijos. Funkcija, kuri nurodytoje eilutėje „initial_string“ pakeičia simbolių eilutę „string_to_replace“ eilute „destination_string“. Grąžina pakeistą simbolių eilutę. Funkcija skiria didžiąsias ir mažąsias raides.

**Funkcijos sintaksė:**

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

Boolean_all_or_first: gali įgyti reikšmę 0 arba 1. Jei 0, pakeičiamas tik pirmas rastas atvejis; jei 1, pakeičiami visi rasti atvejai. Parametras neprivalomas; numatytoji reikšmė yra 0.

Destination_string gali būti tuščia: tokiu atveju keičiama eilutė tiesiog panaikinama.

**Naudojimo būdas:**

- Operaciją REPLACE galima naudoti visuose „expression“ tipo laukuose, pavyzdžiui, COPY, MODVALUE ir kt.
- Išraiškoje naudojamose eilutėse gali būti raktažodžių, skirtų atributų reikšmėms gauti, pavyzdžiui, SyncAttSrc arba SyncAttDst.

**Konfigūravimo pavyzdžiai:**

- <REPLACE:XXXstringXXX:string:newString> grąžina XXXnewStringXXX
- <REPLACE:XXXstringXXX:X::0> grąžina XXstringXXX
- <REPLACE:XXXstringXXX:X::1> grąžina string
- <REPLACE:XXXstringXXX:X:A:1> grąžina AAAstringAAA
