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

# Низове от знаци

## UPPER

Преобразува текстов низ в главни букви.

**Синтаксис на функцията:**

<UPPER:[Expression]>

**Начин на използване:**

- Ключовата дума UPPER може да се използва във всички полета от тип „expression“, например в операции от тип COPY, MODVALUE и т.н.
- Изчисляваният израз може да съдържа ключови думи за извличане на стойности на атрибути, например SyncAttSrc или SyncAttDst.

## LOWER

Преобразува текстов низ в малки букви.

**Синтаксис на функцията:**

<LOWER:[Expression]>

**Начин на използване:**

- Ключовата дума LOWER може да се използва във всички полета от тип „expression“, например в операции от тип COPY, MODVALUE и т.н.
- Изчисляваният израз може да съдържа ключови думи за извличане на стойности на атрибути, например SyncAttSrc или SyncAttDst.

## LEFT

**Синтаксис на функцията:**

<LEFT:[Character_number]:[Expression]>

**Начин на използване:**

- Ключовата дума LEFT може да се използва във всички полета от тип „expression“, например в операции от тип COPY, MODVALUE и т.н.
- Изчисляваният израз може да съдържа ключови думи за извличане на стойности на атрибути, например SyncAttSrc или SyncAttDst.

## TOKLEFT

Извлича n-тия обект, броен отляво.

**Синтаксис на функцията:**

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

Обектът се намира между два разделителя. Не е необходимо да се поставя разделител в началото и в края на низа на израза.

**Начин на използване:**

- Ключовата дума TOKLEFT може да се използва във всички полета от тип „expression“, например в операции от тип COPY, MODVALUE и т.н.
- Изчисляваният израз може да съдържа ключови думи за извличане на стойности на атрибути, например SyncAttSrc или SyncAttDst.

**Примери за конфигурация:**

- Пример:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Върнат резултат: Level 3

## RIGHT

Извлича определен брой знаци от дясната страна на стойност.

**Синтаксис на функцията:**

<RIGHT:[Character_number]:[Expression]>

**Начин на използване:**

- Ключовата дума RIGHT може да се използва във всички полета от тип „expression“, например в операции от тип COPY, MODVALUE и т.н.
- Изчисляваният израз може да съдържа ключови думи за извличане на стойности на атрибути, например SyncAttSrc или SyncAttDst.

## SHA256

Шифрова низ от знаци с алгоритъма SHA256.

**Синтаксис на функцията:**

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

Където:

- [string_encoding]: „UTF8“ или „UTF16“. Кодирането трябва да се укаже според формата, очакван от целевото приложение. В повечето случаи трябва да се използва UTF8.
- [Hex_B64]: „HEX“ или „B64“ за избор на формата на низа. HEX за шестнадесетичен, B64 за base 64.

**Начин на използване:**

- Ключовата дума SHA256 може да се използва във всички полета от тип „expression“, например в операции COPY, MODVALUE и т.н.
- Изчисляваният израз може да съдържа ключови думи за извличане на стойности на атрибути, например SyncAttSrc или SyncAttDst.

## TOKRIGHT

Извлича част от низ от знаци, започвайки от n-тия обект, броен отдясно.

**Синтаксис на функцията:**

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

Обектът се намира между два разделителя. Не е необходимо да се поставя разделител в началото и в края на низа на израза.

**Начин на използване:**

- Ключовата дума TOKRIGHT може да се използва във всички полета от тип „expression“, например COPY, MODVALUE и т.н.
- Изчисляваният израз може да съдържа ключови думи за извличане на стойности на атрибути, например SyncAttSrc или SyncAttDst.

**Примери за конфигурация:**

- Пример:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Върнат резултат: Level 4/ Level 5

## CENTER

Извлича знаците в средата, като изтрива определен брой знаци отляво и отдясно.

**Синтаксис на функцията:**

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

**Начин на използване:**

- Ключовата дума CENTER може да се използва във всички полета от тип „expression“, например в операции от тип COPY, MODVALUE и т.н.
- Изчисляваният израз може да съдържа ключови думи за извличане на стойности на атрибути, например SyncAttSrc или SyncAttDst.

## REWRITEURL

Пренаписване на URL адрес.

**Синтаксис на функцията:**

<REWRITEURL:[url]>

**Начин на използване:**

- Ключовата дума REWRITEURL може да се използва във всички полета от тип „expression“, например COPY, MODVALUE и т.н.

**Примери за конфигурация:**

- Пример:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Върнат резултат: http://www.avencis.net

## GEN_PASSWORD

Генериране на парола въз основа на маска и с поддръжка на специалните знаци, дефинирани в настройките.

**Синтаксис на функцията:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Форматът на паролата трябва да бъде дефиниран със следните елементи:

- U Главна буква
- L Малка буква
- A Главна или малка буква
- N Цифра
- S Специален знак от списъка [special_characters]
- X Всички знаци (U+L+N+S)

