Seznam operací dostupných v jednotlivých pravidlech synchronizace

	Převod	Pravidla shody	Porovnání	Vytvoření	Úprava	Odstranění
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é pro jednotlivé operace:

	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

**: Filtry se liší podle pravidla, které operaci používá.

• B64: Převede hodnotu atributu do formátu Base 64.
• CI: Case insensitive: porovnání se provádí bez ohledu na velikost písmen.
• DATE: Převede hodnotu atributu do formátu DATE.
• DATE_FILETIME: Převede hodnotu atributu do formátu DATETIME.
• DN: Porovnání DN.
• PARTIAL: částečně porovná data. Vrátí true, pokud je alespoň jedna hodnota obsažena v atributu porovnání.
• PWD: Povolí šifrování dat.
• USEMAP: použití mapy k nalezení atributu, urychluje proces porovnání.

ADDVALUE

Operace, která umožňuje přidat hodnoty do atributu, jenž může být ze své definice vícehodnotový. Umožňuje také zřetězit hodnoty z několika atributů.

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: název atributu, který se má upravit. Pokud atribut neexistuje, bude automaticky vytvořen.
• [Expression]: vzorec, který je třeba zadat. Lze použít klíčová slova nebo zadat zcela či zčásti pevné hodnoty (pevně zakódovaný text). Syntaxi pro váš případ použití najdete v kapitole „Seznam klíčových slov“.

Příklad následující konfigurace:

CHANGE

Operace, která umožňuje upravit hodnotu atributu. Atribut musí existovat a být jednohodnotový. Počáteční hodnota atributu se přepíše a nelze ji již znovu použít.

Upozornění

Operace CHANGE je od verze 7.1 zastaralá a od verze 7.2 bude odebrána. Duplikuje operaci MODVALUE: k úpravě hodnoty atributu nadále používejte MODVALUE.

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: název atributu, který se má upravit. Pokud atribut neexistuje, operace nebude fungovat.
• [Expression]: vzorec, který je třeba zadat. Lze použít klíčová slova nebo zadat zcela či zčásti pevné hodnoty (pevně zakódovaný text). Syntaxi pro váš případ použití najdete v kapitole „Seznam klíčových slov“.

Příklad následující konfigurace:

COMPAREATTNAME

Operace, která umožňuje vyjmenovat atributy, jež se nemají porovnávat, a porovnat všechny ostatní atributy se stejným názvem v obou úložištích. Názvy atributů ve zdrojovém úložišti, které nemají protějšek v cílovém úložišti, budou ignorovány a nebudou porovnávány. Lze ji použít jako náhradu jednotlivého mapování porovnávaných atributů.

Upozorňujeme, že tato operace je k dispozici až od verze 6.2 a lze ji použít pouze v pravidlech OnCompare v rámci operace MATCH v konektorech zřizování typu stav zřizování (status).

Syntaxe funkce:

• [Attribute] = Seznam atributů, které se nemají porovnávat. Atributy musí být odděleny čárkami a bez mezer.

Příklad následující konfigurace:

COMPAREWITHEXCLUSIONS

Operace, která porovná všechny atributy mezi oběma zdroji, aniž by bylo nutné zadávat názvy atributů zdrojového nebo cílového úložiště. Můžete zadat názvy atributů, které se nemají porovnávat, což odpovídá definování atributů, jejichž kódy se mezi oběma úložišti liší.

Upozorňujeme, že tato operace je k dispozici až od verze 7.1 a lze ji použít pouze v pravidle Matching a v pravidlech porovnání.

Tuto operaci se doporučuje použít, pokud má většina atributů ve zdrojovém a cílovém úložišti stejný název; ušetříte tím čas při konfiguraci.

Na rozdíl od operace COMPAREATTNAME, která ignoruje atributy bez protějšku v cílovém úložišti a používá se pouze v konektorech stavu zřizování, tato operace hlásí také atributy, které jsou přítomny pouze v jednom z obou úložišť.

Změny zjištěné touto operací odpovídají následujícím případům použití:

• atribut existuje ve zdrojovém úložišti i v cílovém úložišti, ale s různými hodnotami;
• atribut existuje ve zdrojovém úložišti, ale ne v cílovém úložišti;
• atribut existuje v cílovém úložišti, ale ne ve zdrojovém úložišti.

