Luettelo eri synkronointisäännöissä käytettävissä olevista toiminnoista

	Muunnos	Vastaavuus- säännöt	Vertailu	Luonti	Muokkaus	Poisto
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

Kullekin toiminnolle käytettävissä olevat vaihtoehdot:

	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

**: Suodattimet vaihtelevat sen säännön mukaan, joka käyttää toimintoa.

• B64: Muuntaa attribuutin arvon Base 64 -muotoon.
• CI: Case insensitive: vertailu tehdään kirjainkoosta riippumatta.
• DATE: Muuntaa attribuutin arvon DATE-muotoon.
• DATE_FILETIME: Muuntaa attribuutin arvon DATETIME-muotoon.
• DN: DN-vertailu.
• PARTIAL: vertaa tietoja osittain. Palauttaa arvon true, jos vähintään yksi arvo sisältyy vertailuattribuuttiin.
• PWD: Ottaa käyttöön tietojen salauksen.
• USEMAP: mapin käyttö attribuutin löytämiseen, nopeuttaa vertailuprosessia.

ADDVALUE

Toiminto, jolla voi lisätä arvoja attribuuttiin, joka voi määritelmän mukaan olla moniarvoinen. Se mahdollistaa myös useiden attribuuttien arvojen ketjutuksen.

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: muutettavan attribuutin nimi. Jos attribuuttia ei ole, se luodaan automaattisesti.
• [Expression]: syötettävä kaava. Voit käyttää avainsanoja tai syöttää kiinteitä arvoja kokonaan tai osittain (kovakoodattu teksti). Katso käyttötapaukseesi sovellettava syntaksi luvusta ”Avainsanojen luettelo”.

Esimerkki seuraavasta määrityksestä:

CHANGE

Toiminto, jolla voi muuttaa attribuutin arvoa. Attribuutin on oltava olemassa ja yksiarvoinen. Attribuutin alkuperäinen arvo korvataan, eikä sitä voi enää käyttää uudelleen.

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: muutettavan attribuutin nimi. Jos attribuuttia ei ole, toiminto ei toimi.
• [Expression]: syötettävä kaava. Voit käyttää avainsanoja tai syöttää kiinteitä arvoja kokonaan tai osittain (kovakoodattu teksti). Katso käyttötapaukseesi sovellettava syntaksi luvusta ”Avainsanojen luettelo”.

Esimerkki seuraavasta määrityksestä:

COMPAREATTNAME

Toiminto, jolla voi luetteloida attribuutit, joita ei pidä verrata, ja verrata kaikkia muita attribuutteja, joilla on sama nimi molemmissa repositoryissa. Lähderepositoryn attribuuttien nimet, joilla ei ole vastinetta kohderepositoryssa, ohitetaan eikä niitä verrata. Sillä voi korvata verrattavien attribuuttien yksittäisen mappauksen.

Huomaa, että tämä toiminto on käytettävissä vain versiosta 6.2 alkaen ja sitä voi käyttää vain OnCompare-säännöissä MATCH-toiminnon sisällä provisioning-tilan (status) provisioning-liittimissä.

Funktion syntaksi:

• [Attribute] = luettelo attribuuteista, joita ei pidä verrata. Attribuutit on erotettava pilkuilla ja ilman välilyöntejä.

Esimerkki seuraavasta määrityksestä:

CONTAIN

Toiminto, joka tekee vertailun varmistaakseen, että auktoritatiivisen lähteen attribuutin arvot ovat kohdelähteen attribuutissa. Toiminnon tuloksena on kohdelähteen attribuutin arvojen ja niiden auktoritatiivisen lähteen attribuutin arvojen ketjutus, joita ei löytynyt.

Esimerkki

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Tulos kohdelähteen attribuutissa =

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

Tässä toiminnossa ei voi käyttää avainsanoja.

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: kohdelähteessä olevan attribuutin nimi, jolle vertailu tehdään.
• [Attribute Name]: auktoritatiivisessa lähteessä olevan attribuutin nimi, jolle vertailu tehdään.

Esimerkki seuraavasta määrityksestä:

CONVERT

COPY

Toiminto, jolla voi kopioida yhden attribuutin arvon toiseen attribuuttiin. Se toimii yksiarvoisille ja moniarvoisille attribuuteille.

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: muutettavan attribuutin nimi. Attribuutin on oltava olemassa.
• [Attribute Name]: lähdeattribuutin nimi, jonka arvo kopioidaan.