**Начин на използване:**

- Ключовата дума GEN_PASSWORD може да се използва във всички полета от тип „expression“, например в операции COPY, MODVALUE и т.н.

**Примери за конфигурация:**

- Пример:
    - <GEN_PASSWORD:ULNXXXXXXX:,$£!§&#>

## B64ENCODEASCII

Преобразува израз в ASCII и след това връща низа, кодиран в B64.

**Синтаксис на функцията:**

<B64ENCODEASCII:[Expression]>

**Начин на използване:**

- Ключовата дума B64ENCODEASCII може да се използва във всички полета от тип „expression“, например в операции COPY, MODVALUE и т.н.
- Изчисляваният израз може да съдържа ключови думи за извличане на стойности на атрибути, например SyncAttSrc или SyncAttDst.

## B64SID2STRING

Преобразува SID в Base64 и връща низа във формат Unicode.

**Синтаксис на функцията:**

<B64SID2STRING:[Expression]>

**Начин на използване:**

- Ключовата дума B64SID2STRING може да се използва във всички полета от тип „expression“, например в операции COPY, MODVALUE и т.н.
- Изчисляваният израз може да съдържа ключови думи за извличане на стойности на атрибути, например SyncAttSrc или SyncAttDst.

## FIND

Функция за намиране на позицията на низ от знаци в друг низ от знаци. Тя връща индекса на позицията (започвайки от индекс 0), ако низът е намерен, в противен случай връща дължината на низа.

**Синтаксис на функцията:**

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

Индексът започва от позиция 0.

**Начин на използване:**

- Операцията FIND може да се използва във всички полета от тип „expression“, например COPY, MODVALUE и т.н.
- Различните низове, използвани в израза, могат да съдържат ключови думи за извличане на стойности на атрибути, например SyncAttSrc или SyncAttDst.

**Примери за конфигурация:**

- Пример 1:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> при <SyncAttSrc:FIRSTNAME> = Emilie
    - Резултат = 0
- Пример 2:
    - <FIND:I:<SyncAttSrc:FIRSTNAME>:0> при <SyncAttSrc:FIRSTNAME> = Emilie
    - Резултат = 2
- Пример 3:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> при <SyncAttSrc:FIRSTNAME> = Paul
    - Резултат = 4

## SUBSTRING

Функция, която извлича низ от знаци от друг низ от знаци. Тя връща низа от знаци, ако подадените параметри са валидни; в противен случай връща празна стойност. **Синтаксис на функцията:**

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

Индексът започва от позиция 0.

**Начин на използване:**

- Операцията SUBSTRING може да се използва във всички полета от тип „expression“, например COPY, MODVALUE и т.н.
- Различните низове, използвани в израза, могат да съдържат ключови думи за извличане на стойности на атрибути, например SyncAttSrc или SyncAttDst.

**Примери за конфигурация:**

- Пример 1:
    - <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> при <SyncAttSrc:DisplayName> = Carine HOPFNER
    - Резултат = Carine

## LEN

Функция, която връща дължината на низ от знаци. Функцията връща 0, ако в конфигурацията има грешка.

**Синтаксис на функцията:**

<LEN:[chaîne_initiale]>

**Начин на използване:**

- Операцията LEN може да се използва във всички полета от тип „expression“, например COPY, MODVALUE и т.н.
- Различните низове, използвани в израза, могат да съдържат ключови думи за извличане на стойности на атрибути, например SyncAttSrc или SyncAttDst.

**Примери за конфигурация:**

- Пример 1:
    - <LEN:<SyncAttSrc:DisplayName>> при <SyncAttSrc:DisplayName> = Emilie Paris
    - Резултат = 12

## REPLACE

Налична от версия 7.0 нататък. Функция, която заменя низа от знаци „string_to_replace“ в даден низ „initial_string“ с низа „destination_string“. Връща променения низ от знаци. Функцията различава главни от малки букви.

**Синтаксис на функцията:**

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

Boolean_all_or_first: може да приема стойностите 0 или 1. При 0 се заменя само първото намерено срещане; при 1 се заменят всички намерени срещания. Параметърът не е задължителен; стойността по подразбиране е 0.

Destination_string може да бъде празен: в този случай низът, който трябва да бъде заменен, просто се изтрива.

**Начин на използване:**

- Операцията REPLACE може да се използва във всички полета от тип „expression“, например COPY, MODVALUE и т.н.
- Различните низове, използвани в израза, могат да съдържат ключови думи за извличане на стойности на атрибути, например SyncAttSrc или SyncAttDst.

**Примери за конфигурация:**

- <REPLACE:XXXstringXXX:string:newString> връща XXXnewStringXXX
- <REPLACE:XXXstringXXX:X::0> връща XXstringXXX
- <REPLACE:XXXstringXXX:X::1> връща string
- <REPLACE:XXXstringXXX:X:A:1> връща AAAstringAAA
