Elenco delle operazioni disponibili secondo le regole di sincronizzazione

	Conversione	corrispondenza regole	Confronto	Creazione	Modifica	Sborra
ADDVALUE	X			X	X	X
CHANGE	X			X	X	X
COMPAREATTNAME ComparareATTNAME			X
CONTRARO			X
CONVERT	X
Copia	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
- E' un'altra cosa.	X
GROUPAR	X
SONO CONTENUTI			X
MERGE	X
VALORE MODALE	X			X	X	X
MULTCOPIA				X	X	X
MULTDSTCOPY				X	X	X
MULTIEVALEQ		X
MULTSET	X			X	X	X
MVEQ			X
RINOMI	X
SET	X			X	X	X
SIMPLEEQ		X
SPLIT	X

Opzioni disponibili per ogni operazione:

	B64	CI	DATE	DATE_FILETIME	DN	PARZIALE	PWD	USEMAP
ADDVALUE	X		X	X			X
CHANGE	X		X	X			X
COMPAREATTNAME ComparareATTNAME		X			X
CONTENUTI		X			X
CONVERT	X		X	X			X
Copia	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
- E' un'altra cosa.	X		X	X			X
GROUPAR	X		X	X			X
SONO CONTENUTI		X			X
MERGE	X		X	X			X
VALORE MODALE	X		X	X			X
MULTCOPIA	X		X	X			X
MULTDSTCOPY	X		X	X			X
MULTIEVALEQ		X				X		X
MULTSET	X		X	X			X
MVEQ		X			X
RINOMI	X		X	X			X
SET	X		X	X			X
SIMPLEEQ**		X			X			X
SPLIT	X		X	X			X

**: I filtri variano a seconda della regola che utilizza l'operazione.

• B64: converte il valore dell'attributo in formato Base 64.
• CI: caso insensibile: il confronto viene effettuato indipendentemente dal caso.
• DATE: converte il valore dell'attributo in formato DATE.
• DATE_FILETIME: converte il valore dell'attributo in formato DATETIME.
• DN: confronto DN.
• PARTIAL: confronta parzialmente i dati. Ritorna true se almeno un valore è contenuto nell'attributo di confronto.
• PWD: Consente la crittografia dei dati.
• USEMAP: utilizzo di una mappa per trovare l'attributo, accelera il processo di confronto.

ADDVALUE

Operazione che consente di aggiungere valori ad un attributo che, per definizione, può essere multivalutato. Consente anche la concatenazione di valori da più attributi.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo da modificare. Se l'attributo non esiste, verrà creato automaticamente.
• [Espressione]: formula da inserire. È possibile utilizzare parole chiave o inserire tutti o parte di valori fissi (testo codificato). Si rimanda al capitolo "Lista di parole chiave" per la sintassi da applicare nel caso di utilizzo.

Esempio della seguente configurazione:

CHANGE

Operazione che consente di modificare il valore di un attributo. L'attributo deve esistere e avere un solo valore. Il valore iniziale dell'attributo viene sovrascritto e non può più essere riutilizzato.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo da modificare. Se l'attributo non esiste, l'operazione non funzionerà.
• [Espressione]: formula da inserire. È possibile utilizzare parole chiave o inserire tutti o parte di valori fissi (testo codificato). Si rimanda al capitolo "Lista di parole chiave" per la sintassi da applicare nel caso di utilizzo.

Esempio della seguente configurazione:

COMPAREATTNAME ## ComparareATTNAME

Operazione che consente di elencare gli attributi che non devono essere confrontati e di confrontare tutti gli altri attributi che hanno lo stesso nome in entrambi i repository. I nomi degli attributi nel repository di origine che non hanno una controparte nel repository di destinazione saranno ignorati e non confrontati. Può essere utilizzato per sostituire la mappatura unitaria degli attributi da confrontare.

Si prega di notare che questa operazione è disponibile solo dalla versione 6.2 in poi e può essere utilizzata solo nelle regole OnCompare in un'operazione MATCH nei connettori di provisioning status (status) provisioning.

Sintassi della funzione:

• [Attributo] = Elenco di attributi che non devono essere confrontati. Gli attributi devono essere separati da virgole e senza spazi.

Esempio della seguente configurazione:

