Sünkroonimisreeglites saadaolevate toimingute loend

	Teisendus	Vastavus- reeglid	Võrdlus	Loomine	Muutmine	Kustutamine
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

Iga toimingu jaoks saadaolevad suvandid:

	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

**: Filtrid erinevad olenevalt toimingut kasutavast reeglist.

• B64: Teisendab atribuudi väärtuse Base 64 vormingusse.
• CI: Case insensitive: võrdlus tehakse tõstutundetult.
• DATE: Teisendab atribuudi väärtuse DATE-vormingusse.
• DATE_FILETIME: Teisendab atribuudi väärtuse DATETIME-vormingusse.
• DN: DN-võrdlus.
• PARTIAL: võrdleb andmeid osaliselt. Tagastab väärtuse true, kui vähemalt üks väärtus sisaldub võrdlusatribuudis.
• PWD: Lülitab sisse andmete krüptimise.
• USEMAP: atribuudi leidmiseks kasutatakse vastendustabelit (map), mis kiirendab võrdlusprotsessi.

ADDVALUE

Toiming, mis võimaldab lisada väärtusi atribuudile, mis võib definitsiooni järgi olla mitmeväärtuseline. Samuti võimaldab see mitme atribuudi väärtuste konkateneerimist.

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: muudetava atribuudi nimi. Kui atribuuti pole olemas, luuakse see automaatselt.
• [Expression]: sisestatav valem. Võite kasutada võtmesõnu või sisestada fikseeritud väärtusi täielikult või osaliselt (kõvakodeeritud tekst). Teie kasutusjuhul rakendatava süntaksi leiate peatükist „Võtmesõnade loend“.

Järgmise konfiguratsiooni näide:

CHANGE

Toiming, mis võimaldab muuta atribuudi väärtust. Atribuut peab olema olemas ja üheväärtuseline. Atribuudi algne väärtus kirjutatakse üle ja seda ei saa enam uuesti kasutada.

Tähelepanu

Toiming CHANGE on alates versioonist 7.1 iganenuks märgitud ja eemaldatakse alates versioonist 7.2. See dubleerib toimingut MODVALUE: kasutage edaspidi atribuudi väärtuse muutmiseks toimingut MODVALUE.

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: muudetava atribuudi nimi. Kui atribuuti pole olemas, toiming ei tööta.
• [Expression]: sisestatav valem. Võite kasutada võtmesõnu või sisestada fikseeritud väärtusi täielikult või osaliselt (kõvakodeeritud tekst). Teie kasutusjuhul rakendatava süntaksi leiate peatükist „Võtmesõnade loend“.

Järgmise konfiguratsiooni näide:

COMPAREATTNAME

Toiming, mis võimaldab loetleda atribuudid, mida ei tohi võrrelda, ja võrrelda kõiki teisi atribuute, millel on mõlemas hoidlas sama nimi. Allikahoidla atribuutide nimesid, millel sihthoidlas vastet pole, eiratakse ja neid ei võrrelda. Sellega saab asendada võrreldavate atribuutide ükshaaval vastendamise.

Pange tähele, et see toiming on saadaval ainult alates versioonist 6.2 ja seda saab kasutada ainult OnCompare-reeglites MATCH-toimingus ettevalmistusolekute (status) ettevalmistuskonnektorites.

Funktsiooni süntaks:

• [Attribute] = loend atribuutidest, mida ei tohi võrrelda. Atribuudid tuleb eraldada komadega ja ilma tühikuteta.

Järgmise konfiguratsiooni näide:

COMPAREWITHEXCLUSIONS

Toiming, mis võrdleb kahe allika vahel kõiki atribuute, ilma et oleks vaja määrata allikahoidla või sihthoidla atribuutide nimesid. Saate määrata nende atribuutide nimed, mida ei võrrelda, mis tähendab nende atribuutide määratlemist, mille koodid kahes hoidlas erinevad.

Pange tähele, et see toiming on saadaval alles alates versioonist 7.1 ja seda saab kasutada ainult Matching-reeglis ja võrdlusreeglites.

Seda toimingut on soovitatav kasutada, kui enamikul atribuutidel on allika- ja sihthoidlas sama nimi, et säästa konfigureerimisele kuluvat aega.

Erinevalt toimingust COMPAREATTNAME, mis eirab atribuute, millel sihthoidlas vastet pole, ja mida kasutatakse ainult ettevalmistusolekute konnektorites, teatab see toiming ka atribuutidest, mis on olemas ainult ühes kahest hoidlast.

Selle toimingu tuvastatud muudatused vastavad järgmistele kasutusjuhtudele:

• atribuut on olemas nii allikahoidlas kui ka sihthoidlas, erinevate väärtustega;
• atribuut on olemas allikahoidlas, kuid mitte sihthoidlas;
• atribuut on olemas sihthoidlas, kuid mitte allikahoidlas.

