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

# Rakstzīmju virknes

## UPPER

Pārvērš teksta virkni lielajos burtos.

**Funkcijas sintakse:**

<UPPER:[Expression]>

**Lietošanas veids:**

- Atslēgvārdu UPPER var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c. tipa operācijās.
- Novērtētajā izteiksmē var būt atslēgvārdi atribūtu vērtību izgūšanai, piemēram, SyncAttSrc vai SyncAttDst.

## LOWER

Pārvērš teksta virkni mazajos burtos.

**Funkcijas sintakse:**

<LOWER:[Expression]>

**Lietošanas veids:**

- Atslēgvārdu LOWER var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c. tipa operācijās.
- Novērtētajā izteiksmē var būt atslēgvārdi atribūtu vērtību izgūšanai, piemēram, SyncAttSrc vai SyncAttDst.

## LEFT

**Funkcijas sintakse:**

<LEFT:[Character_number]:[Expression]>

**Lietošanas veids:**

- Atslēgvārdu LEFT var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c. tipa operācijās.
- Novērtētajā izteiksmē var būt atslēgvārdi atribūtu vērtību izgūšanai, piemēram, SyncAttSrc vai SyncAttDst.

## TOKLEFT

Izgūst n-to objektu, skaitot no kreisās puses.

**Funkcijas sintakse:**

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

Objekts atrodas starp diviem atdalītājiem. Izteiksmes virknes sākumā un beigās atdalītājs nav jānorāda.

**Lietošanas veids:**

- Atslēgvārdu TOKLEFT var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c. tipa operācijās.
- Novērtētajā izteiksmē var būt atslēgvārdi atribūtu vērtību izgūšanai, piemēram, SyncAttSrc vai SyncAttDst.

**Konfigurācijas piemēri:**

- Piemērs:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Atgrieztais rezultāts: Level 3

## RIGHT

Izgūst noteiktu rakstzīmju skaitu no vērtības labās puses.

**Funkcijas sintakse:**

<RIGHT:[Character_number]:[Expression]>

**Lietošanas veids:**

- Atslēgvārdu RIGHT var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c. tipa operācijās.
- Novērtētajā izteiksmē var būt atslēgvārdi atribūtu vērtību izgūšanai, piemēram, SyncAttSrc vai SyncAttDst.

## SHA256

Šifrē rakstzīmju virkni ar SHA256.

**Funkcijas sintakse:**

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

Kur:

- [string_encoding]: „UTF8“ vai „UTF16“. Kodējums jānorāda atbilstoši mērķa lietojumprogrammas gaidītajam formātam. Vairumā gadījumu jāizmanto UTF8.
- [Hex_B64]: „HEX“ vai „B64“, lai izvēlētos virknes formātu. HEX — heksadecimālajam formātam, B64 — base 64 formātam.

**Lietošanas veids:**

- Atslēgvārdu SHA256 var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c. operācijās.
- Novērtētajā izteiksmē var būt atslēgvārdi atribūtu vērtību izgūšanai, piemēram, SyncAttSrc vai SyncAttDst.

## TOKRIGHT

Izgūst rakstzīmju virknes daļu, sākot no n-tā objekta, skaitot no labās puses.

**Funkcijas sintakse:**

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

Objekts atrodas starp diviem atdalītājiem. Izteiksmes virknes sākumā un beigās atdalītājs nav jānorāda.

**Lietošanas veids:**

- Atslēgvārdu TOKRIGHT var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c.
- Novērtētajā izteiksmē var būt atslēgvārdi atribūtu vērtību izgūšanai, piemēram, SyncAttSrc vai SyncAttDst.

**Konfigurācijas piemēri:**

- Piemērs:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Atgrieztais rezultāts: Level 4/ Level 5

## CENTER

Izgūst vidējās rakstzīmes, dzēšot noteiktu rakstzīmju skaitu kreisajā un labajā pusē.

**Funkcijas sintakse:**

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

**Lietošanas veids:**

- Atslēgvārdu CENTER var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c. tipa operācijās.
- Novērtētajā izteiksmē var būt atslēgvārdi atribūtu vērtību izgūšanai, piemēram, SyncAttSrc vai SyncAttDst.

## REWRITEURL

URL pārrakstīšana.

**Funkcijas sintakse:**

<REWRITEURL:[url]>

**Lietošanas veids:**

- Atslēgvārdu REWRITEURL var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c.

**Konfigurācijas piemēri:**

- Piemērs:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Atgrieztais rezultāts: http://www.avencis.net

## GEN_PASSWORD

Paroles ģenerēšana, pamatojoties uz masku un ar atbalstu iestatījumos definētajām speciālajām rakstzīmēm.

**Funkcijas sintakse:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Paroles formāts jādefinē ar šādiem elementiem:

- U lielais burts
- L mazais burts
- A lielais vai mazais burts
- N cipars
- S speciālā rakstzīme no saraksta [special_characters]
- X visas rakstzīmes (U+L+N+S)

