Zoznam operácií dostupných pre jednotlivé pravidlá synchronizácie

	Konverzia	Pravidlá zhody	Porovnanie	Vytvorenie	Úprava	Odstránenie
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

Možnosti dostupné pre jednotlivé operácie:

	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

**: Filtre sa líšia v závislosti od pravidla, ktoré operáciu používa.

• B64: Prevedie hodnotu atribútu do formátu Base 64.
• CI: Case insensitive: porovnanie sa vykonáva bez ohľadu na veľkosť písmen.
• DATE: Prevedie hodnotu atribútu do formátu DATE.
• DATE_FILETIME: Prevedie hodnotu atribútu do formátu DATETIME.
• DN: Porovnanie DN.
• PARTIAL: čiastočne porovná údaje. Vráti true, ak sa aspoň jedna hodnota nachádza v porovnávanom atribúte.
• PWD: Povolí šifrovanie údajov.
• USEMAP: použitie mapy na vyhľadanie atribútu, urýchľuje proces porovnávania.

ADDVALUE

Operácia, ktorá umožňuje pridať hodnoty do atribútu, ktorý môže byť z definície viachodnotový. Umožňuje tiež zreťaziť hodnoty z viacerých atribútov.

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: názov atribútu, ktorý sa má upraviť. Ak atribút neexistuje, vytvorí sa automaticky.
• [Expression]: vzorec, ktorý treba zadať. Možno použiť kľúčové slová alebo zadať pevné hodnoty celé alebo ich časť (napevno zadaný text). Syntax, ktorú treba použiť vo vašom prípade použitia, nájdete v kapitole „Zoznam kľúčových slov“.

Príklad nasledujúcej konfigurácie:

CHANGE

Operácia, ktorá umožňuje upraviť hodnotu atribútu. Atribút musí existovať a byť jednohodnotový. Počiatočná hodnota atribútu sa prepíše a už ju nemožno znova použiť.

Pozor

Operácia CHANGE je od verzie 7.1 zastaraná a vo verzii 7.2 bude odobratá. Duplikuje operáciu MODVALUE: odteraz na úpravu hodnoty atribútu používajte MODVALUE.

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: názov atribútu, ktorý sa má upraviť. Ak atribút neexistuje, operácia nebude fungovať.
• [Expression]: vzorec, ktorý treba zadať. Možno použiť kľúčové slová alebo zadať pevné hodnoty celé alebo ich časť (napevno zadaný text). Syntax, ktorú treba použiť vo vašom prípade použitia, nájdete v kapitole „Zoznam kľúčových slov“.

Príklad nasledujúcej konfigurácie:

COMPAREATTNAME

Operácia, ktorá umožňuje uviesť atribúty, ktoré sa nemajú porovnávať, a porovnať všetky ostatné atribúty s rovnakým názvom v oboch úložiskách. Názvy atribútov zdrojového úložiska, ktoré nemajú náprotivok v cieľovom úložisku, sa ignorujú a neporovnávajú. Operácia môže nahradiť jednotlivé mapovanie porovnávaných atribútov.

Upozorňujeme, že táto operácia je dostupná až od verzie 6.2 a možno ju použiť iba v pravidlách OnCompare v operácii MATCH v konektoroch zriaďovania so stavom zriaďovania (status).

Syntax funkcie:

• [Attribute] = zoznam atribútov, ktoré sa nemajú porovnávať. Atribúty musia byť oddelené čiarkami a bez medzier.

Príklad nasledujúcej konfigurácie:

COMPAREWITHEXCLUSIONS

Operácia, ktorá porovná všetky atribúty medzi oboma zdrojmi bez zadania názvov atribútov zdrojového ani cieľového úložiska. Môžete zadať názvy atribútov, ktoré sa nemajú porovnávať, čo znamená definovať atribúty, ktorých kódy sa medzi oboma úložiskami líšia.

