Seznam operacij, ki so na voljo v posameznih pravilih sinhronizacije

	Pretvorba	Pravila ujemanja	Primerjava	Ustvarjanje	Sprememba	Izbris
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, ki so na voljo za posamezno operacijo:

	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

**: Filtri se razlikujejo glede na pravilo, ki uporablja operacijo.

• B64: Pretvori vrednost atributa v obliko Base 64.
• CI: Case insensitive: primerjava se izvede ne glede na velike in male črke.
• DATE: Pretvori vrednost atributa v obliko DATE.
• DATE_FILETIME: Pretvori vrednost atributa v obliko DATETIME.
• DN: primerjava DN.
• PARTIAL: delno primerja podatke. Vrne true, če je vsaj ena vrednost vsebovana v atributu primerjave.
• PWD: Omogoči šifriranje podatkov.
• USEMAP: uporaba preslikave za iskanje atributa, kar pospeši postopek primerjave.

ADDVALUE

Operacija, ki omogoča dodajanje vrednosti atributu, ki je po definiciji lahko večvrednostni. Omogoča tudi združevanje vrednosti iz več atributov.

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: ime atributa, ki ga je treba spremeniti. Če atribut ne obstaja, bo samodejno ustvarjen.
• [Expression]: formula, ki jo je treba vnesti. Uporabite lahko ključne besede ali v celoti ali delno vnesete fiksne vrednosti (trdo kodirano besedilo). Sintakso, ki velja za vaš primer uporabe, najdete v poglavju „Seznam ključnih besed“.

Primer naslednje konfiguracije:

CHANGE

Operacija, ki omogoča spreminjanje vrednosti atributa. Atribut mora obstajati in biti enovrednostni. Začetna vrednost atributa se prepiše in je ni več mogoče znova uporabiti.

Pozor

Operacija CHANGE je od različice 7.1 opuščena in bo odstranjena v različici 7.2. Podvaja operacijo MODVALUE: odslej za spreminjanje vrednosti atributa uporabljajte MODVALUE.

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: ime atributa, ki ga je treba spremeniti. Če atribut ne obstaja, operacija ne bo delovala.
• [Expression]: formula, ki jo je treba vnesti. Uporabite lahko ključne besede ali v celoti ali delno vnesete fiksne vrednosti (trdo kodirano besedilo). Sintakso, ki velja za vaš primer uporabe, najdete v poglavju „Seznam ključnih besed“.

Primer naslednje konfiguracije:

COMPAREATTNAME

Operacija, ki omogoča navedbo atributov, ki jih ni treba primerjati, in primerjavo vseh drugih atributov z enakim imenom v obeh skladiščih. Imena atributov v izvornem skladišču, ki nimajo ustreznika v ciljnem skladišču, bodo prezrta in ne bodo primerjana. Z njo lahko nadomestite posamično preslikavo atributov, ki jih je treba primerjati.

Upoštevajte, da je ta operacija na voljo šele od različice 6.2 naprej in jo je mogoče uporabiti samo v pravilih OnCompare v operaciji MATCH v povezovalnikih za zagotavljanje vrste stanje zagotavljanja (status).

Sintaksa funkcije:

• [Attribute] = seznam atributov, ki jih ni treba primerjati. Atributi morajo biti ločeni z vejicami in brez presledkov.

Primer naslednje konfiguracije:

COMPAREWITHEXCLUSIONS

Operacija, ki primerja vse atribute med obema izvoroma, ne da bi bilo treba navesti imena atributov izvornega ali ciljnega skladišča. Navedete lahko imena atributov, ki jih ni treba primerjati, kar pomeni, da določite atribute, katerih kode se med obema skladiščema razlikujejo.

Upoštevajte, da je ta operacija na voljo šele od različice 7.1 naprej in jo je mogoče uporabiti samo v pravilu Matching in v pravilih primerjave.

Uporabo te operacije priporočamo, kadar ima večina atributov enako ime v izvornem in ciljnem skladišču, saj tako prihranite čas pri konfiguraciji.

Za razliko od operacije COMPAREATTNAME, ki prezre atribute brez ustreznika v ciljnem skladišču in se uporablja samo v povezovalnikih stanja zagotavljanja, ta operacija sporoči tudi atribute, ki so prisotni samo v enem od obeh skladišč.

Spremembe, ki jih zazna ta operacija, ustrezajo naslednjim primerom uporabe:

