> Source: https://docs.cyberelements.io/identity/7.1/sk/UserDocumentation/AutomaticProvisioningConnectorsManagement/KeywordsInOperations/TestsAndComparisons/

# Testy a porovnania

## CMP

Funkcia, ktorá porovná dva reťazce bez ohľadu na veľkosť písmen.

> **Poznámka**
>
> Od verzie 7.1 modul zriaďovania pri porovnávaní reťazcov už nezohľadňuje veľkosť písmen. Operácia CMP preto nerozlišuje veľké a malé písmená a operácia CMPi už nemá žiadne využitie.

**Syntax funkcie:**

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

Reťazce znakov môžu byť atribútom; v takom prípade musíte použiť kľúčové slovo <syncattsrc:[attribute_name]> alebo <syncattdst:[attribute_name]> podľa toho, či sa operácia týka zdrojového alebo cieľového úložiska.

**Spôsob použitia:**

- Kľúčové slovo CMP možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Zvyčajne sa kombinuje s kľúčovými slovami IF alebo SWITCH.

**Možné výsledky:**

- True: ak sú oba reťazce znakov identické.
- False: ak sú oba reťazce znakov odlišné.

**Príklady konfigurácie:**

- Príklad:
    - <IF:<CMP:<SyncAttSrc:STATUT>:Done>:OK:KO>

## CMPi

> **Pozor**
>
> Operácia CMPi je od verzie 7.1 zastaraná a vo verzii 7.2 bude odobratá. Používajte iba operáciu CMP, ktorá teraz nerozlišuje veľké a malé písmená.
>
> Vo verzii 7.1 modul **stále rozpoznáva** CMPi: existujúce pravidlá naďalej fungujú. Naopak, pravidlo CMP napísané pred verziou 7.1 na zámerné **rozlíšenie** dvoch hodnôt, ktoré sa líšia iba veľkosťou písmen, už toto rozlíšenie nevykonáva: počas upgradu tieto pravidlá skontrolujte.

Funkcia, ktorá porovná dva reťazce bez ohľadu na veľkosť písmen.

**Syntax funkcie:**

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

Reťazce znakov môžu byť atribútom; v takom prípade musíte použiť kľúčové slovo <syncattsrc:[attribute_name]> alebo <syncattdst:[attribute_name]> podľa toho, či sa operácia týka zdrojového alebo cieľového úložiska.

**Spôsob použitia:**

- Kľúčové slovo CMPi možno použiť vo všetkých poliach typu „expression“, napríklad COPY, MODVALUE atď.
- Zvyčajne sa kombinuje s kľúčovými slovami IF alebo SWITCH.

**Možné výsledky:**

- True: ak sú oba reťazce znakov identické.
- False: ak sú oba reťazce znakov odlišné.

**Príklady konfigurácie:**

- Príklad: <IF:<CMPi:<SyncAttSrc:STATUT>:Completed>:OK:KO>

## EXISTS

Funkcia, ktorá umožňuje otestovať prítomnosť atribútu v exporte.

**Syntax funkcie:**

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

- [nom_attribut_recherché] = názov atribútu, ktorého existenciu treba otestovať
- [DataSource] = SRC alebo DST. Umožňuje vyhľadať prítomnosť atribútu buď v exporte zdrojového úložiska (=SRC), alebo v exporte cieľového úložiska (=DST). Parameter je voliteľný, pokiaľ nie je zadaná operácia. Ak parameter nie je zadaný, predvolene sa použije hodnota SRC.
- [Operation] = ADD alebo DEL. Slúži na otestovanie prítomnosti atribútu s podoperáciou ADD alebo DEL. Parameter je voliteľný.

**Možné výsledky:**

Ak sa atribút nájde, vráti 1, inak vráti 0.

**Spôsob použitia:**

- Kľúčové slovo EXISTS možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách COPY, MODVALUE atď., alebo v podmienkach vykonania v pravidlách importu databázového konektora.

**Príklady konfigurácie:**

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

- Výsledok: dotaz SQL sa vykoná iba vtedy, ak je atribút „wiki_mod_2“ prítomný v zdrojovom úložisku s podoperáciou ADD.

## NOT

Vráti 1, ak je výraz nepravdivý, inak 0.

**Syntax funkcie:**

<NOT:[Expression]>

Výraz môže obsahovať ďalšie kľúčové slová.