Syntaxe funkce:

COMPAREWITHEXCLUSIONS:[attribute_1],[attribute_2],…

Atributy vyloučené z porovnání se uvádějí za dvojtečkou a oddělují se čárkami.

Příklad následující konfigurace:

COMPAREWITHEXCLUSIONS:whenChanged,objectGUID

Mezi oběma úložišti se porovnávají všechny atributy kromě whenChanged a objectGUID.

CONTAIN

Operace, která provede porovnání a ověří, že hodnoty atributu autoritativního zdroje jsou přítomny v atributu cílového zdroje. Výsledkem operace bude zřetězení hodnot atributu cílového zdroje s hodnotami atributu autoritativního zdroje, které nebyly nalezeny.

Příklad

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Výsledek v atributu cílového zdroje =

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

V této operaci nelze používat žádná klíčová slova.

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: název atributu přítomného v cílovém zdroji, na kterém se má provést porovnání.
• [Attribute Name]: název atributu přítomného v autoritativním zdroji, na kterém se má provést porovnání.

Příklad následující konfigurace:

CONVERT

COPY

Operace, která umožňuje zkopírovat hodnotu jednoho atributu do jiného atributu. Funguje pro jednohodnotové i vícehodnotové atributy.

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: název atributu, který se má upravit. Atribut musí existovat.
• [Attribute Name]: název zdrojového atributu, jehož hodnota se zkopíruje.

Příklad následující konfigurace:

Atribut „usual_name“ převezme hodnotu atributu „birth_name“.

DELETE

Operace, která umožňuje odstranit atribut v zadaném zdroji (zdroj exportu, cíl exportu nebo DELTA).

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: název atributu, který se má odstranit.
• [Expression]: toto pole nevyplňujte.

DELVALUE

Operace, která umožňuje odstranit hodnoty z atributu na základě logického výrazu: pokud výraz vrátí „True“, hodnoty se odstraní. Obvykle se proto používá u vícehodnotových atributů.

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: název atributu, který se má upravit.
• [Expression]: vzorec, který je třeba zadat. Lze použít klíčová slova nebo zadat zcela či zčásti pevné hodnoty (pevně zakódovaný text). Syntaxi pro váš případ použití najdete v kapitole „Seznam klíčových slov“.

Příklad následující konfigurace:

Pokud atribut „groups“ obsahuje hodnotu „GRP_ACCES_COMMUN“, bude odebrána ze seznamu hodnot „groups“ a upravený seznam atributu „groups“ se zkopíruje do atributu „memberof@“.

DELVALUEBYVALUE

Operace, která umožňuje odstranit hodnoty z atributu na základě zadaného seznamu. Obvykle se proto používá u vícehodnotových atributů.

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: název atributu, který se má upravit.
• [Expression]: Hodnoty, které je třeba zadat, oddělené znakem „;“. Lze použít klíčová slova nebo zadat zcela či zčásti pevné hodnoty (pevně zakódovaný text). Syntaxi pro váš případ použití najdete v kapitole „Seznam klíčových slov“.

Příklad následující konfigurace:

Hodnoty atributu „groups_admin“ a hodnota „GRP_ACCES_COMMUN“ se odeberou ze seznamu hodnot obsažených v „memberof@“.

DSTCOPY

Operace, která zkopíruje hodnotu atributu nalezeného v cílovém exportu do jiného atributu v souboru DELTA. Funguje pro jednohodnotové i vícehodnotové atributy. Obvykle se používá k přenosu hodnot z cílového úložiště, které nejsou známy ve zdrojovém úložišti, často v případě odstranění (nejsou známy ve zdroji, ale jsou stále přítomny v cíli).

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: název cílového atributu.
• [Attribute Name]: název zdrojového atributu, jehož hodnota se zkopíruje.

Příklad následující konfigurace:

EQ

Operace, která porovná dva jednohodnotové atributy.

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: název porovnávaného atributu, který je přítomen ve zdrojovém exportu.
• [Expression]: vzorec, který je třeba zadat. Lze použít klíčová slova nebo zadat zcela či zčásti pevné hodnoty (pevně zakódovaný text). Syntaxi pro váš případ použití najdete v kapitole „Seznam klíčových slov“.

Příklad následující konfigurace:

GETSTRUCTCHILD