**Lietošanas veids:**

- Atslēgvārdu GEN_PASSWORD var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c. operācijās.

**Konfigurācijas piemēri:**

- Piemērs:
    - <GEN_PASSWORD:ULNXXXXXXX:,$£!§&#>

## B64ENCODEASCII

Pārvērš izteiksmi ASCII formātā un pēc tam atgriež B64 kodētu virkni.

**Funkcijas sintakse:**

<B64ENCODEASCII:[Expression]>

**Lietošanas veids:**

- Atslēgvārdu B64ENCODEASCII var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c. operācijās.
- Novērtētajā izteiksmē var būt atslēgvārdi atribūtu vērtību izgūšanai, piemēram, SyncAttSrc vai SyncAttDst.

## B64SID2STRING

Pārvērš SID uz Base64 un atgriež virkni Unicode formātā.

**Funkcijas sintakse:**

<B64SID2STRING:[Expression]>

**Lietošanas veids:**

- Atslēgvārdu B64SID2STRING var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c. operācijās.
- Novērtētajā izteiksmē var būt atslēgvārdi atribūtu vērtību izgūšanai, piemēram, SyncAttSrc vai SyncAttDst.

## FIND

Funkcija rakstzīmju virknes pozīcijas atrašanai citā rakstzīmju virknē. Ja virkne ir atrasta, tā atgriež pozīcijas indeksu (sākot ar indeksu 0); pretējā gadījumā tā atgriež virknes garumu.

**Funkcijas sintakse:**

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

Indekss sākas ar pozīciju 0.

**Lietošanas veids:**

- Operāciju FIND var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c.
- Izteiksmē izmantotajās virknēs var būt atslēgvārdi atribūtu vērtību izgūšanai, piemēram, SyncAttSrc vai SyncAttDst.

**Konfigurācijas piemēri:**

- Piemērs 1:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> ar <SyncAttSrc:FIRSTNAME> = Emilie
    - Rezultāts = 0
- Piemērs 2:
    - <FIND:I:<SyncAttSrc:FIRSTNAME>:0> ar <SyncAttSrc:FIRSTNAME> = Emilie
    - Rezultāts = 2
- Piemērs 3:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> ar <SyncAttSrc:FIRSTNAME> = Paul
    - Rezultāts = 4

## SUBSTRING

Funkcija, kas izgūst rakstzīmju virkni no citas rakstzīmju virknes. Tā atgriež rakstzīmju virkni, ja nodotie parametri ir derīgi; pretējā gadījumā tā atgriež tukšu vērtību. **Funkcijas sintakse:**

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

Indekss sākas ar pozīciju 0.

**Lietošanas veids:**

- Operāciju SUBSTRING var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c.
- Izteiksmē izmantotajās virknēs var būt atslēgvārdi atribūtu vērtību izgūšanai, piemēram, SyncAttSrc vai SyncAttDst.

**Konfigurācijas piemēri:**

- Piemērs 1:
    - <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> ar <SyncAttSrc:DisplayName> = Carine HOPFNER
    - Rezultāts = Carine

## LEN

Funkcija, kas atgriež rakstzīmju virknes garumu. Ja konfigurācijā ir kļūda, funkcija atgriež 0.

**Funkcijas sintakse:**

<LEN:[chaîne_initiale]>

**Lietošanas veids:**

- Operāciju LEN var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c.
- Izteiksmē izmantotajās virknēs var būt atslēgvārdi atribūtu vērtību izgūšanai, piemēram, SyncAttSrc vai SyncAttDst.

**Konfigurācijas piemēri:**

- Piemērs 1:
    - <LEN:<SyncAttSrc:DisplayName>> ar <SyncAttSrc:DisplayName> = Emilie Paris
    - Rezultāts = 12

## REPLACE

Pieejama, sākot ar versiju 7.0. Funkcija, kas dotajā virknē „initial_string“ aizstāj rakstzīmju virkni „string_to_replace“ ar virkni „destination_string“. Atgriež modificēto rakstzīmju virkni. Funkcija ir reģistrjutīga.

**Funkcijas sintakse:**

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

Boolean_all_or_first: var pieņemt vērtību 0 vai 1. Ja 0, tiek aizstāts tikai pirmais atrastais gadījums; ja 1, tiek aizstāti visi atrastie gadījumi. Parametrs nav obligāts; noklusējuma vērtība ir 0.

Destination_string var būt tukšs: šādā gadījumā aizstājamā virkne tiek vienkārši dzēsta.

**Lietošanas veids:**

- Operāciju REPLACE var izmantot visos „expression“ tipa laukos, piemēram, COPY, MODVALUE u. c.
- Izteiksmē izmantotajās virknēs var būt atslēgvārdi atribūtu vērtību izgūšanai, piemēram, SyncAttSrc vai SyncAttDst.

**Konfigurācijas piemēri:**

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