Lista över åtgärder som är tillgängliga per synkroniseringsregel

	Konvertering	Matchnings- regler	Jämförelse	Skapande	Ändring	Borttagning
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

Alternativ som är tillgängliga för varje åtgärd:

	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

**: Filtren skiljer sig beroende på vilken regel som använder åtgärden.

• B64: konverterar attributvärdet till formatet Base 64.
• CI: Case insensitive: jämförelsen görs oavsett skiftläge.
• DATE: konverterar attributvärdet till formatet DATE.
• DATE_FILETIME: konverterar attributvärdet till formatet DATETIME.
• DN: jämförelse av DN.
• PARTIAL: jämför data delvis. Returnerar true om minst ett värde finns i jämförelseattributet.
• PWD: möjliggör kryptering av data.
• USEMAP: användning av en map för att hitta attributet, snabbar upp jämförelseprocessen.

ADDVALUE

Åtgärd som gör det möjligt att lägga till värden i ett attribut som per definition kan vara flervärt. Den gör det också möjligt att sammanfoga värden från flera attribut.

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: namnet på det attribut som ska ändras. Om attributet inte finns skapas det automatiskt.
• [Expression]: formeln som ska anges. Du kan använda nyckelord eller ange fasta värden helt eller delvis (hårdkodad text). Se kapitlet ”Lista över nyckelord” för den syntax som gäller för ditt användningsfall.

Exempel på följande konfiguration:

CHANGE

Åtgärd som gör det möjligt att ändra ett attributvärde. Attributet måste finnas och vara envärt. Attributets ursprungliga värde skrivs över och kan inte längre återanvändas.

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: namnet på det attribut som ska ändras. Om attributet inte finns fungerar inte åtgärden.
• [Expression]: formeln som ska anges. Du kan använda nyckelord eller ange fasta värden helt eller delvis (hårdkodad text). Se kapitlet ”Lista över nyckelord” för den syntax som gäller för ditt användningsfall.

Exempel på följande konfiguration:

COMPAREATTNAME

Åtgärd som gör det möjligt att lista de attribut som inte ska jämföras och att jämföra alla andra attribut som har samma namn i båda repositoryna. Attributnamn i käll-repositoryt som inte har någon motsvarighet i mål-repositoryt ignoreras och jämförs inte. Åtgärden kan användas för att ersätta den styckvisa mappningen av de attribut som ska jämföras.

Observera att den här åtgärden bara är tillgänglig från version 6.2 och bara kan användas i OnCompare-regler i en MATCH-åtgärd i provisioneringskonnektorer med provisioneringsstatus (status).

Funktionens syntax:

• [Attribute] = lista över de attribut som inte ska jämföras. Attributen måste separeras med komma och utan blanksteg.

Exempel på följande konfiguration:

CONTAIN

Åtgärd som utför en jämförelse för att kontrollera att värdena i den auktoritativa källans attribut finns i målkällans attribut. Resultatet av åtgärden är en sammanfogning av värdena i målkällans attribut med de värden i den auktoritativa källans attribut som inte hittades.

Exempel

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Resultat i målkällans attribut =

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

Inga nyckelord kan användas i den här åtgärden.

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: namnet på det attribut i målkällan som jämförelsen ska utföras på.
• [Attribute Name]: namnet på det attribut i den auktoritativa källan som jämförelsen ska utföras på.

Exempel på följande konfiguration:

CONVERT

COPY

Åtgärd som gör det möjligt att kopiera värdet på ett attribut till ett annat attribut. Den fungerar för envärda och flervärda attribut.

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: namnet på det attribut som ska ändras. Attributet måste finnas.
• [Attribute Name]: namnet på det källattribut vars värde ska kopieras.

Exempel på följande konfiguration:

Attributet ”usual_name” får värdet på attributet ”birth_name”.

DELETE

Åtgärd som gör det möjligt att ta bort ett attribut i en angiven källa (exportkälla, exportmål eller DELTA).

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: namnet på det attribut som ska tas bort.
• [Expression]: fyll inte i det här fältet.

DELVALUE

Åtgärd som gör det möjligt att ta bort värden från ett attribut utifrån ett booleskt uttryck: om uttrycket returnerar ”True” tas värdena bort. Den gäller därför i allmänhet flervärda attribut.

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: namnet på det attribut som ska ändras.
• [Expression]: formeln som ska anges. Du kan använda nyckelord eller ange fasta värden helt eller delvis (hårdkodad text). Se kapitlet ”Lista över nyckelord” för den syntax som gäller för ditt användningsfall.

Exempel på följande konfiguration:

Om attributet ”groups” innehåller värdet ”GRP_ACCES_COMMUN” tas det bort från listan över värden i ”groups”, och den ändrade listan för attributet ”groups” kopieras till attributet ”memberof@”.

