A szinkronizálási szabályonként elérhető műveletek listája

	Átalakítás	Matching szabályok	Összehasonlítás	Létrehozás	Módosítás	Törlés
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

Az egyes műveletekhez elérhető opciók:

	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

**: A szűrők a műveletet használó szabálytól függően eltérnek.

• B64: Base 64 formátumra alakítja az attribútum értékét.
• CI: Case insensitive: az összehasonlítás a kis- és nagybetűktől függetlenül történik.
• DATE: DATE formátumra alakítja az attribútum értékét.
• DATE_FILETIME: DATETIME formátumra alakítja az attribútum értékét.
• DN: DN-összehasonlítás.
• PARTIAL: részlegesen hasonlítja össze az adatokat. Ha legalább egy érték szerepel az összehasonlítási attribútumban, true értéket ad vissza.
• PWD: bekapcsolja az adatok titkosítását.
• USEMAP: egy map használata az attribútum megkereséséhez; felgyorsítja az összehasonlítási folyamatot.

ADDVALUE

Művelet, amellyel értékek adhatók hozzá egy olyan attribútumhoz, amely definíció szerint többértékű lehet. Több attribútum értékeinek összefűzését is lehetővé teszi.

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: a módosítandó attribútum neve. Ha az attribútum nem létezik, a rendszer automatikusan létrehozza.
• [Expression]: a megadandó képlet. Használhat kulcsszavakat, vagy megadhat teljesen vagy részben rögzített értékeket (fixen kódolt szöveget). Az Ön esetében alkalmazandó szintaxist a „Kulcsszavak listája” fejezetben találja.

Példa a következő konfigurációra:

CHANGE

Művelet, amellyel egy attribútumérték módosítható. Az attribútumnak léteznie kell, és egyértékűnek kell lennie. Az attribútum kezdeti értéke felülíródik, és többé nem használható fel újra.

Figyelem

A CHANGE művelet a 7.1-es verziótól elavult, és a 7.2-es verziótól eltávolításra kerül. A MODVALUE művelettel azonos funkciót lát el: mostantól a MODVALUE műveletet használja egy attribútum értékének módosításához.

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: a módosítandó attribútum neve. Ha az attribútum nem létezik, a művelet nem működik.
• [Expression]: a megadandó képlet. Használhat kulcsszavakat, vagy megadhat teljesen vagy részben rögzített értékeket (fixen kódolt szöveget). Az Ön esetében alkalmazandó szintaxist a „Kulcsszavak listája” fejezetben találja.

Példa a következő konfigurációra:

COMPAREATTNAME

Művelet, amellyel felsorolhatók azok az attribútumok, amelyeket nem kell összehasonlítani, és összehasonlítható minden más attribútum, amelynek a neve mindkét tárházban azonos. A forrástárház azon attribútumneveit, amelyeknek nincs megfelelőjük a céltárházban, a rendszer figyelmen kívül hagyja, és nem hasonlítja össze. Az összehasonlítandó attribútumok egyenkénti leképezése helyett is használható.

Vegye figyelembe, hogy ez a művelet csak a 6.2-es verziótól érhető el, és csak kiépítési állapotot (status) kezelő kiépítési összekötőkben, egy MATCH-műveleten belüli OnCompare-szabályokban használható.

A függvény szintaxisa:

• [Attribute] = a nem összehasonlítandó attribútumok listája. Az attribútumokat vesszővel, szóköz nélkül kell elválasztani.

Példa a következő konfigurációra:

COMPAREWITHEXCLUSIONS

Művelet, amely a két forrás között minden attribútumot összehasonlít anélkül, hogy meg kellene adni a forrástárház vagy a céltárház attribútumainak nevét. Megadhatja azoknak az attribútumoknak a nevét, amelyeket nem kell összehasonlítani; ez azoknak az attribútumoknak a meghatározását jelenti, amelyek kódja eltér a két tárházban.

Vegye figyelembe, hogy ez a művelet csak a 7.1-es verziótól érhető el, és csak a Matching-szabályban és az összehasonlítási szabályokban használható.

A konfigurációs idő megtakarítása érdekében ezt a műveletet akkor ajánlott használni, ha a legtöbb attribútum neve azonos a forrás- és a céltárházban.

A COMPAREATTNAME művelettel ellentétben – amely figyelmen kívül hagyja a céltárházban megfelelővel nem rendelkező attribútumokat, és csak kiépítési állapotot kezelő összekötőkben használható – ez a művelet azokat az attribútumokat is jelzi, amelyek csak a két tárház egyikében találhatók meg.

Az e művelet által azonosított módosítások a következő használati eseteknek felelnek meg:

• egy attribútum a forrástárházban és a céltárházban is létezik, eltérő értékekkel;
• egy attribútum létezik a forrástárházban, de a céltárházban nem;
• egy attribútum létezik a céltárházban, de a forrástárházban nem.

A függvény szintaxisa:

COMPAREWITHEXCLUSIONS:[attribute_1],[attribute_2],…

Az összehasonlításból kizárt attribútumok a kettőspont után, vesszővel elválasztva szerepelnek.

Példa a következő konfigurációra:

COMPAREWITHEXCLUSIONS:whenChanged,objectGUID

A rendszer a két tárház között minden attribútumot összehasonlít, kivéve a whenChanged és az objectGUID attribútumot.

CONTAIN

Művelet, amely összehasonlítással ellenőrzi, hogy a mérvadó forrás attribútumának értékei megtalálhatók-e a célforrás attribútumában. A művelet eredménye a célforrás attribútumértékeinek és a mérvadó forrás attribútumának nem talált értékeinek összefűzése.

Példa

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Eredmény a célforrás attribútumában =

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

Ebben a műveletben nem használhatók kulcsszavak.

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: a célforrásban található attribútum neve, amelyen az összehasonlítást végre kell hajtani.
• [Attribute Name]: a mérvadó forrásban található attribútum neve, amelyen az összehasonlítást végre kell hajtani.

Példa a következő konfigurációra:

CONVERT

COPY

Művelet, amellyel egy attribútum értéke átmásolható egy másik attribútumba. Egyértékű és többértékű attribútumoknál egyaránt működik.

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: a módosítandó attribútum neve. Az attribútumnak léteznie kell.
• [Attribute Name]: annak a forrásattribútumnak a neve, amelynek az értékét a rendszer átmásolja.

Példa a következő konfigurációra:

A „usual_name” attribútum a „birth_name” attribútum értékét veszi fel.

DELETE

Művelet, amellyel törölhető egy attribútum egy megadott forrásban (exportforrás, exportcél vagy DELTA).

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: a törlendő attribútum neve.
• [Expression]: ezt a mezőt ne töltse ki.

DELVALUE

Művelet, amellyel értékek törölhetők egy attribútumból egy logikai kifejezés alapján: ha a kifejezés „True” értéket ad vissza, a rendszer törli az értékeket. Ezért általában többértékű attribútumokra vonatkozik.

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: a módosítandó attribútum neve.
• [Expression]: a megadandó képlet. Használhat kulcsszavakat, vagy megadhat teljesen vagy részben rögzített értékeket (fixen kódolt szöveget). Az Ön esetében alkalmazandó szintaxist a „Kulcsszavak listája” fejezetben találja.

Példa a következő konfigurációra:

Ha a „groups” attribútum tartalmazza a „GRP_ACCES_COMMUN” értéket, a rendszer eltávolítja a „groups” értékeinek listájából, és a „groups” attribútum módosított listáját átmásolja a „memberof@” attribútumba.

DELVALUEBYVALUE

Művelet, amellyel értékek törölhetők egy attribútumból egy megadott lista alapján. Ezért általában többértékű attribútumokra vonatkozik.

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: a módosítandó attribútum neve.
• [Expression]: a megadandó értékek, „;” karakterrel elválasztva. Használhat kulcsszavakat, vagy megadhat teljesen vagy részben rögzített értékeket (fixen kódolt szöveget). Az Ön esetében alkalmazandó szintaxist a „Kulcsszavak listája” fejezetben találja.

Példa a következő konfigurációra:

A rendszer eltávolítja a „memberof@” attribútumban található értékek listájából a „groups_admin” attribútum értékeit és a „GRP_ACCES_COMMUN” értéket.

DSTCOPY

Művelet, amely a célexportban talált attribútum értékét átmásolja a DELTA-fájl egy másik attribútumába. Egyértékű és többértékű attribútumoknál egyaránt működik. Általában arra használják, hogy a céltárházból olyan értékeket vigyenek át, amelyek a forrástárházban ismeretlenek, gyakran törlés esetén (a forrásban nem ismert, de a célban még jelen van).

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: a célattribútum neve.
• [Attribute Name]: annak a forrásattribútumnak a neve, amelynek az értékét a rendszer átmásolja.

Példa a következő konfigurációra:

EQ

Művelet, amely két egyértékű attribútumot hasonlít össze.

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: az összehasonlítandó attribútum neve, amely a forrásexportban található.
• [Expression]: a megadandó képlet. Használhat kulcsszavakat, vagy megadhat teljesen vagy részben rögzített értékeket (fixen kódolt szöveget). Az Ön esetében alkalmazandó szintaxist a „Kulcsszavak listája” fejezetben találja.

Példa a következő konfigurációra:

GETSTRUCTCHILD

