Lista operacji dostępnych według reguł synchronizacji

	Konwersja	Reguły dopasowania	Porównanie	Tworzenie	Modyfikacja	Usuwanie
ADDVALUE	X			X	X	X
CHANGE	X			X	X	X
COMPAREATTNAME			X
COMPAREWITHEXCLUSIONS		X	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

Opcje dostępne dla każdej operacji:

	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

**: filtry różnią się w zależności od reguły używającej danej operacji.

• B64: konwertuje wartość atrybutu do formatu Base 64.
• CI: Case insensitive: porównanie jest wykonywane bez uwzględniania wielkości liter.
• DATE: konwertuje wartość atrybutu do formatu DATE.
• DATE_FILETIME: konwertuje wartość atrybutu do formatu DATETIME.
• DN: porównanie DN.
• PARTIAL: częściowo porównuje dane. Zwraca true, jeśli co najmniej jedna wartość jest zawarta w atrybucie porównania.
• PWD: włącza szyfrowanie danych.
• USEMAP: użycie mapy do odnalezienia atrybutu, przyspiesza proces porównywania.

ADDVALUE

Operacja umożliwiająca dodawanie wartości do atrybutu, który z definicji może być wielowartościowy. Umożliwia również łączenie wartości pochodzących z kilku atrybutów.

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nazwa atrybutu, który ma zostać zmodyfikowany. Jeśli atrybut nie istnieje, zostanie utworzony automatycznie.
• [Expression]: formuła do wprowadzenia. Można używać słów kluczowych albo wprowadzić w całości lub częściowo wartości stałe (tekst zapisany na stałe). Składnię właściwą dla Twojego przypadku użycia znajdziesz w rozdziale „Lista słów kluczowych”.

Przykład następującej konfiguracji:

CHANGE

Operacja umożliwiająca zmianę wartości atrybutu. Atrybut musi istnieć i być jednowartościowy. Początkowa wartość atrybutu jest nadpisywana i nie może być już ponownie użyta.

Uwaga

Operacja CHANGE jest przestarzała od wersji 7.1 i zostanie usunięta w wersji 7.2. Powiela ona operację MODVALUE: od teraz do modyfikowania wartości atrybutu używaj MODVALUE.

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nazwa atrybutu, który ma zostać zmodyfikowany. Jeśli atrybut nie istnieje, operacja nie zadziała.
• [Expression]: formuła do wprowadzenia. Można używać słów kluczowych albo wprowadzić w całości lub częściowo wartości stałe (tekst zapisany na stałe). Składnię właściwą dla Twojego przypadku użycia znajdziesz w rozdziale „Lista słów kluczowych”.

Przykład następującej konfiguracji:

COMPAREATTNAME

Operacja umożliwiająca wskazanie atrybutów, które nie mają być porównywane, oraz porównanie wszystkich pozostałych atrybutów o tej samej nazwie w obu repozytoriach. Nazwy atrybutów repozytorium źródłowego, które nie mają odpowiednika w repozytorium docelowym, są ignorowane i nie są porównywane. Operacja może zastąpić jednostkowe mapowanie atrybutów do porównania.

Zwróć uwagę, że ta operacja jest dostępna dopiero od wersji 6.2 i może być używana wyłącznie w regułach OnCompare w ramach operacji MATCH w konektorach provisioningu ze statusem provisioningu (status).

Składnia funkcji:

• [Attribute] = lista atrybutów, które nie mają być porównywane. Atrybuty muszą być rozdzielone przecinkami, bez spacji.

Przykład następującej konfiguracji:

COMPAREWITHEXCLUSIONS

Operacja, która porównuje wszystkie atrybuty między dwoma źródłami bez określania nazw atrybutów repozytorium źródłowego ani repozytorium docelowego. Możesz określić nazwy atrybutów, które nie mają być porównywane, co sprowadza się do zdefiniowania atrybutów, których kody różnią się między dwoma repozytoriami.