**Spôsob použitia:**

- Kľúčové slovo NOT možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Výrazy vracajúce logickú hodnotu sa zvyčajne vytvárajú z kombinácií kľúčových slov, ako sú CMP, IF atď.

**Príklady konfigurácie:**

- Príklad:
    - <IF:<NOT:<CMP:<SyncAttSrc:STATUS>:Completed>>:Echec:Success>
    - Vráti „Success“, ak sa stav rovná „Completed“, inak vráti „Failure“, ak stav nie je „Completed“.

## &NOT

Binárna operácia „NOT“.

**Syntax funkcie:**

<&NOT:[Expression]>

Výraz môže obsahovať ďalšie kľúčové slová, napríklad na získanie hodnoty atribútu.

**Spôsob použitia:**

- Kľúčové slovo NOT možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Výrazy vracajúce logickú hodnotu sa zvyčajne vytvárajú z kombinácií kľúčových slov, ako sú CMP, IF atď.

**Možné výsledky:**

- Binárna hodnota

**Príklady konfigurácie:**

- Príklad:
    - <&NOT:<CMP:<SyncAttSrc:STATUS>:512>>:Disabled:Enabled>
    - Vráti „Enabled“, ak sa stav rovná „Completed“, inak vráti „Failed“, ak stav nie je „Completed“.

## AND

Vráti 1 (pravda), ak sú výraz 1 aj výraz 2 pravdivé, inak 0.

**Syntax funkcie:**

<AND:[Expression_1]:[Expression_2]>

**Spôsob použitia:**

- Kľúčové slovo AND možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Zvyčajne sa kombinuje s kľúčovými slovami IF alebo SWITCH.

**Príklady konfigurácie:**

- Príklad: <IF:<AND:<CMP:<SyncAttSrc:person_type>:Agent>:<CMP:<SyncAttSrc:job>:Accountant>>:Agent_comptable:External_accountant>

## ANDX

Vráti 1, ak sú všetky výrazy v zozname pravdivé, inak 0.

**Syntax funkcie:** <ANDX:[Expression_1]:[Expression_2]:[Expression_n] >

**Spôsob použitia:**

- Kľúčové slovo ANDX možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Zvyčajne sa kombinuje s kľúčovými slovami IF alebo SWITCH.

**Príklady konfigurácie:**

- Príklad:

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

## &AND

Binárna operácia „AND“ medzi dvoma hodnotami.

**Syntax funkcie:**

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

**Spôsob použitia:**

- Kľúčové slovo &AND možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách COPY, MODVALUE atď.
- Zvyčajne sa kombinuje s kľúčovými slovami IF alebo SWITCH.

**Výsledky:**

- Vráti desiatkovú hodnotu, ktorá zodpovedá výsledku binárnej operácie „AND“ medzi dvoma porovnávanými hodnotami.

**Príklady konfigurácie:**

- Príklad:
- <&AND:7:11> dá výsledok = 3
- Pričom 7 má binárnu hodnotu „111“ a 11 má binárnu hodnotu „1011“
- Výsledok binárnej operácie „AND“ medzi 111 a 1011 sa rovná 11, teda desiatkovej hodnote 3.

## OR

Vráti 1 (pravda), ak je výraz 1 alebo výraz 2 pravdivý, inak 0.

**Syntax funkcie:**

<OR:[Expression_1]:[Expression_2]>

**Spôsob použitia:**

- Kľúčové slovo OR možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Zvyčajne sa kombinuje s kľúčovými slovami IF alebo SWITCH.

**Príklady konfigurácie:**

- Príklad: <IF:<OR:<CMP:<SyncAttSrc:type_personne>:Agent>:<CMP:<SyncAttSrc:person_type >:Employee>>:Agent_comptable:External_accountant>

## ORX

Vráti 1, ak je ktorýkoľvek z výrazov v zozname pravdivý, inak 0.

**Syntax funkcie:**

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

**Spôsob použitia:**

- Kľúčové slovo ORX možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Zvyčajne sa kombinuje s kľúčovými slovami IF alebo SWITCH.

**Príklady konfigurácie:**

- Príklad: <IF:<ORX:<CMP:<SyncAttSrc:person_type>:Agent>:<CMP:<SyncAttSrc:person_type>:Employee>:<CMP:<SyncAttSrc:person_type>:Internal>>:Agent_interne:External_agent>

