Popis operacija dostupnih po pravilima sinkronizacije

	Pretvorba	Pravila podudaranja	Usporedba	Stvaranje	Izmjena	Brisanje
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

Opcije dostupne za svaku operaciju:

	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 razlikuju ovisno o pravilu koje koristi operaciju.

• B64: pretvara vrijednost atributa u format Base 64.
• CI: Case insensitive: usporedba se provodi bez razlikovanja velikih i malih slova.
• DATE: pretvara vrijednost atributa u format DATE.
• DATE_FILETIME: pretvara vrijednost atributa u format DATETIME.
• DN: usporedba DN-a.
• PARTIAL: djelomično uspoređuje podatke. Vraća true ako je barem jedna vrijednost sadržana u atributu usporedbe.
• PWD: omogućuje šifriranje podataka.
• USEMAP: korištenje mape za pronalaženje atributa, ubrzava postupak usporedbe.

ADDVALUE

Operacija koja omogućuje dodavanje vrijednosti atributu koji po definiciji može biti viševrijednosni. Omogućuje i spajanje vrijednosti iz više atributa.

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: naziv atributa koji treba izmijeniti. Ako atribut ne postoji, automatski će se stvoriti.
• [Expression]: formula koju treba unijeti. Moguće je koristiti ključne riječi ili unijeti fiksne vrijednosti u cijelosti ili djelomično (čvrsto kodirani tekst). Sintaksu koju treba primijeniti u vašem slučaju upotrebe potražite u poglavlju „Popis ključnih riječi“.

Primjer sljedeće konfiguracije:

CHANGE

Operacija koja omogućuje izmjenu vrijednosti atributa. Atribut mora postojati i biti jednovrijednosni. Početna vrijednost atributa prepisuje se i više se ne može ponovno upotrijebiti.

Pozor

Operacija CHANGE zastarjela je od verzije 7.1 i bit će uklonjena od verzije 7.2. Ona duplicira operaciju MODVALUE: od sada za izmjenu vrijednosti atributa koristite MODVALUE.

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: naziv atributa koji treba izmijeniti. Ako atribut ne postoji, operacija neće funkcionirati.
• [Expression]: formula koju treba unijeti. Moguće je koristiti ključne riječi ili unijeti fiksne vrijednosti u cijelosti ili djelomično (čvrsto kodirani tekst). Sintaksu koju treba primijeniti u vašem slučaju upotrebe potražite u poglavlju „Popis ključnih riječi“.

Primjer sljedeće konfiguracije:

COMPAREATTNAME

Operacija koja omogućuje navođenje atributa koje ne treba uspoređivati i usporedbu svih ostalih atributa istog naziva u oba repozitorija. Nazivi atributa u izvornom repozitoriju koji nemaju parnjak u ciljnom repozitoriju zanemaruju se i ne uspoređuju. Može se koristiti umjesto pojedinačnog mapiranja atributa koje treba usporediti.

Imajte na umu da je ova operacija dostupna tek od verzije 6.2 i da se može koristiti samo u pravilima OnCompare u operaciji MATCH u poveznicima za dodjeljivanje sa statusom dodjeljivanja (status).

Sintaksa funkcije:

• [Attribute] = popis atributa koje ne treba uspoređivati. Atributi moraju biti odvojeni zarezima, bez razmaka.

Primjer sljedeće konfiguracije:

COMPAREWITHEXCLUSIONS

Operacija koja uspoređuje sve atribute između dvaju izvora, bez navođenja naziva atributa izvornog ili ciljnog repozitorija. Možete navesti nazive atributa koje ne treba uspoređivati, što odgovara definiranju atributa čije se šifre razlikuju između dvaju repozitorija.

Imajte na umu da je ova operacija dostupna tek od verzije 7.1 i da se može koristiti samo u pravilu Matching i u pravilima usporedbe.

Ovu se operaciju preporučuje koristiti kada većina atributa ima isti naziv u izvornom i ciljnom repozitoriju, kako bi se uštedjelo vrijeme konfiguracije.

Za razliku od operacije COMPAREATTNAME, koja zanemaruje atribute bez parnjaka u ciljnom repozitoriju i koristi se samo u poveznicima statusa dodjeljivanja, ova operacija prijavljuje i atribute koji su prisutni samo u jednom od dvaju repozitorija.

Izmjene koje ova operacija utvrđuje odgovaraju sljedećim slučajevima upotrebe:

• atribut postoji u izvornom i u ciljnom repozitoriju, s različitim vrijednostima;
• atribut postoji u izvornom repozitoriju, ali ne i u ciljnom repozitoriju;
• atribut postoji u ciljnom repozitoriju, ali ne i u izvornom repozitoriju.