Funktsiooni süntaks:

COMPAREWITHEXCLUSIONS:[atribuut_1],[atribuut_2],…

Võrdlusest välja jäetud atribuudid loetletakse pärast koolonit, eraldatuna komadega.

Järgmise konfiguratsiooni näide:

COMPAREWITHEXCLUSIONS:whenChanged,objectGUID

Kahe hoidla vahel võrreldakse kõiki atribuute, välja arvatud whenChanged ja objectGUID.

CONTAIN

Toiming, mis teeb võrdluse, et kontrollida, kas autoriteetse allika atribuudi väärtused on olemas sihtallika atribuudis. Toimingu tulemuseks on sihtallika atribuudi väärtuste ja leidmata jäänud autoriteetse allika atribuudi väärtuste konkateneerimine.

Näide

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Tulemus sihtallika atribuudis =

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

Selles toimingus ei saa võtmesõnu kasutada.

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: sihtallikas oleva atribuudi nimi, mille põhjal võrdlus tehakse.
• [Attribute Name]: autoriteetses allikas oleva atribuudi nimi, mille põhjal võrdlus tehakse.

Järgmise konfiguratsiooni näide:

CONVERT

COPY

Toiming, mis võimaldab kopeerida ühe atribuudi väärtuse teise atribuuti. See töötab nii üheväärtuseliste kui ka mitmeväärtuseliste atribuutidega.

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: muudetava atribuudi nimi. Atribuut peab olema olemas.
• [Attribute Name]: allikaatribuudi nimi, mille väärtus kopeeritakse.

Järgmise konfiguratsiooni näide:

Atribuut „usual_name“ saab atribuudi „birth_name“ väärtuse.

DELETE

Toiming, mis võimaldab kustutada atribuudi määratud allikast (ekspordi allikas, ekspordi siht või DELTA).

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: kustutatava atribuudi nimi.
• [Expression]: ärge täitke seda välja.

DELVALUE

Toiming, mis võimaldab kustutada atribuudist väärtusi tõeväärtusavaldise põhjal: kui avaldis tagastab „True“, kustutatakse väärtused. Seetõttu rakendub see üldjuhul mitmeväärtuselistele atribuutidele.

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: muudetava atribuudi nimi.
• [Expression]: sisestatav valem. Võite kasutada võtmesõnu või sisestada fikseeritud väärtusi täielikult või osaliselt (kõvakodeeritud tekst). Teie kasutusjuhul rakendatava süntaksi leiate peatükist „Võtmesõnade loend“.

Järgmise konfiguratsiooni näide:

Kui atribuut „groups“ sisaldab väärtust „GRP_ACCES_COMMUN“, eemaldatakse see atribuudi „groups“ väärtuste loendist ja atribuudi „groups“ muudetud loend kopeeritakse atribuuti „memberof@“.

DELVALUEBYVALUE

Toiming, mis võimaldab kustutada atribuudist väärtusi antud loendi põhjal. Seetõttu rakendub see üldjuhul mitmeväärtuselistele atribuutidele.

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: muudetava atribuudi nimi.
• [Expression]: sisestatavad väärtused, eraldatuna märgiga „;“. Võite kasutada võtmesõnu või sisestada fikseeritud väärtusi täielikult või osaliselt (kõvakodeeritud tekst). Teie kasutusjuhul rakendatava süntaksi leiate peatükist „Võtmesõnade loend“.

Järgmise konfiguratsiooni näide:

Atribuudi „groups_admin“ väärtused ja väärtus „GRP_ACCES_COMMUN“ eemaldatakse atribuudis „memberof@“ sisalduvate väärtuste loendist.

DSTCOPY

Toiming, mis kopeerib sihtekspordis leitud atribuudi väärtuse DELTA-faili teise atribuuti. See töötab nii üheväärtuseliste kui ka mitmeväärtuseliste atribuutidega. Tavaliselt kasutatakse seda sihthoidlast selliste väärtuste ülekandmiseks, mis allikahoidlas pole teada, sageli kustutamise korral (allikas pole teada, kuid sihtkohas on endiselt olemas).

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: sihtatribuudi nimi.
• [Attribute Name]: allikaatribuudi nimi, mille väärtus kopeeritakse.

Järgmise konfiguratsiooni näide:

EQ

Toiming, mis võrdleb kahte üheväärtuselist atribuuti.

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: võrreldava atribuudi nimi, mis on olemas allikaekspordis.
• [Expression]: sisestatav valem. Võite kasutada võtmesõnu või sisestada fikseeritud väärtusi täielikult või osaliselt (kõvakodeeritud tekst). Teie kasutusjuhul rakendatava süntaksi leiate peatükist „Võtmesõnade loend“.

