Lista operațiilor disponibile pe reguli de sincronizare

	Conversie	Reguli de corespondență	Comparare	Creare	Modificare	Ștergere
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

Opțiuni disponibile pentru fiecare operație:

	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

**: Filtrele diferă în funcție de regula care utilizează operația.

• B64: convertește valoarea atributului în formatul Base 64.
• CI: Case insensitive: comparația se efectuează fără a ține cont de majuscule și minuscule.
• DATE: convertește valoarea atributului în formatul DATE.
• DATE_FILETIME: convertește valoarea atributului în formatul DATETIME.
• DN: comparare de DN.
• PARTIAL: compară parțial datele. Returnează „true” dacă cel puțin o valoare este conținută în atributul de comparare.
• PWD: activează criptarea datelor.
• USEMAP: utilizarea unei hărți pentru a găsi atributul, accelerează procesul de comparare.

ADDVALUE

Operație care permite adăugarea de valori la un atribut care, prin definiție, poate avea valori multiple. Permite de asemenea concatenarea valorilor mai multor atribute.

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: numele atributului care trebuie modificat. Dacă atributul nu există, va fi creat automat.
• [Expression]: formula care trebuie introdusă. Este posibil să utilizați cuvinte-cheie sau să introduceți în totalitate sau parțial valori fixe (text codificat rigid). Consultați capitolul „Lista cuvintelor-cheie” pentru sintaxa care trebuie aplicată în cazul dumneavoastră de utilizare.

Exemplu al configurației următoare:

CHANGE

Operație care permite modificarea valorii unui atribut. Atributul trebuie să existe și să aibă o singură valoare. Valoarea inițială a atributului este suprascrisă și nu mai poate fi reutilizată.

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: numele atributului care trebuie modificat. Dacă atributul nu există, operația nu va funcționa.
• [Expression]: formula care trebuie introdusă. Este posibil să utilizați cuvinte-cheie sau să introduceți în totalitate sau parțial valori fixe (text codificat rigid). Consultați capitolul „Lista cuvintelor-cheie” pentru sintaxa care trebuie aplicată în cazul dumneavoastră de utilizare.

Exemplu al configurației următoare:

COMPAREATTNAME

Operație care permite enumerarea atributelor care nu trebuie comparate și compararea tuturor celorlalte atribute care au același nume în ambele repository-uri. Numele de atribute din repository-ul sursă care nu au un corespondent în repository-ul de destinație vor fi ignorate și nu vor fi comparate. Poate fi utilizată pentru a înlocui maparea unitară a atributelor care trebuie comparate.

Rețineți că această operație este disponibilă numai începând cu versiunea 6.2 și poate fi utilizată numai în regulile OnCompare, într-o operație MATCH, în conectorii de provizionare de tip status (status).

Sintaxa funcției:

• [Attribute] = lista atributelor care nu trebuie comparate. Atributele trebuie separate prin virgule și fără spații.

Exemplu al configurației următoare:

CONTAIN

Operație care efectuează o comparare pentru a verifica dacă valorile atributului sursei autoritare sunt prezente în atributul sursei țintă. Rezultatul operației va fi concatenarea valorilor atributului sursei țintă cu valorile atributului sursei autoritare care nu au fost găsite.

Exemplu

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Rezultatul în atributul sursei țintă =

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

În această operație nu se poate utiliza niciun cuvânt-cheie.

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: numele atributului prezent în sursa țintă asupra căruia se efectuează comparația.
• [Attribute Name]: numele atributului prezent în sursa autoritară asupra căruia se efectuează comparația.

Exemplu al configurației următoare:

CONVERT

COPY

Operație care permite copierea valorii unui atribut în alt atribut. Funcționează pentru atributele cu o singură valoare și pentru cele cu valori multiple.

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: numele atributului care trebuie modificat. Atributul trebuie să existe.
• [Attribute Name]: numele atributului sursă a cărui valoare va fi copiată.

