> Source: https://docs.cyberelements.io/identity/7.0/it/UserDocumentation/AutomaticProvisioningConnectorsManagement/KeywordsInOperations/TestsAndComparisons/

# Test e confronti

## CMP

Funzione che confronta due stringhe di caratteri tenendo conto delle maiuscole e delle minuscole.

**Sintassi della funzione:**

<CMP:[chaîne_caractère_1]:[chaîne_caractère_2]>

Le stringhe di caratteri possono essere un attributo; in tal caso occorre utilizzare la parola chiave <syncattsrc:[attribute_name]> o <syncattdst:[attribute_name]> a seconda che l'operazione riguardi il repository di origine o quello di destinazione.

**Modalità d'uso:**

- La parola chiave CMP può essere utilizzata in tutti i campi di tipo «expression», come le operazioni di tipo COPY, MODVALUE, ecc.
- Viene generalmente combinata con le parole chiave IF o SWITCH.

**Risultati possibili:**

- True: se le due stringhe di caratteri sono identiche.
- False: se le due stringhe di caratteri sono diverse.

**Esempi di configurazione:**

- Esempio:
    - <IF:<CMP:<SyncAttSrc:STATUT>:Done>:OK:KO>

## CMPi

Funzione che confronta due stringhe di caratteri senza tenere conto delle maiuscole e delle minuscole.

**Sintassi della funzione:**

<CMP:[chaîne_caractère_1]:[chaîne_caractère_2]>

Le stringhe di caratteri possono essere un attributo; in tal caso occorre utilizzare la parola chiave <syncattsrc:[attribute_name]> o <syncattdst:[attribute_name]> a seconda che l'operazione riguardi il repository di origine o quello di destinazione.

**Modalità d'uso:**

- La parola chiave CMPi può essere utilizzata in tutti i campi di tipo «expression», come COPY, MODVALUE, ecc.
- Viene generalmente combinata con le parole chiave IF o SWITCH.

**Risultati possibili:**

- True: se le due stringhe di caratteri sono identiche.
- False: se le due stringhe di caratteri sono diverse.

**Esempi di configurazione:**

- Esempio: <IF:<CMP:<SyncAttSrc:STATUT>:Completed>:OK:KO>

## EXISTS

Funzione che permette di verificare la presenza di un attributo in un'esportazione.

**Sintassi della funzione:**

<EXISTS:[searched_attribute_name]:[DataSource]:[Operation]>

- [searched_attribute_name] = nome dell'attributo di cui deve essere verificata l'esistenza
- [DataSource] = SRC o DST. Permette di cercare la presenza dell'attributo nell'esportazione del repository di origine (=SRC) o in quella del repository di destinazione (=DST). Il parametro è facoltativo, salvo se viene indicata un'operazione. Se il parametro non è indicato, si applica per impostazione predefinita il valore SRC.
- [Operation] = ADD o DEL. Permette di verificare la presenza dell'attributo con una sotto-operazione ADD o DEL. Il parametro è facoltativo.

**Risultati possibili:**

Restituisce 1 se l'attributo viene trovato, altrimenti restituisce 0.

**Modalità d'uso:**

- La parola chiave EXISTS può essere utilizzata in tutti i campi di tipo «expression», come le operazioni COPY, MODVALUE, ecc., oppure nelle condizioni di esecuzione delle regole di importazione di un connettore di database.

**Esempi di configurazione:**

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_TestsComparaisonsEXISTS.png)

- Risultato: la query SQL verrà eseguita solo se l'attributo "wiki_mod_2" è presente nel repository di origine con una sotto-operazione ADD.

## NOT

Restituisce 1 se l'espressione è falsa, altrimenti 0.

**Sintassi della funzione:**

<NOT:[Expression]>

L'espressione può contenere altre parole chiave.

**Modalità d'uso:**

- La parola chiave NOT può essere utilizzata in tutti i campi di tipo «expression», come le operazioni di tipo COPY, MODVALUE, ecc.
- Le espressioni che restituiscono un valore booleano sono generalmente costruite combinando parole chiave come CMP, IF, ecc.

**Esempi di configurazione:**

- Esempio:
    - <IF:<NOT:<CMP:<SyncAttSrc:STATUS>:Completed>>:Echec:Success>
    - Restituisce «Success» se lo stato è uguale a «Completed»; in caso contrario restituisce "Failure" se lo stato non è «Completed».

## &NOT

Operazione binaria «NOT».

**Sintassi della funzione:**

<&NOT:[Expression]>

L'espressione può contenere altre parole chiave, ad esempio per recuperare il valore di un attributo.

**Modalità d'uso:**