Sintaksa funkcije:

COMPAREWITHEXCLUSIONS:[attribute_1],[attribute_2],…

Atributi isključeni iz usporedbe navode se nakon dvotočke, odvojeni zarezima.

Primjer sljedeće konfiguracije:

COMPAREWITHEXCLUSIONS:whenChanged,objectGUID

Svi se atributi uspoređuju između dvaju repozitorija, osim whenChanged i objectGUID.

CONTAIN

Operacija koja provodi usporedbu radi provjere jesu li vrijednosti atributa autoritativnog izvora prisutne u atributu ciljnog izvora. Rezultat operacije bit će spoj vrijednosti atributa ciljnog izvora s onim vrijednostima atributa autoritativnog izvora koje nisu pronađene.

Primjer

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Rezultat u atributu ciljnog izvora =

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

U ovoj se operaciji ne mogu koristiti ključne riječi.

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: naziv atributa prisutnog u ciljnom izvoru na kojem treba izvršiti usporedbu.
• [Attribute Name]: naziv atributa prisutnog u autoritativnom izvoru na kojem treba izvršiti usporedbu.

Primjer sljedeće konfiguracije:

CONVERT

COPY

Operacija koja omogućuje kopiranje vrijednosti jednog atributa u drugi atribut. Funkcionira za jednovrijednosne i viševrijednosne atribute.

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: naziv atributa koji treba izmijeniti. Atribut mora postojati.
• [Attribute Name]: naziv izvornog atributa čija će se vrijednost kopirati.

Primjer sljedeće konfiguracije:

Atribut „usual_name“ preuzet će vrijednost atributa „birth_name“.

DELETE

Operacija koja omogućuje brisanje atributa u navedenom izvoru (izvor izvoza, cilj izvoza ili DELTA).

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: naziv atributa koji treba izbrisati.
• [Expression]: ne ispunjavajte ovo polje.

DELVALUE

Operacija koja omogućuje brisanje vrijednosti iz atributa na temelju Booleova izraza: ako izraz vrati „True“, vrijednosti se brišu. Stoga se općenito primjenjuje na viševrijednosne atribute.

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: naziv atributa koji treba izmijeniti.
• [Expression]: formula koju treba unijeti. Moguće je koristiti ključne riječi ili unijeti fiksne vrijednosti u cijelosti ili djelomično (čvrsto kodirani tekst). Sintaksu koju treba primijeniti u vašem slučaju upotrebe potražite u poglavlju „Popis ključnih riječi“.

Primjer sljedeće konfiguracije:

Ako atribut „groups“ sadrži vrijednost „GRP_ACCES_COMMUN“, ona će se ukloniti s popisa vrijednosti atributa „groups“, a izmijenjeni popis atributa „groups“ kopirat će se u atribut „memberof@“.

DELVALUEBYVALUE

Operacija koja omogućuje brisanje vrijednosti iz atributa na temelju zadanog popisa. Stoga se općenito primjenjuje na viševrijednosne atribute.

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: naziv atributa koji treba izmijeniti.
• [Expression]: vrijednosti koje treba unijeti, odvojene znakom „;“. Moguće je koristiti ključne riječi ili unijeti fiksne vrijednosti u cijelosti ili djelomično (čvrsto kodirani tekst). Sintaksu koju treba primijeniti u vašem slučaju upotrebe potražite u poglavlju „Popis ključnih riječi“.

Primjer sljedeće konfiguracije:

Vrijednosti atributa „groups_admin“ i vrijednost „GRP_ACCES_COMMUN“ uklanjaju se s popisa vrijednosti sadržanih u „memberof@“.

DSTCOPY

Operacija koja kopira vrijednost atributa pronađenog u ciljnom izvozu u drugi atribut u datoteci DELTA. Funkcionira za jednovrijednosne i viševrijednosne atribute. Općenito se koristi za prijenos vrijednosti iz ciljnog repozitorija koje su nepoznate u izvornom repozitoriju, često u slučaju brisanja (nepoznato u izvoru, ali još uvijek prisutno u cilju).

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: naziv odredišnog atributa.
• [Attribute Name]: naziv izvornog atributa čija će se vrijednost kopirati.

Primjer sljedeće konfiguracije:

EQ

Operacija koja uspoređuje dva jednovrijednosna atributa.

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: naziv atributa koji treba usporediti, prisutnog u izvornom izvozu.
• [Expression]: formula koju treba unijeti. Moguće je koristiti ključne riječi ili unijeti fiksne vrijednosti u cijelosti ili djelomično (čvrsto kodirani tekst). Sintaksu koju treba primijeniti u vašem slučaju upotrebe potražite u poglavlju „Popis ključnih riječi“.