Umožňuje načíst seznam podřízených struktur do atributu „Destination_attribute_name“ pro danou strukturu v „Parent_structure_attribute_name“. Tuto operaci lze provést pouze s daty z úložiště Identity (například s exportem identit, který obsahuje atribut typu struktura).

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: název cílového atributu, který obdrží seznam podřízených struktur.
• [Expression]: Název atributu nadřazené struktury bez klíčových slov.

Příklad následující konfigurace:

Vrátí všechny podřízené struktury struktury s kódem „Site“.

ISCONTAINED

Operace, která porovná vícehodnotový atribut v autoritativním zdroji s vícehodnotovým atributem v cílovém zdroji, aby extrahovala pouze seznam hodnot, které jsou přítomny v obou atributech.

Příklad:

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3
• Val_4

Source_target_attribute_values =

• Val_3
• Val_4
• Val_5

Výsledek v atributu cílového zdroje =

• Val_3
• Val_4

V této operaci nelze používat žádná klíčová slova.

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: název atributu přítomného v cílovém zdroji, na kterém se má provést porovnání.
• [Attribute Name]: název atributu přítomného v autoritativním zdroji, na kterém se má provést porovnání.

Příklad následující konfigurace:

MERGE

Operace, která umožňuje vytvořit zřetězení hodnot vícehodnotového atributu a přiřadit je jednohodnotovému atributu.

Upozorňujeme, že tato operace je k dispozici až od verze 6.2.

Syntaxe funkce:

• [name_out_attribute_monovalue] = Název atributu, který se má poskytnout jako výstup.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: Oddělovač musí být jeden znak a nesmí to být „;“, protože tento znak se používá v konfiguračním souboru konektoru.
  • [name_attribute_multivalues]: Název vícehodnotového atributu, jehož hodnoty se mají zřetězit.

Způsob použití:

Operaci MERGE lze použít v pravidlech synchronizace, a to pouze v operacích CONVERT.

Příklad následující konfigurace:

• Pokud má atribut „wiki_mod_1“ hodnotu:
  • Droit_001
  • Droit_002
  • Droit_003
• Výsledek: v souboru sync.xml bude mít atribut „lst_right“ následující hodnotu:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Operace, která umožňuje upravit hodnotu atributu. Atribut musí existovat a být jednohodnotový. Počáteční hodnota atributu se přepíše a nelze ji již znovu použít.

Poznámka

Tato operace nahrazuje operaci CHANGE, zastaralou od verze 7.1 a odebranou od verze 7.2.

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: název atributu, který se má upravit. Pokud atribut neexistuje, operace nebude fungovat.
• [Expression]: vzorec, který je třeba zadat. Lze použít klíčová slova nebo zadat zcela či zčásti pevné hodnoty (pevně zakódovaný text). Syntaxi pro váš případ použití najdete v kapitole „Seznam klíčových slov“.

Příklad následující konfigurace:

MULTCOPY

Kopírování atributů ze zdroje

Operace, která kopíruje hodnoty atributů ze zdrojového exportu do atributů v souboru DELTA. Funguje pro jednohodnotové atributy .

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute name to copy]: Název atributu, který musí být ve zdrojovém exportu. Atribut musí existovat.
• [Target attribute name]: Atribut musí existovat. Název atributu, který musí být zahrnut v cílovém exportu a který bude umístěn v souboru DELTA.

Operaci je nutné provést tolikrát, kolikrát je potřeba.

Příklad následující konfigurace:

MULTDSTCOPY

Operace, která kopíruje hodnoty atributů nalezené v cílovém exportu do atributů v souboru DELTA. Funguje pro jednohodnotové atributy . Obvykle se používá k přenesení hodnot z cílového úložiště, které zdrojové úložiště nezná, často v případě odstranění (ve zdroji již nejsou známy, ale v cíli jsou stále přítomny).

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute name to copy]: Název atributu, který musí být zahrnut v cílovém exportu. Atribut musí existovat.
• [Target attribute name]: Název cílového atributu, který se musí nacházet v souboru DELTA.

Operaci je nutné provést tolikrát, kolikrát je potřeba.

Příklad následující konfigurace:

MULTIEVALEQ

