Lijst van beschikbare bewerkingen per synchronisatieregel

	Conversie	Matching- regels	Vergelijking	Aanmaken	Wijziging	Verwijdering
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

Voor elke bewerking beschikbare opties:

	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

**: De filters verschillen afhankelijk van de regel die de bewerking gebruikt.

• B64: Zet de waarde van het attribuut om naar het formaat Base 64.
• CI: Case insensitive: de vergelijking wordt uitgevoerd zonder onderscheid tussen hoofdletters en kleine letters.
• DATE: Zet de waarde van het attribuut om naar het formaat DATE.
• DATE_FILETIME: Zet de waarde van het attribuut om naar het formaat DATETIME.
• DN: vergelijking van de DN.
• PARTIAL: vergelijkt de gegevens gedeeltelijk. Geeft true terug als ten minste één waarde in het vergelijkingsattribuut voorkomt.
• PWD: maakt de versleuteling van de gegevens mogelijk.
• USEMAP: gebruik van een mapping om het attribuut te vinden; versnelt het vergelijkingsproces.

ADDVALUE

Bewerking waarmee waarden kunnen worden toegevoegd aan een attribuut dat per definitie meerdere waarden kan hebben. Ze maakt ook de samenvoeging van waarden uit verschillende attributen mogelijk.

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: naam van het te wijzigen attribuut. Als het attribuut niet bestaat, wordt het automatisch aangemaakt.
• [Expression]: de in te voeren formule. Het is mogelijk trefwoorden te gebruiken of vaste waarden geheel of gedeeltelijk in te voeren (hard gecodeerde tekst). Raadpleeg het hoofdstuk ”List of keywords” voor de syntaxis die op uw gebruiksscenario van toepassing is.

Voorbeeld van de volgende configuratie:

CHANGE

Bewerking waarmee de waarde van een attribuut kan worden gewijzigd. Het attribuut moet bestaan en één waarde hebben. De oorspronkelijke waarde van het attribuut wordt overschreven en kan niet meer worden hergebruikt.

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: naam van het te wijzigen attribuut. Als het attribuut niet bestaat, werkt de bewerking niet.
• [Expression]: de in te voeren formule. Het is mogelijk trefwoorden te gebruiken of vaste waarden geheel of gedeeltelijk in te voeren (hard gecodeerde tekst). Raadpleeg het hoofdstuk ”List of keywords” voor de syntaxis die op uw gebruiksscenario van toepassing is.

Voorbeeld van de volgende configuratie:

COMPAREATTNAME

Bewerking waarmee attributen kunnen worden opgesomd die niet mogen worden vergeleken en waarmee alle andere attributen worden vergeleken die in beide repositories dezelfde naam hebben. Namen van attributen in de bronrepository die geen tegenhanger in de doelrepository hebben, worden genegeerd en niet vergeleken. Ze kan de afzonderlijke mapping van de te vergelijken attributen vervangen.

Let erop dat deze bewerking pas vanaf versie 6.2 beschikbaar is en alleen kan worden gebruikt in OnCompare-regels binnen een MATCH-bewerking bij provisioningconnectoren met provisioningstatus (status).

Syntaxis van de functie:

• [Attribute] = lijst van attributen die niet mogen worden vergeleken. De attributen moeten door komma's worden gescheiden, zonder spaties.

Voorbeeld van de volgende configuratie:

CONTAIN

Bewerking die een vergelijking uitvoert om te controleren of de waarden van het attribuut van de autoritatieve bron aanwezig zijn in het attribuut van de doelbron. Het resultaat van de bewerking is de samenvoeging van de waarden van het attribuut van de doelbron met de waarden van het attribuut van de autoritatieve bron die niet zijn gevonden.

Voorbeeld

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Resultaat in het attribuut van de doelbron =

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

In deze bewerking kunnen geen trefwoorden worden gebruikt.

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: naam van het attribuut in de doelbron waarop de vergelijking moet worden uitgevoerd.
• [Attribute Name]: naam van het attribuut in de autoritatieve bron waarop de vergelijking moet worden uitgevoerd.

Voorbeeld van de volgende configuratie:

CONVERT

COPY

Bewerking waarmee de waarde van een attribuut naar een ander attribuut kan worden gekopieerd. Ze werkt voor attributen met één waarde en voor attributen met meerdere waarden.

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: naam van het te wijzigen attribuut. Het attribuut moet bestaan.
• [Attribute Name]: naam van het bronattribuut waarvan de waarde wordt gekopieerd.