Upozorňujeme, že táto operácia je dostupná až od verzie 7.1 a možno ju použiť iba v pravidle Matching a v pravidlách porovnania.

Túto operáciu odporúčame použiť, keď má väčšina atribútov v zdrojovom a cieľovom úložisku rovnaký názov, aby sa ušetril čas konfigurácie.

Na rozdiel od operácie COMPAREATTNAME, ktorá ignoruje atribúty bez náprotivku v cieľovom úložisku a používa sa iba v konektoroch stavu zriaďovania, táto operácia hlási aj atribúty, ktoré sa nachádzajú iba v jednom z oboch úložísk.

Úpravy zistené touto operáciou zodpovedajú nasledujúcim prípadom použitia:

• atribút existuje v zdrojovom aj v cieľovom úložisku s rôznymi hodnotami;
• atribút existuje v zdrojovom úložisku, ale nie v cieľovom úložisku;
• atribút existuje v cieľovom úložisku, ale nie v zdrojovom úložisku.

Syntax funkcie:

COMPAREWITHEXCLUSIONS:[attribute_1],[attribute_2],…

Atribúty vylúčené z porovnania sa uvádzajú za dvojbodkou, oddelené čiarkami.

Príklad nasledujúcej konfigurácie:

COMPAREWITHEXCLUSIONS:whenChanged,objectGUID

Všetky atribúty sa porovnávajú medzi oboma úložiskami okrem whenChanged a objectGUID.

CONTAIN

Operácia, ktorá vykoná porovnanie na overenie, či sú hodnoty atribútu autoritatívneho zdroja prítomné v atribúte cieľového zdroja. Výsledkom operácie bude zreťazenie hodnôt atribútu cieľového zdroja s hodnotami atribútu autoritatívneho zdroja, ktoré sa nenašli.

Príklad

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Výsledok v atribúte cieľového zdroja =

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

V tejto operácii nemožno použiť žiadne kľúčové slová.

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: názov atribútu v cieľovom zdroji, na ktorom sa má vykonať porovnanie.
• [Attribute Name]: názov atribútu v autoritatívnom zdroji, na ktorom sa má vykonať porovnanie.

Príklad nasledujúcej konfigurácie:

CONVERT

COPY

Operácia, ktorá umožňuje skopírovať hodnotu jedného atribútu do iného atribútu. Funguje pre jednohodnotové aj viachodnotové atribúty.

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: názov atribútu, ktorý sa má upraviť. Atribút musí existovať.
• [Attribute Name]: názov zdrojového atribútu, ktorého hodnota sa skopíruje.

Príklad nasledujúcej konfigurácie:

Atribút „usual_name“ prevezme hodnotu atribútu „birth_name“.

DELETE

Operácia, ktorá umožňuje odstrániť atribút v zadanom zdroji (zdroj exportu, cieľ exportu alebo DELTA).

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: názov atribútu, ktorý sa má odstrániť.
• [Expression]: toto pole nevypĺňajte.

DELVALUE

Operácia, ktorá umožňuje odstrániť hodnoty z atribútu na základe logického výrazu: ak výraz vráti „True“, hodnoty sa odstránia. Preto sa zvyčajne používa pri viachodnotových atribútoch.

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: názov atribútu, ktorý sa má upraviť.
• [Expression]: vzorec, ktorý treba zadať. Možno použiť kľúčové slová alebo zadať pevné hodnoty celé alebo ich časť (napevno zadaný text). Syntax, ktorú treba použiť vo vašom prípade použitia, nájdete v kapitole „Zoznam kľúčových slov“.

Príklad nasledujúcej konfigurácie:

Ak atribút „groups“ obsahuje hodnotu „GRP_ACCES_COMMUN“, táto hodnota sa odoberie zo zoznamu hodnôt „groups“ a upravený zoznam atribútu „groups“ sa skopíruje do atribútu „memberof@“.

