Sinhronizācijas kārtulām pieejamo operāciju saraksts

	Konvertēšana	Matching kārtulas	Salīdzināšana	Izveide	Modificēšana	Dzēšana
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

Katrai operācijai pieejamās opcijas:

	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 atšķiras atkarībā no kārtulas, kas izmanto operāciju.

• B64: Pārvērš atribūta vērtību Base 64 formātā.
• CI: Case insensitive: salīdzināšana tiek veikta neatkarīgi no reģistra.
• DATE: Pārvērš atribūta vērtību DATE formātā.
• DATE_FILETIME: Pārvērš atribūta vērtību DATETIME formātā.
• DN: DN salīdzināšana.
• PARTIAL: daļēji salīdzina datus. Atgriež true, ja salīdzināšanas atribūtā ir ietverta vismaz viena vērtība.
• PWD: Iespējo datu šifrēšanu.
• USEMAP: kartējuma izmantošana atribūta atrašanai, paātrina salīdzināšanas procesu.

ADDVALUE

Operācija, kas ļauj pievienot vērtības atribūtam, kas pēc definīcijas var būt vairākvērtību atribūts. Tā ļauj arī savirknēt vairāku atribūtu vērtības.

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: modificējamā atribūta nosaukums. Ja atribūts neeksistē, tas tiks izveidots automātiski.
• [Expression]: ievadāmā formula. Var izmantot atslēgvārdus vai ievadīt fiksētas vērtības pilnībā vai daļēji (iekodētu tekstu). Jūsu lietošanas gadījumā piemērojamo sintaksi skatiet nodaļā „Atslēgvārdu saraksts“.

Šādas konfigurācijas piemērs:

CHANGE

Operācija, kas ļauj modificēt atribūta vērtību. Atribūtam jāeksistē un jābūt vienvērtības atribūtam. Atribūta sākotnējā vērtība tiek pārrakstīta, un to vairs nevar izmantot atkārtoti.

Uzmanību

Operācija CHANGE ir novecojusi, sākot ar versiju 7.1, un tiks noņemta, sākot ar versiju 7.2. Tā dublē operāciju MODVALUE: turpmāk atribūta vērtības modificēšanai izmantojiet MODVALUE.

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: modificējamā atribūta nosaukums. Ja atribūts neeksistē, operācija nedarbosies.
• [Expression]: ievadāmā formula. Var izmantot atslēgvārdus vai ievadīt fiksētas vērtības pilnībā vai daļēji (iekodētu tekstu). Jūsu lietošanas gadījumā piemērojamo sintaksi skatiet nodaļā „Atslēgvārdu saraksts“.

Šādas konfigurācijas piemērs:

COMPAREATTNAME

Operācija, kas ļauj uzskaitīt atribūtus, kurus nevajag salīdzināt, un salīdzināt visus pārējos atribūtus, kuriem abās krātuvēs ir vienāds nosaukums. Avota krātuves atribūtu nosaukumi, kuriem mērķa krātuvē nav atbilsmes, tiks ignorēti un netiks salīdzināti. To var izmantot salīdzināmo atribūtu atsevišķas kartēšanas vietā.

Ņemiet vērā, ka šī operācija ir pieejama tikai sākot ar versiju 6.2 un to var izmantot tikai OnCompare kārtulās MATCH operācijā nodrošināšanas statusa (status) nodrošināšanas savienotājos.

Funkcijas sintakse:

• [Attribute] = to atribūtu saraksts, kurus nesalīdzināt. Atribūti jāatdala ar komatiem, bez atstarpēm.

Šādas konfigurācijas piemērs:

COMPAREWITHEXCLUSIONS

Operācija, kas salīdzina visus atribūtus starp abiem avotiem, nenorādot avota krātuves vai mērķa krātuves atribūtu nosaukumus. Varat norādīt to atribūtu nosaukumus, kurus nesalīdzināt; tas nozīmē definēt atribūtus, kuru kodi abās krātuvēs atšķiras.

