Списък на наличните операции според правилата за синхронизация

	Преобразуване	Правила Matching	Сравнение	Създаване	Промяна	Изтриване
ADDVALUE	X			X	X	X
CHANGE	X			X	X	X
COMPAREATTNAME			X
COMPAREWITHEXCLUSIONS		X	X
COMPARE			X
CONVERT	X
COPY	X			X	X	X
DELETE	X
DELVALUE	X			X	X	X
DELVALUEBYVALUE	X			X	X	X
DSTCOPY	X			X	X	X
EQ		X	X
FILTERAR	X
GETSTRUCTCHILD	X
GROUPAR	X
ISCONTAINED			X
MERGE	X
MODVALUE	X			X	X	X
MULTCOPY				X	X	X
MULTDSTCOPY				X	X	X
MULTIEVALEQ		X
MULTSET	X			X	X	X
MVEQ			X
RENAME	X
SET	X			X	X	X
SIMPLEEQ		X
SPLIT	X

Налични опции за всяка операция:

	B64	CI	DATE	DATE_FILETIME	DN	PARTIAL	PWD	USEMAP
ADDVALUE	X		X	X			X
CHANGE	X		X	X			X
COMPAREATTNAME		X			X
CONTAIN		X			X
CONVERT	X		X	X			X
COPY	X		X	X			X
DELETE	X		X	X			X
DELVALUE	X		X	X			X
DELVALUEBYVALUE	X		X	X			X
DSTCOPY	X		X	X			X
EQ**		X			X			X
FILTREAR	X		X	X			X
GETSTRUCTCHILD	X		X	X			X
GROUPAR	X		X	X			X
ISCONTAINED		X			X
MERGE	X		X	X			X
MODVALUE	X		X	X			X
MULTCOPY	X		X	X			X
MULTDSTCOPY	X		X	X			X
MULTIEVALEQ		X				X		X
MULTSET	X		X	X			X
MVEQ		X			X
RENAME	X		X	X			X
SET	X		X	X			X
SIMPLEEQ**		X			X			X
SPLIT	X		X	X			X

**: Филтрите се различават в зависимост от правилото, което използва операцията.

• B64: преобразува стойността на атрибута във формат Base 64.
• CI: Case insensitive: сравнението се извършва, без да се взема предвид регистърът на буквите.
• DATE: преобразува стойността на атрибута във формат DATE.
• DATE_FILETIME: преобразува стойността на атрибута във формат DATETIME.
• DN: сравнение на DN.
• PARTIAL: сравнява данните частично. Връща true, ако поне една стойност се съдържа в атрибута за сравнение.
• PWD: активира шифроването на данните.
• USEMAP: използване на карта за намиране на атрибута, което ускорява процеса на сравнение.

ADDVALUE

Операция, която позволява добавянето на стойности към атрибут, който по дефиниция може да бъде многозначен. Тя позволява също конкатенацията на стойности от няколко атрибута.

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: име на атрибута, който трябва да бъде променен. Ако атрибутът не съществува, той ще бъде създаден автоматично.
• [Expression]: формула, която трябва да бъде въведена. Можете да използвате ключови думи или да въведете изцяло или частично фиксирани стойности (твърдо кодиран текст). Вижте главата „Списък на ключовите думи“ за синтаксиса, който да приложите във вашия случай на употреба.

Пример за следната конфигурация:

CHANGE

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

Внимание

Операцията CHANGE е обявена за остаряла от версия 7.1 и ще бъде премахната от версия 7.2. Тя дублира операцията MODVALUE: отсега нататък използвайте MODVALUE, за да промените стойността на атрибут.

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: име на атрибута, който трябва да бъде променен. Ако атрибутът не съществува, операцията няма да работи.
• [Expression]: формула, която трябва да бъде въведена. Можете да използвате ключови думи или да въведете изцяло или частично фиксирани стойности (твърдо кодиран текст). Вижте главата „Списък на ключовите думи“ за синтаксиса, който да приложите във вашия случай на употреба.

Пример за следната конфигурация:

COMPAREATTNAME

Операция, която ви позволява да изброите атрибутите, които не трябва да се сравняват, и да сравните всички останали атрибути, които имат едно и също име в двете хранилища. Имената на атрибути в хранилището източник, които нямат съответствие в целевото хранилище, ще бъдат пренебрегнати и няма да бъдат сравнени. Тя може да се използва вместо единичното съпоставяне на атрибутите, които трябва да бъдат сравнени.

Обърнете внимание, че тази операция е налична едва от версия 6.2 нататък и може да се използва само в правила OnCompare на операция MATCH в конекторите за осигуряване на състоянието на осигуряването (status).

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

