Elenco delle operazioni disponibili per regola di sincronizzazione¶
| Conversione |
Regole di corrispondenza |
Confronto | Creazione | Modifica | Eliminazione | |
|---|---|---|---|---|---|---|
| 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 |
Opzioni disponibili per ogni operazione:
| 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 |
**: I filtri variano in funzione della regola che utilizza l'operazione.
- B64: converte il valore dell'attributo nel formato Base 64.
- CI: Case insensitive: il confronto viene eseguito senza tenere conto delle maiuscole e delle minuscole.
- DATE: converte il valore dell'attributo nel formato DATE.
- DATE_FILETIME: converte il valore dell'attributo nel formato DATETIME.
- DN: confronto dei DN.
- PARTIAL: confronta parzialmente i dati. Restituisce true se almeno un valore è contenuto nell'attributo di confronto.
- PWD: abilita la cifratura dei dati.
- USEMAP: utilizzo di una map per trovare l'attributo, accelera il processo di confronto.
ADDVALUE¶
Operazione che permette di aggiungere valori a un attributo che, per definizione, può essere multivalore. Permette inoltre la concatenazione di valori provenienti da più attributi.
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nome dell'attributo da modificare. Se l'attributo non esiste, verrà creato automaticamente.
- [Expression]: formula da immettere. È possibile utilizzare parole chiave oppure immettere in tutto o in parte valori fissi (testo codificato). Per la sintassi da applicare al proprio caso d'uso, consultare il capitolo «Elenco delle parole chiave».
Esempio della configurazione seguente:
CHANGE¶
Operazione che permette di modificare il valore di un attributo. L'attributo deve esistere ed essere monovalore. Il valore iniziale dell'attributo viene sovrascritto e non può più essere riutilizzato.
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nome dell'attributo da modificare. Se l'attributo non esiste, l'operazione non funzionerà.
- [Expression]: formula da immettere. È possibile utilizzare parole chiave oppure immettere in tutto o in parte valori fissi (testo codificato). Per la sintassi da applicare al proprio caso d'uso, consultare il capitolo «Elenco delle parole chiave».
Esempio della configurazione seguente:
COMPAREATTNAME¶
Operazione che permette di elencare gli attributi che non devono essere confrontati e di confrontare tutti gli altri attributi che hanno lo stesso nome nei due repository. I nomi degli attributi del repository di origine che non hanno un corrispondente nel repository di destinazione vengono ignorati e non confrontati. Può essere utilizzata per sostituire la mappatura unitaria degli attributi da confrontare.
Si noti che questa operazione è disponibile solo a partire dalla versione 6.2 e può essere utilizzata soltanto nelle regole OnCompare all'interno di un'operazione MATCH, nei connettori di provisioning di tipo stato di provisioning (status).
Sintassi della funzione:
- [Attribute] = elenco degli attributi da non confrontare. Gli attributi devono essere separati da virgole e senza spazi.
Esempio della configurazione seguente:
CONTAIN¶
Operazione che esegue un confronto per verificare che i valori dell'attributo della fonte autorevole siano presenti nell'attributo della fonte di destinazione. Il risultato dell'operazione sarà la concatenazione dei valori dell'attributo della fonte di destinazione con i valori dell'attributo della fonte autorevole che non sono stati trovati.
Esempio
Authoritative_source_attribute_values =
- Val_1
- Val_2
- Val_3
Source_target_attribute_values =
- Val_4
- Val_5
- Val_6
Risultato nell'attributo della fonte di destinazione =
- Val_1
- Val_2
- Val_3
- Val_4
- Val_5
- Val_6
In questa operazione non è possibile utilizzare parole chiave.
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nome dell'attributo presente nella fonte di destinazione sul quale eseguire il confronto.
- [Attribute Name]: nome dell'attributo presente nella fonte autorevole sul quale eseguire il confronto.
Esempio della configurazione seguente:
CONVERT¶
COPY¶
Operazione che permette di copiare il valore di un attributo in un altro attributo. Funziona per gli attributi monovalore e multivalore.
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nome dell'attributo da modificare. L'attributo deve esistere.
- [Attribute Name]: nome dell'attributo di origine il cui valore verrà copiato.
Esempio della configurazione seguente:
L'attributo «usual_name» assumerà il valore dell'attributo «birth_name».
DELETE¶
Operazione che permette di eliminare un attributo in una fonte specificata (fonte di esportazione, destinazione di esportazione o DELTA).
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nome dell'attributo da eliminare.
- [Expression]: non compilare questo campo.
DELVALUE¶
Operazione che permette di eliminare valori da un attributo in base a un'espressione booleana: se l'espressione restituisce «True», i valori vengono eliminati. Si applica quindi generalmente agli attributi multivalore.
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nome dell'attributo da modificare.
- [Expression]: formula da immettere. È possibile utilizzare parole chiave oppure immettere in tutto o in parte valori fissi (testo codificato). Per la sintassi da applicare al proprio caso d'uso, consultare il capitolo «Elenco delle parole chiave».
Esempio della configurazione seguente:
Se l'attributo «groups» contiene il valore «GRP_ACCES_COMMUN», questo verrà rimosso dall'elenco dei valori di «groups» e l'elenco modificato dell'attributo «groups» verrà copiato nell'attributo «memberof@».
DELVALUEBYVALUE¶
Operazione che permette di eliminare valori da un attributo in base a un elenco fornito. Si applica quindi generalmente agli attributi multivalore.
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nome dell'attributo da modificare.
- [Expression]: valori da immettere, separati da «;». È possibile utilizzare parole chiave oppure immettere in tutto o in parte valori fissi (testo codificato). Per la sintassi da applicare al proprio caso d'uso, consultare il capitolo «Elenco delle parole chiave».
Esempio della configurazione seguente:
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 del file DELTA. Funziona per gli attributi monovalore e multivalore. Viene generalmente utilizzata per trasferire valori dal repository di destinazione che non sono noti nel repository di origine, spesso nel caso di un'eliminazione (non noto nell'origine ma ancora presente nella destinazione).
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nome dell'attributo di destinazione.
- [Attribute Name]: nome dell'attributo di origine il cui valore verrà copiato.
Esempio della configurazione seguente:
EQ¶
Operazione che confronta due attributi monovalore.
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nome dell'attributo da confrontare, presente nell'esportazione di origine.
- [Expression]: formula da immettere. È possibile utilizzare parole chiave oppure immettere in tutto o in parte valori fissi (testo codificato). Per la sintassi da applicare al proprio caso d'uso, consultare il capitolo «Elenco delle parole chiave».
Esempio della configurazione seguente:
GETSTRUCTCHILD¶
Permette di recuperare l'elenco delle strutture figlie nell'attributo «Destination_attribute_name» di una data struttura in «Parent_structure_attribute_name». Questa operazione può essere eseguita solo su dati provenienti dal repository Identity (per esempio su un'esportazione di identità che possiede un attributo di tipo struttura).
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nome dell'attributo di destinazione che riceverà l'elenco delle strutture figlie.
- [Expression]: nome dell'attributo della struttura padre, senza parole chiave.
Esempio della configurazione seguente:
Restituisce tutte le strutture figlie della struttura con il codice «Site».
ISCONTAINED¶
Operazione che confronta un attributo multivalore della fonte autorevole con un attributo multivalore della fonte di destinazione al fine di estrarre solo l'elenco dei valori presenti in entrambi gli attributi.
Esempio:
Authoritative_source_attribute_values =
- Val_1
- Val_2
- Val_3
- Val_4
Source_target_attribute_values =
- Val_3
- Val_4
- Val_5
Risultato nell'attributo della fonte di destinazione =
- Val_3
- Val_4
In questa operazione non è possibile utilizzare parole chiave.
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nome dell'attributo presente nella fonte di destinazione sul quale eseguire il confronto.
- [Attribute Name]: nome dell'attributo presente nella fonte autorevole sul quale eseguire il confronto.
Esempio della configurazione seguente:
MERGE¶
Operazione che permette di creare una concatenazione di valori a partire da un attributo multivalore e di assegnarla a un attributo monovalore.
Si noti che questa operazione è disponibile solo a partire dalla versione 6.2.
Sintassi della funzione:
- [name_out_attribute_monovalue] = nome dell'attributo da fornire come output.
- [Expression] = [separator];[name_attribute_multivalues]
- [separator]: il separatore deve essere un carattere singolo e non può essere ";", poiché questo carattere è utilizzato nel file di configurazione del connettore.
- [name_attribute_multivalues]: nome dell'attributo multivalore i cui valori devono essere concatenati.
Modalità d'uso:
L'operazione MERGE può essere utilizzata nelle regole di sincronizzazione e solo nelle operazioni CONVERT.
Esempio della configurazione seguente:
- Con l'attributo "wiki_mod_1" uguale a:
- Droit_001
- Droit_002
- Droit_003
- Risultato: nel file sync.xml l'attributo "lst_right" avrà il valore seguente:
- Droit_001#Droit_002#Droit_003
MODVALUE¶
Operazione che permette di modificare il valore di un attributo. L'attributo deve esistere ed essere monovalore. Il valore iniziale dell'attributo viene sovrascritto e non può più essere riutilizzato.
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nome dell'attributo da modificare. Se l'attributo non esiste, l'operazione non funzionerà.
- [Expression]: formula da immettere. È possibile utilizzare parole chiave oppure immettere in tutto o in parte valori fissi (testo codificato). Per la sintassi da applicare al proprio caso d'uso, consultare il capitolo «Elenco delle parole chiave».
Esempio della configurazione seguente:
MULTCOPY¶
Copiare gli attributi dall'origine
Operazione che copia i valori degli attributi dall'esportazione di origine in attributi del file DELTA. Funziona per gli attributi monovalore .
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute name to copy]: nome dell'attributo che deve essere presente nell'esportazione di origine. L'attributo deve esistere.
- [Target attribute name]: l'attributo deve esistere. Nome dell'attributo che deve essere incluso nell'esportazione di destinazione e che si troverà nel file DELTA.
L'operazione deve essere eseguita tutte le volte che è necessario.
Esempio della configurazione seguente:
MULTDSTCOPY¶
Operazione che copia i valori degli attributi trovati nell'esportazione di destinazione in attributi del file DELTA. Funziona per gli attributi monovalore . Viene generalmente utilizzata per riportare valori dal repository di destinazione che non sono noti nel repository di origine, spesso nel caso di un'eliminazione (non più noto nell'origine ma ancora presente nella destinazione).
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute name to copy]: nome dell'attributo che deve essere incluso nell'esportazione di destinazione. L'attributo deve esistere.
- [Target attribute name]: nome dell'attributo di destinazione che deve trovarsi nel file DELTA.
L'operazione deve essere eseguita tutte le volte che è necessario.
Esempio della configurazione seguente:
MULTIEVALEQ¶
Operazione che confronta più attributi multivalore.
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Source attribute name]: nome dell'attributo da confrontare, presente nell'esportazione di origine.
- [Destination attribute name]: nome dell'attributo da confrontare, presente nell'esportazione di destinazione.
L'operazione deve essere eseguita tutte le volte che è necessario. Gli oggetti vengono associati se tutti gli attributi sono uguali.
Esempio della configurazione seguente:
MULTSET¶
Operazione che permette di realizzare copie di attributi multivalore con la possibilità di aggiungere un prefisso.
Sintassi della funzione:
- [Nom_attribut_dest] = nome dell'attributo da fornire come output. L'attributo non deve necessariamente esistere in precedenza.
- [Nom_attribut_src] = nome dell'attributo i cui valori verranno copiati. Attenzione: non utilizzare le parole chiave <syncattsrc> o <syncattdst>.
- [prefixe] = stringa da aggiungere prima di ogni valore dell'attributo [Nom_attribut_src]. Il prefisso può essere il valore di un attributo utilizzando la parola chiave
Modalità d'uso:
L'operazione MULTSET può essere utilizzata nelle regole di sincronizzazione per le operazioni CONVERT e MATCH (OnCreate, OnModify e OnDelete).
Esempio della configurazione seguente:
- Con l'attributo "postal_code" uguale a:
- 68300
- 68390
- 38670
- Risultato: nel file sync.xml l'attributo "Code_postal_prefix" avrà i valori seguenti:
- CP_68300
- CP_68390
- CP_38670
MVEQ¶
Operazione che confronta 2 attributi multivalore.
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nome dell'attributo da confrontare, presente nell'esportazione di destinazione.
- [Attribute Name]: nome dell'attributo da confrontare, presente nell'esportazione di origine.
Esempio della configurazione seguente:
RENAME¶
Operazione che rinomina un attributo.
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nuovo nome dell'attributo.
- [Expression]: nome dell'attributo da rinominare.
Esempio della configurazione seguente:
SET¶
Operazione che permette di assegnare un valore a un attributo, esclusivamente monovalore, indipendentemente dal fatto che esista o no.
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Attribute]: nome dell'attributo al quale assegnare un valore. Se l'attributo esiste, il valore iniziale verrà sovrascritto; se l'attributo non esiste, verrà creato.
- [Expression]: formula da immettere. È possibile utilizzare parole chiave oppure immettere in tutto o in parte valori fissi (testo codificato). Per la sintassi da applicare al proprio caso d'uso, consultare il capitolo «Elenco delle parole chiave».
Esempio della configurazione seguente:
SIMPLEEQ¶
Operazione che confronta più attributi monovalore.
Sintassi della funzione:
- [Description]: testo libero per descrivere l'operazione (facoltativo).
- [Source attribute name]: nome dell'attributo da confrontare, presente nell'esportazione di origine.
- [Destination attribute name]: nome dell'attributo da confrontare, presente nell'esportazione di destinazione.
L'operazione deve essere eseguita tutte le volte che è necessario. Gli oggetti vengono associati se tutti gli attributi sono uguali.
Esempio della configurazione seguente:
SPLIT¶
Operazione utilizzata per creare una separazione dei valori a partire da un attributo monovalore e da un separatore, per poi assegnarla a un attributo multivalore.
Si noti che questa operazione è disponibile solo a partire dalla versione 6.2.
Sintassi della funzione:
- [name_out_attribute_multivalues] = nome dell'attributo da fornire come output.
- [Expression] = [separator];[name_attribute_monovalue]
- [separator]: il separatore deve essere un carattere singolo e non può essere ";", poiché questo carattere è utilizzato nel file di configurazione del connettore.
- [name_attribute_multivalues]: nome dell'attributo multivalore i cui valori devono essere concatenati.
Risultati possibili:
- Se il separatore viene trovato almeno una volta: restituisce un elenco di valori
- Se il separatore non viene trovato: restituisce la stringa completa
Risultati possibili:
L'operazione SPLIT può essere utilizzata nelle regole di sincronizzazione e solo nelle operazioni CONVERT.
Esempio della configurazione seguente:
- Con l'attributo "string_rights" uguale a:
- Droit_001#Droit_002#Droit_003
- Risultato: nel file sync.xml l'attributo «lst_right_multi» avrà il valore seguente:
- Droit_001
- Droit_002
- Droit_003