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

# Märgistringid

## UPPER

Teisendab tekstistringi suurtähtedeks.

**Funktsiooni süntaks:**

<UPPER:[Expression]>

**Kasutusviis:**

- Võtmesõna UPPER saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne tüüpi toimingutes.
- Hinnatav avaldis võib sisaldada võtmesõnu atribuutide väärtuste toomiseks, näiteks SyncAttSrc või SyncAttDst.

## LOWER

Teisendab tekstistringi väiketähtedeks.

**Funktsiooni süntaks:**

<LOWER:[Expression]>

**Kasutusviis:**

- Võtmesõna LOWER saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne tüüpi toimingutes.
- Hinnatav avaldis võib sisaldada võtmesõnu atribuutide väärtuste toomiseks, näiteks SyncAttSrc või SyncAttDst.

## LEFT

**Funktsiooni süntaks:**

<LEFT:[Character_number]:[Expression]>

**Kasutusviis:**

- Võtmesõna LEFT saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne tüüpi toimingutes.
- Hinnatav avaldis võib sisaldada võtmesõnu atribuutide väärtuste toomiseks, näiteks SyncAttSrc või SyncAttDst.

## TOKLEFT

Toob vasakult lugedes n-nda objekti.

**Funktsiooni süntaks:**

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

Objekt asub kahe eraldaja vahel. Eraldajat ei ole vaja paigutada avaldise stringi algusesse ega lõppu.

**Kasutusviis:**

- Võtmesõna TOKLEFT saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne tüüpi toimingutes.
- Hinnatav avaldis võib sisaldada võtmesõnu atribuutide väärtuste toomiseks, näiteks SyncAttSrc või SyncAttDst.

**Konfiguratsiooninäited:**

- Näide:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Tagastatud tulemus: Level 3

## RIGHT

Toob väärtuse paremast servast teatud arvu märke.

**Funktsiooni süntaks:**

<RIGHT:[Character_number]:[Expression]>

**Kasutusviis:**

- Võtmesõna RIGHT saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne tüüpi toimingutes.
- Hinnatav avaldis võib sisaldada võtmesõnu atribuutide väärtuste toomiseks, näiteks SyncAttSrc või SyncAttDst.

## SHA256

Krüptib märgistringi SHA256-algoritmiga.

**Funktsiooni süntaks:**

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

Kus:

- [string_encoding]: „UTF8“ või „UTF16“. Kodeering määratakse vastavalt sihtrakenduse oodatavale vormingule. Enamasti tuleks kasutada UTF8-t.
- [Hex_B64]: „HEX“ või „B64“ stringi vormingu valimiseks. HEX tähistab kuueteistkümnendsüsteemi, B64 base 64 kodeeringut.

**Kasutusviis:**

- Võtmesõna SHA256 saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne toimingutes.
- Hinnatav avaldis võib sisaldada võtmesõnu atribuutide väärtuste toomiseks, näiteks SyncAttSrc või SyncAttDst.

## TOKRIGHT

Toob märgistringi osa alates n-ndast objektist, lugedes paremalt.

**Funktsiooni süntaks:**

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

Objekt asub kahe eraldaja vahel. Eraldajat ei ole vaja paigutada avaldise stringi algusesse ega lõppu.

**Kasutusviis:**

- Võtmesõna TOKRIGHT saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne.
- Hinnatav avaldis võib sisaldada võtmesõnu atribuutide väärtuste toomiseks, näiteks SyncAttSrc või SyncAttDst.

**Konfiguratsiooninäited:**

- Näide:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Tagastatud tulemus: Level 4/ Level 5

## CENTER

Toob keskel asuvad märgid, kustutades vasakult ja paremalt teatud arvu märke.

**Funktsiooni süntaks:**

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

**Kasutusviis:**

- Võtmesõna CENTER saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne tüüpi toimingutes.
- Hinnatav avaldis võib sisaldada võtmesõnu atribuutide väärtuste toomiseks, näiteks SyncAttSrc või SyncAttDst.

## REWRITEURL

URL-i ümberkirjutamine.

**Funktsiooni süntaks:**

<REWRITEURL:[url]>

**Kasutusviis:**

- Võtmesõna REWRITEURL saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne.

**Konfiguratsiooninäited:**

- Näide:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Tagastatud tulemus: http://www.avencis.net

## GEN_PASSWORD

Parooli genereerimine maski alusel, toetades sätetes määratud erimärke.

**Funktsiooni süntaks:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Paroolivorming tuleb määratleda järgmiste elementidega:

- U Suurtäht
- L Väiketäht
- A Suur- või väiketäht
- N Number
- S Erimärk loendist [special_characters]
- X Kõik märgid (U+L+N+S)