Esimerkki seuraavasta määrityksestä:

Attribuutti ”usual_name” saa attribuutin ”birth_name” arvon.

DELETE

Toiminto, jolla voi poistaa attribuutin määritetystä lähteestä (viennin lähde, viennin kohde tai DELTA).

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: poistettavan attribuutin nimi.
• [Expression]: älä täytä tätä kenttää.

DELVALUE

Toiminto, jolla voi poistaa attribuutista arvoja totuusarvolausekkeen perusteella: jos lauseke palauttaa arvon ”True”, arvot poistetaan. Se koskee siksi yleensä moniarvoisia attribuutteja.

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: muutettavan attribuutin nimi.
• [Expression]: syötettävä kaava. Voit käyttää avainsanoja tai syöttää kiinteitä arvoja kokonaan tai osittain (kovakoodattu teksti). Katso käyttötapaukseesi sovellettava syntaksi luvusta ”Avainsanojen luettelo”.

Esimerkki seuraavasta määrityksestä:

Jos attribuutti ”groups” sisältää arvon ”GRP_ACCES_COMMUN”, se poistetaan attribuutin ”groups” arvojen luettelosta, ja attribuutin ”groups” muutettu luettelo kopioidaan attribuuttiin ”memberof@”.

DELVALUEBYVALUE

Toiminto, jolla voi poistaa attribuutista arvoja annetun luettelon perusteella. Se koskee siksi yleensä moniarvoisia attribuutteja.

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: muutettavan attribuutin nimi.
• [Expression]: syötettävät arvot, erotettuina merkillä ”;”. Voit käyttää avainsanoja tai syöttää kiinteitä arvoja kokonaan tai osittain (kovakoodattu teksti). Katso käyttötapaukseesi sovellettava syntaksi luvusta ”Avainsanojen luettelo”.

Esimerkki seuraavasta määrityksestä:

Attribuutin ”groups_admin” arvot ja arvo ”GRP_ACCES_COMMUN” poistetaan attribuutissa ”memberof@” olevien arvojen luettelosta.

DSTCOPY

Toiminto, joka kopioi kohdeviennistä löytyvän attribuutin arvon toiseen attribuuttiin DELTA-tiedostossa. Se toimii yksiarvoisille ja moniarvoisille attribuuteille. Sitä käytetään yleensä siirtämään kohderepositorysta arvoja, jotka ovat lähderepositoryssa tuntemattomia, usein poiston tapauksessa (ei tiedossa lähteessä, mutta yhä olemassa kohteessa).

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: kohdeattribuutin nimi.
• [Attribute Name]: lähdeattribuutin nimi, jonka arvo kopioidaan.

Esimerkki seuraavasta määrityksestä:

EQ

Toiminto, joka vertaa kahta yksiarvoista attribuuttia.

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: verrattavan attribuutin nimi, joka on lähdeviennissä.
• [Expression]: syötettävä kaava. Voit käyttää avainsanoja tai syöttää kiinteitä arvoja kokonaan tai osittain (kovakoodattu teksti). Katso käyttötapaukseesi sovellettava syntaksi luvusta ”Avainsanojen luettelo”.

Esimerkki seuraavasta määrityksestä:

GETSTRUCTCHILD

Mahdollistaa alirakenteiden luettelon hakemisen attribuuttiin ”Destination_attribute_name” annetusta rakenteesta attribuutissa ”Parent_structure_attribute_name”. Tämä toiminto voidaan tehdä vain Identity-repositoryn tiedoille (esimerkiksi identiteettien viennille, jossa on rakennetyypin attribuutti).

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: kohdeattribuutin nimi, joka vastaanottaa alirakenteiden luettelon.
• [Expression]: ylemmän rakenteen attribuutin nimi ilman avainsanoja.

Esimerkki seuraavasta määrityksestä:

Palauttaa kaikki rakenteen, jonka koodi on ”Site”, alirakenteet.

ISCONTAINED

Toiminto, joka vertaa auktoritatiivisen lähteen moniarvoista attribuuttia kohdelähteen moniarvoiseen attribuuttiin poimien vain niiden arvojen luettelon, jotka ovat molemmissa attribuuteissa.

