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
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.

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:

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.

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 zgłaszania wartości z repozytorium docelowego, które są nieznane w repozytorium źródłowym, często w przypadku usunięcia (nieznane już w źródle, ale nadal obecne w celu).

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