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

# Tests et comparaisons

## CMP

Fonction qui compare 2 chaînes de caractères en tenant compte de la casse.

**Syntaxe de la fonction :**

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

Les chaînes de caractères peuvent être un attribut, dans ce cas il faudra utiliser le mot clé <syncattsrc:[nom_attribut]> ou <syncattdst:[nom_attribut]> selon que l’opération soit sur le référentiel source ou destination.

**Mode d'utilisation :**

- Le mot-clé CMP peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- Elle est généralement combinée avec les mots-clés IF ou SWITCH.

**Résultats possibles :**

- Vrai : si les 2 chaînes de caractères sont identiques.
- Faux : si les 2 chaînes de caractères sont différentes.

**Exemples de configuration :**

- Exemple :
    - <IF:<CMP:<SyncAttSrc:STATUT>:Terminé>:OK:KO>

## CMPi

Fonction qui compare 2 chaînes de caractères sans tenir compte de la casse.

**Syntaxe de la fonction :**

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

Les chaînes de caractères peuvent être un attribut, dans ce cas il faudra utiliser le mot clé <syncattsrc:[nom_attribut]> ou <syncattdst:[nom_attribut]> selon que l’opération soit sur le référentiel source ou destination.

**Mode d'utilisation :**

- Le mot-clé CMPi peut être utilisée dans tous les champs de type « expression » comme par exemple les opérations de type COPY, MODVALUE, etc.
- Elle est généralement combinée avec les mots-clés IF ou SWITCH.

**Résultats possibles :**

- Vrai : si les 2 chaînes de caractères sont identiques.
- Faux : si les 2 chaînes de caractères sont différentes.

**Exemples de configuration :**

- Exemple : <IF:<CMP:<SyncAttSrc:STATUT>:Terminé>:OK:KO>

## EXISTS

Fonction qui permet de tester la présence d’un attribut dans un export.

**Syntaxe de la fonction :**

<EXISTS:[nom_attribut_recherché]:[DataSource]:[Operation]>

- [nom_attribut_recherché] = Nom de l’attribut dont on veut tester l’existence
- [DataSource] = SRC ou DST. Permet de rechercher la présence de l’attribut soit l’export du référentiel source (=SRC), soit dans l’export du référentiel cible (=DST). Le paramètre est facultatif sauf si une opération est renseignée. Si le paramètre n’est pas renseigné, alors la valeur SRC est appliquée par défaut.
- [Operation] = ADD ou DEL. Permet de tester la présence de l’attribut avec une sous-opération ADD ou DEL. Le paramètre est facultatif.

**Résultats possibles :**

Renvoie 1 si l’attribut est trouvé, sinon renvoie 0.

**Mode d'utilisation :**

- Le mot-clé EXISTS peut être utilisé dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc ou dans les conditions d’exécution dans les règles d’import d’un connecteur BDD.

**Exemples de configuration :**

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

- Résultat : la requête SQL ne sera exécutée que si l’attribut « wiki_mod_2 » est présent dans le référentiel source avec une sous-opération ADD.

## NOT

Retourne 1 si l’expression est fausse et 0 sinon.

**Syntaxe de la fonction :**

<NOT:[Expression]>

L’expression peut contenir d’autres mots-clés.

**Mode d'utilisation :**

- Le mot-clé NOT peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression renvoyant un booléen est généralement construite à partir de combinaisons de mots-clés type CMP, IF, etc.

**Exemples de configuration :**

- Exemple :
    - <IF:<NOT:<CMP:<SyncAttSrc:STATUT>:Terminé>>:Echec:Succès>
    - Renvoie « Succès » si le statut est égal à « Terminé » sinon renvoie « Echec » si le statut est différent de « Terminé ».

## &NOT

Opération binaire ‘NOT’.

**Syntaxe de la fonction :**

<&NOT:[Expression]>

L’expression peut contenir d’autres mots-clés pour récupérer une valeur d’un attribut par exemple.

**Mode d'utilisation :**

- Le mot-clé NOT peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression renvoyant un booléen est généralement construite à partir de combinaisons de mots-clés type CMP, IF, etc.