Voorbeeld van de volgende configuratie:

Het attribuut ”usual_name” neemt de waarde over van het attribuut ”birth_name”.

DELETE

Bewerking waarmee een attribuut in een opgegeven bron kan worden verwijderd (exportbron, exportdoel of DELTA).

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: naam van het te verwijderen attribuut.
• [Expression]: vul dit veld niet in.

DELVALUE

Bewerking waarmee waarden uit een attribuut kunnen worden verwijderd op basis van een booleaanse expressie: geeft de expressie ”True” terug, dan worden de waarden verwijderd. Ze geldt daarom in het algemeen voor attributen met meerdere waarden.

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: naam van het te wijzigen attribuut.
• [Expression]: de in te voeren formule. Het is mogelijk trefwoorden te gebruiken of vaste waarden geheel of gedeeltelijk in te voeren (hard gecodeerde tekst). Raadpleeg het hoofdstuk ”List of keywords” voor de syntaxis die op uw gebruiksscenario van toepassing is.

Voorbeeld van de volgende configuratie:

Als het attribuut ”groups” de waarde ”GRP_ACCES_COMMUN” bevat, wordt deze uit de lijst met waarden van ”groups” verwijderd en wordt de gewijzigde lijst van het attribuut ”groups” naar het attribuut ”memberof@” gekopieerd.

DELVALUEBYVALUE

Bewerking waarmee waarden uit een attribuut kunnen worden verwijderd op basis van een opgegeven lijst. Ze geldt daarom in het algemeen voor attributen met meerdere waarden.

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: naam van het te wijzigen attribuut.
• [Expression]: de in te voeren waarden, gescheiden door ”;”. Het is mogelijk trefwoorden te gebruiken of vaste waarden geheel of gedeeltelijk in te voeren (hard gecodeerde tekst). Raadpleeg het hoofdstuk ”List of keywords” voor de syntaxis die op uw gebruiksscenario van toepassing is.

Voorbeeld van de volgende configuratie:

De waarden van het attribuut ”groups_admin” en de waarde ”GRP_ACCES_COMMUN” worden verwijderd uit de lijst met waarden die in ”memberof@” staat.

DSTCOPY

Bewerking die de waarde van een in de doelexport gevonden attribuut naar een ander attribuut in het DELTA-bestand kopieert. Ze werkt voor attributen met één waarde en voor attributen met meerdere waarden. Ze wordt in het algemeen gebruikt om waarden uit de doelrepository over te brengen die in de bronrepository onbekend zijn, vaak bij een verwijdering (niet bekend in de bron, maar nog aanwezig in het doel).

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: naam van het doelattribuut.
• [Attribute Name]: naam van het bronattribuut waarvan de waarde wordt gekopieerd.

Voorbeeld van de volgende configuratie:

EQ

Bewerking die twee attributen met één waarde vergelijkt.

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: naam van het te vergelijken attribuut, aanwezig in de bronexport.
• [Expression]: de in te voeren formule. Het is mogelijk trefwoorden te gebruiken of vaste waarden geheel of gedeeltelijk in te voeren (hard gecodeerde tekst). Raadpleeg het hoofdstuk ”List of keywords” voor de syntaxis die op uw gebruiksscenario van toepassing is.

Voorbeeld van de volgende configuratie:

GETSTRUCTCHILD

Maakt het mogelijk de lijst van onderliggende structuren op te halen in het attribuut ”Destination_attribute_name” van een bepaalde structuur in ”Parent_structure_attribute_name”. Deze bewerking kan alleen worden uitgevoerd op gegevens uit de Identity-repository (bijvoorbeeld op een export van identiteiten die een attribuut van het type structuur bevat).

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: naam van het doelattribuut dat de lijst van onderliggende structuren ontvangt.
• [Expression]: naam van het attribuut van de bovenliggende structuur, zonder trefwoorden.

Voorbeeld van de volgende configuratie:

Geeft alle onderliggende structuren terug van de structuur met de code ”Site”.

ISCONTAINED

Bewerking die een attribuut met meerdere waarden van de autoritatieve bron vergelijkt met een attribuut met meerdere waarden van de doelbron, om alleen de lijst van waarden te halen die in beide attributen aanwezig zijn.

Voorbeeld:

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3
• Val_4