DELVALUEBYVALUE

Åtgärd som gör det möjligt att ta bort värden från ett attribut utifrån en given lista. Den gäller därför i allmänhet flervärda attribut.

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: namnet på det attribut som ska ändras.
• [Expression]: värdena som ska anges, separerade med ”;”. Du kan använda nyckelord eller ange fasta värden helt eller delvis (hårdkodad text). Se kapitlet ”Lista över nyckelord” för den syntax som gäller för ditt användningsfall.

Exempel på följande konfiguration:

Värdena i attributet ”groups_admin” och värdet ”GRP_ACCES_COMMUN” tas bort från listan över värden i ”memberof@”.

DSTCOPY

Åtgärd som kopierar värdet på ett attribut i målexporten till ett annat attribut i DELTA-filen. Den fungerar för envärda och flervärda attribut. Den används i allmänhet för att överföra värden från mål-repositoryt som är okända i käll-repositoryt, ofta vid borttagning (inte känt i källan men fortfarande närvarande i målet).

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: namnet på målattributet.
• [Attribute Name]: namnet på det källattribut vars värde ska kopieras.

Exempel på följande konfiguration:

EQ

Åtgärd som jämför två envärda attribut.

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: namnet på det attribut som ska jämföras, som finns i källexporten.
• [Expression]: formeln som ska anges. Du kan använda nyckelord eller ange fasta värden helt eller delvis (hårdkodad text). Se kapitlet ”Lista över nyckelord” för den syntax som gäller för ditt användningsfall.

Exempel på följande konfiguration:

GETSTRUCTCHILD

Gör det möjligt att hämta listan över underordnade strukturer i attributet ”Destination_attribute_name” för en given struktur i ”Parent_structure_attribute_name”. Den här åtgärden kan bara utföras på data från Identity-repositoryt (till exempel på en export av identiteter som har ett attribut av typen struktur).

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: namnet på det målattribut som ska ta emot listan över underordnade strukturer.
• [Expression]: namnet på den överordnade strukturens attribut, utan nyckelord.

Exempel på följande konfiguration:

Returnerar alla underordnade strukturer för strukturen med koden ”Site”.

ISCONTAINED

Åtgärd som jämför ett flervärt attribut i den auktoritativa källan med ett flervärt attribut i målkällan för att bara extrahera listan över de värden som finns i båda attributen.

Exempel:

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ålkällans attribut =

• Val_3
• Val_4

Inga nyckelord kan användas i den här åtgärden.

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: namnet på det attribut i målkällan som jämförelsen ska utföras på.
• [Attribute Name]: namnet på det attribut i den auktoritativa källan som jämförelsen ska utföras på.

Exempel på följande konfiguration:

MERGE

Åtgärd som gör det möjligt att skapa en sammanfogning av värden från ett flervärt attribut och tilldela den till ett envärt attribut.

Observera att den här åtgärden bara är tillgänglig från version 6.2.

Funktionens syntax:

• [name_out_attribute_monovalue] = namnet på det attribut som ska tillhandahållas som utdata.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: avgränsaren måste vara ett enda tecken och kan inte vara ”;”, eftersom det tecknet används i konnektorns konfigurationsfil.
  • [name_attribute_multivalues]: namnet på det flervärda attribut vars värden ska sammanfogas.

Användningssätt:

Åtgärden MERGE kan användas i synkroniseringsregler och bara i CONVERT-åtgärder.

Exempel på följande konfiguration:

• Med attributet ”wiki_mod_1” lika med:
  • Droit_001
  • Droit_002
  • Droit_003
• Resultat: i filen sync.xml har attributet ”lst_right” följande värde:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Åtgärd som gör det möjligt att ändra ett attributvärde. Attributet måste finnas och vara envärt. Attributets ursprungliga värde skrivs över och kan inte längre återanvändas.

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: namnet på det attribut som ska ändras. Om attributet inte finns fungerar inte åtgärden.
• [Expression]: formeln som ska anges. Du kan använda nyckelord eller ange fasta värden helt eller delvis (hårdkodad text). Se kapitlet ”Lista över nyckelord” för den syntax som gäller för ditt användningsfall.

Exempel på följande konfiguration:

MULTCOPY

Kopiera attribut från källan

Åtgärd som kopierar attributvärden från källexporten till attribut i DELTA-filen. Den fungerar för envärda attribut .

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute name to copy]: namnet på det attribut som måste finnas i källexporten. Attributet måste finnas.
• [Target attribute name]: attributet måste finnas. Namnet på det attribut som måste finnas i målexporten, och som kommer att ligga i DELTA-filen.

Åtgärden måste utföras så många gånger som behövs.

Exempel på följande konfiguration:

MULTDSTCOPY