Zwróć uwagę, że ta operacja jest dostępna dopiero od wersji 7.1 i można jej używać wyłącznie w regule Matching i w regułach porównywania.

Zaleca się używanie tej operacji, gdy większość atrybutów ma tę samą nazwę w repozytorium źródłowym i docelowym, aby zaoszczędzić czas konfiguracji.

W przeciwieństwie do operacji COMPAREATTNAME, która ignoruje atrybuty bez odpowiednika w repozytorium docelowym i jest używana tylko w konektorach statusów provisioningu, ta operacja zgłasza również atrybuty obecne tylko w jednym z dwóch repozytoriów.

Modyfikacje wykrywane przez tę operację odpowiadają następującym przypadkom użycia:

• atrybut istnieje w repozytorium źródłowym i w repozytorium docelowym, z różnymi wartościami;
• atrybut istnieje w repozytorium źródłowym, ale nie w repozytorium docelowym;
• atrybut istnieje w repozytorium docelowym, ale nie w repozytorium źródłowym.

Składnia funkcji:

COMPAREWITHEXCLUSIONS:[attribute_1],[attribute_2],…

Atrybuty wykluczone z porównania są wymieniane po dwukropku, rozdzielone przecinkami.

Przykład następującej konfiguracji:

COMPAREWITHEXCLUSIONS:whenChanged,objectGUID

Wszystkie atrybuty są porównywane między dwoma repozytoriami, z wyjątkiem whenChanged i objectGUID.

CONTAIN

Operacja wykonująca porównanie, aby sprawdzić, czy wartości atrybutu źródła autorytatywnego są obecne w atrybucie źródła docelowego. Wynikiem operacji będzie połączenie wartości atrybutu źródła docelowego z tymi wartościami atrybutu źródła autorytatywnego, których nie znaleziono.

Przykład

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3

Source_target_attribute_values =

• Val_4
• Val_5
• Val_6

Wynik w atrybucie źródła docelowego =

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

W tej operacji nie można używać słów kluczowych.

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nazwa atrybutu obecnego w źródle docelowym, dla którego ma zostać wykonane porównanie.
• [Attribute Name]: nazwa atrybutu obecnego w źródle autorytatywnym, dla którego ma zostać wykonane porównanie.

Przykład następującej konfiguracji:

CONVERT

COPY

Operacja umożliwiająca skopiowanie wartości jednego atrybutu do innego atrybutu. Działa dla atrybutów jednowartościowych i wielowartościowych.

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nazwa atrybutu, który ma zostać zmodyfikowany. Atrybut musi istnieć.
• [Attribute Name]: nazwa atrybutu źródłowego, którego wartość zostanie skopiowana.

Przykład następującej konfiguracji:

Atrybut „usual_name” przyjmie wartość atrybutu „birth_name”.

DELETE

Operacja umożliwiająca usunięcie atrybutu w określonym źródle (źródło eksportu, cel eksportu lub DELTA).

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nazwa atrybutu, który ma zostać usunięty.
• [Expression]: nie wypełniaj tego pola.

DELVALUE

Operacja umożliwiająca usuwanie wartości z atrybutu na podstawie wyrażenia logicznego: jeśli wyrażenie zwraca „True”, wartości są usuwane. Dotyczy zatem zazwyczaj atrybutów wielowartościowych.

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nazwa atrybutu, który ma zostać zmodyfikowany.
• [Expression]: formuła do wprowadzenia. Można używać słów kluczowych albo wprowadzić w całości lub częściowo wartości stałe (tekst zapisany na stałe). Składnię właściwą dla Twojego przypadku użycia znajdziesz w rozdziale „Lista słów kluczowych”.

Przykład następującej konfiguracji:

Jeśli atrybut „groups” zawiera wartość „GRP_ACCES_COMMUN”, zostanie ona usunięta z listy wartości „groups”, a zmodyfikowana lista atrybutu „groups” zostanie skopiowana do atrybutu „memberof@”.