Source_target_attribute_values =

• Val_3
• Val_4
• Val_5

Resultaat in het attribuut van de doelbron =

• Val_3
• Val_4

In deze bewerking kunnen geen trefwoorden worden gebruikt.

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: naam van het attribuut in de doelbron waarop de vergelijking moet worden uitgevoerd.
• [Attribute Name]: naam van het attribuut in de autoritatieve bron waarop de vergelijking moet worden uitgevoerd.

Voorbeeld van de volgende configuratie:

MERGE

Bewerking waarmee een samenvoeging van waarden uit een attribuut met meerdere waarden kan worden gemaakt en aan een attribuut met één waarde kan worden toegekend.

Let erop dat deze bewerking pas vanaf versie 6.2 beschikbaar is.

Syntaxis van de functie:

• [name_out_attribute_monovalue] = naam van het attribuut dat als uitvoer moet worden geleverd.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: het scheidingsteken moet één enkel teken zijn en mag niet ";" zijn, omdat dit teken in het configuratiebestand van de connector wordt gebruikt.
  • [name_attribute_multivalues]: naam van het attribuut met meerdere waarden waarvan de waarden moeten worden samengevoegd.

Wijze van gebruik:

De bewerking MERGE kan worden gebruikt in synchronisatieregels en alleen in CONVERT-bewerkingen.

Voorbeeld van de volgende configuratie:

• Met het attribuut "wiki_mod_1" met de volgende waarde:
  • Droit_001
  • Droit_002
  • Droit_003
• Resultaat: in het bestand sync.xml heeft het attribuut "lst_right" de volgende waarde:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Bewerking waarmee de waarde van een attribuut kan worden gewijzigd. Het attribuut moet bestaan en één waarde hebben. De oorspronkelijke waarde van het attribuut wordt overschreven en kan niet meer worden hergebruikt.

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: naam van het te wijzigen attribuut. Als het attribuut niet bestaat, werkt de bewerking niet.
• [Expression]: de in te voeren formule. Het is mogelijk trefwoorden te gebruiken of vaste waarden geheel of gedeeltelijk in te voeren (hard gecodeerde tekst). Raadpleeg het hoofdstuk ”List of keywords” voor de syntaxis die op uw gebruiksscenario van toepassing is.

Voorbeeld van de volgende configuratie:

MULTCOPY

Attributen uit de bron kopiëren

Bewerking die attribuutwaarden uit de bronexport naar attributen in het DELTA-bestand kopieert. Ze werkt voor attributen met één waarde .

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute name to copy]: naam van het attribuut dat in de bronexport aanwezig moet zijn. Het attribuut moet bestaan.
• [Target attribute name]: het attribuut moet bestaan. Naam van het attribuut dat in de doelexport opgenomen moet zijn en dat zich in het DELTA-bestand bevindt.

De bewerking moet zo vaak als nodig worden uitgevoerd.

Voorbeeld van de volgende configuratie:

MULTDSTCOPY

Bewerking die in de doelexport gevonden attribuutwaarden naar attributen in het DELTA-bestand kopieert. Ze werkt voor attributen met één waarde . Ze wordt in het algemeen gebruikt om waarden uit de doelrepository te melden die in de bronrepository onbekend zijn, vaak bij een verwijdering (niet meer bekend in de bron, maar nog aanwezig in het doel).

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute name to copy]: naam van het attribuut dat in de doelexport opgenomen moet zijn. Het attribuut moet bestaan.
• [Target attribute name]: naam van het doelattribuut dat in het DELTA-bestand moet worden gevonden.

De bewerking moet zo vaak als nodig worden uitgevoerd.

Voorbeeld van de volgende configuratie:

MULTIEVALEQ

Bewerking die meerdere attributen met meerdere waarden vergelijkt.

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Source attribute name]: naam van het te vergelijken attribuut, aanwezig in de bronexport.
• [Destination attribute name]: naam van het te vergelijken attribuut, aanwezig in de doelexport.

De bewerking moet zo vaak als nodig worden uitgevoerd. Objecten worden gekoppeld als alle attributen gelijk zijn.

Voorbeeld van de volgende configuratie:

MULTSET

Bewerking waarmee kopieën van attributen met meerdere waarden kunnen worden gemaakt, met de mogelijkheid een voorvoegsel toe te voegen.

Syntaxis van de functie:

• [Nom_attribut_dest] = naam van het attribuut dat als uitvoer moet worden geleverd. Het attribuut hoeft niet vooraf te bestaan.
• [Nom_attribut_src] = naam van het attribuut waarvan de waarden worden gekopieerd. Let op: gebruik niet de trefwoorden <syncattsrc> of <syncattdst>.
• [prefixe] = tekenreeks die vóór elke waarde van het attribuut [Nom_attribut_src] wordt toegevoegd. Het voorvoegsel kan de waarde van een attribuut zijn, met behulp van het trefwoord >. Als u geen voorvoegsel wilt toevoegen, geef dan alleen <uid> op in de tweede parameter van de verwachte expressie.

Wijze van gebruik:

De bewerking MULTSET kan worden gebruikt in synchronisatieregels voor de bewerkingen CONVERT en MATCH (OnCreate, OnModify en OnDelete).

Voorbeeld van de volgende configuratie:

• Met het attribuut "postal_code" met de volgende waarde:
  • 68300
  • 68390
  • 38670
• Resultaat: in het bestand sync.xml heeft het attribuut "Code_postal_prefix" de volgende waarden:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Bewerking die 2 attributen met meerdere waarden vergelijkt.

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: naam van het te vergelijken attribuut, aanwezig in de doelexport.
• [Attribute Name]: naam van het te vergelijken attribuut, aanwezig in de bronexport.

Voorbeeld van de volgende configuratie:

RENAME

Bewerking die een attribuut een nieuwe naam geeft.

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: nieuwe naam van het attribuut.
• [Expression]: naam van het attribuut waarvan de naam moet worden gewijzigd.

Voorbeeld van de volgende configuratie:

SET

Bewerking waarmee een waarde aan een attribuut kan worden toegekend – uitsluitend met één waarde – ongeacht of het bestaat of niet.

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Attribute]: naam van het attribuut waaraan een waarde moet worden toegekend. Als het attribuut bestaat, wordt de oorspronkelijke waarde overschreven; bestaat het attribuut niet, dan wordt het aangemaakt.
• [Expression]: de in te voeren formule. Het is mogelijk trefwoorden te gebruiken of vaste waarden geheel of gedeeltelijk in te voeren (hard gecodeerde tekst). Raadpleeg het hoofdstuk ”List of keywords” voor de syntaxis die op uw gebruiksscenario van toepassing is.

Voorbeeld van de volgende configuratie:

SIMPLEEQ

Bewerking die meerdere attributen met één waarde vergelijkt.

Syntaxis van de functie:

• [Description]: vrije tekst om de bewerking te beschrijven (optioneel).
• [Source attribute name]: naam van het te vergelijken attribuut, aanwezig in de bronexport.
• [Destination attribute name]: naam van het te vergelijken attribuut, aanwezig in de doelexport.

De bewerking moet zo vaak als nodig worden uitgevoerd. Objecten worden gekoppeld als alle attributen gelijk zijn.

Voorbeeld van de volgende configuratie:

SPLIT

Bewerking waarmee de waarden van een attribuut met één waarde op basis van een scheidingsteken worden gesplitst en het resultaat vervolgens aan een attribuut met meerdere waarden wordt toegekend.

Let erop dat deze bewerking pas vanaf versie 6.2 beschikbaar is.

Syntaxis van de functie:

• [name_out_attribute_multivalues] = naam van het attribuut dat als uitvoer moet worden geleverd.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: het scheidingsteken moet één enkel teken zijn en mag niet ";" zijn, omdat dit teken in het configuratiebestand van de connector wordt gebruikt.
  • [name_attribute_multivalues]: naam van het attribuut met meerdere waarden waarvan de waarden moeten worden samengevoegd.

Mogelijke resultaten:

• Als het scheidingsteken ten minste één keer wordt gevonden: geeft een lijst van waarden terug
• Als het scheidingsteken niet wordt gevonden: geeft de volledige tekenreeks terug

Mogelijke resultaten:

De bewerking SPLIT kan worden gebruikt in synchronisatieregels en alleen in CONVERT-bewerkingen.

Voorbeeld van de volgende configuratie:

• Met het attribuut "string_rights" met de volgende waarde:
  • Droit_001#Droit_002#Droit_003
• Resultaat: in het bestand sync.xml heeft het attribuut ”lst_right_multi” de volgende waarde:
  • Droit_001
  • Droit_002
  • Droit_003