Gå til innhold

Liste over operasjoner som er tilgjengelige per synkroniseringsregel

Konvertering Matching-
regler 		Sammenligning Oppretting Endring Sletting
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

Alternativer som er tilgjengelige for hver operasjon:

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

**: Filtrene varierer avhengig av regelen som bruker operasjonen.

  • B64: Konverterer attributtverdien til formatet Base 64.
  • CI: Case insensitive: sammenligningen utføres uavhengig av store og små bokstaver.
  • DATE: Konverterer attributtverdien til formatet DATE.
  • DATE_FILETIME: Konverterer attributtverdien til formatet DATETIME.
  • DN: Sammenligning av DN.
  • PARTIAL: sammenligner dataene delvis. Returnerer true hvis minst én verdi finnes i sammenligningsattributtet.
  • PWD: Aktiverer kryptering av dataene.
  • USEMAP: bruk av et map for å finne attributtet, gjør sammenligningsprosessen raskere.

ADDVALUE

Operasjon som gjør det mulig å legge verdier til et attributt som per definisjon kan ha flere verdier. Den gjør det også mulig å kjede sammen verdier fra flere attributter.

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: navnet på attributtet som skal endres. Hvis attributtet ikke finnes, opprettes det automatisk.
  • [Expression]: formelen som skal fylles inn. Du kan bruke nøkkelord eller angi faste verdier helt eller delvis (hardkodet tekst). Se kapittelet ”Liste over nøkkelord” for syntaksen som gjelder for ditt bruksområde.

Eksempel på følgende konfigurasjon:

CHANGE

Operasjon som gjør det mulig å endre en attributtverdi. Attributtet må finnes og ha én enkelt verdi. Den opprinnelige verdien til attributtet overskrives og kan ikke brukes videre.

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: navnet på attributtet som skal endres. Hvis attributtet ikke finnes, fungerer ikke operasjonen.
  • [Expression]: formelen som skal fylles inn. Du kan bruke nøkkelord eller angi faste verdier helt eller delvis (hardkodet tekst). Se kapittelet ”Liste over nøkkelord” for syntaksen som gjelder for ditt bruksområde.

Eksempel på følgende konfigurasjon:

COMPAREATTNAME

Operasjon som gjør det mulig å liste opp attributter som ikke skal sammenlignes, og å sammenligne alle andre attributter som har samme navn i begge repositoryene. Attributtnavn i kilde-repositoryet som ikke har en motpart i mål-repositoryet, ignoreres og sammenlignes ikke. Den kan brukes i stedet for enkeltvis mapping av attributtene som skal sammenlignes.

Merk at denne operasjonen først er tilgjengelig fra versjon 6.2, og at den bare kan brukes i OnCompare-regler i en MATCH-operasjon på provisjoneringskonnektorer med provisjoneringsstatus (status).

Syntaks for funksjonen:

  • [Attribute] = liste over attributter som ikke skal sammenlignes. Attributtene må skilles med komma og uten mellomrom.

Eksempel på følgende konfigurasjon:

CONTAIN

Operasjon som utfører en sammenligning for å kontrollere at verdiene i attributtet til den autoritative kilden finnes i attributtet til målkilden. Resultatet av operasjonen er sammenkjedningen av verdiene i attributtet til målkilden med verdiene i attributtet til den autoritative kilden som ikke ble funnet.

Eksempel

Authoritative_source_attribute_values =

  • Val_1
  • Val_2
  • Val_3

Source_target_attribute_values =

  • Val_4
  • Val_5
  • Val_6

Resultat i attributtet til målkilden =

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

Det kan ikke brukes nøkkelord i denne operasjonen.

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: navnet på attributtet i målkilden som sammenligningen skal utføres på.
  • [Attribute Name]: navnet på attributtet i den autoritative kilden som sammenligningen skal utføres på.

Eksempel på følgende konfigurasjon:

CONVERT

COPY

Operasjon som gjør det mulig å kopiere verdien fra ett attributt til et annet attributt. Den fungerer for attributter med én verdi og attributter med flere verdier.

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: navnet på attributtet som skal endres. Attributtet må finnes.
  • [Attribute Name]: navnet på kildeattributtet som verdien kopieres fra.

