Gå til indholdet

Liste over tilgængelige operationer pr. synkroniseringsregel

Konvertering Matchnings-
regler 		Sammenligning Oprettelse Ændring Sletning
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

Tilgængelige indstillinger for hver operation:

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 er forskellige afhængigt af den regel, der bruger operationen.

  • B64: Konverterer attributværdien til formatet Base 64.
  • CI: Case insensitive: sammenligningen udføres uden hensyn til store og små bogstaver.
  • DATE: Konverterer attributværdien til formatet DATE.
  • DATE_FILETIME: Konverterer attributværdien til formatet DATETIME.
  • DN: Sammenligning af DN.
  • PARTIAL: sammenligner data delvist. Returnerer true, hvis mindst én værdi findes i sammenligningsattributtet.
  • PWD: Muliggør kryptering af data.
  • USEMAP: brug af en map til at finde attributtet, hvilket fremskynder sammenligningsprocessen.

ADDVALUE

Operation, der gør det muligt at tilføje værdier til et attribut, som per definition kan være flerværdi. Den gør det også muligt at sammenkæde værdier fra flere attributter.

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: navn på det attribut, der skal ændres. Hvis attributtet ikke findes, oprettes det automatisk.
  • [Expression]: formel, der skal indtastes. Det er muligt at bruge nøgleord eller indtaste faste værdier helt eller delvist (hårdkodet tekst). Se kapitlet ”Liste over nøgleord” for den syntaks, der skal anvendes i dit tilfælde.

Eksempel på følgende konfiguration:

CHANGE

Operation, der gør det muligt at ændre en attributværdi. Attributtet skal findes og være enkeltværdi. Attributtets oprindelige værdi overskrives og kan ikke længere genbruges.

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: navn på det attribut, der skal ændres. Hvis attributtet ikke findes, virker operationen ikke.
  • [Expression]: formel, der skal indtastes. Det er muligt at bruge nøgleord eller indtaste faste værdier helt eller delvist (hårdkodet tekst). Se kapitlet ”Liste over nøgleord” for den syntaks, der skal anvendes i dit tilfælde.

Eksempel på følgende konfiguration:

COMPAREATTNAME

Operation, der gør det muligt at angive attributter, som ikke skal sammenlignes, og at sammenligne alle øvrige attributter, der har samme navn i begge repositories. Attributnavne i kilde-repository, der ikke har en modpart i mål-repository, ignoreres og sammenlignes ikke. Den kan bruges i stedet for enkeltvis mapping af de attributter, der skal sammenlignes.

Bemærk, at denne operation først er tilgængelig fra version 6.2, og at den kun kan bruges i OnCompare-regler i en MATCH-operation i provisioning-konnektorer med provisioning-status (status).

Syntaks for funktionen:

  • [Attribute] = liste over attributter, der ikke skal sammenlignes. Attributterne skal adskilles med kommaer og uden mellemrum.

Eksempel på følgende konfiguration:

CONTAIN

Operation, der udfører en sammenligning for at kontrollere, at værdierne i attributtet for den autoritative kilde findes i attributtet for målkilden. Resultatet af operationen er sammenkædningen af værdierne i målkildens attribut med de værdier i den autoritative kildes attribut, der ikke blev fundet.

Eksempel

Authoritative_source_attribute_values =

  • Val_1
  • Val_2
  • Val_3

Source_target_attribute_values =

  • Val_4
  • Val_5
  • Val_6

Resultat i målkildens attribut =

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

Der kan ikke bruges nøgleord i denne operation.

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: navn på det attribut i målkilden, som sammenligningen skal udføres på.
  • [Attribute Name]: navn på det attribut i den autoritative kilde, som sammenligningen skal udføres på.

Eksempel på følgende konfiguration:

CONVERT

COPY