Ņemiet vērā, ka šī operācija ir pieejama tikai sākot ar versiju 7.1 un to var izmantot tikai Matching kārtulā un salīdzināšanas kārtulās.

Šo operāciju ieteicams izmantot, ja lielākajai daļai atribūtu avota un mērķa krātuvē ir vienāds nosaukums, lai ietaupītu konfigurēšanas laiku.

Atšķirībā no operācijas COMPAREATTNAME, kas ignorē atribūtus bez atbilsmes mērķa krātuvē un tiek izmantota tikai nodrošināšanas statusa savienotājos, šī operācija ziņo arī par atribūtiem, kas atrodas tikai vienā no abām krātuvēm.

Šīs operācijas konstatētās modifikācijas atbilst šādiem lietošanas gadījumiem:

• atribūts eksistē avota krātuvē un mērķa krātuvē ar atšķirīgām vērtībām;
• atribūts eksistē avota krātuvē, bet ne mērķa krātuvē;
• atribūts eksistē mērķa krātuvē, bet ne avota krātuvē.

Funkcijas sintakse:

COMPAREWITHEXCLUSIONS:[attribute_1],[attribute_2],…

Salīdzināšanā neiekļautie atribūti ir uzskaitīti aiz kola, atdalīti ar komatiem.

Šādas konfigurācijas piemērs:

COMPAREWITHEXCLUSIONS:whenChanged,objectGUID

Starp abām krātuvēm tiek salīdzināti visi atribūti, izņemot whenChanged un objectGUID.

CONTAIN

Operācija, kas veic salīdzināšanu, lai pārbaudītu, vai autoritatīvā avota atribūta vērtības atrodas mērķa avota atribūtā. Operācijas rezultāts būs mērķa avota atribūta vērtību savirknējums ar tām autoritatīvā avota atribūta vērtībām, kas netika atrastas.

Piemērs

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Rezultāts mērķa avota atribūtā =

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

Šajā operācijā nevar izmantot atslēgvārdus.

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: mērķa avotā esošā atribūta nosaukums, kuram jāveic salīdzināšana.
• [Attribute Name]: autoritatīvajā avotā esošā atribūta nosaukums, kuram jāveic salīdzināšana.

Šādas konfigurācijas piemērs:

CONVERT

COPY

Operācija, kas ļauj kopēt viena atribūta vērtību citā atribūtā. Tā darbojas vienvērtības un vairākvērtību atribūtiem.

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: modificējamā atribūta nosaukums. Atribūtam jāeksistē.
• [Attribute Name]: tā avota atribūta nosaukums, kura vērtība tiks kopēta.

Šādas konfigurācijas piemērs:

Atribūts „usual_name“ iegūs atribūta „birth_name“ vērtību.

DELETE

Operācija, kas ļauj dzēst atribūtu norādītā avotā (eksporta avotā, eksporta mērķī vai DELTA).

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: dzēšamā atribūta nosaukums.
• [Expression]: neaizpildiet šo lauku.

DELVALUE

Operācija, kas ļauj dzēst vērtības no atribūta, pamatojoties uz Būla izteiksmi: ja izteiksme atgriež „True“, vērtības tiek dzēstas. Tāpēc to parasti lieto vairākvērtību atribūtiem.

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: modificējamā atribūta nosaukums.
• [Expression]: ievadāmā formula. Var izmantot atslēgvārdus vai ievadīt fiksētas vērtības pilnībā vai daļēji (iekodētu tekstu). Jūsu lietošanas gadījumā piemērojamo sintaksi skatiet nodaļā „Atslēgvārdu saraksts“.

Šādas konfigurācijas piemērs:

Ja atribūtā „groups“ ir vērtība „GRP_ACCES_COMMUN“, tā tiks noņemta no „groups“ vērtību saraksta, un atribūta „groups“ modificētais saraksts tiks kopēts atribūtā „memberof@“.