Eksempel på følgende konfigurasjon:

Attributtet ”usual_name” får verdien til attributtet ”birth_name”.

DELETE

Operasjon som gjør det mulig å slette et attributt i en angitt kilde (eksportkilde, eksportmål eller DELTA).

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: navnet på attributtet som skal slettes.
  • [Expression]: ikke fyll ut dette feltet.

DELVALUE

Operasjon som gjør det mulig å slette verdier fra et attributt på grunnlag av et boolsk uttrykk: hvis uttrykket returnerer ”True”, slettes verdiene. Den gjelder derfor vanligvis attributter med flere verdier.

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: navnet på attributtet som skal endres.
  • [Expression]: formelen som skal fylles inn. Du kan bruke nøkkelord eller angi faste verdier helt eller delvis (hardkodet tekst). Se kapittelet ”Liste over nøkkelord” for syntaksen som gjelder for ditt bruksområde.

Eksempel på følgende konfigurasjon:

Hvis attributtet ”groups” inneholder verdien ”GRP_ACCES_COMMUN”, fjernes den fra listen over verdier i ”groups”, og den endrede listen i attributtet ”groups” kopieres til attributtet ”memberof@”.

DELVALUEBYVALUE

Operasjon som gjør det mulig å slette verdier fra et attributt på grunnlag av en gitt liste. Den gjelder derfor vanligvis attributter med flere verdier.

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: navnet på attributtet som skal endres.
  • [Expression]: verdier som skal fylles inn, atskilt med ”;”. Du kan bruke nøkkelord eller angi faste verdier helt eller delvis (hardkodet tekst). Se kapittelet ”Liste over nøkkelord” for syntaksen som gjelder for ditt bruksområde.

Eksempel på følgende konfigurasjon:

Verdiene i attributtet ”groups_admin” og verdien ”GRP_ACCES_COMMUN” fjernes fra listen over verdier i ”memberof@”.

DSTCOPY

Operasjon som kopierer verdien til et attributt som finnes i måleksporten, til et annet attributt i DELTA-filen. Den fungerer for attributter med én verdi og attributter med flere verdier. Den brukes vanligvis til å overføre verdier fra mål-repositoryet som er ukjente i kilde-repositoryet, ofte ved sletting (ikke kjent i kilden, men fremdeles til stede i målet).

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: navnet på målattributtet.
  • [Attribute Name]: navnet på kildeattributtet som verdien kopieres fra.

Eksempel på følgende konfigurasjon:

EQ

Operasjon som sammenligner to attributter med én verdi.

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: navnet på attributtet som skal sammenlignes, og som finnes i kildeeksporten.
  • [Expression]: formelen som skal fylles inn. Du kan bruke nøkkelord eller angi faste verdier helt eller delvis (hardkodet tekst). Se kapittelet ”Liste over nøkkelord” for syntaksen som gjelder for ditt bruksområde.

Eksempel på den følgende konfigurasjonen:

GETSTRUCTCHILD

Gjør det mulig å hente listen over underordnede strukturer i attributtet ”Destination_attribute_name” for en gitt struktur i ”Parent_structure_attribute_name”. Denne operasjonen kan bare utføres på data fra Identity-repositoryet (for eksempel på en eksport av identiteter som har et attributt av typen struktur).

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: navnet på målattributtet som skal motta listen over underordnede strukturer.
  • [Expression]: navnet på attributtet til den overordnede strukturen, uten nøkkelord.

Eksempel på følgende konfigurasjon:

Returnerer alle underordnede strukturer av strukturen med koden ”Site”.

ISCONTAINED

Operasjon som sammenligner et attributt med flere verdier i den autoritative kilden med et attributt med flere verdier i målkilden, for bare å hente ut listen over verdier som finnes i begge attributtene.

Eksempel:

Authoritative_source_attribute_values =

  • Val_1
  • Val_2
  • Val_3
  • Val_4

Source_target_attribute_values =

  • Val_3
  • Val_4
  • Val_5