DELVALUEBYVALUE

Operacja umożliwiająca usuwanie wartości z atrybutu na podstawie podanej listy. Dotyczy zatem zazwyczaj atrybutów wielowartościowych.

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nazwa atrybutu, który ma zostać zmodyfikowany.
• [Expression]: wartości do wprowadzenia, rozdzielone znakiem „;”. Można używać słów kluczowych albo wprowadzić w całości lub częściowo wartości stałe (tekst zapisany na stałe). Składnię właściwą dla Twojego przypadku użycia znajdziesz w rozdziale „Lista słów kluczowych”.

Przykład następującej konfiguracji:

Wartości atrybutu „groups_admin” oraz wartość „GRP_ACCES_COMMUN” są usuwane z listy wartości zawartych w „memberof@”.

DSTCOPY

Operacja kopiująca wartość atrybutu znalezionego w eksporcie docelowym do innego atrybutu w pliku DELTA. Działa dla atrybutów jednowartościowych i wielowartościowych. Jest zazwyczaj używana do przenoszenia wartości z repozytorium docelowego, które są nieznane w repozytorium źródłowym, często w przypadku usunięcia (nieznane w źródle, ale nadal obecne w celu).

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nazwa atrybutu docelowego.
• [Attribute Name]: nazwa atrybutu źródłowego, którego wartość zostanie skopiowana.

Przykład następującej konfiguracji:

EQ

Operacja porównująca dwa atrybuty jednowartościowe.

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nazwa atrybutu do porównania, obecnego w eksporcie źródłowym.
• [Expression]: formuła do wprowadzenia. Można używać słów kluczowych albo wprowadzić w całości lub częściowo wartości stałe (tekst zapisany na stałe). Składnię właściwą dla Twojego przypadku użycia znajdziesz w rozdziale „Lista słów kluczowych”.

Przykład następującej konfiguracji:

GETSTRUCTCHILD

Umożliwia pobranie listy struktur podrzędnych do atrybutu „Destination_attribute_name” dla danej struktury wskazanej w „Parent_structure_attribute_name”. Ta operacja może być wykonywana wyłącznie na danych z repozytorium Identity (na przykład na eksporcie tożsamości zawierającym atrybut typu struktura).

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nazwa atrybutu docelowego, który otrzyma listę struktur podrzędnych.
• [Expression]: nazwa atrybutu struktury nadrzędnej, bez słów kluczowych.

Przykład następującej konfiguracji:

Zwraca wszystkie struktury podrzędne struktury o kodzie „Site”.

ISCONTAINED

Operacja porównująca atrybut wielowartościowy źródła autorytatywnego z atrybutem wielowartościowym źródła docelowego, aby wyodrębnić tylko listę wartości obecnych w obu atrybutach.

Przykład:

Authoritative_source_attribute_values =

• Val_1
• Val_2
• Val_3
• Val_4

Source_target_attribute_values =

• Val_3
• Val_4
• Val_5

Wynik w atrybucie źródła docelowego =

• Val_3
• Val_4

W tej operacji nie można używać słów kluczowych.

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nazwa atrybutu obecnego w źródle docelowym, dla którego ma zostać wykonane porównanie.
• [Attribute Name]: nazwa atrybutu obecnego w źródle autorytatywnym, dla którego ma zostać wykonane porównanie.

Przykład następującej konfiguracji:

MERGE

Operacja umożliwiająca utworzenie połączenia wartości atrybutu wielowartościowego i przypisanie go do atrybutu jednowartościowego.

Zwróć uwagę, że ta operacja jest dostępna dopiero od wersji 6.2.

Składnia funkcji:

• [name_out_attribute_monovalue] = nazwa atrybutu, który ma zostać dostarczony jako wynik.
• [Expression] = [separator];[name_attribute_multivalues]
  • [separator]: separator musi być pojedynczym znakiem i nie może być ";", ponieważ ten znak jest używany w pliku konfiguracyjnym konektora.
  • [name_attribute_multivalues]: nazwa atrybutu wielowartościowego, którego wartości mają zostać połączone.

Sposób użycia:

Operacja MERGE może być używana w regułach synchronizacji i tylko w operacjach CONVERT.

Przykład następującej konfiguracji:

• Przy atrybucie "wiki_mod_1" o wartości:
  • Droit_001
  • Droit_002
  • Droit_003
• Wynik: w pliku sync.xml atrybut "lst_right" będzie mieć następującą wartość:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Operacja umożliwiająca zmianę wartości atrybutu. Atrybut musi istnieć i być jednowartościowy. Początkowa wartość atrybutu jest nadpisywana i nie może być już ponownie użyta.

Uwaga

Ta operacja zastępuje operację CHANGE, przestarzałą od wersji 7.1 i usuniętą w wersji 7.2.

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nazwa atrybutu, który ma zostać zmodyfikowany. Jeśli atrybut nie istnieje, operacja nie zadziała.
• [Expression]: formuła do wprowadzenia. Można używać słów kluczowych albo wprowadzić w całości lub częściowo wartości stałe (tekst zapisany na stałe). Składnię właściwą dla Twojego przypadku użycia znajdziesz w rozdziale „Lista słów kluczowych”.

Przykład następującej konfiguracji:

MULTCOPY

Kopiowanie atrybutów ze źródła

Operacja kopiująca wartości atrybutów z eksportu źródłowego do atrybutów w pliku DELTA. Działa dla atrybutów jednowartościowych .

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute name to copy]: nazwa atrybutu, który musi znajdować się w eksporcie źródłowym. Atrybut musi istnieć.
• [Target attribute name]: atrybut musi istnieć. Nazwa atrybutu, który musi znajdować się w eksporcie docelowym i który będzie umieszczony w pliku DELTA.

Operacja musi być wykonana tyle razy, ile jest to konieczne.

Przykład następującej konfiguracji:

MULTDSTCOPY

Operacja kopiująca wartości atrybutów znalezione w eksporcie docelowym do atrybutów w pliku DELTA. Działa dla atrybutów jednowartościowych . Jest zazwyczaj używana do przenoszenia wartości z repozytorium docelowego, które są nieznane w repozytorium źródłowym, często w przypadku usunięcia (już nieznane w źródle, ale nadal obecne w miejscu docelowym).

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute name to copy]: nazwa atrybutu, który musi znajdować się w eksporcie docelowym. Atrybut musi istnieć.
• [Target attribute name]: nazwa atrybutu docelowego, który musi znajdować się w pliku DELTA.

Operacja musi być wykonana tyle razy, ile jest to konieczne.

Przykład następującej konfiguracji:

MULTIEVALEQ

Operacja porównująca kilka atrybutów wielowartościowych.

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Source attribute name]: nazwa atrybutu do porównania, obecnego w eksporcie źródłowym.
• [Destination attribute name]: nazwa atrybutu do porównania, obecnego w eksporcie docelowym.

Operacja musi być wykonana tyle razy, ile jest to konieczne. Obiekty są parowane, jeśli wszystkie atrybuty są równe.

Przykład następującej konfiguracji:

MULTSET

Operacja umożliwiająca tworzenie kopii atrybutów wielowartościowych z możliwością dodania prefiksu.

Składnia funkcji:

• [Nom_attribut_dest] = nazwa atrybutu, który ma zostać dostarczony jako wynik. Atrybut nie musi istnieć wcześniej.
• [Nom_attribut_src] = nazwa atrybutu, którego wartości zostaną skopiowane. Uwaga: nie używaj słów kluczowych <syncattsrc> ani <syncattdst>.
• [prefixe] = łańcuch znaków dodawany przed każdą wartością atrybutu [Nom_attribut_src]. Prefiksem może być wartość atrybutu, przy użyciu słowa kluczowego >. Jeśli nie chcesz dodawać prefiksu, wystarczy podać <uid> w drugim parametrze oczekiwanego wyrażenia.