## &OR

Binárna operácia „OR“ medzi dvoma hodnotami.

**Syntax funkcie:**

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

**Spôsob použitia:**

- Kľúčové slovo &OR možno použiť vo všetkých poliach typu „expression“, napríklad COPY, MODVALUE atď.
- Zvyčajne sa kombinuje s kľúčovými slovami IF alebo SWITCH.

**Výsledky:**

- Vráti desiatkovú hodnotu, ktorá zodpovedá výsledku binárnej operácie „OR“ medzi dvoma porovnávanými hodnotami.

**Príklady konfigurácie:**

- Príklad:
- <&OR:7:11> dá výsledok = 15.
- Pričom 7 má binárnu hodnotu „111“ a 11 má binárnu hodnotu „1011“.
- Výsledok binárnej operácie „OR“ medzi 111 a 1011 sa rovná 1111, teda desiatkovej hodnote 15.

## SWITCH

Vyhodnotí výraz a potom ho porovná s každým prvkom zoznamu. Ak sa niektorý z prvkov zoznamu zhoduje (s rozlišovaním veľkých a malých písmen), vráti sa priradená hodnota. Ak sa s výrazom nezhoduje žiadny prvok zoznamu a je definovaný prvok „default“, vráti sa hodnota priradená tomuto prvku.

**Syntax funkcie:**

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

**Spôsob použitia:**

- Kľúčové slovo SWITCH možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Vyhodnocovaný výraz môže obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

**Príklady konfigurácie:**

- Príklad: <SWITCH:<SyncAttSrc:job_code>:DOC,Doctor:NUR,Nurse:HCA,Healthcare Assistant>

## SWITCHI

Rovnaké ako SWITCH, ale bez ohľadu na veľkosť písmen. Vyhodnotí výraz a potom ho porovná s každým prvkom zoznamu. Ak sa niektorý z prvkov zoznamu zhoduje (bez rozlišovania veľkých a malých písmen), vráti sa priradená hodnota. Ak sa s výrazom nezhoduje žiadny prvok zoznamu a je definovaný prvok „default“, vráti sa hodnota priradená tomuto prvku.

**Syntax funkcie:**

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

**Spôsob použitia:**

- Kľúčové slovo SWITCHi možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách COPY, MODVALUE atď.
- Vyhodnocovaný výraz môže obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

**Príklady konfigurácie:**

- Príklad: <SWITCHi:<SyncAttSrc:job_code>:DOC,Doctor:NUR,Nurse:HCA,Healthcare Assistant>

## SWITCH_TABLE

Rovnaké ako SWITCHi, ale prvky sa nezískavajú zo zoznamu vo výraze: sú uložené v súbore definovanom parametrom. Vyhodnotí výraz a potom ho porovná s každým prvkom zoznamu, ktorý sa nachádza v súbore. Ak sa niektorý z prvkov zoznamu zhoduje (bez rozlišovania veľkých a malých písmen), vráti sa priradená hodnota. Ak sa s výrazom nezhoduje žiadny prvok zoznamu a je definovaný prvok „default“, vráti sa hodnota priradená tomuto prvku.

**Syntax funkcie:**

<SWITCH_TABLE:[Expression]:[file_path]>

Súbor má nasledujúci formát:

```
1
2
3
4
```

Položky zoznamu sa čítajú v poradí, kým sa nenarazí na chýbajúce číslo.

**Spôsob použitia:**

- Kľúčové slovo SWITCH_TABLE možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Vyhodnocovaný výraz môže obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

**Príklady konfigurácie:**

- Príklad:
- Súbor:

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

## IF

Vyhodnotí výraz. Ak je výsledok pravdivý (1), ako výsledok sa vráti prvá hodnota; inak sa vráti druhá hodnota.

**Syntax funkcie:**

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

**Spôsob použitia:**

- Kľúčové slovo IF možno použiť vo všetkých poliach typu „expression“, napríklad v operáciách typu COPY, MODVALUE atď.
- Vyhodnocovaný výraz môže obsahovať kľúčové slová na získanie hodnôt atribútov, napríklad SyncAttSrc alebo SyncAttDst.

**Príklady konfigurácie:**

- Príklad: <IF:<CMP:<SyncAttSrc:person_type>:Agent>:Agent_interne:External_Agent>