Exemplu al configurației următoare:

Atributul „usual_name” va lua valoarea atributului „birth_name”.

DELETE

Operație care permite ștergerea unui atribut într-o sursă specificată (sursă de export, destinație de export sau DELTA).

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: numele atributului care trebuie șters.
• [Expression]: nu completați acest câmp.

DELVALUE

Operație care permite ștergerea valorilor unui atribut pe baza unei expresii booleene: dacă expresia returnează „True”, valorile sunt șterse. Prin urmare, se aplică în general atributelor cu valori multiple.

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: numele atributului care trebuie modificat.
• [Expression]: formula care trebuie introdusă. Este posibil să utilizați cuvinte-cheie sau să introduceți în totalitate sau parțial valori fixe (text codificat rigid). Consultați capitolul „Lista cuvintelor-cheie” pentru sintaxa care trebuie aplicată în cazul dumneavoastră de utilizare.

Exemplu al configurației următoare:

Dacă atributul „groups” conține valoarea „GRP_ACCES_COMMUN”, aceasta va fi eliminată din lista de valori „groups”, iar lista modificată a atributului „groups” va fi copiată în atributul „memberof@”.

DELVALUEBYVALUE

Operație care permite ștergerea valorilor unui atribut pe baza unei liste date. Prin urmare, se aplică în general atributelor cu valori multiple.

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: numele atributului care trebuie modificat.
• [Expression]: valorile care trebuie introduse, separate prin „;”. Este posibil să utilizați cuvinte-cheie sau să introduceți în totalitate sau parțial valori fixe (text codificat rigid). Consultați capitolul „Lista cuvintelor-cheie” pentru sintaxa care trebuie aplicată în cazul dumneavoastră de utilizare.

Exemplu al configurației următoare:

Valorile atributului „groups_admin” și valoarea „GRP_ACCES_COMMUN” sunt eliminate din lista de valori conținută în „memberof@”.

DSTCOPY

Operație care copiază valoarea unui atribut găsit în exportul de destinație într-un alt atribut din fișierul DELTA. Funcționează pentru atributele cu o singură valoare și pentru cele cu valori multiple. Este utilizată în general pentru a transfera valori din repository-ul de destinație care nu sunt cunoscute în repository-ul sursă, adesea în cazul ștergerii (necunoscută în sursă, dar încă prezentă în destinație).

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: numele atributului de destinație.
• [Attribute Name]: numele atributului sursă a cărui valoare va fi copiată.

Exemplu al configurației următoare:

EQ

Operație care compară două atribute cu o singură valoare.

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: numele atributului care trebuie comparat, prezent în exportul sursă.
• [Expression]: formula care trebuie introdusă. Este posibil să utilizați cuvinte-cheie sau să introduceți în totalitate sau parțial valori fixe (text codificat rigid). Consultați capitolul „Lista cuvintelor-cheie” pentru sintaxa care trebuie aplicată în cazul dumneavoastră de utilizare.

Exemplu al configurației următoare:

GETSTRUCTCHILD

Permite recuperarea listei structurilor copil în atributul „Destination_attribute_name” al unei structuri date, indicată în „Parent_structure_attribute_name”. Această operație poate fi efectuată numai pe datele din repository-ul Identity (de exemplu, pe un export de identități care are un atribut de tip structură).

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: numele atributului de destinație care va primi lista structurilor copil.
• [Expression]: numele atributului structurii părinte, fără niciun cuvânt-cheie.

Exemplu al configurației următoare:

Returnează toate structurile copil ale structurii cu codul „Site”.

ISCONTAINED

Operație care compară un atribut cu valori multiple din sursa autoritară cu un atribut cu valori multiple din sursa țintă, pentru a extrage numai lista valorilor prezente în ambele atribute.

Exemplu:

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3
• Val_4

Source_target_attribute_values =

• Val_3
• Val_4
• Val_5