DELVALUEBYVALUE

Operācija, kas ļauj dzēst vērtības no atribūta, pamatojoties uz doto sarakstu. Tāpēc to parasti lieto vairākvērtību atribūtiem.

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: modificējamā atribūta nosaukums.
• [Expression]: ievadāmās vērtības, atdalītas ar „;“. Var izmantot atslēgvārdus vai ievadīt fiksētas vērtības pilnībā vai daļēji (iekodētu tekstu). Jūsu lietošanas gadījumā piemērojamo sintaksi skatiet nodaļā „Atslēgvārdu saraksts“.

Šādas konfigurācijas piemērs:

Atribūta „groups_admin“ vērtības un vērtība „GRP_ACCES_COMMUN“ tiek noņemtas no „memberof@“ ietverto vērtību saraksta.

DSTCOPY

Operācija, kas kopē mērķa eksportā atrasta atribūta vērtību citā DELTA faila atribūtā. Tā darbojas vienvērtības un vairākvērtību atribūtiem. To parasti izmanto, lai pārnestu no mērķa krātuves vērtības, kas avota krātuvē nav zināmas, bieži vien dzēšanas gadījumā (avotā nav zināmas, bet mērķī joprojām atrodas).

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: mērķa atribūta nosaukums.
• [Attribute Name]: tā avota atribūta nosaukums, kura vērtība tiks kopēta.

Šādas konfigurācijas piemērs:

EQ

Operācija, kas salīdzina divus vienvērtības atribūtus.

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: salīdzināmā atribūta nosaukums, kas atrodas avota eksportā.
• [Expression]: ievadāmā formula. Var izmantot atslēgvārdus vai ievadīt fiksētas vērtības pilnībā vai daļēji (iekodētu tekstu). Jūsu lietošanas gadījumā piemērojamo sintaksi skatiet nodaļā „Atslēgvārdu saraksts“.

Šādas konfigurācijas piemērs:

GETSTRUCTCHILD

Ļauj izgūt pakārtoto struktūru sarakstu atribūtā „Destination_attribute_name“ konkrētai struktūrai, kas norādīta „Parent_structure_attribute_name“. Šo operāciju var veikt tikai ar datiem no Identity krātuves (piemēram, ar identitāšu eksportu, kurā ir struktūras tipa atribūts).

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: mērķa atribūta nosaukums, kurā tiks saņemts pakārtoto struktūru saraksts.
• [Expression]: vecākstruktūras atribūta nosaukums bez atslēgvārdiem.

Šādas konfigurācijas piemērs:

Atgriež visas pakārtotās struktūras struktūrai ar kodu „Site“.

ISCONTAINED

Operācija, kas salīdzina autoritatīvā avota vairākvērtību atribūtu ar mērķa avota vairākvērtību atribūtu, lai izgūtu tikai to vērtību sarakstu, kas atrodas abos atribūtos.

Piemērs:

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3
• Val_4

Source_target_attribute_values =

• Val_3
• Val_4
• Val_5

Rezultāts mērķa avota atribūtā =

• Val_3
• Val_4

Šajā operācijā nevar izmantot atslēgvārdus.

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: mērķa avotā esošā atribūta nosaukums, kuram jāveic salīdzināšana.
• [Attribute Name]: autoritatīvajā avotā esošā atribūta nosaukums, kuram jāveic salīdzināšana.

Šādas konfigurācijas piemērs:

MERGE

Operācija, kas ļauj izveidot vairākvērtību atribūta vērtību savirknējumu un piešķirt to vienvērtības atribūtam.

Ņemiet vērā, ka šī operācija ir pieejama tikai sākot ar versiju 6.2.

Funkcijas sintakse:

• [name_out_attribute_monovalue] = izvadē nododamā atribūta nosaukums.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: Atdalītājam jābūt vienai rakstzīmei, un tas nevar būt „;“, jo šī rakstzīme tiek izmantota savienotāja konfigurācijas failā.
  • [name_attribute_multivalues]: Tā vairākvērtību atribūta nosaukums, kura vērtības jāsavirknē.