Sposób użycia:

Operacja MULTSET może być używana w regułach synchronizacji dla operacji CONVERT i MATCH (OnCreate, OnModify i OnDelete).

Przykład następującej konfiguracji:

• Przy atrybucie "postal_code" o wartości:
  • 68300
  • 68390
  • 38670
• Wynik: w pliku sync.xml atrybut "Code_postal_prefix" będzie mieć następujące wartości:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Operacja porównująca 2 atrybuty wielowartościowe.

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nazwa atrybutu do porównania, obecnego w eksporcie docelowym.
• [Attribute Name]: nazwa atrybutu do porównania, obecnego w eksporcie źródłowym.

Przykład następującej konfiguracji:

RENAME

Operacja zmieniająca nazwę atrybutu.

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nowa nazwa atrybutu.
• [Expression]: nazwa atrybutu, którego nazwa ma zostać zmieniona.

Przykład następującej konfiguracji:

SET

Operacja umożliwiająca przypisanie wartości do atrybutu — wyłącznie jednowartościowego — niezależnie od tego, czy istnieje, czy nie.

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Attribute]: nazwa atrybutu, do którego ma zostać przypisana wartość. Jeśli atrybut istnieje, jego początkowa wartość zostanie nadpisana; jeśli atrybut nie istnieje, zostanie utworzony.
• [Expression]: formuła do wprowadzenia. Można używać słów kluczowych albo wprowadzić w całości lub częściowo wartości stałe (tekst zapisany na stałe). Składnię właściwą dla Twojego przypadku użycia znajdziesz w rozdziale „Lista słów kluczowych”.

Przykład następującej konfiguracji:

SIMPLEEQ

Operacja porównująca kilka atrybutów jednowartościowych.

Składnia funkcji:

• [Description]: dowolny tekst opisujący operację (opcjonalnie).
• [Source attribute name]: nazwa atrybutu do porównania, obecnego w eksporcie źródłowym.
• [Destination attribute name]: nazwa atrybutu do porównania, obecnego w eksporcie docelowym.

Operacja musi być wykonana tyle razy, ile jest to konieczne. Obiekty są parowane, jeśli wszystkie atrybuty są równe.

Przykład następującej konfiguracji:

SPLIT

Operacja służąca do rozdzielenia wartości atrybutu jednowartościowego przy użyciu separatora i przypisania wyniku do atrybutu wielowartościowego.

Zwróć uwagę, że ta operacja jest dostępna dopiero od wersji 6.2.

Składnia funkcji:

• [name_out_attribute_multivalues] = nazwa atrybutu, który ma zostać dostarczony jako wynik.
• [Expression] = [separator];[name_attribute_monovalue]
  • [separator]: separator musi być pojedynczym znakiem i nie może być ";", ponieważ ten znak jest używany w pliku konfiguracyjnym konektora.
  • [name_attribute_multivalues]: nazwa atrybutu wielowartościowego, którego wartości mają zostać połączone.

Możliwe wyniki:

• Jeśli separator zostanie znaleziony co najmniej raz: zwraca listę wartości
• Jeśli separator nie zostanie znaleziony: zwraca cały łańcuch znaków

Możliwe wyniki:

Operacja SPLIT może być używana w regułach synchronizacji i tylko w operacjach CONVERT.

Przykład następującej konfiguracji:

• Przy atrybucie "string_rights" o wartości:
  • Droit_001#Droit_002#Droit_003
• Wynik: w pliku sync.xml atrybut „lst_right_multi” będzie mieć następującą wartość:
  • Droit_001
  • Droit_002
  • Droit_003