DELVALUEBYVALUE

Operácia, ktorá umožňuje odstrániť hodnoty z atribútu na základe zadaného zoznamu. Preto sa zvyčajne používa pri viachodnotových atribútoch.

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: názov atribútu, ktorý sa má upraviť.
• [Expression]: hodnoty, ktoré treba zadať, oddelené znakom „;“. Možno použiť kľúčové slová alebo zadať pevné hodnoty celé alebo ich časť (napevno zadaný text). Syntax, ktorú treba použiť vo vašom prípade použitia, nájdete v kapitole „Zoznam kľúčových slov“.

Príklad nasledujúcej konfigurácie:

Hodnoty atribútu „groups_admin“ a hodnota „GRP_ACCES_COMMUN“ sa odoberú zo zoznamu hodnôt obsiahnutých v „memberof@“.

DSTCOPY

Operácia, ktorá skopíruje hodnotu atribútu nájdeného v cieľovom exporte do iného atribútu v súbore DELTA. Funguje pre jednohodnotové aj viachodnotové atribúty. Zvyčajne sa používa na prenos hodnôt z cieľového úložiska, ktoré sú v zdrojovom úložisku neznáme, často pri odstránení (neznáme v zdroji, ale stále prítomné v cieli).

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: názov cieľového atribútu.
• [Attribute Name]: názov zdrojového atribútu, ktorého hodnota sa skopíruje.

Príklad nasledujúcej konfigurácie:

EQ

Operácia, ktorá porovná dva jednohodnotové atribúty.

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: názov porovnávaného atribútu, ktorý sa nachádza v zdrojovom exporte.
• [Expression]: vzorec, ktorý treba zadať. Možno použiť kľúčové slová alebo zadať pevné hodnoty celé alebo ich časť (napevno zadaný text). Syntax, ktorú treba použiť vo vašom prípade použitia, nájdete v kapitole „Zoznam kľúčových slov“.

Príklad nasledujúcej konfigurácie:

GETSTRUCTCHILD

Umožňuje získať zoznam podriadených štruktúr do atribútu „Destination_attribute_name“ pre danú štruktúru v „Parent_structure_attribute_name“. Túto operáciu možno vykonať iba na údajoch z úložiska Identity (napríklad na exporte identít, ktorý obsahuje atribút typu štruktúra).

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: názov cieľového atribútu, ktorý dostane zoznam podriadených štruktúr.
• [Expression]: názov atribútu nadradenej štruktúry bez kľúčových slov.

Príklad nasledujúcej konfigurácie:

Vráti všetky podriadené štruktúry štruktúry s kódom „Site“.

ISCONTAINED

Operácia, ktorá porovná viachodnotový atribút v autoritatívnom zdroji s viachodnotovým atribútom v cieľovom zdroji, aby extrahovala iba zoznam hodnôt, ktoré sa nachádzajú v oboch atribútoch.

Príklad:

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3
• Val_4

Source_target_attribute_values =

• Val_3
• Val_4
• Val_5

Výsledok v atribúte cieľového zdroja =

• Val_3
• Val_4

V tejto operácii nemožno použiť žiadne kľúčové slová.

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: názov atribútu v cieľovom zdroji, na ktorom sa má vykonať porovnanie.
• [Attribute Name]: názov atribútu v autoritatívnom zdroji, na ktorom sa má vykonať porovnanie.

Príklad nasledujúcej konfigurácie:

MERGE

Operácia, ktorá umožňuje vytvoriť zreťazenie hodnôt viachodnotového atribútu a priradiť ho jednohodnotovému atribútu.

Upozorňujeme, že táto operácia je dostupná až od verzie 6.2.

Syntax funkcie:

• [name_out_attribute_monovalue] = názov atribútu, ktorý sa má vrátiť ako výsledok.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: oddeľovač musí byť jeden znak a nemôže to byť „;“, pretože tento znak sa používa v konfiguračnom súbore konektora.
  • [name_attribute_multivalues]: názov viachodnotového atribútu, ktorého hodnoty sa majú zreťaziť.