**Résultats possibles :**

- Valeur binaire

**Exemples de configuration :**

- Exemple :
    - <&NOT:<CMP:<SyncAttSrc:STATUT>:512>>:Désactivé:Activé>
    - Renvoie « Activé » si le statut est égal à « Terminé » sinon renvoie « Echec » si le statut est différent de « Terminé ».

## AND

Renvoie 1 (vrai) si l’expression 1 et l’expression 2 sont vraies, 0 sinon.

**Syntaxe de la fonction :**

<AND:[Expression_1]:[Expression_2]>

**Mode d'utilisation :**

- Le mot-clé AND peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- Elle est généralement combinée avec les mots-clés IF ou SWITCH.

**Exemples de configuration :**

- Exemple : <IF:<AND:<CMP:<SyncAttSrc:type_personne>:Agent>:<CMP:<SyncAttSrc:metier>:Comptable>>:Agent_comptable:Externe_comptable>

## ANDX

Renvoie 1 si toutes les expressions de la liste sont vraies, 0 sinon.

**Syntaxe de la fonction :** <ANDX:[Expression_1]:[Expression_2]:[Expression_n] >

**Mode d'utilisation :**

- Le mot-clé ANDX peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- Elle est généralement combinée avec les mots-clés IF ou SWITCH.

**Exemples de configuration :**

- Exemple :

<IF:<ANDX:<CMP:<SyncAttSrc:type_personne>:Agent>:<CMP:<SyncAttSrc:metier>:Comptable>:<CMP:<SyncAttSrc:Is_Valid>:Oui>>:Agent_comptable:Externe_comptable>

## &AND

Opération binaire ‘AND’ entre 2 valeurs.

**Syntaxe de la fonction :**

<&AND:[valeur_décimale_1]:[valeur_décimale_2]>

**Mode d'utilisation :**

- Le mot-clé &AND peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- Elle est généralement combinée avec les mots-clés IF ou SWITCH.

**Résultats :**

- Renvoie une valeur décimale qui correspond au résultat de l’opération binaire ‘AND’ entre les 2 valeurs comparées.

**Exemples de configuration :**

- Exemple :
    - <&AND:7:11> aura pour résultat = 3
    - Avec 7 ayant une valeur binaire « 111 » et 11 ayant une valeur binaire « 1011 »
    - Résultat de l’opération binaire ‘AND’ entre 111 et 1011 est égal à 11 soit, la valeur décimale 3

## OR

Renvoie 1 (vrai) si l’expression 1 ou l’expression 2 sont vraies, 0 sinon.

**Syntaxe de la fonction :**

<OR:[Expression_1]:[Expression_2]>

**Mode d'utilisation :**

- Le mot-clé OR peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- Elle est généralement combinée avec les mots-clés IF ou SWITCH.

**Exemples de configuration :**

- Exemple : <IF:<OR:<CMP:<SyncAttSrc:type_personne>:Agent>:<CMP:<SyncAttSrc:type_personne >:Employe>>:Agent_comptable:Externe_comptable>

## ORX

Renvoie 1 si une des expressions de la liste est vraie, 0 sinon.

**Syntaxe de la fonction :**

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

**Mode d'utilisation :**

- Le mot-clé ORX peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- Elle est généralement combinée avec les mots-clés IF ou SWITCH.

**Exemples de configuration :**

- Exemple : <IF:<ORX:<CMP:<SyncAttSrc:type_personne>:Agent>:<CMP:<SyncAttSrc:type_personne>:Employe>:<CMP:<SyncAttSrc:type_personne>:Interne>>:Agent_interne:Agent_externe>

## &OR

Opération binaire ‘OR’ entre 2 valeurs.

**Syntaxe de la fonction :**

<&OR:[valeur_décimale_1]:[valeur_décimale_2]>

**Mode d'utilisation :**

- Le mot-clé &OR peut être utilisée dans tous les champs de type « expression » comme par exemple les opérations de type COPY, MODVALUE, etc.
- Elle est généralement combinée avec les mots-clés IF ou SWITCH.

**Résultats :**