**Kasutusviis:**

- Võtmesõna GEN_PASSWORD saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne toimingutes.

**Konfiguratsiooninäited:**

- Näide:
    - <GEN_PASSWORD:ULNXXXXXXX:,$£!§&#>

## B64ENCODEASCII

Teisendab avaldise ASCII-vormingusse ja tagastab B64-kodeeringus stringi.

**Funktsiooni süntaks:**

<B64ENCODEASCII:[Expression]>

**Kasutusviis:**

- Võtmesõna B64ENCODEASCII saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne toimingutes.
- Hinnatav avaldis võib sisaldada võtmesõnu atribuutide väärtuste toomiseks, näiteks SyncAttSrc või SyncAttDst.

## B64SID2STRING

Teisendab SID-i Base64-vormingusse ja tagastab stringi Unicode-vormingus.

**Funktsiooni süntaks:**

<B64SID2STRING:[Expression]>

**Kasutusviis:**

- Võtmesõna B64SID2STRING saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne toimingutes.
- Hinnatav avaldis võib sisaldada võtmesõnu atribuutide väärtuste toomiseks, näiteks SyncAttSrc või SyncAttDst.

## FIND

Funktsioon, mis leiab märgistringi asukoha teises märgistringis. Kui string leitakse, tagastab see asukoha indeksi (alates indeksist 0), vastasel juhul tagastab stringi pikkuse.

**Funktsiooni süntaks:**

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

Indeks algab positsioonist 0.

**Kasutusviis:**

- Toimingut FIND saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne.
- Avaldises kasutatavad stringid võivad sisaldada võtmesõnu atribuutide väärtuste toomiseks, näiteks SyncAttSrc või SyncAttDst.

**Konfiguratsiooninäited:**

- Näide 1:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0>, kui <SyncAttSrc:FIRSTNAME> = Emilie
    - Tulemus = 0
- Näide 2:
    - <FIND:I:<SyncAttSrc:FIRSTNAME>:0>, kui <SyncAttSrc:FIRSTNAME> = Emilie
    - Tulemus = 2
- Näide 3:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0>, kui <SyncAttSrc:FIRSTNAME> = Paul
    - Tulemus = 4

## SUBSTRING

Funktsioon, mis eraldab märgistringi teisest märgistringist. Kui edastatud parameetrid on kehtivad, tagastab see märgistringi; vastasel juhul tagastab tühja väärtuse. **Funktsiooni süntaks:**

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

Indeks algab positsioonist 0.

**Kasutusviis:**

- Toimingut SUBSTRING saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne.
- Avaldises kasutatavad stringid võivad sisaldada võtmesõnu atribuutide väärtuste toomiseks, näiteks SyncAttSrc või SyncAttDst.

**Konfiguratsiooninäited:**

- Näide 1:
    - <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>>, kui <SyncAttSrc:DisplayName> = Carine HOPFNER
    - Tulemus = Carine

## LEN

Funktsioon, mis tagastab märgistringi pikkuse. Konfiguratsioonivea korral tagastab funktsioon 0.

**Funktsiooni süntaks:**

<LEN:[chaîne_initiale]>

**Kasutusviis:**

- Toimingut LEN saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne.
- Avaldises kasutatavad stringid võivad sisaldada võtmesõnu atribuutide väärtuste toomiseks, näiteks SyncAttSrc või SyncAttDst.

**Konfiguratsiooninäited:**

- Näide 1:
    - <LEN:<SyncAttSrc:DisplayName>>, kui <SyncAttSrc:DisplayName> = Emilie Paris
    - Tulemus = 12

## REPLACE

Saadaval alates versioonist 7.0. Funktsioon, mis asendab antud stringis „initial_string“ märgistringi „string_to_replace“ stringiga „destination_string“. Tagastab muudetud märgistringi. Funktsioon on tõstutundlik.

**Funktsiooni süntaks:**

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

Boolean_all_or_first: võib saada väärtuse 0 või 1. Väärtuse 0 korral asendatakse ainult esimene leitud esinemus; väärtuse 1 korral asendatakse kõik leitud esinemused. Parameeter on valikuline; vaikeväärtus on 0.

Destination_string võib olla tühi: sel juhul asendatav string lihtsalt kustutatakse.

**Kasutusviis:**

- Toimingut REPLACE saab kasutada kõigil „expression“-tüüpi väljadel, näiteks COPY, MODVALUE jne.
- Avaldises kasutatavad stringid võivad sisaldada võtmesõnu atribuutide väärtuste toomiseks, näiteks SyncAttSrc või SyncAttDst.

**Konfiguratsiooninäited:**

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