CONTENUTI

Operazione che esegue un confronto per verificare che i valori dell'attributo sorgente autorevole siano presenti nell'attributo sorgente di destinazione. Il risultato dell'operazione sarà la concatenazione dei valori dell'attributo sorgente di destinazione con i valori dell'attributo sorgente autorevole che non sono stati trovati.

**Esempio **

Valori dell'attributo_fonte_autorevole =

• Val_1
• Val_2
• Val_3

Valori dell'attributo =

• Val_4
• Val_5
• Val_6

Risultato nell'attributo sorgente di destinazione =

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

In questa operazione non possono essere utilizzate parole chiave.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo presente nella sorgente di destinazione su cui si intende effettuare il confronto.
• [Nome dell'attributo]: nome dell'attributo presente nella fonte autorevole su cui si intende effettuare il confronto.

Esempio della seguente configurazione:

CONVERT

Copia

Operazione che consente di copiare il valore di un attributo su un altro attributo. Funziona per gli attributi a valore singolo e a valore multiplo.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo da modificare. L'attributo deve esistere.
• [Nome dell'attributo]: nome dell'attributo sorgente il cui valore sarà copiato.

Esempio della seguente configurazione:

L'attributo usual_name assume il valore dell'attributo birth_name.

DELETE

Operazione che consente di eliminare un attributo in una sorgente specificata (sorgente di esportazione, destinazione di esportazione o DELTA).

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo da eliminare.
• [Espressione]: non compilare questo campo.

DELVALUE

Operazione che consente di eliminare valori da un attributo basato su un'espressione booleana: se l'espressione restituisce True, i valori vengono eliminati.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo da modificare.
• [Espressione]: formula da inserire. È possibile utilizzare parole chiave o inserire tutti o parte di valori fissi (testo codificato). Si rimanda al capitolo "Lista di parole chiave" per la sintassi da applicare nel caso di utilizzo.

Esempio della seguente configurazione:

Se l'attributo groups contiene il valore GRP_ACCES_COMMUN, esso verrà rimosso dall'elenco dei valori groups e l'elenco modificato dell'attributo groups verrà copiato nell'attributo memberof@.

DELVALUEBYVALUE

Operazione che consente di eliminare valori da un attributo basato su un determinato elenco.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo da modificare.
• [Espressione]: Valori da inserire, separati da ;. È possibile utilizzare parole chiave o inserire tutti o parte di valori fissi (testo codificato).

Esempio della seguente configurazione:

I valori dell'attributo groups_admin e il valore GRP_ACCES_COMMUN vengono rimossi dall'elenco dei valori contenuti in memberof@.

DSTCOPY

Operazione che copia il valore di un attributo trovato nell'esportazione di destinazione in un altro attributo nel file DELTA. Funziona per gli attributi a valore singolo e a valore multiplo. È generalmente utilizzato per trasferire valori dal repository di destinazione che sono sconosciuti nel repository di origine, spesso in caso di cancellazione (non conosciuto nella fonte ma ancora presente nel target).

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo di destinazione.
• [Nome dell'attributo]: nome dell'attributo sorgente il cui valore sarà copiato.

Esempio della seguente configurazione:

EQ

Operazione che confronta due attributi a valore singolo.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo da confrontare, presente nell'esportazione di origine.
• [Espressione]: formula da inserire. È possibile utilizzare parole chiave o inserire tutti o parte di valori fissi (testo codificato). Si rimanda al capitolo "Lista di parole chiave" per la sintassi da applicare nel caso di utilizzo.

Esempio della seguente configurazione la:

- E' un'altra cosa.

Consente di recuperare l'elenco delle strutture figlio nell'attributo Destination_attribute_name di una data struttura in Parent_structure_attribute_name. Questa operazione può essere eseguita solo sui dati del repository Identity (ad esempio, su un'esportazione di identità che ha un attributo di tipo struttura).

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo di destinazione che riceverà l'elenco delle strutture figlio.
• [Espressione]: Nome dell'attributo della struttura madre senza parole chiave.

Esempio della seguente configurazione:

Restituisce tutte le strutture figlio della struttura con il codice Sito.

• GROUPAR

Permette di raggruppare in un attributo unico la lista di abilitazioni di tipo « gruppo » corrispondente a un référentiel.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo di destinazione.
• [Espressione] : « REF: » Il codice di riferimento non può riunire tutte le abilitazioni in un unico attributo.

Esempio di configurazione:

Riunire tutte le abilitazioni del référentiel AD in un attributo « groupes ».-->

SONO CONTENUTI

Operazione che confronta un attributo multivalore nella fonte autorevole con un attributo multivalore nella fonte di destinazione al fine di estrarre solo l'elenco dei valori presenti in entrambi gli attributi.

Esempio:

Valori dell'attributo_fonte_autorevole =

• Val_1
• Val_2
• Val_3
• Val_4

Valori dell'attributo =

• Val_3
• Val_4
• Val_5

Risultato nell'attributo sorgente di destinazione =

• Val_3
• Val_4

In questa operazione non possono essere utilizzate parole chiave.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo presente nella sorgente di destinazione su cui si intende effettuare il confronto.
• [Nome dell'attributo]: nome dell'attributo presente nella fonte autorevole su cui si intende effettuare il confronto.

Esempio della seguente configurazione:

MERGE

Operazione che consente di creare una concatenazione di valori da un attributo a valori multipli e di assegnarlo a un attributo a valori singoli.

Si prega di notare che questa operazione è disponibile solo dalla versione 6.2 in poi.

Sintassi della funzione:

• [name_out_attribute_monovalue] = Nome dell'attributo da fornire come output.
• [Espressione] = [separatore];[nome_attributo_multivalori]
  • [separatore]: il separatore deve essere un singolo carattere e non può essere ";", poiché questo carattere è utilizzato nel file di configurazione del connettore.
  • [nome_attributo_multivalues]: Nome dell'attributo multivalore i cui valori devono essere concatenati.

Modo di utilizzo:

L'operazione MERGE può essere utilizzata nelle regole di sincronizzazione e solo nelle operazioni CONVERT.

Esempio della seguente configurazione:

• Con l'attributo "wiki_mod_1" uguale a:
  • Droit_001
  • Droit_002
  • Droit_003
• Resultato: nel file sync.xml, l'attributo "lst_right" avrà il seguente valore:

  • Diritto 002 # Diritto 003

VALORE MODALE

Operazione che consente di modificare il valore di un attributo. L'attributo deve esistere e avere un solo valore. Il valore iniziale dell'attributo viene sovrascritto e non può più essere riutilizzato.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo da modificare. Se l'attributo non esiste, l'operazione non funzionerà.
• [Espressione]: formula da inserire. È possibile utilizzare parole chiave o inserire tutti o parte di valori fissi (testo codificato). Si rimanda al capitolo "Lista di parole chiave" per la sintassi da applicare nel caso di utilizzo.

Esempio della seguente configurazione:

MULTCOPIA

Copia gli attributi dall'origine

Operazione che copia i valori degli attributi dall'esportazione di origine agli attributi nel file DELTA. Funziona per gli attributi a valore singolo .

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Nome dell'attributo da copiare]: Nome dell'attributo che deve essere nell'esportazione di origine.
• [Nome dell'attributo target]: L'attributo deve esistere. Nome dell'attributo che deve essere incluso nell'esportazione target, che si trova nel file DELTA.

L'operazione deve essere eseguita tutte le volte che è necessario.

Esempio della seguente configurazione:

MULTDSTCOPY

Operazione che copia i valori di attributi trovati nell'esportazione di destinazione agli attributi nel file DELTA. Funziona per gli attributi a valore singolo . È generalmente utilizzato per segnalare valori dal repository di destinazione che sono sconosciuti nel repository di origine, spesso in caso di cancellazione (non più noti nella fonte ma ancora presenti nel target).

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Nome dell'attributo da copiare]: Nome dell'attributo che deve essere incluso nell'esportazione di destinazione.
• [Nome dell'attributo di destinazione]: Nome dell'attributo di destinazione che deve essere trovato nel file DELTA.

L'operazione deve essere eseguita tutte le volte che è necessario.

Esempio della seguente configurazione:

MULTIEVALEQ

Operazione che confronta più attributi multivalori.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Nome dell'attributo sorgente]: nome dell'attributo da confrontare, presente nell'esportazione sorgente.
• [Nome dell'attributo di destinazione]: nome dell'attributo da confrontare, presente nell'esportazione di destinazione.

L'operazione deve essere eseguita quante volte necessario.

Esempio della seguente configurazione:

MULTSET

Operazione che consente di fare copie di attributi a valori multipli con l'opzione di aggiungere un prefisso.

Sintassi della funzione:

• [Nom_attribu_dest] = Nome dell'attributo da fornire come output. L'attributo non deve essere già esistito.
• [Nom_attribu_src] = Nome dell'attributo i cui valori verranno copiati. Attenzione, non utilizzare le parole chiave <syncattsrc> o <syncattdst>.
• [prefisso] = String da aggiungere prima di ogni valore dell'attributo [Nom_attribu_src]. Il prefisso può essere il valore di un attributo usando la parola chiave >. Se non si desidera aggiungere un prefisso, è sufficiente specificare <uid> nel secondo parametro dell'espressione attesa.

Modo di utilizzo:

L'operazione MULTSET può essere utilizzata nelle regole di sincronizzazione per le operazioni CONVERT e MATCH (OnCreate, OnModify e OnDelete).

Esempio della seguente configurazione:

• Con l'attributo "codice postale" pari a:
  • 68300
  • 68390
  • 38670
• Resultato: nel file sync.xml, l'attributo "Code_postal_prefix" avrà i seguenti valori:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Operazione che confronta 2 attributi multivalori.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo da confrontare, presente nell'esportazione di destinazione.
• [Nome dell'attributo]: nome dell'attributo da confrontare, presente nell'esportazione di origine.

Esempio della seguente configurazione:

RINOMI

Operazione che rinomina un attributo.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nuovo nome dell'attributo.
• [Espressione]: nome dell'attributo da rinominare.

Esempio della seguente configurazione:

SET

Operazione che consente di assegnare un valore ad un attributo, solo a valore singolo, che esista o meno.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Attributo]: nome dell'attributo al quale deve essere assegnato un valore. Se l'attributo esiste, il valore iniziale verrà sovrascritto; se l'attributo non esiste, verrà creato.
• [Espressione]: formula da inserire. È possibile utilizzare parole chiave o inserire tutti o parte di valori fissi (testo codificato). Si rimanda al capitolo "Lista di parole chiave" per la sintassi da applicare nel caso di utilizzo.

Esempio della seguente configurazione:

SIMPLEEQ

Operazione che confronta diversi attributi a valore singolo.

Sintassi della funzione:

• [Descrizione]: testo libero per descrivere l'operazione (facoltativo).
• [Nome dell'attributo sorgente]: nome dell'attributo da confrontare, presente nell'esportazione sorgente.
• [Nome dell'attributo di destinazione]: nome dell'attributo da confrontare, presente nell'esportazione di destinazione.

L'operazione deve essere eseguita quante volte necessario.

Esempio della seguente configurazione:

SPLIT

Operazione utilizzata per creare una separazione dei valori da un attributo monovalente e da un separatore, quindi assegnarlo a un attributo multivalente.

Si prega di notare che questa operazione è disponibile solo dalla versione 6.2 in poi.

Sintassi della funzione:

• [name_out_attribute_multivalues] = Nome dell'attributo da fornire come output.
• [Espressione] = [separatore];[nome_attributo_monovalore]
  • [separatore]: il separatore deve essere un singolo carattere e non può essere ";", poiché questo carattere è utilizzato nel file di configurazione del connettore.
  • [nome_attributo_multivalues]: Nome dell'attributo multivalore i cui valori devono essere concatenati.

Risultati possibili:

• Se il separatore è trovato almeno una volta: restituisce un elenco di valori
• Se il separatore non è trovato: restituisce la stringa completa

Risultati possibili:

L'operazione SPLIT può essere utilizzata nelle regole di sincronizzazione e solo nelle operazioni CONVERT.

Esempio della seguente configurazione:

• Con l'attributo "string_rights" uguale a:

  • Diritto 002 # Diritto 003

• Resultato: nel file sync.xml, l'attributo lst_right_multi avrà il seguente valore:
  • Droit_001
  • Droit_002
  • Droit_003