• [Attribute] = списък на атрибутите, които не трябва да се сравняват. Атрибутите трябва да бъдат разделени със запетаи и без интервали.

Пример за следната конфигурация:

COMPAREWITHEXCLUSIONS

Операция, която сравнява всички атрибути между двата източника, без да указва имената на атрибутите на хранилището източник или на целевото хранилище. Можете да укажете имената на атрибутите, които не трябва да се сравняват, което се равнява на дефиниране на атрибутите, чиито кодове се различават между двете хранилища.

Обърнете внимание, че тази операция е налична едва от версия 7.1 нататък и може да се използва само в правилото Matching и в правилата за сравнение.

Препоръчително е да използвате тази операция, когато повечето атрибути имат едно и също име в хранилището източник и в целевото хранилище, за да спестите време за конфигуриране.

За разлика от операцията COMPAREATTNAME, която пренебрегва атрибутите без съответствие в целевото хранилище и се използва само в конекторите за състоянието на осигуряването, тази операция отчита също атрибутите, които присъстват само в едно от двете хранилища.

Промените, установени от тази операция, съответстват на следните случаи на употреба:

• атрибут съществува в хранилището източник и в целевото хранилище с различни стойности;
• атрибут съществува в хранилището източник, но не и в целевото хранилище;
• атрибут съществува в целевото хранилище, но не и в хранилището източник.

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

COMPAREWITHEXCLUSIONS:[attribute_1],[attribute_2],…

Атрибутите, изключени от сравнението, се изброяват след двоеточието, разделени със запетаи.

Пример за следната конфигурация:

COMPAREWITHEXCLUSIONS:whenChanged,objectGUID

Всички атрибути се сравняват между двете хранилища с изключение на whenChanged и objectGUID.

CONTAIN

Операция, която извършва сравнение, за да провери дали стойностите на атрибута на авторитетния източник присъстват в атрибута на целевия източник. Резултатът от операцията ще бъде конкатенацията на стойностите на атрибута на целевия източник със стойностите на атрибута на авторитетния източник, които не са намерени.

Пример

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Резултат в атрибута на целевия източник =

• Val_1
• Val_2
• Val_3
• Val_4
• Val_5
• Val_6

В тази операция не могат да се използват ключови думи.

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: име на атрибута в целевия източник, върху който трябва да се извърши сравнението.
• [Attribute Name]: име на атрибута в авторитетния източник, върху който трябва да се извърши сравнението.

Пример за следната конфигурация:

CONVERT

COPY

Операция, която ви позволява да копирате стойността на един атрибут в друг атрибут. Тя работи за еднозначни и многозначни атрибути.

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: име на атрибута, който трябва да бъде променен. Атрибутът трябва да съществува.
• [Attribute Name]: име на атрибута източник, чиято стойност ще бъде копирана.

Пример за следната конфигурация:

Атрибутът „usual_name“ ще приеме стойността на атрибута „birth_name“.

DELETE

Операция, която ви позволява да изтриете атрибут в указан източник (източник на експортирането, цел на експортирането или DELTA).

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: име на атрибута, който трябва да бъде изтрит.
• [Expression]: не попълвайте това поле.

DELVALUE

Операция, която позволява изтриването на стойности от атрибут въз основа на булев израз: ако изразът върне „True“, стойностите се изтриват. Затова тя обикновено се прилага за многозначни атрибути.

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: име на атрибута, който трябва да бъде променен.
• [Expression]: формула, която трябва да бъде въведена. Можете да използвате ключови думи или да въведете изцяло или частично фиксирани стойности (твърдо кодиран текст). Вижте главата „Списък на ключовите думи“ за синтаксиса, който да приложите във вашия случай на употреба.

Пример за следната конфигурация:

Ако атрибутът „groups“ съдържа стойността „GRP_ACCES_COMMUN“, тя ще бъде премахната от списъка със стойности на „groups“, а промененият списък на атрибута „groups“ ще бъде копиран в атрибута „memberof@“.

DELVALUEBYVALUE

Операция, която позволява изтриването на стойности от атрибут въз основа на даден списък. Затова тя обикновено се прилага за многозначни атрибути.

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: име на атрибута, който трябва да бъде променен.
• [Expression]: стойности, които трябва да бъдат въведени, разделени с „;“. Можете да използвате ключови думи или да въведете изцяло или частично фиксирани стойности (твърдо кодиран текст). Вижте главата „Списък на ключовите думи“ за синтаксиса, който да приложите във вашия случай на употреба.

Пример за следната конфигурация:

Стойностите на атрибута „groups_admin“ и стойността „GRP_ACCES_COMMUN“ се премахват от списъка със стойности, съдържащи се в „memberof@“.

DSTCOPY

Операция, която копира стойността на атрибут, намерен в целевото експортиране, в друг атрибут във файла DELTA. Тя работи за еднозначни и многозначни атрибути. Обикновено се използва за пренасяне на стойности от целевото хранилище, които са неизвестни в хранилището източник, често в случай на изтриване (неизвестни в източника, но все още присъстващи в целта).

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: име на целевия атрибут.
• [Attribute Name]: име на атрибута източник, чиято стойност ще бъде копирана.

Пример за следната конфигурация:

EQ

Операция, която сравнява два еднозначни атрибута.

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: име на атрибута, който трябва да бъде сравнен, присъстващ в експортирането от източника.
• [Expression]: формула, която трябва да бъде въведена. Можете да използвате ключови думи или да въведете изцяло или частично фиксирани стойности (твърдо кодиран текст). Вижте главата „Списък на ключовите думи“ за синтаксиса, който да приложите във вашия случай на употреба.

Пример за следната конфигурация:

GETSTRUCTCHILD

Позволява ви да извлечете списъка с дъщерните структури в атрибута „Destination_attribute_name“ на дадена структура в „Parent_structure_attribute_name“. Тази операция може да се извършва само върху данни от хранилището на Identity (например върху експортиране на самоличности, което има атрибут от тип структура).

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: име на целевия атрибут, който ще получи списъка с дъщерните структури.
• [Expression]: име на атрибута на родителската структура без ключови думи.

Пример за следната конфигурация:

Връща всички дъщерни структури на структурата с код „Site“.

ISCONTAINED

Операция, която сравнява многозначен атрибут в авторитетния източник с многозначен атрибут в целевия източник, за да извлече само списъка със стойностите, които присъстват и в двата атрибута.

Пример:

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3
• Val_4

Source_target_attribute_values =

• Val_3
• Val_4
• Val_5

Резултат в атрибута на целевия източник =

• Val_3
• Val_4

В тази операция не могат да се използват ключови думи.

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: име на атрибута в целевия източник, върху който трябва да се извърши сравнението.
• [Attribute Name]: име на атрибута в авторитетния източник, върху който трябва да се извърши сравнението.

Пример за следната конфигурация:

MERGE

Операция, която ви позволява да създадете конкатенация от стойностите на многозначен атрибут и да я присвоите на еднозначен атрибут.

Обърнете внимание, че тази операция е налична едва от версия 6.2 нататък.

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

• [name_out_attribute_monovalue] = име на атрибута, който трябва да бъде предоставен като изход.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: разделителят трябва да бъде единичен знак и не може да бъде „;“, тъй като този знак се използва във файла за конфигурация на конектора.
  • [name_attribute_multivalues]: име на многозначния атрибут, чиито стойности трябва да бъдат конкатенирани.

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

Операцията MERGE може да се използва в правилата за синхронизация и само в операциите CONVERT.

Пример за следната конфигурация:

• При атрибут „wiki_mod_1“, равен на:
  • Droit_001
  • Droit_002
  • Droit_003
• Резултат: във файла sync.xml атрибутът „lst_right“ ще има следната стойност:
  • Droit_001#Droit_002#Droit_003

MODVALUE

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

Забележка

Тази операция заменя операцията CHANGE, обявена за остаряла от версия 7.1 и премахната от версия 7.2.

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: име на атрибута, който трябва да бъде променен. Ако атрибутът не съществува, операцията няма да работи.
• [Expression]: формула, която трябва да бъде въведена. Можете да използвате ключови думи или да въведете изцяло или частично фиксирани стойности (твърдо кодиран текст). Вижте главата „Списък на ключовите думи“ за синтаксиса, който да приложите във вашия случай на употреба.

Пример за следната конфигурация:

MULTCOPY

Копиране на атрибути от източника

Операция, която копира стойностите на атрибути от експортирането от източника в атрибути във файла DELTA. Тя работи за еднозначни атрибути .

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute name to copy]: име на атрибута, който трябва да се намира в експортирането от източника. Атрибутът трябва да съществува.
• [Target attribute name]: атрибутът трябва да съществува. Име на атрибута, който трябва да бъде включен в целевото експортиране и който ще се намира във файла DELTA.

Операцията трябва да бъде извършена толкова пъти, колкото е необходимо.

Пример за следната конфигурация:

MULTDSTCOPY