Rezultatul în atributul sursei țintă =

• Val_3
• Val_4

În această operație nu se poate utiliza niciun cuvânt-cheie.

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: numele atributului prezent în sursa țintă asupra căruia se efectuează comparația.
• [Attribute Name]: numele atributului prezent în sursa autoritară asupra căruia se efectuează comparația.

Exemplu al configurației următoare:

MERGE

Operație care permite crearea unei concatenări a valorilor unui atribut cu valori multiple și atribuirea acesteia unui atribut cu o singură valoare.

Rețineți că această operație este disponibilă numai începând cu versiunea 6.2.

Sintaxa funcției:

• [name_out_attribute_monovalue] = numele atributului care trebuie furnizat la ieșire.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: separatorul trebuie să fie un singur caracter și nu poate fi „;”, deoarece acest caracter este utilizat în fișierul de configurare al conectorului.
  • [name_attribute_multivalues]: numele atributului cu valori multiple ale cărui valori trebuie concatenate.

Mod de utilizare:

Operația MERGE poate fi utilizată în regulile de sincronizare și numai în operațiile CONVERT.

Exemplu al configurației următoare:

• Cu atributul „wiki_mod_1” egal cu:
  • Droit_001
  • Droit_002
  • Droit_003
• Rezultat: în fișierul sync.xml, atributul „lst_right” va avea valoarea următoare:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Operație care permite modificarea valorii unui atribut. Atributul trebuie să existe și să aibă o singură valoare. Valoarea inițială a atributului este suprascrisă și nu mai poate fi reutilizată.

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: numele atributului care trebuie modificat. Dacă atributul nu există, operația nu va funcționa.
• [Expression]: formula care trebuie introdusă. Este posibil să utilizați cuvinte-cheie sau să introduceți în totalitate sau parțial valori fixe (text codificat rigid). Consultați capitolul „Lista cuvintelor-cheie” pentru sintaxa care trebuie aplicată în cazul dumneavoastră de utilizare.

Exemplu al configurației următoare:

MULTCOPY

Copierea atributelor din sursă

Operație care copiază valorile atributelor din exportul sursă în atribute din fișierul DELTA. Funcționează pentru atributele cu o singură valoare .

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute name to copy]: numele atributului care trebuie să se afle în exportul sursă. Atributul trebuie să existe.
• [Target attribute name]: atributul trebuie să existe. Numele atributului care trebuie inclus în exportul de destinație, care va fi situat în fișierul DELTA.

Operația trebuie efectuată de câte ori este necesar.

Exemplu al configurației următoare:

MULTDSTCOPY

Operație care copiază valorile atributelor găsite în exportul de destinație în atribute din fișierul DELTA. Funcționează pentru atributele cu o singură valoare . Este utilizată în general pentru a raporta valori din repository-ul de destinație care nu sunt cunoscute în repository-ul sursă, adesea în cazul ștergerii (nu mai sunt cunoscute în sursă, dar sunt încă prezente în destinație).

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute name to copy]: numele atributului care trebuie inclus în exportul de destinație. Atributul trebuie să existe.
• [Target attribute name]: numele atributului de destinație care trebuie să se afle în fișierul DELTA.

Operația trebuie efectuată de câte ori este necesar.

Exemplu al configurației următoare:

MULTIEVALEQ

Operație care compară mai multe atribute cu valori multiple.

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Source attribute name]: numele atributului care trebuie comparat, prezent în exportul sursă.
• [Destination attribute name]: numele atributului care trebuie comparat, prezent în exportul de destinație.

Operația trebuie efectuată de câte ori este necesar. Obiectele sunt asociate dacă toate atributele sunt egale.

Exemplu al configurației următoare:

MULTSET

Operație care permite realizarea de copii ale atributelor cu valori multiple, cu opțiunea de a adăuga un prefix.

Sintaxa funcției:

• [Nom_attribut_dest] = numele atributului care trebuie furnizat la ieșire. Nu este necesar ca atributul să existe în prealabil.
• [Nom_attribut_src] = numele atributului a cărui valori vor fi copiate. Atenție, nu utilizați cuvintele-cheie <syncattsrc> sau <syncattdst>.
• [prefixe] = șirul de caractere care trebuie adăugat înaintea fiecărei valori a atributului [Nom_attribut_src]. Prefixul poate fi valoarea unui atribut, folosind cuvântul-cheie >. Dacă nu doriți să adăugați un prefix, specificați pur și simplu <uid> în al doilea parametru al expresiei așteptate.

Mod de utilizare:

Operația MULTSET poate fi utilizată în regulile de sincronizare pentru operațiile CONVERT și MATCH (OnCreate, OnModify și OnDelete).

Exemplu al configurației următoare:

• Cu atributul „postal_code” egal cu:
  • 68300
  • 68390
  • 38670
• Rezultat: în fișierul sync.xml, atributul „Code_postal_prefix” va avea valorile următoare:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Operație care compară 2 atribute cu valori multiple.

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: numele atributului care trebuie comparat, prezent în exportul de destinație.
• [Attribute Name]: numele atributului care trebuie comparat, prezent în exportul sursă.

Exemplu al configurației următoare:

RENAME

Operație care redenumește un atribut.

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: noul nume al atributului.
• [Expression]: numele atributului care trebuie redenumit.

Exemplu al configurației următoare:

SET

Operație care permite atribuirea unei valori unui atribut, numai cu o singură valoare, indiferent dacă acesta există sau nu.

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Attribute]: numele atributului căruia trebuie să i se atribuie o valoare. Dacă atributul există, valoarea inițială va fi suprascrisă; dacă atributul nu există, acesta va fi creat.
• [Expression]: formula care trebuie introdusă. Este posibil să utilizați cuvinte-cheie sau să introduceți în totalitate sau parțial valori fixe (text codificat rigid). Consultați capitolul „Lista cuvintelor-cheie” pentru sintaxa care trebuie aplicată în cazul dumneavoastră de utilizare.

Exemplu al configurației următoare:

SIMPLEEQ

Operație care compară mai multe atribute cu o singură valoare.

Sintaxa funcției:

• [Description]: text liber pentru a descrie operația (opțional).
• [Source attribute name]: numele atributului care trebuie comparat, prezent în exportul sursă.
• [Destination attribute name]: numele atributului care trebuie comparat, prezent în exportul de destinație.

Operația trebuie efectuată de câte ori este necesar. Obiectele sunt asociate dacă toate atributele sunt egale.

Exemplu al configurației următoare:

SPLIT

Operație utilizată pentru a crea o separare a valorilor dintr-un atribut cu o singură valoare și un separator, apoi pentru a o atribui unui atribut cu valori multiple.

Rețineți că această operație este disponibilă numai începând cu versiunea 6.2.

Sintaxa funcției:

• [name_out_attribute_multivalues] = numele atributului care trebuie furnizat la ieșire.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: separatorul trebuie să fie un singur caracter și nu poate fi „;”, deoarece acest caracter este utilizat în fișierul de configurare al conectorului.
  • [name_attribute_multivalues]: numele atributului cu valori multiple ale cărui valori trebuie concatenate.

Rezultate posibile:

• Dacă separatorul este găsit cel puțin o dată: returnează o listă de valori
• Dacă separatorul nu este găsit: returnează șirul complet

Rezultate posibile:

Operația SPLIT poate fi utilizată în regulile de sincronizare și numai în operațiile CONVERT.

Exemplu al configurației următoare:

• Cu atributul „string_rights” egal cu:
  • Droit_001#Droit_002#Droit_003
• Rezultat: în fișierul sync.xml, atributul „lst_right_multi” va avea valoarea următoare:
  • Droit_001
  • Droit_002
  • Droit_003