Lietošanas veids:

Operāciju MERGE var izmantot sinhronizācijas kārtulās un tikai CONVERT operācijās.

Šādas konfigurācijas piemērs:

• Ja atribūta „wiki_mod_1“ vērtība ir:
  • Droit_001
  • Droit_002
  • Droit_003
• Rezultāts: failā sync.xml atribūtam „lst_right“ būs šāda vērtība:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Operācija, kas ļauj modificēt atribūta vērtību. Atribūtam jāeksistē un jābūt vienvērtības atribūtam. Atribūta sākotnējā vērtība tiek pārrakstīta, un to vairs nevar izmantot atkārtoti.

Piezīme

Šī operācija aizstāj operāciju CHANGE, kas ir novecojusi, sākot ar versiju 7.1, un tiek noņemta, sākot ar versiju 7.2.

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: modificējamā atribūta nosaukums. Ja atribūts neeksistē, operācija nedarbosies.
• [Expression]: ievadāmā formula. Var izmantot atslēgvārdus vai ievadīt fiksētas vērtības pilnībā vai daļēji (iekodētu tekstu). Jūsu lietošanas gadījumā piemērojamo sintaksi skatiet nodaļā „Atslēgvārdu saraksts“.

Šādas konfigurācijas piemērs:

MULTCOPY

Kopēt atribūtus no avota

Operācija, kas kopē atribūtu vērtības no avota eksporta DELTA faila atribūtos. Tā darbojas vienvērtības atribūtiem .

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute name to copy]: Tā atribūta nosaukums, kuram jābūt avota eksportā. Atribūtam jāeksistē.
• [Target attribute name]: Atribūtam jāeksistē. Tā atribūta nosaukums, kuram jābūt iekļautam mērķa eksportā un kurš atradīsies DELTA failā.

Operācija jāveic tik reižu, cik nepieciešams.

Šādas konfigurācijas piemērs:

MULTDSTCOPY

Operācija, kas kopē mērķa eksportā atrastās atribūtu vērtības DELTA faila atribūtos. Tā darbojas vienvērtības atribūtiem . To parasti izmanto, lai pārnestu no mērķa krātuves vērtības, kas avota krātuvē nav zināmas, bieži vien dzēšanas gadījumā (avotā vairs nav zināmas, bet mērķī joprojām atrodas).

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute name to copy]: Tā atribūta nosaukums, kuram jābūt iekļautam mērķa eksportā. Atribūtam jāeksistē.
• [Target attribute name]: Tā mērķa atribūta nosaukums, kuram jāatrodas DELTA failā.

Operācija jāveic tik reižu, cik nepieciešams.

Šādas konfigurācijas piemērs:

MULTIEVALEQ

Operācija, kas salīdzina vairākus vairākvērtību atribūtus.

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Source attribute name]: salīdzināmā atribūta nosaukums, kas atrodas avota eksportā.
• [Destination attribute name]: salīdzināmā atribūta nosaukums, kas atrodas mērķa eksportā.

Operācija jāveic tik reižu, cik nepieciešams. Objekti tiek sasaistīti, ja visi atribūti ir vienādi.

Šādas konfigurācijas piemērs:

MULTSET

Operācija, kas ļauj izveidot vairākvērtību atribūtu kopijas ar iespēju pievienot prefiksu.

Funkcijas sintakse:

• [Nom_attribut_dest] = izvadē nododamā atribūta nosaukums. Atribūtam nav jāeksistē iepriekš.
• [Nom_attribut_src] = Tā atribūta nosaukums, kura vērtības tiks kopētas. Uzmanību: neizmantojiet atslēgvārdus <syncattsrc> vai <syncattdst>.
• [prefixe] = Virkne, kas jāpievieno pirms katras atribūta [Nom_attribut_src] vērtības. Prefikss var būt atribūta vērtība, izmantojot atslēgvārdu >. Ja nevēlaties pievienot prefiksu, gaidītās izteiksmes otrajā parametrā vienkārši norādiet <uid>.