Spôsob použitia:

Operáciu MERGE možno použiť v pravidlách synchronizácie, a to iba v operáciách CONVERT.

Príklad nasledujúcej konfigurácie:

• Pre atribút „wiki_mod_1“ s hodnotou:
  • Droit_001
  • Droit_002
  • Droit_003
• Výsledok: v súbore sync.xml bude mať atribút „lst_right“ nasledujúcu hodnotu:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Operácia, ktorá umožňuje upraviť hodnotu atribútu. Atribút musí existovať a byť jednohodnotový. Počiatočná hodnota atribútu sa prepíše a už ju nemožno znova použiť.

Poznámka

Táto operácia nahrádza operáciu CHANGE, ktorá je od verzie 7.1 zastaraná a od verzie 7.2 odobratá.

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: názov atribútu, ktorý sa má upraviť. Ak atribút neexistuje, operácia nebude fungovať.
• [Expression]: vzorec, ktorý treba zadať. Možno použiť kľúčové slová alebo zadať pevné hodnoty celé alebo ich časť (napevno zadaný text). Syntax, ktorú treba použiť vo vašom prípade použitia, nájdete v kapitole „Zoznam kľúčových slov“.

Príklad nasledujúcej konfigurácie:

MULTCOPY

Kopírovanie atribútov zo zdroja

Operácia, ktorá skopíruje hodnoty atribútov zo zdrojového exportu do atribútov v súbore DELTA. Funguje pre jednohodnotové atribúty .

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute name to copy]: názov atribútu, ktorý sa musí nachádzať v zdrojovom exporte. Atribút musí existovať.
• [Target attribute name]: atribút musí existovať. Názov atribútu, ktorý musí byť zahrnutý v cieľovom exporte a bude sa nachádzať v súbore DELTA.

Operáciu treba vykonať toľkokrát, koľkokrát je to potrebné.

Príklad nasledujúcej konfigurácie:

MULTDSTCOPY

Operácia, ktorá skopíruje hodnoty atribútov nájdené v cieľovom exporte do atribútov v súbore DELTA. Funguje pre jednohodnotové atribúty . Zvyčajne sa používa na prenos hodnôt z cieľového úložiska, ktoré sú v zdrojovom úložisku neznáme, často pri odstránení (v zdroji už neznáme, ale stále prítomné v cieli).

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute name to copy]: názov atribútu, ktorý musí byť zahrnutý v cieľovom exporte. Atribút musí existovať.
• [Target attribute name]: názov cieľového atribútu, ktorý sa musí nachádzať v súbore DELTA.

Operáciu treba vykonať toľkokrát, koľkokrát je to potrebné.

Príklad nasledujúcej konfigurácie:

MULTIEVALEQ

Operácia, ktorá porovná viacero viachodnotových atribútov.

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Source attribute name]: názov porovnávaného atribútu, ktorý sa nachádza v zdrojovom exporte.
• [Destination attribute name]: názov porovnávaného atribútu, ktorý sa nachádza v cieľovom exporte.

Operáciu treba vykonať toľkokrát, koľkokrát je to potrebné. Objekty sa spárujú, ak sú všetky atribúty rovnaké.

Príklad nasledujúcej konfigurácie:

MULTSET

Operácia, ktorá umožňuje vytvárať kópie viachodnotových atribútov s možnosťou pridať predponu.

Syntax funkcie:

• [Nom_attribut_dest] = názov atribútu, ktorý sa má vrátiť ako výsledok. Atribút nemusí vopred existovať.
• [Nom_attribut_src] = názov atribútu, ktorého hodnoty sa skopírujú. Upozornenie: nepoužívajte kľúčové slová <syncattsrc> ani <syncattdst>.
• [prefixe] = reťazec, ktorý sa pridá pred každú hodnotu atribútu [Nom_attribut_src]. Predponou môže byť hodnota atribútu pomocou kľúčového slova >. Ak nechcete pridať predponu, stačí v druhom parametri očakávaného výrazu zadať <uid>.

