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

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