• atribut obstaja v izvornem in ciljnem skladišču, vendar z različnima vrednostma;
• atribut obstaja v izvornem skladišču, ne pa v ciljnem skladišču;
• atribut obstaja v ciljnem skladišču, ne pa v izvornem skladišču.

Sintaksa funkcije:

COMPAREWITHEXCLUSIONS:[attribute_1],[attribute_2],…

Atributi, izključeni iz primerjave, so navedeni za dvopičjem in ločeni z vejicami.

Primer naslednje konfiguracije:

COMPAREWITHEXCLUSIONS:whenChanged,objectGUID

Med obema skladiščema se primerjajo vsi atributi razen whenChanged in objectGUID.

CONTAIN

Operacija, ki izvede primerjavo, da preveri, ali so vrednosti atributa avtoritativnega izvora prisotne v atributu ciljnega izvora. Rezultat operacije bo združitev vrednosti atributa ciljnega izvora z vrednostmi atributa avtoritativnega izvora, ki niso bile najdene.

Primer

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Rezultat v atributu ciljnega izvora =

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

V tej operaciji ni mogoče uporabiti ključnih besed.

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: ime atributa v ciljnem izvoru, na katerem se izvede primerjava.
• [Attribute Name]: ime atributa v avtoritativnem izvoru, na katerem se izvede primerjava.

Primer naslednje konfiguracije:

CONVERT

COPY

Operacija, ki omogoča kopiranje vrednosti enega atributa v drug atribut. Deluje za enovrednostne in večvrednostne atribute.

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: ime atributa, ki ga je treba spremeniti. Atribut mora obstajati.
• [Attribute Name]: ime izvornega atributa, katerega vrednost bo kopirana.

Primer naslednje konfiguracije:

Atribut „usual_name“ bo prevzel vrednost atributa „birth_name“.

DELETE

Operacija, ki omogoča izbris atributa v določenem izvoru (izvor izvoza, cilj izvoza ali DELTA).

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: ime atributa, ki ga je treba izbrisati.
• [Expression]: tega polja ne izpolnjujte.

DELVALUE

Operacija, ki omogoča brisanje vrednosti iz atributa na podlagi logičnega izraza: če izraz vrne „True“, se vrednosti izbrišejo. Zato se običajno uporablja za večvrednostne atribute.

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: ime atributa, ki ga je treba spremeniti.
• [Expression]: formula, ki jo je treba vnesti. Uporabite lahko ključne besede ali v celoti ali delno vnesete fiksne vrednosti (trdo kodirano besedilo). Sintakso, ki velja za vaš primer uporabe, najdete v poglavju „Seznam ključnih besed“.

Primer naslednje konfiguracije:

Če atribut „groups“ vsebuje vrednost „GRP_ACCES_COMMUN“, bo ta odstranjena s seznama vrednosti „groups“, spremenjeni seznam atributa „groups“ pa bo kopiran v atribut „memberof@“.

DELVALUEBYVALUE

Operacija, ki omogoča brisanje vrednosti iz atributa na podlagi danega seznama. Zato se običajno uporablja za večvrednostne atribute.

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: ime atributa, ki ga je treba spremeniti.
• [Expression]: vrednosti, ki jih je treba vnesti, ločene z „;“. Uporabite lahko ključne besede ali v celoti ali delno vnesete fiksne vrednosti (trdo kodirano besedilo). Sintakso, ki velja za vaš primer uporabe, najdete v poglavju „Seznam ključnih besed“.

Primer naslednje konfiguracije:

Vrednosti atributa „groups_admin“ in vrednost „GRP_ACCES_COMMUN“ se odstranijo s seznama vrednosti v „memberof@“.

DSTCOPY

Operacija, ki kopira vrednost atributa, najdenega v ciljnem izvozu, v drug atribut v datoteki DELTA. Deluje za enovrednostne in večvrednostne atribute. Običajno se uporablja za prenos vrednosti iz ciljnega skladišča, ki v izvornem skladišču niso znane, pogosto v primeru izbrisa (v izvoru niso znane, v cilju pa so še vedno prisotne).

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: ime ciljnega atributa.
• [Attribute Name]: ime izvornega atributa, katerega vrednost bo kopirana.

Primer naslednje konfiguracije:

EQ

Operacija, ki primerja dva enovrednostna atributa.

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: ime atributa za primerjavo, ki je prisoten v izvornem izvozu.
• [Expression]: formula, ki jo je treba vnesti. Uporabite lahko ključne besede ali v celoti ali delno vnesete fiksne vrednosti (trdo kodirano besedilo). Sintakso, ki velja za vaš primer uporabe, najdete v poglavju „Seznam ključnih besed“.