Lietošanas veids:

Operāciju MULTSET var izmantot sinhronizācijas kārtulās CONVERT un MATCH operācijām (OnCreate, OnModify un OnDelete).

Šādas konfigurācijas piemērs:

• Ja atribūta „postal_code“ vērtība ir:
  • 68300
  • 68390
  • 38670
• Rezultāts: failā sync.xml atribūtam „Code_postal_prefix“ būs šādas vērtības:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Operācija, kas salīdzina 2 vairākvērtību atribūtus.

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: salīdzināmā atribūta nosaukums, kas atrodas mērķa eksportā.
• [Attribute Name]: salīdzināmā atribūta nosaukums, kas atrodas avota eksportā.

Šādas konfigurācijas piemērs:

RENAME

Operācija, kas pārdēvē atribūtu.

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: atribūta jaunais nosaukums.
• [Expression]: pārdēvējamā atribūta nosaukums.

Šādas konfigurācijas piemērs:

SET

Operācija, kas ļauj piešķirt vērtību atribūtam (tikai vienvērtības atribūtam) neatkarīgi no tā, vai tas pastāv vai ne.

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Attribute]: tā atribūta nosaukums, kuram jāpiešķir vērtība. Ja atribūts pastāv, sākotnējā vērtība tiks pārrakstīta; ja atribūts nepastāv, tas tiks izveidots.
• [Expression]: ievadāmā formula. Var izmantot atslēgvārdus vai ievadīt fiksētas vērtības pilnībā vai daļēji (iekodētu tekstu). Jūsu lietošanas gadījumā piemērojamo sintaksi skatiet nodaļā „Atslēgvārdu saraksts“.

Šādas konfigurācijas piemērs:

SIMPLEEQ

Operācija, kas salīdzina vairākus vienvērtības atribūtus.

Funkcijas sintakse:

• [Description]: brīvs teksts operācijas aprakstam (nav obligāts).
• [Source attribute name]: salīdzināmā atribūta nosaukums, kas atrodas avota eksportā.
• [Destination attribute name]: salīdzināmā atribūta nosaukums, kas atrodas mērķa eksportā.

Operācija jāveic tik reižu, cik nepieciešams. Objekti tiek sasaistīti, ja visi atribūti ir vienādi.

Šādas konfigurācijas piemērs:

SPLIT

Operācija, ar kuru vienvērtības atribūta vērtības tiek sadalītas, izmantojot atdalītāju, un rezultāts pēc tam tiek piešķirts daudzvērtību atribūtam.

Ņemiet vērā, ka šī operācija ir pieejama tikai sākot ar versiju 6.2.

Funkcijas sintakse:

• [name_out_attribute_multivalues] = Tā atribūta nosaukums, kas jāsniedz kā izvade.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: Atdalītājam jābūt vienai rakstzīmei, un tas nevar būt „;“, jo šī rakstzīme tiek izmantota savienotāja konfigurācijas failā.
  • [name_attribute_multivalues]: Tā vairākvērtību atribūta nosaukums, kura vērtības jāsavirknē.

Iespējamie rezultāti:

• Ja atdalītājs tiek atrasts vismaz vienreiz: atgriež vērtību sarakstu
• Ja atdalītājs netiek atrasts: atgriež visu virkni

Iespējamie rezultāti:

Operāciju SPLIT var izmantot sinhronizācijas kārtulās un tikai operācijās CONVERT.

Šādas konfigurācijas piemērs:

• Ja atribūta „string_rights“ vērtība ir:
  • Droit_001#Droit_002#Droit_003
• Rezultāts: failā sync.xml atribūtam „lst_right_multi“ būs šāda vērtība:
  • Droit_001
  • Droit_002
  • Droit_003