Operace, která porovná několik vícehodnotových atributů.

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Source attribute name]: název porovnávaného atributu, který je přítomen ve zdrojovém exportu.
• [Destination attribute name]: název porovnávaného atributu, který je přítomen v cílovém exportu.

Operaci je nutné provést tolikrát, kolikrát je potřeba. Objekty se spárují, pokud jsou si všechny atributy rovny.

Příklad následující konfigurace:

MULTSET

Operace, která umožňuje vytvářet kopie vícehodnotových atributů s možností přidat předponu.

Syntaxe funkce:

• [Nom_attribut_dest] = Název atributu, který se má poskytnout jako výstup. Atribut nemusí předem existovat.
• [Nom_attribut_src] = Název atributu, jehož hodnoty se zkopírují. Pozor, nepoužívejte klíčová slova <syncattsrc> ani <syncattdst>.
• [prefixe] = Řetězec, který se přidá před každou hodnotu atributu [Nom_attribut_src]. Předponou může být hodnota atributu získaná pomocí klíčového slova >. Pokud nechcete přidávat předponu, stačí ve druhém parametru očekávaného výrazu zadat <uid>.

Způsob použití:

Operaci MULTSET lze použít v pravidlech synchronizace pro operace CONVERT a MATCH (OnCreate, OnModify a OnDelete).

Příklad následující konfigurace:

• Pokud má atribut „postal_code“ hodnotu:
  • 68300
  • 68390
  • 38670
• Výsledek: v souboru sync.xml bude mít atribut „Code_postal_prefix“ následující hodnoty:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Operace, která porovná 2 vícehodnotové atributy.

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: název porovnávaného atributu, který je přítomen v cílovém exportu.
• [Attribute Name]: název porovnávaného atributu, který je přítomen ve zdrojovém exportu.

Příklad následující konfigurace:

RENAME

Operace, která přejmenuje atribut.

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: nový název atributu.
• [Expression]: název atributu, který se má přejmenovat.

Příklad následující konfigurace:

SET

Operace, která umožňuje přiřadit hodnotu atributu, a to pouze jednohodnotovému, bez ohledu na to, zda existuje, či nikoli.

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Attribute]: název atributu, kterému se má přiřadit hodnota. Pokud atribut existuje, počáteční hodnota se přepíše; pokud atribut neexistuje, bude vytvořen.
• [Expression]: vzorec, který je třeba zadat. Lze použít klíčová slova nebo zadat zcela či zčásti pevné hodnoty (pevně zakódovaný text). Syntaxi pro váš případ použití najdete v kapitole „Seznam klíčových slov“.

Příklad následující konfigurace:

SIMPLEEQ

Operace, která porovnává několik jednohodnotových atributů.

Syntaxe funkce:

• [Description]: volný text popisující operaci (volitelné).
• [Source attribute name]: název porovnávaného atributu, který je přítomen ve zdrojovém exportu.
• [Destination attribute name]: název porovnávaného atributu, který je přítomen v cílovém exportu.

Operaci je nutné provést tolikrát, kolikrát je potřeba. Objekty se spárují, pokud jsou si všechny atributy rovny.

Příklad následující konfigurace:

SPLIT

Operace, která slouží k rozdělení hodnot jednohodnotového atributu pomocí oddělovače a k jejich následnému přiřazení vícehodnotovému atributu.

Upozorňujeme, že tato operace je k dispozici až od verze 6.2.

Syntaxe funkce:

• [name_out_attribute_multivalues] = název atributu, který se má poskytnout jako výstup.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: Oddělovač musí být jeden znak a nesmí to být „;“, protože tento znak se používá v konfiguračním souboru konektoru.
  • [name_attribute_multivalues]: Název vícehodnotového atributu, jehož hodnoty se mají zřetězit.

Možné výsledky:

• Pokud je oddělovač nalezen alespoň jednou: vrátí seznam hodnot
• Pokud oddělovač nalezen není: vrátí celý řetězec

Možné výsledky:

Operaci SPLIT lze použít v pravidlech synchronizace, a to pouze v operacích CONVERT.

Příklad následující konfigurace:

• Pokud má atribut „string_rights“ hodnotu:
  • Droit_001#Droit_002#Droit_003
• Výsledek: v souboru sync.xml bude mít atribut „lst_right_multi“ následující hodnotu:
  • Droit_001
  • Droit_002
  • Droit_003