Primer naslednje konfiguracije:

GETSTRUCTCHILD

Omogoča pridobitev seznama podrejenih struktur v atribut „Destination_attribute_name“ za dano strukturo v „Parent_structure_attribute_name“. To operacijo je mogoče izvesti samo na podatkih iz skladišča Identity (na primer na izvozu identitet, ki ima atribut vrste struktura).

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: ime ciljnega atributa, ki bo prejel seznam podrejenih struktur.
• [Expression]: ime atributa nadrejene strukture brez ključnih besed.

Primer naslednje konfiguracije:

Vrne vse podrejene strukture strukture s kodo „Site“.

ISCONTAINED

Operacija, ki primerja večvrednostni atribut v avtoritativnem izvoru z večvrednostnim atributom v ciljnem izvoru, da izvleče samo seznam vrednosti, ki so prisotne v obeh atributih.

Primer:

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3
• Val_4

Source_target_attribute_values =

• Val_3
• Val_4
• Val_5

Rezultat v atributu ciljnega izvora =

• Val_3
• Val_4

V tej operaciji ni mogoče uporabiti ključnih besed.

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: ime atributa v ciljnem izvoru, na katerem se izvede primerjava.
• [Attribute Name]: ime atributa v avtoritativnem izvoru, na katerem se izvede primerjava.

Primer naslednje konfiguracije:

MERGE

Operacija, ki omogoča združitev vrednosti večvrednostnega atributa in njeno dodelitev enovrednostnemu atributu.

Upoštevajte, da je ta operacija na voljo šele od različice 6.2 naprej.

Sintaksa funkcije:

• [name_out_attribute_monovalue] = ime izhodnega atributa, ki ga je treba zapolniti.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: Ločilo mora biti en sam znak in ne sme biti „;“, ker se ta znak uporablja v konfiguracijski datoteki povezovalnika.
  • [name_attribute_multivalues]: Ime večvrednostnega atributa, katerega vrednosti je treba združiti.

Način uporabe:

Operacijo MERGE je mogoče uporabiti v pravilih sinhronizacije in samo v operacijah CONVERT.

Primer naslednje konfiguracije:

• Pri atributu „wiki_mod_1“ z vrednostjo:
  • Droit_001
  • Droit_002
  • Droit_003
• Rezultat: v datoteki sync.xml bo imel atribut „lst_right“ naslednjo vrednost:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Operacija, ki omogoča spreminjanje vrednosti atributa. Atribut mora obstajati in biti enovrednostni. Začetna vrednost atributa se prepiše in je ni več mogoče znova uporabiti.

Opomba

Ta operacija nadomešča operacijo CHANGE, ki je od različice 7.1 opuščena in v različici 7.2 odstranjena.

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: ime atributa, ki ga je treba spremeniti. Če atribut ne obstaja, operacija ne bo delovala.
• [Expression]: formula, ki jo je treba vnesti. Uporabite lahko ključne besede ali v celoti ali delno vnesete fiksne vrednosti (trdo kodirano besedilo). Sintakso, ki velja za vaš primer uporabe, najdete v poglavju „Seznam ključnih besed“.

Primer naslednje konfiguracije:

MULTCOPY

Kopiranje atributov iz izvora

Operacija, ki kopira vrednosti atributov iz izvornega izvoza v atribute v datoteki DELTA. Deluje za enovrednostne atribute .

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute name to copy]: Ime atributa, ki mora biti v izvornem izvozu. Atribut mora obstajati.
• [Target attribute name]: Atribut mora obstajati. Ime atributa, ki mora biti vključen v ciljni izvoz in bo v datoteki DELTA.

Operacijo je treba izvesti tolikokrat, kot je potrebno.

Primer naslednje konfiguracije:

MULTDSTCOPY

Operacija, ki kopira vrednosti atributov, najdene v ciljnem izvozu, v atribute v datoteki DELTA. Deluje za enovrednostne atribute . Običajno se uporablja za prenos vrednosti iz ciljnega skladišča, ki v izvornem skladišču niso znane, pogosto v primeru izbrisa (v izvoru niso več znane, v cilju pa so še vedno prisotne).

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute name to copy]: Ime atributa, ki mora biti vključen v ciljni izvoz. Atribut mora obstajati.
• [Target attribute name]: Ime ciljnega atributa, ki mora biti v datoteki DELTA.

Operacijo je treba izvesti tolikokrat, kot je potrebno.

Primer naslednje konfiguracije:

MULTIEVALEQ