Operation, der gør det muligt at kopiere værdien af et attribut til et andet attribut. Den virker for enkeltværdi- og flerværdiattributter.

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: navn på det attribut, der skal ændres. Attributtet skal findes.
  • [Attribute Name]: navn på kildeattributtet, hvis værdi kopieres.

Eksempel på følgende konfiguration:

Attributtet ”usual_name” får værdien af attributtet ”birth_name”.

DELETE

Operation, der gør det muligt at slette et attribut i en angivet kilde (eksportkilde, eksportmål eller DELTA).

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: navn på det attribut, der skal slettes.
  • [Expression]: udfyld ikke dette felt.

DELVALUE

Operation, der gør det muligt at slette værdier fra et attribut på grundlag af et boolesk udtryk: hvis udtrykket returnerer ”True”, slettes værdierne. Den gælder derfor generelt for flerværdiattributter.

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: navn på det attribut, der skal ændres.
  • [Expression]: formel, der skal indtastes. Det er muligt at bruge nøgleord eller indtaste faste værdier helt eller delvist (hårdkodet tekst). Se kapitlet ”Liste over nøgleord” for den syntaks, der skal anvendes i dit tilfælde.

Eksempel på følgende konfiguration:

Hvis attributtet ”groups” indeholder værdien ”GRP_ACCES_COMMUN”, fjernes den fra listen over værdier i ”groups”, og den ændrede liste for attributtet ”groups” kopieres til attributtet ”memberof@”.

DELVALUEBYVALUE

Operation, der gør det muligt at slette værdier fra et attribut på grundlag af en given liste. Den gælder derfor generelt for flerværdiattributter.

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: navn på det attribut, der skal ændres.
  • [Expression]: værdier, der skal indtastes, adskilt af ”;”. Det er muligt at bruge nøgleord eller indtaste faste værdier helt eller delvist (hårdkodet tekst). Se kapitlet ”Liste over nøgleord” for den syntaks, der skal anvendes i dit tilfælde.

Eksempel på følgende konfiguration:

Værdierne i attributtet ”groups_admin” og værdien ”GRP_ACCES_COMMUN” fjernes fra listen over værdier i ”memberof@”.

DSTCOPY

Operation, der kopierer værdien af et attribut fra måleksporten til et andet attribut i DELTA-filen. Den virker for enkeltværdi- og flerværdiattributter. Den bruges generelt til at overføre værdier fra mål-repository, som er ukendte i kilde-repository, ofte i tilfælde af sletning (ikke kendt i kilden, men stadig til stede i målet).

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: navn på målattributtet.
  • [Attribute Name]: navn på kildeattributtet, hvis værdi kopieres.

Eksempel på følgende konfiguration:

EQ

Operation, der sammenligner to enkeltværdiattributter.

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: navn på det attribut, der skal sammenlignes, og som findes i kildeeksporten.
  • [Expression]: formel, der skal indtastes. Det er muligt at bruge nøgleord eller indtaste faste værdier helt eller delvist (hårdkodet tekst). Se kapitlet ”Liste over nøgleord” for den syntaks, der skal anvendes i dit tilfælde.

Eksempel på følgende konfiguration:

GETSTRUCTCHILD

Gør det muligt at hente listen over underordnede strukturer i attributtet ”Destination_attribute_name” for en given struktur i ”Parent_structure_attribute_name”. Denne operation kan kun udføres på data fra Identity-repository (for eksempel på en eksport af identiteter, der har et attribut af typen struktur).

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: navn på målattributtet, der modtager listen over underordnede strukturer.
  • [Expression]: navn på attributtet for den overordnede struktur, uden nøgleord.

Eksempel på følgende konfiguration:

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

ISCONTAINED

Operation, der sammenligner et flerværdiattribut i den autoritative kilde med et flerværdiattribut i målkilden for kun at udtrække listen over de værdier, der findes i begge attributter.

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 målkildens attribut =

  • Val_3
  • Val_4