Spôsob použitia:

Operáciu MULTSET možno použiť v pravidlách synchronizácie pre operácie CONVERT a MATCH (OnCreate, OnModify a OnDelete).

Príklad nasledujúcej konfigurácie:

• Pre atribút „postal_code“ s hodnotou:
  • 68300
  • 68390
  • 38670
• Výsledok: v súbore sync.xml bude mať atribút „Code_postal_prefix“ nasledujúce hodnoty:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Operácia, ktorá porovná 2 viachodnotové atribúty.

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: názov porovnávaného atribútu, ktorý sa nachádza v cieľovom exporte.
• [Attribute Name]: názov porovnávaného atribútu, ktorý sa nachádza v zdrojovom exporte.

Príklad nasledujúcej konfigurácie:

RENAME

Operácia, ktorá premenuje atribút.

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: nový názov atribútu.
• [Expression]: názov atribútu, ktorý sa má premenovať.

Príklad nasledujúcej konfigurácie:

SET

Operácia, ktorá umožňuje priradiť hodnotu atribútu, iba jednohodnotovému, bez ohľadu na to, či existuje alebo nie.

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Attribute]: názov atribútu, ktorému sa má priradiť hodnota. Ak atribút existuje, počiatočná hodnota sa prepíše; ak atribút neexistuje, vytvorí sa.
• [Expression]: vzorec, ktorý treba zadať. Možno použiť kľúčové slová alebo zadať pevné hodnoty celé alebo ich časť (napevno zadaný text). Syntax, ktorú treba použiť vo vašom prípade použitia, nájdete v kapitole „Zoznam kľúčových slov“.

Príklad nasledujúcej konfigurácie:

SIMPLEEQ

Operácia, ktorá porovná viacero jednohodnotových atribútov.

Syntax funkcie:

• [Description]: voľný text na opis operácie (voliteľné).
• [Source attribute name]: názov porovnávaného atribútu, ktorý sa nachádza v zdrojovom exporte.
• [Destination attribute name]: názov porovnávaného atribútu, ktorý sa nachádza v cieľovom exporte.

Operáciu treba vykonať toľkokrát, koľkokrát je to potrebné. Objekty sa spárujú, ak sú všetky atribúty rovnaké.

Príklad nasledujúcej konfigurácie:

SPLIT

Operácia slúžiaca na rozdelenie hodnôt jednohodnotového atribútu pomocou oddeľovača a ich následné priradenie viachodnotovému atribútu.

Upozorňujeme, že táto operácia je dostupná až od verzie 6.2.

Syntax funkcie:

• [name_out_attribute_multivalues] = Názov atribútu, ktorý sa má poskytnúť ako výstup.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: oddeľovač musí byť jeden znak a nemôže to byť „;“, pretože tento znak sa používa v konfiguračnom súbore konektora.
  • [name_attribute_multivalues]: názov viachodnotového atribútu, ktorého hodnoty sa majú zreťaziť.

Možné výsledky:

• Ak sa oddeľovač nájde aspoň raz: vráti zoznam hodnôt
• Ak sa oddeľovač nenájde: vráti celý reťazec

Možné výsledky:

Operáciu SPLIT možno použiť v pravidlách synchronizácie, a to iba v operáciách CONVERT.

Príklad nasledujúcej konfigurácie:

• Ak má atribút „string_rights“ hodnotu:
  • Droit_001#Droit_002#Droit_003
• Výsledok: v súbore sync.xml bude mať atribút „lst_right_multi“ nasledujúcu hodnotu:
  • Droit_001
  • Droit_002
  • Droit_003