Lehetővé teszi a „Parent_structure_attribute_name” attribútumban megadott struktúra gyermekstruktúráinak lekérését a „Destination_attribute_name” attribútumba. Ez a művelet csak az Identity tárház adatain hajtható végre (például egy olyan identitásexporton, amely struktúra típusú attribútummal rendelkezik).

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: annak a célattribútumnak a neve, amely megkapja a gyermekstruktúrák listáját.
• [Expression]: a szülőstruktúra attribútumának neve, kulcsszavak nélkül.

Példa a következő konfigurációra:

A „Site” kódú struktúra összes gyermekstruktúráját adja vissza.

ISCONTAINED

Művelet, amely a mérvadó forrás egy többértékű attribútumát összehasonlítja a célforrás egy többértékű attribútumával, hogy csak a mindkét attribútumban jelen lévő értékek listáját nyerje ki.

Példa:

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3
• Val_4

Source_target_attribute_values =

• Val_3
• Val_4
• Val_5

Eredmény a célforrás attribútumában =

• Val_3
• Val_4

Ebben a műveletben nem használhatók kulcsszavak.

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: a célforrásban található attribútum neve, amelyen az összehasonlítást végre kell hajtani.
• [Attribute Name]: a mérvadó forrásban található attribútum neve, amelyen az összehasonlítást végre kell hajtani.

Példa a következő konfigurációra:

MERGE

Művelet, amellyel egy többértékű attribútum értékeiből összefűzés hozható létre, és hozzárendelhető egy egyértékű attribútumhoz.

Vegye figyelembe, hogy ez a művelet csak a 6.2-es verziótól érhető el.

A függvény szintaxisa:

• [name_out_attribute_monovalue] = a kimenetként szolgáltatandó attribútum neve.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: az elválasztónak egyetlen karakternek kell lennie, és nem lehet „;”, mert ezt a karaktert az összekötő konfigurációs fájlja használja.
  • [name_attribute_multivalues]: annak a többértékű attribútumnak a neve, amelynek az értékeit össze kell fűzni.

Használati mód:

A MERGE művelet szinkronizálási szabályokban, és ott is csak CONVERT műveletekben használható.

Példa a következő konfigurációra:

• Ha a „wiki_mod_1” attribútum értéke:
  • Droit_001
  • Droit_002
  • Droit_003
• Eredmény: a sync.xml fájlban az „lst_right” attribútum értéke a következő lesz:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Művelet, amellyel egy attribútumérték módosítható. Az attribútumnak léteznie kell, és egyértékűnek kell lennie. Az attribútum kezdeti értéke felülíródik, és többé nem használható fel újra.

Megjegyzés

Ez a művelet a CHANGE műveletet váltja fel, amely a 7.1-es verziótól elavult, és a 7.2-es verziótól eltávolításra kerül.

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: a módosítandó attribútum neve. Ha az attribútum nem létezik, a művelet nem működik.
• [Expression]: a megadandó képlet. Használhat kulcsszavakat, vagy megadhat teljesen vagy részben rögzített értékeket (fixen kódolt szöveget). Az Ön esetében alkalmazandó szintaxist a „Kulcsszavak listája” fejezetben találja.

Példa a következő konfigurációra:

MULTCOPY

Attribútumok másolása a forrásból

Művelet, amely attribútumértékeket másol át a forrásexportból a DELTA-fájl attribútumaiba. Egyértékű attribútumoknál működik .

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute name to copy]: annak az attribútumnak a neve, amelynek a forrásexportban kell szerepelnie. Az attribútumnak léteznie kell.
• [Target attribute name]: az attribútumnak léteznie kell. Annak az attribútumnak a neve, amelynek a célexportban kell szerepelnie, és amely a DELTA-fájlban lesz.

A műveletet annyiszor kell végrehajtani, ahányszor szükséges.

Példa a következő konfigurációra:

MULTDSTCOPY

Művelet, amely a célexportban talált attribútumértékeket átmásolja a DELTA-fájl attribútumaiba. Egyértékű attribútumoknál működik . Általában arra használják, hogy a céltárházból olyan értékeket vegyenek át, amelyek a forrástárházban ismeretlenek, gyakran törlés esetén (a forrásban már nem ismert, de a célban még jelen van).

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute name to copy]: annak az attribútumnak a neve, amelynek a célexportban kell szerepelnie. Az attribútumnak léteznie kell.
• [Target attribute name]: annak a célattribútumnak a neve, amelynek a DELTA-fájlban kell szerepelnie.

A műveletet annyiszor kell végrehajtani, ahányszor szükséges.

Példa a következő konfigurációra:

MULTIEVALEQ

