Kiekvienoje sinchronizavimo taisyklėje galimų operacijų sąrašas

	Konvertavimas	Matching taisyklės	Palyginimas	Kūrimas	Keitimas	Naikinimas
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

Kiekvienai operacijai galimos parinktys:

	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

**: filtrai skiriasi priklausomai nuo taisyklės, kuri naudoja operaciją.

• B64: konvertuoja atributo reikšmę į Base 64 formatą.
• CI: Case insensitive: palyginimas atliekamas neatsižvelgiant į raidžių registrą.
• DATE: konvertuoja atributo reikšmę į DATE formatą.
• DATE_FILETIME: konvertuoja atributo reikšmę į DATETIME formatą.
• DN: DN palyginimas.
• PARTIAL: palygina duomenis iš dalies. Grąžina true, jei bent viena reikšmė yra palyginimo atribute.
• PWD: įjungia duomenų šifravimą.
• USEMAP: atributui rasti naudojamas žemėlapis; tai paspartina palyginimo procesą.

ADDVALUE

Operacija, leidžianti pridėti reikšmių prie atributo, kuris pagal apibrėžtį gali būti daugiareikšmis. Ji taip pat leidžia sujungti kelių atributų reikšmes.

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: keičiamo atributo pavadinimas. Jei atributo nėra, jis bus sukurtas automatiškai.
• [Expression]: įvestina formulė. Galima naudoti raktažodžius arba įvesti visas fiksuotas reikšmes ar jų dalį (tiesiogiai įrašytą tekstą). Jūsų naudojimo atvejui taikytiną sintaksę rasite skyriuje „Raktažodžių sąrašas“.

Toliau pateiktos konfigūracijos pavyzdys:

CHANGE

Operacija, leidžianti pakeisti atributo reikšmę. Atributas turi egzistuoti ir būti vienareikšmis. Pradinė atributo reikšmė perrašoma ir jos nebegalima pakartotinai naudoti.

Dėmesio

Operacija CHANGE nuo 7.1 versijos nebenaudojama ir bus pašalinta nuo 7.2 versijos. Ji dubliuoja operaciją MODVALUE: nuo šiol atributo reikšmei keisti naudokite MODVALUE.

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: keičiamo atributo pavadinimas. Jei atributo nėra, operacija neveiks.
• [Expression]: įvestina formulė. Galima naudoti raktažodžius arba įvesti visas fiksuotas reikšmes ar jų dalį (tiesiogiai įrašytą tekstą). Jūsų naudojimo atvejui taikytiną sintaksę rasite skyriuje „Raktažodžių sąrašas“.

Toliau pateiktos konfigūracijos pavyzdys:

COMPAREATTNAME

Operacija, leidžianti išvardyti atributus, kurių nereikia lyginti, ir palyginti visus kitus atributus, turinčius tą patį pavadinimą abiejose saugyklose. Šaltinio saugyklos atributų pavadinimai, neturintys atitikmens tikslinėje saugykloje, bus ignoruojami ir nelyginami. Ją galima naudoti vietoj pavienio lyginamų atributų susiejimo.

Atkreipkite dėmesį, kad ši operacija pasiekiama tik nuo 6.2 versijos ir gali būti naudojama tik OnCompare taisyklėse, MATCH operacijoje, aprūpinimo būsenos (status) aprūpinimo jungtyse.

Funkcijos sintaksė:

• [Attribute] = nelyginamų atributų sąrašas. Atributai turi būti atskirti kableliais, be tarpų.

Toliau pateiktos konfigūracijos pavyzdys:

COMPAREWITHEXCLUSIONS

Operacija, kuri palygina visus abiejų šaltinių atributus, nenurodant šaltinio saugyklos ar tikslinės saugyklos atributų pavadinimų. Galite nurodyti atributų, kurių nereikia lyginti, pavadinimus; tai prilygsta atributų, kurių kodai abiejose saugyklose skiriasi, apibrėžimui.