Esimerkki:

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3
• Val_4

Source_target_attribute_values =

• Val_3
• Val_4
• Val_5

Tulos kohdelähteen attribuutissa =

• Val_3
• Val_4

Tässä toiminnossa ei voi käyttää avainsanoja.

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: kohdelähteessä olevan attribuutin nimi, jolle vertailu tehdään.
• [Attribute Name]: auktoritatiivisessa lähteessä olevan attribuutin nimi, jolle vertailu tehdään.

Esimerkki seuraavasta määrityksestä:

MERGE

Toiminto, jolla voi luoda moniarvoisen attribuutin arvojen ketjutuksen ja määrittää sen yksiarvoiseen attribuuttiin.

Huomaa, että tämä toiminto on käytettävissä vain versiosta 6.2 alkaen.

Funktion syntaksi:

• [name_out_attribute_monovalue] = tulosteena annettavan attribuutin nimi.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: erottimen on oltava yksi merkki, eikä se voi olla ";", koska tätä merkkiä käytetään liittimen määritystiedostossa.
  • [name_attribute_multivalues]: moniarvoisen attribuutin nimi, jonka arvot on ketjutettava.

Käyttötapa:

MERGE-toimintoa voi käyttää synkronointisäännöissä ja vain CONVERT-toiminnoissa.

Esimerkki seuraavasta määrityksestä:

• Kun attribuutin "wiki_mod_1" arvo on:
  • Droit_001
  • Droit_002
  • Droit_003
• Tulos: tiedostossa sync.xml attribuutilla "lst_right" on seuraava arvo:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Toiminto, jolla voi muuttaa attribuutin arvoa. Attribuutin on oltava olemassa ja yksiarvoinen. Attribuutin alkuperäinen arvo korvataan, eikä sitä voi enää käyttää uudelleen.

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: muutettavan attribuutin nimi. Jos attribuuttia ei ole, toiminto ei toimi.
• [Expression]: syötettävä kaava. Voit käyttää avainsanoja tai syöttää kiinteitä arvoja kokonaan tai osittain (kovakoodattu teksti). Katso käyttötapaukseesi sovellettava syntaksi luvusta ”Avainsanojen luettelo”.

Esimerkki seuraavasta määrityksestä:

MULTCOPY

Kopioi attribuutit lähteestä

Toiminto, joka kopioi attribuuttien arvot lähdeviennistä DELTA-tiedoston attribuutteihin. Se toimii yksiarvoisille attribuuteille .

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute name to copy]: sen attribuutin nimi, joka on oltava lähdeviennissä. Attribuutin on oltava olemassa.
• [Target attribute name]: attribuutin on oltava olemassa. Sen attribuutin nimi, joka on oltava kohdeviennissä ja joka sijaitsee DELTA-tiedostossa.

Toiminto on tehtävä niin monta kertaa kuin on tarpeen.

Esimerkki seuraavasta määrityksestä:

MULTDSTCOPY

Toiminto, joka kopioi kohdeviennistä löytyvät attribuuttien arvot DELTA-tiedoston attribuutteihin. Se toimii yksiarvoisille attribuuteille . Sitä käytetään yleensä ilmoittamaan kohderepositorysta arvoja, jotka ovat lähderepositoryssa tuntemattomia, usein poiston tapauksessa (ei enää tiedossa lähteessä, mutta yhä olemassa kohteessa).

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute name to copy]: sen attribuutin nimi, joka on oltava kohdeviennissä. Attribuutin on oltava olemassa.
• [Target attribute name]: kohdeattribuutin nimi, joka on löydyttävä DELTA-tiedostosta.

Toiminto on tehtävä niin monta kertaa kuin on tarpeen.

Esimerkki seuraavasta määrityksestä:

MULTIEVALEQ

Toiminto, joka vertaa useita moniarvoisia attribuutteja.

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Source attribute name]: verrattavan attribuutin nimi, joka on lähdeviennissä.
• [Destination attribute name]: verrattavan attribuutin nimi, joka on kohdeviennissä.

Toiminto on tehtävä niin monta kertaa kuin on tarpeen. Objektit liitetään pariksi, jos kaikki attribuutit ovat yhtä suuret.

Esimerkki seuraavasta määrityksestä:

MULTSET