- La parola chiave NOT può essere utilizzata in tutti i campi di tipo «expression», come le operazioni di tipo COPY, MODVALUE, ecc.
- Le espressioni che restituiscono un valore booleano sono generalmente costruite combinando parole chiave come CMP, IF, ecc.

**Risultati possibili:**

- Valore binario

**Esempi di configurazione:**

- Esempio:
    - <&NOT:<CMP:<SyncAttSrc:STATUS>:512>>:Disabled:Enabled>
    - Restituisce «Enabled» se lo stato è uguale a «Completed»; in caso contrario restituisce «Failed» se lo stato non è «Completed».

## AND

Restituisce 1 (vero) se l'espressione 1 e l'espressione 2 sono vere, altrimenti 0.

**Sintassi della funzione:**

<AND:[Expression_1]:[Expression_2]>

**Modalità d'uso:**

- La parola chiave AND può essere utilizzata in tutti i campi di tipo «expression», come le operazioni di tipo COPY, MODVALUE, ecc.
- Viene generalmente combinata con le parole chiave IF o SWITCH.

**Esempi di configurazione:**

- Esempio: <IF:<AND:<CMP:<SyncAttSrc:person_type>:Agent>:<CMP:<SyncAttSrc:job>:Accountant>>:Agent_comptable:External_accountant>

## ANDX

Restituisce 1 se tutte le espressioni dell'elenco sono vere, altrimenti 0.

**Sintassi della funzione:** <ANDX:[Expression_1]:[Expression_2]:[Expression_n] >

**Modalità d'uso:**

- La parola chiave ANDX può essere utilizzata in tutti i campi di tipo «expression», come le operazioni di tipo COPY, MODVALUE, ecc.
- Viene generalmente combinata con le parole chiave IF o SWITCH.

**Esempi di configurazione:**

- Esempio:

<IF:<ANDX:<CMP:<SyncAttSrc:person_type>:Agent>:<CMP:<SyncAttSrc:job>:Accountant>:<CMP:<SyncAttSrc:Is_Valid>:Yes>>:Agent_comptable:External_accountant>

## &AND

Operazione binaria «AND» tra due valori.

**Sintassi della funzione:**

<&AND:[decimal_value_1]:[decimal_value_2]>

**Modalità d'uso:**

- La parola chiave &AND può essere utilizzata in tutti i campi di tipo «expression», come le operazioni COPY, MODVALUE, ecc.
- Viene generalmente combinata con le parole chiave IF o SWITCH.

**Risultati:**

- Restituisce un valore decimale che corrisponde al risultato dell'operazione binaria «AND» tra i due valori confrontati.

**Esempi di configurazione:**

- Esempio:
- <&AND:7:11> darà come risultato = 3
- Dove 7 corrisponde al valore binario «111» e 11 al valore binario «1011»
- Il risultato dell'operazione binaria «AND» tra 111 e 1011 è pari a 11, ossia al valore decimale 3.

## OR

Restituisce 1 (vero) se l'espressione 1 o l'espressione 2 sono vere, altrimenti 0.

**Sintassi della funzione:**

<OR:[Expression_1]:[Expression_2]>

**Modalità d'uso:**

- La parola chiave OR può essere utilizzata in tutti i campi di tipo «expression», come le operazioni di tipo COPY, MODVALUE, ecc.
- Viene generalmente combinata con le parole chiave IF o SWITCH.

**Esempi di configurazione:**

- Esempio: <IF:<OR:<CMP:<SyncAttSrc:type_personne>:Agent>:<CMP:<SyncAttSrc:person_type >:Employee>>:Agent_comptable:External_accountant>

## ORX

Restituisce 1 se una delle espressioni dell'elenco è vera, altrimenti 0.

**Sintassi della funzione:**

<ORX:[Expression_1]:[Expression_2]:[Expression_n] >

**Modalità d'uso:**

- La parola chiave ORX può essere utilizzata in tutti i campi di tipo «expression», come le operazioni di tipo COPY, MODVALUE, ecc.
- Viene generalmente combinata con le parole chiave IF o SWITCH.

**Esempi di configurazione:**

- Esempio: <IF:<ORX:<CMP:<SyncAttSrc:person_type>:Agent>:<CMP:<SyncAttSrc:person_type>:Employee>:<CMP:<SyncAttSrc:person_type>:Internal>>:Agent_interne:External_agent>

## &OR

Operazione binaria «OR» tra due valori.

**Sintassi della funzione:**

<&OR:[decimal_value_1]:[decimal_value_2]>

**Modalità d'uso:**

- La parola chiave &OR può essere utilizzata in tutti i campi di tipo «expression», come COPY, MODVALUE, ecc.
- Viene generalmente combinata con le parole chiave IF o SWITCH.

**Risultati:**