Atkreipkite dėmesį, kad ši operacija pasiekiama tik nuo 7.1 versijos ir gali būti naudojama tik Matching taisyklėje ir palyginimo taisyklėse.

Šią operaciją rekomenduojama naudoti, kai dauguma atributų šaltinio ir tikslinėje saugyklose turi tuos pačius pavadinimus – taip sutaupoma konfigūravimo laiko.

Skirtingai nuo operacijos COMPAREATTNAME, kuri ignoruoja atributus, neturinčius atitikmens tikslinėje saugykloje, ir naudojama tik aprūpinimo būsenos jungtyse, ši operacija taip pat praneša apie atributus, esančius tik vienoje iš dviejų saugyklų.

Šios operacijos nustatyti pakeitimai atitinka šiuos naudojimo atvejus:

• atributas egzistuoja šaltinio saugykloje ir tikslinėje saugykloje, bet jo reikšmės skiriasi;
• atributas egzistuoja šaltinio saugykloje, bet neegzistuoja tikslinėje saugykloje;
• atributas egzistuoja tikslinėje saugykloje, bet neegzistuoja šaltinio saugykloje.

Funkcijos sintaksė:

COMPAREWITHEXCLUSIONS:[attribute_1],[attribute_2],…

Iš palyginimo pašalinti atributai išvardijami po dvitaškio, atskirti kableliais.

Toliau pateiktos konfigūracijos pavyzdys:

COMPAREWITHEXCLUSIONS:whenChanged,objectGUID

Visi abiejų saugyklų atributai palyginami, išskyrus whenChanged ir objectGUID.

CONTAIN

Operacija, kuri atlieka palyginimą, kad patikrintų, ar autoritetingo šaltinio atributo reikšmės yra tikslinio šaltinio atribute. Operacijos rezultatas – tikslinio šaltinio atributo reikšmių ir nerastų autoritetingo šaltinio atributo reikšmių sujungimas.

Pavyzdys

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Rezultatas tikslinio šaltinio atribute =

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

Šioje operacijoje negalima naudoti jokių raktažodžių.

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: tikslinio šaltinio atributo, kuriam atliekamas palyginimas, pavadinimas.
• [Attribute Name]: autoritetingo šaltinio atributo, kuriam atliekamas palyginimas, pavadinimas.

Toliau pateiktos konfigūracijos pavyzdys:

CONVERT

COPY

Operacija, leidžianti nukopijuoti vieno atributo reikšmę į kitą atributą. Ji veikia su vienareikšmiais ir daugiareikšmiais atributais.

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: keičiamo atributo pavadinimas. Atributas turi egzistuoti.
• [Attribute Name]: šaltinio atributo, kurio reikšmė bus nukopijuota, pavadinimas.

Toliau pateiktos konfigūracijos pavyzdys:

Atributas „usual_name“ įgis atributo „birth_name“ reikšmę.

DELETE

Operacija, leidžianti panaikinti atributą nurodytame šaltinyje (eksporto šaltinyje, eksporto paskirtyje arba DELTA).

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: naikinamo atributo pavadinimas.
• [Expression]: šio lauko nepildykite.

DELVALUE

Operacija, leidžianti panaikinti atributo reikšmes pagal loginę išraišką: jei išraiška grąžina „True“, reikšmės panaikinamos. Todėl ji paprastai taikoma daugiareikšmiams atributams.

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: keičiamo atributo pavadinimas.
• [Expression]: įvestina formulė. Galima naudoti raktažodžius arba įvesti visas fiksuotas reikšmes ar jų dalį (tiesiogiai įrašytą tekstą). Jūsų naudojimo atvejui taikytiną sintaksę rasite skyriuje „Raktažodžių sąrašas“.

Toliau pateiktos konfigūracijos pavyzdys:

Jei atribute „groups“ yra reikšmė „GRP_ACCES_COMMUN“, ji bus pašalinta iš „groups“ reikšmių sąrašo, o pakeistas atributo „groups“ sąrašas bus nukopijuotas į atributą „memberof@“.