- Renvoie une valeur décimale qui correspond au résultat de l’opération binaire ‘OR’ entre les 2 valeurs comparées.

**Exemples de configuration :**

- Exemple :
    - <&OR:7:11> aura pour résultat = 15.
    - Avec 7 ayant une valeur binaire « 111 » et 11 ayant une valeur binaire « 1011 ».
    - Résultat de l’opération binaire ‘OR’ entre 111 et 1011 est égal à 1111 soit, la valeur décimale 15.

## SWITCH

Évalue l’expression puis les compare à chacune des membres de la liste. Si un des membres de la liste correspond (sensible à la casse), la valeur associée est renvoyée. Si aucun membre de la liste ne correspond à l’expression et qu’un membre « default » est défini, c’est la valeur associée à ce membre qui est renvoyée.

**Syntaxe de la fonction :**

<SWITCH:[Expression]:[Val_cherchée_1],[Valeur_renvoyée_1]:[Val_cherchée_2],[Valeur_renvoyée_2]:[Val_cherchée_N],[Valeur_renvoyée_N]:…:[default,value]>

**Mode d'utilisation :**

- Le mot-clé SWITCH peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression évaluée peut contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

**Exemples de configuration :**

- Exemple : <SWITCH:<SyncAttSrc:code_metier>:MED,Médecin:INF,Infirmier:AID,Aide-Soignant>

## SWITCHI

Identique à SWITCH mais sans tenir compte de la casse. Évalue l’expression puis les compare à chacune des membres de la liste. Si un des membres de la liste correspond (non sensible à la casse), la valeur associée est renvoyée. Si aucun membre de la liste ne correspond à l’expression et qu’un membre « default » est défini, c’est la valeur associée à ce membre qui est renvoyée.

**Syntaxe de la fonction :**

<SWITCHi:[Expression]:[Val_cherchée_1],[Valeur_renvoyée_1]:[Val_cherchée_2],[Valeur_renvoyée_2]:[Val_cherchée_N],[Valeur_renvoyée_N]>

**Mode d'utilisation :**

- Le mot-clé SWITCHi peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression évaluée peut contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

**Exemples de configuration :**

- Exemple : <SWITCHi:<SyncAttSrc:code_metier>:MED,Médecin:INF,Infirmier:AID,Aide-Soignant>

## SWITCH_TABLE

Identique à SWITCHi, mais au lieu de récupérer les éléments dans la liste, ils sont stockés dans un fichier défini par le paramètre. Évalue l’expression puis les compare à chacune des membres de la liste qui se trouve dans le fichier. Si un des membres de la liste correspond (non sensible à la casse), la valeur associée est renvoyée. Si aucun membre de la liste ne correspond à l’expression et qu’un membre « default » est défini, c’est la valeur associée à ce membre qui est renvoyée.

**Syntaxe de la fonction :**

<SWITCH_TABLE:[Expression]:[chemin_fichier]>

Le format du fichier est :

```
1
2
3
4
```

Les items de la liste sont lus dans l’ordre jusqu’à ce qu’un numéro soit manquant.

**Mode d'utilisation :**

- Le mot-clé SWITCH_TABLE peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression évaluée peut contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

**Exemples de configuration :**

- Exemple :
    - Fichier :

      ```
      1
      2
      3
      4
      ```
    - <SWITCH_TABLE:<SyncAttSrc:code_metier>:C:cheminmetier.txt>

## IF

Evalue l’expression. Si le résultat est vrai (1), on renvoie la 1ère valeur en résultat sinon on renvoie la 2nde valeur.

**Syntaxe de la fonction :**

<IF:[Expression]:[Résultat_si_vrai]:[Résultat_si_faux]>

**Mode d'utilisation :**

- Le mot-clé IF peut être utilisée dans tous les champs de type « expression » comme des opérations de type COPY, MODVALUE, etc.
- L’expression évaluée peut contenir des mots-clés pour récupérer des valeurs d’attributs, par exemple SyncAttSrc ou SyncAttDst.

**Exemples de configuration :**

- Exemple : <IF:<CMP:<SyncAttSrc:type_personne>:Agent>:Agent_interne:Agent_Externe>