Resultat i attributtet til målkilden =

  • Val_3
  • Val_4

Det kan ikke brukes nøkkelord i denne operasjonen.

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: navnet på attributtet i målkilden som sammenligningen skal utføres på.
  • [Attribute Name]: navnet på attributtet i den autoritative kilden som sammenligningen skal utføres på.

Eksempel på følgende konfigurasjon:

MERGE

Operasjon som gjør det mulig å opprette en sammenkjedning av verdier fra et attributt med flere verdier og tilordne den til et attributt med én verdi.

Merk at denne operasjonen først er tilgjengelig fra versjon 6.2.

Syntaks for funksjonen:

  • [name_out_attribute_monovalue] = navnet på attributtet som skal leveres som utdata.
  • [Expression] = [separator];[name_attribute_multivalues]
    • [separator]: skilletegnet må være et enkelt tegn og kan ikke være ";", siden dette tegnet brukes i konfigurasjonsfilen til konnektoren.
    • [name_attribute_multivalues]: navnet på attributtet med flere verdier som verdiene skal kjedes sammen fra.

Bruksmåte:

Operasjonen MERGE kan brukes i synkroniseringsregler og bare i CONVERT-operasjoner.

Eksempel på følgende konfigurasjon:

  • Med attributtet "wiki_mod_1" lik:
    • Droit_001
    • Droit_002
    • Droit_003
  • Resultat: i filen sync.xml får attributtet "lst_right" følgende verdi:
    • Droit_001#Droit_002#Droit_003

MODVALUE

Operasjon som gjør det mulig å endre en attributtverdi. Attributtet må finnes og ha én enkelt verdi. Den opprinnelige verdien til attributtet overskrives og kan ikke brukes videre.

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: navnet på attributtet som skal endres. Hvis attributtet ikke finnes, fungerer ikke operasjonen.
  • [Expression]: formelen som skal fylles inn. Du kan bruke nøkkelord eller angi faste verdier helt eller delvis (hardkodet tekst). Se kapittelet ”Liste over nøkkelord” for syntaksen som gjelder for ditt bruksområde.

Eksempel på følgende konfigurasjon:

MULTCOPY

Kopiere attributter fra kilden

Operasjon som kopierer attributtverdier fra kildeeksporten til attributter i DELTA-filen. Den fungerer for attributter med én verdi .

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute name to copy]: navnet på attributtet som må finnes i kildeeksporten. Attributtet må finnes.
  • [Target attribute name]: attributtet må finnes. Navnet på attributtet som må finnes i måleksporten, og som vil ligge i DELTA-filen.

Operasjonen må utføres så mange ganger som nødvendig.

Eksempel på følgende konfigurasjon:

MULTDSTCOPY

Operasjon som kopierer attributtverdier som finnes i måleksporten, til attributter i DELTA-filen. Den fungerer for attributter med én verdi . Den brukes vanligvis til å rapportere verdier fra mål-repositoryet som er ukjente i kilde-repositoryet, ofte ved sletting (ikke lenger kjent i kilden, men fremdeles til stede i målet).

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute name to copy]: navnet på attributtet som må finnes i måleksporten. Attributtet må finnes.
  • [Target attribute name]: navnet på målattributtet som må finnes i DELTA-filen.

Operasjonen må utføres så mange ganger som nødvendig.

Eksempel på følgende konfigurasjon:

MULTIEVALEQ

Operasjon som sammenligner flere attributter med flere verdier.

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Source attribute name]: navnet på attributtet som skal sammenlignes, og som finnes i kildeeksporten.
  • [Destination attribute name]: navnet på attributtet som skal sammenlignes, og som finnes i måleksporten.

Operasjonen må utføres så mange ganger som nødvendig. Objekter knyttes sammen hvis alle attributtene er like.

Eksempel på følgende konfigurasjon:

MULTSET

Operasjon som gjør det mulig å lage kopier av attributter med flere verdier, med mulighet for å legge til et prefiks.