Primjer sljedeće konfiguracije:

GETSTRUCTCHILD

Omogućuje dohvaćanje popisa podređenih struktura u atribut „Destination_attribute_name“ za zadanu strukturu u „Parent_structure_attribute_name“. Ova se operacija može izvršiti samo na podacima iz repozitorija Identity (na primjer, na izvozu identiteta koji ima atribut tipa strukture).

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: naziv odredišnog atributa koji će primiti popis podređenih struktura.
• [Expression]: naziv atributa nadređene strukture, bez ključnih riječi.

Primjer sljedeće konfiguracije:

Vraća sve podređene strukture strukture sa šifrom „Site“.

ISCONTAINED

Operacija koja uspoređuje viševrijednosni atribut u autoritativnom izvoru s viševrijednosnim atributom u ciljnom izvoru kako bi se izdvojio samo popis vrijednosti prisutnih u oba atributa.

Primjer:

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3
• Val_4

Source_target_attribute_values =

• Val_3
• Val_4
• Val_5

Rezultat u atributu ciljnog izvora =

• Val_3
• Val_4

U ovoj se operaciji ne mogu koristiti ključne riječi.

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: naziv atributa prisutnog u ciljnom izvoru na kojem treba izvršiti usporedbu.
• [Attribute Name]: naziv atributa prisutnog u autoritativnom izvoru na kojem treba izvršiti usporedbu.

Primjer sljedeće konfiguracije:

MERGE

Operacija koja omogućuje stvaranje spoja vrijednosti viševrijednosnog atributa i njegovo pridruživanje jednovrijednosnom atributu.

Imajte na umu da je ova operacija dostupna tek od verzije 6.2.

Sintaksa funkcije:

• [name_out_attribute_monovalue] = naziv atributa koji treba dati kao izlaz.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: razdjelnik mora biti jedan znak i ne može biti „;“, jer se taj znak koristi u konfiguracijskoj datoteci poveznika.
  • [name_attribute_multivalues]: naziv viševrijednosnog atributa čije vrijednosti treba spojiti.

Način upotrebe:

Operacija MERGE može se koristiti u pravilima sinkronizacije i samo u operacijama CONVERT.

Primjer sljedeće konfiguracije:

• Ako je atribut „wiki_mod_1“ jednak:
  • Droit_001
  • Droit_002
  • Droit_003
• Rezultat: u datoteci sync.xml atribut „lst_right“ imat će sljedeću vrijednost:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Operacija koja omogućuje izmjenu vrijednosti atributa. Atribut mora postojati i biti jednovrijednosni. Početna vrijednost atributa prepisuje se i više se ne može ponovno upotrijebiti.

Napomena

Ova operacija zamjenjuje operaciju CHANGE, koja je zastarjela od verzije 7.1 i uklonjena od verzije 7.2.

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: naziv atributa koji treba izmijeniti. Ako atribut ne postoji, operacija neće funkcionirati.
• [Expression]: formula koju treba unijeti. Moguće je koristiti ključne riječi ili unijeti fiksne vrijednosti u cijelosti ili djelomično (čvrsto kodirani tekst). Sintaksu koju treba primijeniti u vašem slučaju upotrebe potražite u poglavlju „Popis ključnih riječi“.

Primjer sljedeće konfiguracije:

MULTCOPY

Kopiranje atributa iz izvora

Operacija koja kopira vrijednosti atributa iz izvornog izvoza u atribute u datoteci DELTA. Funkcionira za jednovrijednosne atribute .

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute name to copy]: naziv atributa koji mora biti u izvornom izvozu. Atribut mora postojati.
• [Target attribute name]: atribut mora postojati. Naziv atributa koji mora biti uključen u ciljni izvoz, a koji će se nalaziti u datoteci DELTA.

Operaciju treba izvršiti onoliko puta koliko je potrebno.

Primjer sljedeće konfiguracije:

MULTDSTCOPY

Operacija koja kopira vrijednosti atributa pronađene u ciljnom izvozu u atribute u datoteci DELTA. Funkcionira za jednovrijednosne atribute . Općenito se koristi za prijenos vrijednosti iz ciljnog repozitorija koje su nepoznate u izvornom repozitoriju, često u slučaju brisanja (više nepoznato u izvoru, ali još uvijek prisutno u cilju).

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute name to copy]: naziv atributa koji mora biti uključen u ciljni izvoz. Atribut mora postojati.
• [Target attribute name]: naziv odredišnog atributa koji se mora nalaziti u datoteci DELTA.

Operaciju treba izvršiti onoliko puta koliko je potrebno.

Primjer sljedeće konfiguracije:

MULTIEVALEQ