Järgmise konfiguratsiooni näide:

GETSTRUCTCHILD

Võimaldab tuua atribuuti „Destination_attribute_name“ atribuudis „Parent_structure_attribute_name“ antud struktuuri alamstruktuuride loendi. Seda toimingut saab teha ainult Identity hoidla andmetega (näiteks identiteetide ekspordiga, millel on struktuuritüüpi atribuut).

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: sihtatribuudi nimi, mis saab alamstruktuuride loendi.
• [Expression]: Ülemstruktuuri atribuudi nimi ilma võtmesõnadeta.

Järgmise konfiguratsiooni näide:

Tagastab kõik koodiga „Site“ struktuuri alamstruktuurid.

ISCONTAINED

Toiming, mis võrdleb autoriteetse allika mitmeväärtuselist atribuuti sihtallika mitmeväärtuselise atribuudiga, et eraldada ainult nende väärtuste loend, mis on olemas mõlemas atribuudis.

Näide:

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3
• Val_4

Source_target_attribute_values =

• Val_3
• Val_4
• Val_5

Tulemus sihtallika atribuudis =

• Val_3
• Val_4

Selles toimingus ei saa võtmesõnu kasutada.

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: sihtallikas oleva atribuudi nimi, mille põhjal võrdlus tehakse.
• [Attribute Name]: autoriteetses allikas oleva atribuudi nimi, mille põhjal võrdlus tehakse.

Järgmise konfiguratsiooni näide:

MERGE

Toiming, mis võimaldab luua mitmeväärtuselise atribuudi väärtuste konkatenatsiooni ja määrata selle üheväärtuselisele atribuudile.

Pange tähele, et see toiming on saadaval ainult alates versioonist 6.2.

Funktsiooni süntaks:

• [name_out_attribute_monovalue] = väljundina antava atribuudi nimi.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: Eraldaja peab olema üks märk ega tohi olla „;“, kuna seda märki kasutatakse konnektori konfiguratsioonifailis.
  • [name_attribute_multivalues]: Selle mitmeväärtuselise atribuudi nimi, mille väärtused tuleb konkateneerida.

Kasutusviis:

Toimingut MERGE saab kasutada sünkroonimisreeglites ja ainult CONVERT-toimingutes.

Järgmise konfiguratsiooni näide:

• Kui atribuudi „wiki_mod_1“ väärtus on:
  • Droit_001
  • Droit_002
  • Droit_003
• Tulemus: failis sync.xml on atribuudil „lst_right“ järgmine väärtus:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Toiming, mis võimaldab muuta atribuudi väärtust. Atribuut peab olema olemas ja üheväärtuseline. Atribuudi algne väärtus kirjutatakse üle ja seda ei saa enam uuesti kasutada.

Märkus

See toiming asendab toimingu CHANGE, mis on alates versioonist 7.1 iganenuks märgitud ja alates versioonist 7.2 eemaldatud.

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: muudetava atribuudi nimi. Kui atribuuti pole olemas, toiming ei tööta.
• [Expression]: sisestatav valem. Võite kasutada võtmesõnu või sisestada fikseeritud väärtusi täielikult või osaliselt (kõvakodeeritud tekst). Teie kasutusjuhul rakendatava süntaksi leiate peatükist „Võtmesõnade loend“.

Järgmise konfiguratsiooni näide:

MULTCOPY

Atribuutide kopeerimine allikast

Toiming, mis kopeerib atribuutide väärtused allikaekspordist DELTA-faili atribuutidesse. See töötab üheväärtuseliste atribuutidega .

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute name to copy]: Selle atribuudi nimi, mis peab olema allikaekspordis. Atribuut peab olema olemas.
• [Target attribute name]: Atribuut peab olema olemas. Selle atribuudi nimi, mis peab sisalduma sihtekspordis ja mis asub DELTA-failis.

Toimingut tuleb teha nii mitu korda, kui vaja.

Järgmise konfiguratsiooni näide:

MULTDSTCOPY

Toiming, mis kopeerib sihtekspordis leitud atribuutide väärtused DELTA-faili atribuutidesse. See töötab üheväärtuseliste atribuutidega . Tavaliselt kasutatakse seda sihthoidlast selliste väärtuste edastamiseks, mis allikahoidlas pole teada, sageli kustutamise korral (allikas pole enam teada, kuid sihtkohas on endiselt olemas).

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute name to copy]: Selle atribuudi nimi, mis peab sisalduma sihtekspordis. Atribuut peab olema olemas.
• [Target attribute name]: Selle sihtatribuudi nimi, mis peab leiduma DELTA-failis.

Toimingut tuleb teha nii mitu korda, kui vaja.

Järgmise konfiguratsiooni näide:

MULTIEVALEQ