- Restituisce un valore decimale che corrisponde al risultato dell'operazione binaria «OR» tra i due valori confrontati.

**Esempi di configurazione:**

- Esempio:
- <&OR:7:11> darà come risultato = 15.
- Dove 7 corrisponde al valore binario «111» e 11 al valore binario «1011».
- Il risultato dell'operazione binaria «OR» tra 111 e 1011 è pari a 1111, ossia al valore decimale 15.

## SWITCH

Valuta l'espressione e la confronta poi con ciascun elemento dell'elenco. Se uno degli elementi dell'elenco corrisponde (tenendo conto delle maiuscole e delle minuscole), viene restituito il valore associato. Se nessun elemento dell'elenco corrisponde all'espressione ed è definito un elemento «default», viene restituito il valore associato a tale elemento.

**Sintassi della funzione:**

<SWITCH:[Expression]:[Searched_value_1],[Returned_value_1]:[Searched_value_2],[Returned_value_2]:[Searched_value_N],[Returned_value_N]:…:[default,value]>

**Modalità d'uso:**

- La parola chiave SWITCH può essere utilizzata in tutti i campi di tipo «expression», come le operazioni di tipo COPY, MODVALUE, ecc.
- L'espressione valutata può contenere parole chiave per recuperare valori di attributi, per esempio SyncAttSrc o SyncAttDst.

**Esempi di configurazione:**

- Esempio: <SWITCH:<SyncAttSrc:job_code>:DOC,Doctor:NUR,Nurse:HCA,Healthcare Assistant>

## SWITCHI

Identica a SWITCH, ma senza tenere conto delle maiuscole e delle minuscole. Valuta l'espressione e la confronta poi con ciascun elemento dell'elenco. Se uno degli elementi dell'elenco corrisponde (senza tenere conto delle maiuscole e delle minuscole), viene restituito il valore associato. Se nessun elemento dell'elenco corrisponde all'espressione ed è definito un elemento «default», viene restituito il valore associato a tale elemento.

**Sintassi della funzione:**

<SWITCHI:[Expression]:[Searched_value_1],[Returned_value_1]:[Searched_value_2],[Returned_value_2]:[Searched_value_N],[Returned_value_N]>

**Modalità d'uso:**

- La parola chiave SWITCHi può essere utilizzata in tutti i campi di tipo «expression», come le operazioni COPY, MODVALUE, ecc.
- L'espressione valutata può contenere parole chiave per recuperare valori di attributi, per esempio SyncAttSrc o SyncAttDst.

**Esempi di configurazione:**

- Esempio: <SWITCHi:<SyncAttSrc:job_code>:DOC,Doctor:NUR,Nurse:HCA,Healthcare Assistant>

## SWITCH_TABLE

Identica a SWITCHi, ma gli elementi dell'elenco, invece di essere indicati nell'espressione stessa, sono memorizzati in un file definito dal parametro. Valuta l'espressione e la confronta poi con ciascuno degli elementi dell'elenco contenuti nel file. Se uno degli elementi dell'elenco corrisponde (senza tenere conto delle maiuscole e delle minuscole), viene restituito il valore associato. Se nessun elemento dell'elenco corrisponde all'espressione ed è definito un elemento «default», viene restituito il valore associato a tale elemento.

**Sintassi della funzione:**

<SWITCH_TABLE:[Expression]:[file_path]>

Il formato del file è il seguente:

```
1
2
3
4
```

Gli elementi dell'elenco vengono letti nell'ordine fino a quando manca un numero.

**Modalità d'uso:**

- La parola chiave SWITCH_TABLE può essere utilizzata in tutti i campi di tipo «expression», come le operazioni di tipo COPY, MODVALUE, ecc.
- L'espressione valutata può contenere parole chiave per recuperare valori di attributi, per esempio SyncAttSrc o SyncAttDst.

**Esempi di configurazione:**

- Esempio:
- File:

  ```
  1
  2
  3
  4
  ```
- <SWITCH_TABLE:<SyncAttSrc:job_code>:C:\path\job.txt>

## IF

Valuta l'espressione. Se il risultato è vero (1), viene restituito il primo valore come risultato; in caso contrario viene restituito il secondo.

**Sintassi della funzione:**

<IF:[Expression]:[Result_if_true]:[Result_if_false]>

**Modalità d'uso:**

- La parola chiave IF può essere utilizzata in tutti i campi di tipo «expression», come le operazioni di tipo COPY, MODVALUE, ecc.
- L'espressione valutata può contenere parole chiave per recuperare valori di attributi, per esempio SyncAttSrc o SyncAttDst.

**Esempi di configurazione:**

- Esempio: <IF:<CMP:<SyncAttSrc:person_type>:Agent>:Agent_interne:External_Agent>