Operacija koja uspoređuje više viševrijednosnih atributa.

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Source attribute name]: naziv atributa koji treba usporediti, prisutnog u izvornom izvozu.
• [Destination attribute name]: naziv atributa koji treba usporediti, prisutnog u odredišnom izvozu.

Operaciju treba izvršiti onoliko puta koliko je potrebno. Objekti se uparuju ako su svi atributi jednaki.

Primjer sljedeće konfiguracije:

MULTSET

Operacija koja omogućuje izradu kopija viševrijednosnih atributa uz mogućnost dodavanja prefiksa.

Sintaksa funkcije:

• [Nom_attribut_dest] = naziv atributa koji treba dati kao izlaz. Atribut ne mora prethodno postojati.
• [Nom_attribut_src] = naziv atributa čije će se vrijednosti kopirati. Pažnja: ne koristite ključne riječi <syncattsrc> ili <syncattdst>.
• [prefixe] = niz koji treba dodati ispred svake vrijednosti atributa [Nom_attribut_src]. Prefiks može biti vrijednost atributa uz korištenje ključne riječi >. Ako ne želite dodati prefiks, jednostavno navedite <uid> u drugom parametru očekivanog izraza.

Način upotrebe:

Operacija MULTSET može se koristiti u pravilima sinkronizacije za operacije CONVERT i MATCH (OnCreate, OnModify i OnDelete).

Primjer sljedeće konfiguracije:

• Ako je atribut „postal_code“ jednak:
  • 68300
  • 68390
  • 38670
• Rezultat: u datoteci sync.xml atribut „Code_postal_prefix“ imat će sljedeće vrijednosti:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Operacija koja uspoređuje 2 viševrijednosna atributa.

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: naziv atributa koji treba usporediti, prisutnog u ciljnom izvozu.
• [Attribute Name]: naziv atributa koji treba usporediti, prisutnog u izvornom izvozu.

Primjer sljedeće konfiguracije:

RENAME

Operacija koja preimenuje atribut.

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: novi naziv atributa.
• [Expression]: naziv atributa koji treba preimenovati.

Primjer sljedeće konfiguracije:

SET

Operacija koja omogućuje dodjelu vrijednosti atributu, isključivo jednovrijednosnom, bez obzira na to postoji li on ili ne.

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Attribute]: naziv atributa kojem se dodjeljuje vrijednost. Ako atribut postoji, početna vrijednost bit će prebrisana; ako atribut ne postoji, bit će stvoren.
• [Expression]: formula koju treba unijeti. Moguće je koristiti ključne riječi ili unijeti fiksne vrijednosti u cijelosti ili djelomično (čvrsto kodirani tekst). Sintaksu koju treba primijeniti u vašem slučaju upotrebe potražite u poglavlju „Popis ključnih riječi“.

Primjer sljedeće konfiguracije:

SIMPLEEQ

Operacija koja uspoređuje nekoliko jednovrijednosnih atributa.

Sintaksa funkcije:

• [Description]: slobodni tekst za opis operacije (nije obavezno).
• [Source attribute name]: naziv atributa koji treba usporediti, prisutnog u izvornom izvozu.
• [Destination attribute name]: naziv atributa koji treba usporediti, prisutnog u odredišnom izvozu.

Operaciju treba izvršiti onoliko puta koliko je potrebno. Objekti se uparuju ako su svi atributi jednaki.

Primjer sljedeće konfiguracije:

SPLIT

Operacija koja služi za razdvajanje vrijednosti jednovrijednosnog atributa pomoću razdjelnika i njihovu dodjelu viševrijednosnom atributu.

Imajte na umu da je ova operacija dostupna tek od verzije 6.2.

Sintaksa funkcije:

• [name_out_attribute_multivalues] = naziv atributa koji se daje kao izlaz.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: razdjelnik mora biti jedan znak i ne može biti „;“, jer se taj znak koristi u konfiguracijskoj datoteci poveznika.
  • [name_attribute_multivalues]: naziv viševrijednosnog atributa čije vrijednosti treba spojiti.

Mogući rezultati:

• Ako je razdjelnik pronađen barem jednom: vraća popis vrijednosti
• Ako razdjelnik nije pronađen: vraća cijeli niz znakova

Mogući rezultati:

Operacija SPLIT može se koristiti u pravilima sinkronizacije i samo u operacijama CONVERT.

Primjer sljedeće konfiguracije:

• S atributom „string_rights“ jednakim:
  • Droit_001#Droit_002#Droit_003
• Rezultat: u datoteci sync.xml atribut „lst_right_multi“ imat će sljedeću vrijednost:
  • Droit_001
  • Droit_002
  • Droit_003