Preskočiť na obsah

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

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:

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

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