DELVALUEBYVALUE

Operacija, leidžianti panaikinti atributo reikšmes pagal nurodytą sąrašą. Todėl ji paprastai taikoma daugiareikšmiams atributams.

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: keičiamo atributo pavadinimas.
• [Expression]: įvestinos reikšmės, atskirtos „;“. Galima naudoti raktažodžius arba įvesti visas fiksuotas reikšmes ar jų dalį (tiesiogiai įrašytą tekstą). Jūsų naudojimo atvejui taikytiną sintaksę rasite skyriuje „Raktažodžių sąrašas“.

Toliau pateiktos konfigūracijos pavyzdys:

Atributo „groups_admin“ reikšmės ir reikšmė „GRP_ACCES_COMMUN“ pašalinamos iš „memberof@“ esančių reikšmių sąrašo.

DSTCOPY

Operacija, kuri nukopijuoja tiksliniame eksporte rasto atributo reikšmę į kitą DELTA failo atributą. Ji veikia su vienareikšmiais ir daugiareikšmiais atributais. Paprastai ji naudojama tikslinės saugyklos reikšmėms, kurios nežinomos šaltinio saugykloje, perkelti, dažnai naikinimo atveju (šaltinyje nežinomos, bet tikslinėje saugykloje vis dar esančios).

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: paskirties atributo pavadinimas.
• [Attribute Name]: šaltinio atributo, kurio reikšmė bus nukopijuota, pavadinimas.

Toliau pateiktos konfigūracijos pavyzdys:

EQ

Operacija, kuri palygina du vienareikšmius atributus.

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: lyginamo atributo, esančio šaltinio eksporte, pavadinimas.
• [Expression]: įvestina formulė. Galima naudoti raktažodžius arba įvesti visas fiksuotas reikšmes ar jų dalį (tiesiogiai įrašytą tekstą). Jūsų naudojimo atvejui taikytiną sintaksę rasite skyriuje „Raktažodžių sąrašas“.

Toliau pateiktos konfigūracijos pavyzdys:

GETSTRUCTCHILD

Leidžia gauti nurodytos struktūros, esančios „Parent_structure_attribute_name“, antrinių struktūrų sąrašą atribute „Destination_attribute_name“. Šią operaciją galima atlikti tik su Identity saugyklos duomenimis (pavyzdžiui, su tapatybių eksportu, kuriame yra struktūros tipo atributas).

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: paskirties atributo, kuris gaus antrinių struktūrų sąrašą, pavadinimas.
• [Expression]: pirminės struktūros atributo pavadinimas, be jokių raktažodžių.

Toliau pateiktos konfigūracijos pavyzdys:

Grąžina visas struktūros, kurios kodas „Site“, antrines struktūras.

ISCONTAINED

Operacija, kuri palygina autoritetingo šaltinio daugiareikšmį atributą su tikslinio šaltinio daugiareikšmiu atributu, kad išskirtų tik tų reikšmių, kurios yra abiejuose atributuose, sąrašą.

Pavyzdys:

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3
• Val_4

Source_target_attribute_values =

• Val_3
• Val_4
• Val_5

Rezultatas tikslinio šaltinio atribute =

• Val_3
• Val_4

Šioje operacijoje negalima naudoti jokių raktažodžių.

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: tikslinio šaltinio atributo, kuriam atliekamas palyginimas, pavadinimas.
• [Attribute Name]: autoritetingo šaltinio atributo, kuriam atliekamas palyginimas, pavadinimas.

Toliau pateiktos konfigūracijos pavyzdys:

MERGE

Operacija, leidžianti sujungti daugiareikšmio atributo reikšmes ir priskirti jas vienareikšmiam atributui.

Atkreipkite dėmesį, kad ši operacija pasiekiama tik nuo 6.2 versijos.

Funkcijos sintaksė:

• [name_out_attribute_monovalue] = atributo, kuris bus pateiktas kaip išvestis, pavadinimas.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: skyriklis turi būti vienas simbolis ir negali būti „;“, nes šis simbolis naudojamas jungties konfigūracijos faile.
  • [name_attribute_multivalues]: daugiareikšmio atributo, kurio reikšmes reikia sujungti, pavadinimas.

Naudojimo būdas:

Operaciją MERGE galima naudoti sinchronizavimo taisyklėse ir tik CONVERT operacijose.

Toliau pateiktos konfigūracijos pavyzdys:

• Kai atributo „wiki_mod_1“ reikšmė yra:
  • Droit_001
  • Droit_002
  • Droit_003
• Rezultatas: faile sync.xml atributas „lst_right“ turės šią reikšmę:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Operacija, leidžianti pakeisti atributo reikšmę. Atributas turi egzistuoti ir būti vienareikšmis. Pradinė atributo reikšmė perrašoma ir jos nebegalima pakartotinai naudoti.

Pastaba

Ši operacija pakeičia operaciją CHANGE, kuri nuo 7.1 versijos nebenaudojama ir bus pašalinta nuo 7.2 versijos.

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: keičiamo atributo pavadinimas. Jei atributo nėra, operacija neveiks.
• [Expression]: įvestina formulė. Galima naudoti raktažodžius arba įvesti visas fiksuotas reikšmes ar jų dalį (tiesiogiai įrašytą tekstą). Jūsų naudojimo atvejui taikytiną sintaksę rasite skyriuje „Raktažodžių sąrašas“.

Toliau pateiktos konfigūracijos pavyzdys:

MULTCOPY

Kopijuoti atributus iš šaltinio

Operacija, kuri nukopijuoja šaltinio eksporto atributų reikšmes į DELTA failo atributus. Ji veikia su vienareikšmiais atributais .

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute name to copy]: atributo, kuris turi būti šaltinio eksporte, pavadinimas. Atributas turi egzistuoti.
• [Target attribute name]: atributas turi egzistuoti. Atributo, kuris turi būti įtrauktas į tikslinį eksportą ir bus DELTA faile, pavadinimas.

Operaciją reikia atlikti tiek kartų, kiek reikia.

Toliau pateiktos konfigūracijos pavyzdys:

MULTDSTCOPY

Operacija, kuri nukopijuoja tiksliniame eksporte rastas atributų reikšmes į DELTA failo atributus. Ji veikia su vienareikšmiais atributais . Paprastai ji naudojama tikslinės saugyklos reikšmėms, kurios nežinomos šaltinio saugykloje, perkelti, dažnai naikinimo atveju (šaltinyje nebežinomos, bet tikslinėje saugykloje vis dar esančios).

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute name to copy]: atributo, kuris turi būti įtrauktas į tikslinį eksportą, pavadinimas. Atributas turi egzistuoti.
• [Target attribute name]: paskirties atributo, kuris turi būti DELTA faile, pavadinimas.

Operaciją reikia atlikti tiek kartų, kiek reikia.

Toliau pateiktos konfigūracijos pavyzdys:

MULTIEVALEQ

Operacija, kuri palygina kelis daugiareikšmius atributus.

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Source attribute name]: lyginamo atributo, esančio šaltinio eksporte, pavadinimas.
• [Destination attribute name]: lyginamo atributo, esančio paskirties eksporte, pavadinimas.

Operaciją reikia atlikti tiek kartų, kiek reikia. Objektai susiejami, jei visi atributai lygūs.

Toliau pateiktos konfigūracijos pavyzdys:

MULTSET

Operacija, leidžianti kurti daugiareikšmių atributų kopijas su galimybe pridėti priešdėlį.

Funkcijos sintaksė:

• [Nom_attribut_dest] = atributo, kuris bus pateiktas kaip išvestis, pavadinimas. Atributas iš anksto egzistuoti neprivalo.
• [Nom_attribut_src] = atributo, kurio reikšmės bus nukopijuotos, pavadinimas. Dėmesio: nenaudokite raktažodžių <syncattsrc> arba <syncattdst>.
• [prefixe] = eilutė, pridedama prieš kiekvieną atributo [Nom_attribut_src] reikšmę. Priešdėlis gali būti atributo reikšmė, gauta naudojant raktažodį >. Jei nenorite pridėti priešdėlio, tiesiog nurodykite <uid> antrajame laukiamos išraiškos parametre.