Der kan ikke bruges nøgleord i denne operation.

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: navn på det attribut i målkilden, som sammenligningen skal udføres på.
  • [Attribute Name]: navn på det attribut i den autoritative kilde, som sammenligningen skal udføres på.

Eksempel på følgende konfiguration:

MERGE

Operation, der gør det muligt at oprette en sammenkædning af værdier fra et flerværdiattribut og tildele den til et enkeltværdiattribut.

Bemærk, at denne operation først er tilgængelig fra version 6.2.

Syntaks for funktionen:

  • [name_out_attribute_monovalue] = navn på det attribut, der skal leveres som output.
  • [Expression] = [separator];[name_attribute_multivalues]
    • [separator]: separatoren skal være et enkelt tegn og må ikke være ”;”, da dette tegn bruges i konnektorens konfigurationsfil.
    • [name_attribute_multivalues]: navn på det flerværdiattribut, hvis værdier skal sammenkædes.

Anvendelsesmåde:

Operationen MERGE kan bruges i synkroniseringsregler og udelukkende i CONVERT-operationer.

Eksempel på følgende konfiguration:

  • Med attributtet ”wiki_mod_1” svarende til:
    • Droit_001
    • Droit_002
    • Droit_003
  • Resultat: i filen sync.xml har attributtet ”lst_right” følgende værdi:
    • Droit_001#Droit_002#Droit_003

MODVALUE

Operation, der gør det muligt at ændre en attributværdi. Attributtet skal findes og være enkeltværdi. Attributtets oprindelige værdi overskrives og kan ikke længere genbruges.

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: navn på det attribut, der skal ændres. Hvis attributtet ikke findes, virker operationen ikke.
  • [Expression]: formel, der skal indtastes. Det er muligt at bruge nøgleord eller indtaste faste værdier helt eller delvist (hårdkodet tekst). Se kapitlet ”Liste over nøgleord” for den syntaks, der skal anvendes i dit tilfælde.

Eksempel på følgende konfiguration:

MULTCOPY

Kopiér attributter fra kilden

Operation, der kopierer attributværdier fra kildeeksporten til attributter i DELTA-filen. Den virker for enkeltværdiattributter .

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute name to copy]: navn på det attribut, der skal findes i kildeeksporten. Attributtet skal findes.
  • [Target attribute name]: attributtet skal findes. Navn på det attribut, der skal være med i måleksporten, og som placeres i DELTA-filen.

Operationen skal udføres så mange gange som nødvendigt.

Eksempel på følgende konfiguration:

MULTDSTCOPY

Operation, der kopierer attributværdier fra måleksporten til attributter i DELTA-filen. Den virker for enkeltværdiattributter . Den bruges generelt til at rapportere værdier fra mål-repository, som er ukendte i kilde-repository, ofte i tilfælde af sletning (ikke længere kendt i kilden, men stadig til stede i målet).

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute name to copy]: navn på det attribut, der skal være med i måleksporten. Attributtet skal findes.
  • [Target attribute name]: navn på målattributtet, som skal findes i DELTA-filen.

Operationen skal udføres så mange gange som nødvendigt.

Eksempel på følgende konfiguration:

MULTIEVALEQ

Operation, der sammenligner flere flerværdiattributter.

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Source attribute name]: navn på det attribut, der skal sammenlignes, og som findes i kildeeksporten.
  • [Destination attribute name]: navn på det attribut, der skal sammenlignes, og som findes i destinationseksporten.

Operationen skal udføres så mange gange som nødvendigt. Objekter sammenkobles, hvis alle attributter er ens.

Eksempel på følgende konfiguration:

MULTSET

Operation, der gør det muligt at lave kopier af flerværdiattributter med mulighed for at tilføje et præfiks.