Toiminto, jolla voi tehdä kopioita moniarvoisista attribuuteista ja lisätä halutessaan etuliitteen.

Funktion syntaksi:

• [Nom_attribut_dest] = tulosteena annettavan attribuutin nimi. Attribuutin ei tarvitse olla olemassa ennalta.
• [Nom_attribut_src] = sen attribuutin nimi, jonka arvot kopioidaan. Huomio: älä käytä avainsanoja <syncattsrc> tai <syncattdst>.
• [prefixe] = merkkijono, joka lisätään attribuutin [Nom_attribut_src] jokaisen arvon eteen. Etuliite voi olla attribuutin arvo avainsanalla >. Jos et halua lisätä etuliitettä, anna odotetun lausekkeen toisessa parametrissa vain <uid>.

Käyttötapa:

MULTSET-toimintoa voi käyttää synkronointisäännöissä CONVERT- ja MATCH-toiminnoille (OnCreate, OnModify ja OnDelete).

Esimerkki seuraavasta määrityksestä:

• Kun attribuutin "postal_code" arvo on:
  • 68300
  • 68390
  • 38670
• Tulos: tiedostossa sync.xml attribuutilla "Code_postal_prefix" on seuraavat arvot:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Toiminto, joka vertaa kahta moniarvoista attribuuttia.

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: verrattavan attribuutin nimi, joka on kohdeviennissä.
• [Attribute Name]: verrattavan attribuutin nimi, joka on lähdeviennissä.

Esimerkki seuraavasta määrityksestä:

RENAME

Toiminto, joka nimeää attribuutin uudelleen.

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: attribuutin uusi nimi.
• [Expression]: uudelleennimettävän attribuutin nimi.

Esimerkki seuraavasta määrityksestä:

SET

Toiminto, jolla voi määrittää arvon attribuutille – vain yksiarvoiselle – riippumatta siitä, onko attribuutti olemassa vai ei.

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Attribute]: sen attribuutin nimi, jolle arvo määritetään. Jos attribuutti on olemassa, sen alkuperäinen arvo korvataan; jos attribuuttia ei ole, se luodaan.
• [Expression]: syötettävä kaava. Voit käyttää avainsanoja tai syöttää kiinteitä arvoja kokonaan tai osittain (kovakoodattu teksti). Katso käyttötapaukseesi sovellettava syntaksi luvusta ”Avainsanojen luettelo”.

Esimerkki seuraavasta määrityksestä:

SIMPLEEQ

Toiminto, joka vertaa useita yksiarvoisia attribuutteja.

Funktion syntaksi:

• [Description]: vapaa teksti toiminnon kuvaamiseen (valinnainen).
• [Source attribute name]: verrattavan attribuutin nimi, joka on lähdeviennissä.
• [Destination attribute name]: verrattavan attribuutin nimi, joka on kohdeviennissä.

Toiminto on tehtävä niin monta kertaa kuin on tarpeen. Objektit liitetään pariksi, jos kaikki attribuutit ovat yhtä suuret.

Esimerkki seuraavasta määrityksestä:

SPLIT

Toiminto, jolla jaetaan yksiarvoisen attribuutin arvot erottimen avulla ja määritetään tulos moniarvoiseen attribuuttiin.

Huomaa, että tämä toiminto on käytettävissä vain versiosta 6.2 alkaen.

Funktion syntaksi:

• [name_out_attribute_multivalues] = tulosteena annettavan attribuutin nimi.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: erottimen on oltava yksi merkki, eikä se voi olla ";", koska tätä merkkiä käytetään liittimen määritystiedostossa.
  • [name_attribute_multivalues]: moniarvoisen attribuutin nimi, jonka arvot on ketjutettava.

Mahdolliset tulokset:

• Jos erotin löytyy vähintään kerran: palauttaa arvojen luettelon
• Jos erotinta ei löydy: palauttaa koko merkkijonon

Mahdolliset tulokset:

SPLIT-toimintoa voi käyttää synkronointisäännöissä ja vain CONVERT-toiminnoissa.

Esimerkki seuraavasta määrityksestä:

• Kun attribuutin "string_rights" arvo on:
  • Droit_001#Droit_002#Droit_003
• Tulos: tiedostossa sync.xml attribuutilla ”lst_right_multi” on seuraava arvo:
  • Droit_001
  • Droit_002
  • Droit_003