Operacija, ki primerja več večvrednostnih atributov.

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Source attribute name]: ime atributa za primerjavo, ki je prisoten v izvornem izvozu.
• [Destination attribute name]: ime atributa za primerjavo, ki je prisoten v ciljnem izvozu.

Operacijo je treba izvesti tolikokrat, kot je potrebno. Objekti se povežejo, če so vsi atributi enaki.

Primer naslednje konfiguracije:

MULTSET

Operacija, ki omogoča kopiranje večvrednostnih atributov z možnostjo dodajanja predpone.

Sintaksa funkcije:

• [Nom_attribut_dest] = ime izhodnega atributa, ki ga je treba zapolniti. Ni nujno, da atribut že obstaja.
• [Nom_attribut_src] = ime atributa, katerega vrednosti bodo kopirane. Pozor: ne uporabljajte ključnih besed <syncattsrc> ali <syncattdst>.
• [prefixe] = niz, ki se doda pred vsako vrednost atributa [Nom_attribut_src]. Predpona je lahko vrednost atributa, pridobljena s ključno besedo >. Če predpone ne želite dodati, v drugem parametru pričakovanega izraza navedite samo <uid>.

Način uporabe:

Operacijo MULTSET je mogoče uporabiti v pravilih sinhronizacije za operaciji CONVERT in MATCH (OnCreate, OnModify in OnDelete).

Primer naslednje konfiguracije:

• Pri atributu „postal_code“ z vrednostjo:
  • 68300
  • 68390
  • 38670
• Rezultat: v datoteki sync.xml bo imel atribut „Code_postal_prefix“ naslednje vrednosti:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Operacija, ki primerja 2 večvrednostna atributa.

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: ime atributa za primerjavo, ki je prisoten v ciljnem izvozu.
• [Attribute Name]: ime atributa za primerjavo, ki je prisoten v izvornem izvozu.

Primer naslednje konfiguracije:

RENAME

Operacija, ki preimenuje atribut.

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: novo ime atributa.
• [Expression]: ime atributa, ki ga je treba preimenovati.

Primer naslednje konfiguracije:

SET

Operacija, ki omogoča dodelitev vrednosti atributu – samo enovrednostnemu –, ne glede na to, ali obstaja ali ne.

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Attribute]: ime atributa, ki mu je treba dodeliti vrednost. Če atribut obstaja, se začetna vrednost prepiše; če atribut ne obstaja, se ustvari.
• [Expression]: formula, ki jo je treba vnesti. Uporabite lahko ključne besede ali v celoti ali delno vnesete fiksne vrednosti (trdo kodirano besedilo). Sintakso, ki velja za vaš primer uporabe, najdete v poglavju „Seznam ključnih besed“.

Primer naslednje konfiguracije:

SIMPLEEQ

Operacija, ki primerja več enovrednostnih atributov.

Sintaksa funkcije:

• [Description]: prosto besedilo za opis operacije (neobvezno).
• [Source attribute name]: ime atributa za primerjavo, ki je prisoten v izvornem izvozu.
• [Destination attribute name]: ime atributa za primerjavo, ki je prisoten v ciljnem izvozu.

Operacijo je treba izvesti tolikokrat, kot je potrebno. Objekti se povežejo, če so vsi atributi enaki.

Primer naslednje konfiguracije:

SPLIT

Operacija, ki z ločilom razdeli vrednosti enovrednostnega atributa in rezultat dodeli večvrednostnemu atributu.

Upoštevajte, da je ta operacija na voljo šele od različice 6.2 naprej.

Sintaksa funkcije:

• [name_out_attribute_multivalues] = ime atributa, ki ga je treba podati kot izhod.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: Ločilo mora biti en sam znak in ne sme biti „;“, ker se ta znak uporablja v konfiguracijski datoteki povezovalnika.
  • [name_attribute_multivalues]: Ime večvrednostnega atributa, katerega vrednosti je treba združiti.

Možni rezultati:

• Če je ločilo najdeno vsaj enkrat: vrne seznam vrednosti
• Če ločilo ni najdeno: vrne celoten niz

Možni rezultati:

Operacijo SPLIT je mogoče uporabiti v pravilih sinhronizacije in samo v operacijah CONVERT.

Primer naslednje konfiguracije:

• Ko je atribut „string_rights“ enak:
  • Droit_001#Droit_002#Droit_003
• Rezultat: v datoteki sync.xml bo imel atribut „lst_right_multi“ naslednjo vrednost:
  • Droit_001
  • Droit_002
  • Droit_003