Naudojimo būdas:

Operaciją MULTSET galima naudoti sinchronizavimo taisyklėse operacijoms CONVERT ir MATCH (OnCreate, OnModify ir OnDelete).

Toliau pateiktos konfigūracijos pavyzdys:

• Kai atributo „postal_code“ reikšmė yra:
  • 68300
  • 68390
  • 38670
• Rezultatas: faile sync.xml atributas „Code_postal_prefix“ turės šias reikšmes:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Operacija, kuri palygina 2 daugiareikšmius atributus.

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: lyginamo atributo, esančio tiksliniame eksporte, pavadinimas.
• [Attribute Name]: lyginamo atributo, esančio šaltinio eksporte, pavadinimas.

Toliau pateiktos konfigūracijos pavyzdys:

RENAME

Operacija, kuri pervadina atributą.

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: naujas atributo pavadinimas.
• [Expression]: pervadinamo atributo pavadinimas.

Toliau pateiktos konfigūracijos pavyzdys:

SET

Operacija, leidžianti priskirti reikšmę atributui (tik vienareikšmiam), nesvarbu, ar jis egzistuoja, ar ne.

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Attribute]: atributo, kuriam priskiriama reikšmė, pavadinimas. Jei atributas egzistuoja, pradinė reikšmė bus perrašyta; jei atributo nėra, jis bus sukurtas.
• [Expression]: įvestina formulė. Galima naudoti raktažodžius arba įvesti visas fiksuotas reikšmes ar jų dalį (tiesiogiai įrašytą tekstą). Jūsų naudojimo atvejui taikytiną sintaksę rasite skyriuje „Raktažodžių sąrašas“.

Toliau pateiktos konfigūracijos pavyzdys:

SIMPLEEQ

Operacija, lyginanti kelis vienareikšmius atributus.

Funkcijos sintaksė:

• [Description]: laisvas tekstas operacijai aprašyti (neprivaloma).
• [Source attribute name]: lyginamo atributo, esančio šaltinio eksporte, pavadinimas.
• [Destination attribute name]: lyginamo atributo, esančio paskirties eksporte, pavadinimas.

Operaciją reikia atlikti tiek kartų, kiek reikia. Objektai susiejami, jei visi atributai lygūs.

Toliau pateiktos konfigūracijos pavyzdys:

SPLIT

Operacija, naudojama vienareikšmio atributo reikšmėms atskirti pagal skyriklį ir rezultatui priskirti daugiareikšmiam atributui.

Atkreipkite dėmesį, kad ši operacija pasiekiama tik nuo 6.2 versijos.

Funkcijos sintaksė:

• [name_out_attribute_multivalues] = atributo, kuris turi būti pateiktas kaip išvestis, pavadinimas.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: skyriklis turi būti vienas simbolis ir negali būti „;“, nes šis simbolis naudojamas jungties konfigūracijos faile.
  • [name_attribute_multivalues]: daugiareikšmio atributo, kurio reikšmes reikia sujungti, pavadinimas.

Galimi rezultatai:

• Jei skyriklis randamas bent kartą: grąžinamas reikšmių sąrašas
• Jei skyriklis nerandamas: grąžinama visa eilutė

Galimi rezultatai:

Operaciją SPLIT galima naudoti sinchronizavimo taisyklėse ir tik operacijose CONVERT.

Toliau pateiktos konfigūracijos pavyzdys:

• Kai atributo „string_rights“ reikšmė yra:
  • Droit_001#Droit_002#Droit_003
• Rezultatas: faile sync.xml atributas „lst_right_multi“ turės tokią reikšmę:
  • Droit_001
  • Droit_002
  • Droit_003