Přeskočit obsah

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
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.

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:

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.

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