Åtgärd som kopierar attributvärden som hittas i målexporten till attribut i DELTA-filen. Den fungerar för envärda attribut . Den används i allmänhet för att rapportera värden från mål-repositoryt som är okända i käll-repositoryt, ofta vid borttagning (inte längre känt i källan men fortfarande närvarande i målet).

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute name to copy]: namnet på det attribut som måste finnas i målexporten. Attributet måste finnas.
• [Target attribute name]: namnet på det målattribut som måste finnas i DELTA-filen.

Åtgärden måste utföras så många gånger som behövs.

Exempel på följande konfiguration:

MULTIEVALEQ

Åtgärd som jämför flera flervärda attribut.

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Source attribute name]: namnet på det attribut som ska jämföras, som finns i källexporten.
• [Destination attribute name]: namnet på det attribut som ska jämföras, som finns i målexporten.

Åtgärden måste utföras så många gånger som behövs. Objekt paras samman om alla attribut är lika.

Exempel på följande konfiguration:

MULTSET

Åtgärd som gör det möjligt att skapa kopior av flervärda attribut med möjlighet att lägga till ett prefix.

Funktionens syntax:

• [Nom_attribut_dest] = namnet på det attribut som ska tillhandahållas som utdata. Attributet behöver inte finnas i förväg.
• [Nom_attribut_src] = namnet på det attribut vars värden ska kopieras. Observera: använd inte nyckelorden <syncattsrc> eller <syncattdst>.
• [prefixe] = teckensträng som läggs till före varje värde i attributet [Nom_attribut_src]. Prefixet kan vara värdet på ett attribut med hjälp av nyckelordet >. Om du inte vill lägga till något prefix anger du bara <uid> i den andra parametern i det förväntade uttrycket.

Användningssätt:

Åtgärden MULTSET kan användas i synkroniseringsregler för åtgärderna CONVERT och MATCH (OnCreate, OnModify och OnDelete).

Exempel på följande konfiguration:

• Med attributet ”postal_code” lika med:
  • 68300
  • 68390
  • 38670
• Resultat: i filen sync.xml har attributet ”Code_postal_prefix” följande värden:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Åtgärd som jämför 2 flervärda attribut.

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: namnet på det attribut som ska jämföras, som finns i målexporten.
• [Attribute Name]: namnet på det attribut som ska jämföras, som finns i källexporten.

Exempel på följande konfiguration:

RENAME

Åtgärd som byter namn på ett attribut.

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: attributets nya namn.
• [Expression]: namnet på det attribut som ska byta namn.

Exempel på följande konfiguration:

SET

Åtgärd som gör det möjligt att tilldela ett värde till ett attribut, endast envärt, oavsett om det finns eller inte.

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Attribute]: namnet på det attribut som ska tilldelas ett värde. Om attributet finns skrivs det ursprungliga värdet över; om attributet inte finns skapas det.
• [Expression]: formeln som ska anges. Du kan använda nyckelord eller ange fasta värden helt eller delvis (hårdkodad text). Se kapitlet ”Lista över nyckelord” för den syntax som gäller för ditt användningsfall.

Exempel på följande konfiguration:

SIMPLEEQ

Åtgärd som jämför flera envärda attribut.

Funktionens syntax:

• [Description]: fri text som beskriver åtgärden (valfritt).
• [Source attribute name]: namnet på det attribut som ska jämföras, som finns i källexporten.
• [Destination attribute name]: namnet på det attribut som ska jämföras, som finns i målexporten.

Åtgärden måste utföras så många gånger som behövs. Objekt paras samman om alla attribut är lika.

Exempel på följande konfiguration:

SPLIT

Åtgärd som används för att dela upp värdena i ett envärt attribut med hjälp av en avgränsare och sedan tilldela resultatet till ett flervärt attribut.

Observera att den här åtgärden bara är tillgänglig från version 6.2.

Funktionens syntax:

• [name_out_attribute_multivalues] = namnet på det attribut som ska tillhandahållas som utdata.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: avgränsaren måste vara ett enda tecken och kan inte vara ”;”, eftersom det tecknet används i konnektorns konfigurationsfil.
  • [name_attribute_multivalues]: namnet på det flervärda attribut vars värden ska sammanfogas.

Möjliga resultat:

• Om avgränsaren hittas minst en gång: returnerar en lista med värden
• Om avgränsaren inte hittas: returnerar den fullständiga teckensträngen

Möjliga resultat:

Åtgärden SPLIT kan användas i synkroniseringsregler och bara i CONVERT-åtgärder.

Exempel på följande konfiguration:

• Med attributet ”string_rights” lika med:
  • Droit_001#Droit_002#Droit_003
• Resultat: i filen sync.xml har attributet ”lst_right_multi” följande värde:
  • Droit_001
  • Droit_002
  • Droit_003