Syntaks for funksjonen:

  • [Nom_attribut_dest] = navnet på attributtet som skal leveres som utdata. Attributtet trenger ikke å finnes på forhånd.
  • [Nom_attribut_src] = navnet på attributtet som verdiene kopieres fra. Merk: ikke bruk nøkkelordene <syncattsrc> eller <syncattdst>.
  • [prefixe] = tegnstreng som legges til foran hver verdi i attributtet [Nom_attribut_src]. Prefikset kan være verdien til et attributt ved bruk av nøkkelordet >. Hvis du ikke vil legge til et prefiks, angir du bare <uid> i den andre parameteren i det forventede uttrykket.

Bruksmåte:

Operasjonen MULTSET kan brukes i synkroniseringsregler for operasjonene CONVERT og MATCH (OnCreate, OnModify og OnDelete).

Eksempel på følgende konfigurasjon:

  • Med attributtet "postal_code" lik:
    • 68300
    • 68390
    • 38670
  • Resultat: i filen sync.xml får attributtet "Code_postal_prefix" følgende verdier:
    • CP_68300
    • CP_68390
    • CP_38670

MVEQ

Operasjon som sammenligner 2 attributter med flere verdier.

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: navnet på attributtet som skal sammenlignes, og som finnes i måleksporten.
  • [Attribute Name]: navnet på attributtet som skal sammenlignes, og som finnes i kildeeksporten.

Eksempel på følgende konfigurasjon:

RENAME

Operasjon som gir et attributt nytt navn.

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: det nye navnet på attributtet.
  • [Expression]: navnet på attributtet som skal få nytt navn.

Eksempel på følgende konfigurasjon:

SET

Operasjon som gjør det mulig å tilordne en verdi til et attributt, bare med én verdi, uansett om det finnes eller ikke.

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Attribute]: navnet på attributtet som skal tilordnes en verdi. Hvis attributtet finnes, overskrives den opprinnelige verdien; hvis attributtet ikke finnes, opprettes det.
  • [Expression]: formelen som skal fylles inn. Du kan bruke nøkkelord eller angi faste verdier helt eller delvis (hardkodet tekst). Se kapittelet ”Liste over nøkkelord” for syntaksen som gjelder for ditt bruksområde.

Eksempel på følgende konfigurasjon:

SIMPLEEQ

Operasjon som sammenligner flere attributter med én verdi.

Syntaks for funksjonen:

  • [Description]: fritekst for å beskrive operasjonen (valgfritt).
  • [Source attribute name]: navnet på attributtet som skal sammenlignes, og som finnes i kildeeksporten.
  • [Destination attribute name]: navnet på attributtet som skal sammenlignes, og som finnes i måleksporten.

Operasjonen må utføres så mange ganger som nødvendig. Objekter knyttes sammen hvis alle attributtene er like.

Eksempel på følgende konfigurasjon:

SPLIT

Operasjon som brukes til å dele opp verdiene i et attributt med én verdi ved hjelp av et skilletegn, og deretter tilordne resultatet til et attributt med flere verdier.

Merk at denne operasjonen først er tilgjengelig fra versjon 6.2.

Syntaks for funksjonen:

  • [name_out_attribute_multivalues] = navnet på attributtet som skal leveres som utdata.
  • [Expression] = [separator];[name_attribute_monovalue]
    • [separator]: skilletegnet må være et enkelt tegn og kan ikke være ";", siden dette tegnet brukes i konfigurasjonsfilen til konnektoren.
    • [name_attribute_multivalues]: navnet på attributtet med flere verdier som verdiene skal kjedes sammen fra.

Mulige resultater:

  • Hvis skilletegnet finnes minst én gang: returnerer en liste med verdier
  • Hvis skilletegnet ikke finnes: returnerer hele tegnstrengen

Mulige resultater:

Operasjonen SPLIT kan brukes i synkroniseringsregler og bare i CONVERT-operasjoner.

Eksempel på følgende konfigurasjon:

  • Med attributtet "string_rights" lik:
    • Droit_001#Droit_002#Droit_003
  • Resultat: i filen sync.xml får attributtet ”lst_right_multi” følgende verdi:
    • Droit_001
    • Droit_002
    • Droit_003