Művelet, amely több többértékű attribútumot hasonlít össze.

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Source attribute name]: az összehasonlítandó attribútum neve, amely a forrásexportban található.
• [Destination attribute name]: az összehasonlítandó attribútum neve, amely a célexportban található.

A műveletet annyiszor kell végrehajtani, ahányszor szükséges. Az objektumok párosítása akkor történik meg, ha minden attribútum egyezik.

Példa a következő konfigurációra:

MULTSET

Művelet, amellyel többértékű attribútumok másolhatók, előtag hozzáadásának lehetőségével.

A függvény szintaxisa:

• [Nom_attribut_dest] = a kimenetként szolgáltatandó attribútum neve. Az attribútumnak nem kell előzetesen léteznie.
• [Nom_attribut_src] = annak az attribútumnak a neve, amelynek az értékeit a rendszer átmásolja. Figyelem: ne használja a <syncattsrc> vagy a <syncattdst> kulcsszót.
• [prefixe] = a [Nom_attribut_src] attribútum minden értéke elé fűzendő karakterlánc. Az előtag lehet egy attribútum értéke is a > kulcsszó használatával. Ha nem szeretne előtagot hozzáadni, egyszerűen adja meg a <uid> értéket a várt kifejezés második paraméterében.

Használati mód:

A MULTSET művelet szinkronizálási szabályokban, a CONVERT és a MATCH műveletekhez (OnCreate, OnModify és OnDelete) használható.

Példa a következő konfigurációra:

• Ha a „postal_code” attribútum értéke:
  • 68300
  • 68390
  • 38670
• Eredmény: a sync.xml fájlban a „Code_postal_prefix” attribútum értékei a következők lesznek:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Művelet, amely 2 többértékű attribútumot hasonlít össze.

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: az összehasonlítandó attribútum neve, amely a célexportban található.
• [Attribute Name]: az összehasonlítandó attribútum neve, amely a forrásexportban található.

Példa a következő konfigurációra:

RENAME

Művelet, amely átnevez egy attribútumot.

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: az attribútum új neve.
• [Expression]: az átnevezendő attribútum neve.

Példa a következő konfigurációra:

SET

Művelet, amellyel érték rendelhető egy – kizárólag egyértékű – attribútumhoz, függetlenül attól, hogy az attribútum létezik-e.

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Attribute]: annak az attribútumnak a neve, amelyhez értéket kell rendelni. Ha az attribútum létezik, a kezdeti érték felülíródik; ha az attribútum nem létezik, létrejön.
• [Expression]: a megadandó képlet. Használhat kulcsszavakat, vagy megadhat teljesen vagy részben rögzített értékeket (fixen kódolt szöveget). Az Ön esetében alkalmazandó szintaxist a „Kulcsszavak listája” fejezetben találja.

Példa a következő konfigurációra:

SIMPLEEQ

Művelet, amely több egyértékű attribútumot hasonlít össze.

A függvény szintaxisa:

• [Description]: a művelet leírására szolgáló szabad szöveg (nem kötelező).
• [Source attribute name]: az összehasonlítandó attribútum neve, amely a forrásexportban található.
• [Destination attribute name]: az összehasonlítandó attribútum neve, amely a célexportban található.

A műveletet annyiszor kell végrehajtani, ahányszor szükséges. Az objektumok párosítása akkor történik meg, ha minden attribútum egyezik.

Példa a következő konfigurációra:

SPLIT

Művelet, amellyel egy egyértékű attribútum értékei egy elválasztó karakter mentén szétválaszthatók, majd az eredmény egy többértékű attribútumhoz rendelhető.

Vegye figyelembe, hogy ez a művelet csak a 6.2-es verziótól érhető el.

A függvény szintaxisa:

• [name_out_attribute_multivalues] = A kimenetként szolgáltatandó attribútum neve.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: az elválasztónak egyetlen karakternek kell lennie, és nem lehet „;”, mert ezt a karaktert az összekötő konfigurációs fájlja használja.
  • [name_attribute_multivalues]: annak a többértékű attribútumnak a neve, amelynek az értékeit össze kell fűzni.

Lehetséges eredmények:

• Ha az elválasztó karakter legalább egyszer előfordul: értékek listáját adja vissza
• Ha az elválasztó karakter nem fordul elő: a teljes karakterláncot adja vissza

Lehetséges eredmények:

A SPLIT művelet szinkronizálási szabályokban használható, és csak CONVERT műveletekben.

Példa a következő konfigurációra:

• Ha a „string_rights” attribútum értéke a következő:
  • Droit_001#Droit_002#Droit_003
• Eredmény: a sync.xml fájlban a „lst_right_multi” attribútum értéke a következő lesz:
  • Droit_001
  • Droit_002
  • Droit_003