Preskoči na sadržaj

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

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:

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.

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