Syntaks for funktionen:

  • [Nom_attribut_dest] = navn på det attribut, der skal leveres som output. Attributtet behøver ikke findes på forhånd.
  • [Nom_attribut_src] = navn på det attribut, hvis værdier kopieres. Bemærk: brug ikke nøgleordene <syncattsrc> eller <syncattdst>.
  • [prefixe] = streng, der tilføjes før hver værdi af attributtet [Nom_attribut_src]. Præfikset kan være værdien af et attribut ved hjælp af nøgleordet >. Hvis du ikke vil tilføje et præfiks, skal du blot angive <uid> i den anden parameter i det forventede udtryk.

Anvendelsesmåde:

Operationen MULTSET kan bruges i synkroniseringsregler for operationerne CONVERT og MATCH (OnCreate, OnModify og OnDelete).

Eksempel på følgende konfiguration:

  • Med attributtet ”postal_code” svarende til:
    • 68300
    • 68390
    • 38670
  • Resultat: i filen sync.xml har attributtet ”Code_postal_prefix” følgende værdier:
    • CP_68300
    • CP_68390
    • CP_38670

MVEQ

Operation, der sammenligner 2 flerværdiattributter.

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: navn på det attribut, der skal sammenlignes, og som findes i måleksporten.
  • [Attribute Name]: navn på det attribut, der skal sammenlignes, og som findes i kildeeksporten.

Eksempel på følgende konfiguration:

RENAME

Operation, der omdøber et attribut.

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: attributtets nye navn.
  • [Expression]: navn på det attribut, der skal omdøbes.

Eksempel på følgende konfiguration:

SET

Operation, der gør det muligt at tildele en værdi til et attribut – udelukkende enkeltværdi – uanset om det findes eller ikke.

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Attribute]: navn på det attribut, der skal tildeles en værdi. Hvis attributtet findes, overskrives den oprindelige værdi; hvis attributtet ikke findes, oprettes det.
  • [Expression]: formel, der skal indtastes. Det er muligt at bruge nøgleord eller indtaste faste værdier helt eller delvist (hårdkodet tekst). Se kapitlet ”Liste over nøgleord” for den syntaks, der skal anvendes i dit tilfælde.

Eksempel på følgende konfiguration:

SIMPLEEQ

Operation, der sammenligner flere enkeltværdiattributter.

Syntaks for funktionen:

  • [Description]: fri tekst til at beskrive operationen (valgfri).
  • [Source attribute name]: navn på det attribut, der skal sammenlignes, og som findes i kildeeksporten.
  • [Destination attribute name]: navn på det attribut, der skal sammenlignes, og som findes i destinationseksporten.

Operationen skal udføres så mange gange som nødvendigt. Objekter sammenkobles, hvis alle attributter er ens.

Eksempel på følgende konfiguration:

SPLIT

Operation, der bruges til at opdele værdierne i et enkeltværdiattribut ved hjælp af en separator og derefter tildele resultatet til et flerværdiattribut.

Bemærk, at denne operation først er tilgængelig fra version 6.2.

Syntaks for funktionen:

  • [name_out_attribute_multivalues] = navn på det attribut, der skal leveres som output.
  • [Expression] = [separator];[name_attribute_monovalue]
    • [separator]: separatoren skal være et enkelt tegn og må ikke være ”;”, da dette tegn bruges i konnektorens konfigurationsfil.
    • [name_attribute_multivalues]: navn på det flerværdiattribut, hvis værdier skal sammenkædes.

Mulige resultater:

  • Hvis separatoren findes mindst én gang: returnerer en liste af værdier
  • Hvis separatoren ikke findes: returnerer den fulde streng

Mulige resultater:

Operationen SPLIT kan bruges i synkroniseringsregler og udelukkende i CONVERT-operationer.

Eksempel på følgende konfiguration:

  • Med attributtet ”string_rights” svarende til:
    • Droit_001#Droit_002#Droit_003
  • Resultat: i filen sync.xml har attributtet ”lst_right_multi” følgende værdi:
    • Droit_001
    • Droit_002
    • Droit_003