Toiming, mis võrdleb mitut mitmeväärtuselist atribuuti.

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Source attribute name]: võrreldava atribuudi nimi, mis on olemas allikaekspordis.
• [Destination attribute name]: võrreldava atribuudi nimi, mis on olemas sihtekspordis.

Toimingut tuleb teha nii mitu korda, kui vaja. Objektid viiakse paari, kui kõik atribuudid on võrdsed.

Järgmise konfiguratsiooni näide:

MULTSET

Toiming, mis võimaldab teha mitmeväärtuselistest atribuutidest koopiaid, lisades soovi korral eesliite.

Funktsiooni süntaks:

• [Nom_attribut_dest] = väljundina antava atribuudi nimi. Atribuut ei pea eelnevalt olemas olema.
• [Nom_attribut_src] = selle atribuudi nimi, mille väärtused kopeeritakse. Tähelepanu: ärge kasutage võtmesõnu <syncattsrc> või <syncattdst>.
• [prefixe] = string, mis lisatakse atribuudi [Nom_attribut_src] iga väärtuse ette. Eesliide võib olla atribuudi väärtus, kasutades võtmesõna >. Kui te ei soovi eesliidet lisada, määrake oodatava avaldise teises parameetris lihtsalt <uid>.

Kasutusviis:

Toimingut MULTSET saab kasutada sünkroonimisreeglites CONVERT- ja MATCH-toimingute jaoks (OnCreate, OnModify ja OnDelete).

Järgmise konfiguratsiooni näide:

• Kui atribuudi „postal_code“ väärtus on:
  • 68300
  • 68390
  • 38670
• Tulemus: failis sync.xml on atribuudil „Code_postal_prefix“ järgmised väärtused:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Toiming, mis võrdleb kahte mitmeväärtuselist atribuuti.

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: võrreldava atribuudi nimi, mis on olemas sihtekspordis.
• [Attribute Name]: võrreldava atribuudi nimi, mis on olemas allikaekspordis.

Järgmise konfiguratsiooni näide:

RENAME

Toiming, mis nimetab atribuudi ümber.

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: atribuudi uus nimi.
• [Expression]: ümbernimetatava atribuudi nimi.

Järgmise konfiguratsiooni näide:

SET

Toiming, millega saab määrata atribuudile väärtuse (ainult ühe väärtusega atribuudile) olenemata sellest, kas atribuut on olemas või mitte.

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Attribute]: selle atribuudi nimi, millele väärtus määratakse. Kui atribuut on olemas, kirjutatakse algne väärtus üle; kui atribuuti pole olemas, see luuakse.
• [Expression]: sisestatav valem. Võite kasutada võtmesõnu või sisestada fikseeritud väärtusi täielikult või osaliselt (kõvakodeeritud tekst). Teie kasutusjuhul rakendatava süntaksi leiate peatükist „Võtmesõnade loend“.

Järgmise konfiguratsiooni näide:

SIMPLEEQ

Toiming, mis võrdleb mitut ühe väärtusega atribuuti.

Funktsiooni süntaks:

• [Description]: vaba tekst toimingu kirjeldamiseks (valikuline).
• [Source attribute name]: võrreldava atribuudi nimi, mis on olemas allikaekspordis.
• [Destination attribute name]: võrreldava atribuudi nimi, mis on olemas sihtekspordis.

Toimingut tuleb teha nii mitu korda, kui vaja. Objektid viiakse paari, kui kõik atribuudid on võrdsed.

Järgmise konfiguratsiooni näide:

SPLIT

Toiming, millega jagatakse ühe väärtusega atribuudi väärtused eraldaja abil osadeks ja määratakse tulemus mitme väärtusega atribuudile.

Pange tähele, et see toiming on saadaval ainult alates versioonist 6.2.

Funktsiooni süntaks:

• [name_out_attribute_multivalues] = väljundina antava atribuudi nimi.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: Eraldaja peab olema üks märk ega tohi olla „;“, kuna seda märki kasutatakse konnektori konfiguratsioonifailis.
  • [name_attribute_multivalues]: Selle mitmeväärtuselise atribuudi nimi, mille väärtused tuleb konkateneerida.

Võimalikud tulemused:

• Kui eraldaja leitakse vähemalt üks kord: tagastab väärtuste loendi
• Kui eraldajat ei leita: tagastab kogu stringi

Võimalikud tulemused:

Toimingut SPLIT saab kasutada sünkroonimisreeglites ja ainult CONVERT-toimingutes.

Järgmise konfiguratsiooni näide:

• Kui atribuudi „string_rights“ väärtus on:
  • Droit_001#Droit_002#Droit_003
• Tulemus: failis sync.xml on atribuudil „lst_right_multi“ järgmine väärtus:
  • Droit_001
  • Droit_002
  • Droit_003