Операция, която копира стойностите на атрибути, намерени в целевото експортиране, в атрибути във файла DELTA. Тя работи за еднозначни атрибути . Обикновено се използва за пренасяне на стойности от целевото хранилище, които са неизвестни в хранилището източник, често в случай на изтриване (вече неизвестни в източника, но все още присъстващи в целта).

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute name to copy]: име на атрибута, който трябва да бъде включен в целевото експортиране. Атрибутът трябва да съществува.
• [Target attribute name]: име на целевия атрибут, който трябва да се намира във файла DELTA.

Операцията трябва да бъде извършена толкова пъти, колкото е необходимо.

Пример за следната конфигурация:

MULTIEVALEQ

Операция, която сравнява няколко многозначни атрибута.

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Source attribute name]: име на атрибута, който трябва да бъде сравнен, присъстващ в експортирането от източника.
• [Destination attribute name]: име на атрибута, който трябва да бъде сравнен, присъстващ в целевото експортиране.

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

Пример за следната конфигурация:

MULTSET

Операция, която ви позволява да правите копия на многозначни атрибути с възможност за добавяне на префикс.

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

• [Nom_attribut_dest] = име на атрибута, който трябва да бъде предоставен като изход. Не е необходимо атрибутът да съществува предварително.
• [Nom_attribut_src] = име на атрибута, чиито стойности ще бъдат копирани. Внимание: не използвайте ключовите думи <syncattsrc> или <syncattdst>.
• [prefixe] = низ, който да бъде добавен преди всяка стойност на атрибута [Nom_attribut_src]. Префиксът може да бъде стойността на атрибут, като се използва ключовата дума >. Ако не искате да добавяте префикс, просто укажете <uid> във втория параметър на очаквания израз.

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

Операцията MULTSET може да се използва в правилата за синхронизация за операциите CONVERT и MATCH (OnCreate, OnModify и OnDelete).

Пример за следната конфигурация:

• При атрибут „postal_code“, равен на:
  • 68300
  • 68390
  • 38670
• Резултат: във файла sync.xml атрибутът „Code_postal_prefix“ ще има следните стойности:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Операция, която сравнява 2 многозначни атрибута.

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: име на атрибута, който трябва да бъде сравнен, присъстващ в целевото експортиране.
• [Attribute Name]: име на атрибута, който трябва да бъде сравнен, присъстващ в експортирането от източника.

Пример за следната конфигурация:

RENAME

Операция, която преименува атрибут.

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: ново име на атрибута.
• [Expression]: име на атрибута, който трябва да бъде преименуван.

Пример за следната конфигурация:

SET

Операция, която позволява да се присвои стойност на атрибут (само еднозначен), независимо дали той съществува, или не.

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Attribute]: име на атрибута, на който трябва да се присвои стойност. Ако атрибутът съществува, първоначалната стойност ще бъде презаписана; ако атрибутът не съществува, той ще бъде създаден.
• [Expression]: формула, която трябва да бъде въведена. Можете да използвате ключови думи или да въведете изцяло или частично фиксирани стойности (твърдо кодиран текст). Вижте главата „Списък на ключовите думи“ за синтаксиса, който да приложите във вашия случай на употреба.

Пример за следната конфигурация:

SIMPLEEQ

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

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

• [Description]: свободен текст за описание на операцията (незадължително).
• [Source attribute name]: име на атрибута, който трябва да бъде сравнен, присъстващ в експортирането от източника.
• [Destination attribute name]: име на атрибута, който трябва да бъде сравнен, присъстващ в целевото експортиране.

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

Пример за следната конфигурация:

SPLIT

Операция, която служи за разделяне на стойностите на еднозначен атрибут с помощта на разделител и за присвояването им на многозначен атрибут.

Обърнете внимание, че тази операция е налична едва от версия 6.2 нататък.

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

• [name_out_attribute_multivalues] = име на атрибута, който се предоставя като изход.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: разделителят трябва да бъде единичен знак и не може да бъде „;“, тъй като този знак се използва във файла за конфигурация на конектора.
  • [name_attribute_multivalues]: име на многозначния атрибут, чиито стойности трябва да бъдат конкатенирани.

Възможни резултати:

• Ако разделителят е намерен поне веднъж: връща списък от стойности
• Ако разделителят не е намерен: връща целия низ

Възможни резултати:

Операцията SPLIT може да се използва в правилата за синхронизация и само в операции CONVERT.

Пример за следната конфигурация:

• При атрибут „string_rights“, равен на:
  • Droit_001#Droit_002#Droit_003
• Резултат: във файла sync.xml атрибутът „lst_right_multi“ ще има следната стойност:
  • Droit_001
  • Droit_002
  • Droit_003