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

# Testy a porovnání

## CMP

Funkce, která porovná dva řetězce bez ohledu na velikost písmen.

> **Poznámka**
>
> Od verze 7.1 modul zřizování při porovnávání řetězců nerozlišuje velikost písmen. Operace CMP proto nerozlišuje velká a malá písmena a operace CMPi již nemá žádné využití.

**Syntaxe funkce:**

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

Řetězce znaků mohou být atributem; v takovém případě je nutné použít klíčové slovo <syncattsrc:[attribute_name]> nebo <syncattdst:[attribute_name]> podle toho, zda se operace týká zdrojového, nebo cílového úložiště.

**Způsob použití:**

- Klíčové slovo CMP lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Obvykle se kombinuje s klíčovými slovy IF nebo SWITCH.

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

- True: pokud jsou oba řetězce znaků shodné.
- False: pokud se oba řetězce znaků liší.

**Příklady konfigurace:**

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

## CMPi

> **Upozornění**
>
> Operace CMPi je od verze 7.1 zastaralá a od verze 7.2 bude odebrána. Používejte pouze operaci CMP, která nyní nerozlišuje velká a malá písmena.
>
> Ve verzi 7.1 modul operaci CMPi **stále rozpoznává**: stávající pravidla nadále fungují. Naopak pravidlo CMP napsané před verzí 7.1 tak, aby záměrně **rozlišovalo** dvě hodnoty lišící se pouze velikostí písmen, toto rozlišení již neprovádí: při upgradu tato pravidla zkontrolujte.

Funkce, která porovná dva řetězce bez ohledu na velikost písmen.

**Syntaxe funkce:**

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

Řetězce znaků mohou být atributem; v takovém případě je nutné použít klíčové slovo <syncattsrc:[attribute_name]> nebo <syncattdst:[attribute_name]> podle toho, zda se operace týká zdrojového, nebo cílového úložiště.

**Způsob použití:**

- Klíčové slovo CMPi lze použít ve všech polích typu „expression“, například COPY, MODVALUE atd.
- Obvykle se kombinuje s klíčovými slovy IF nebo SWITCH.

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

- True: pokud jsou oba řetězce znaků shodné.
- False: pokud se oba řetězce znaků liší.

**Příklady konfigurace:**

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

## EXISTS

Funkce, která umožňuje ověřit přítomnost atributu v exportu.

**Syntaxe funkce:**

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

- [nom_attribut_recherché] = název atributu, jehož existenci je třeba ověřit
- [DataSource] = SRC nebo DST. Umožňuje vyhledat přítomnost atributu buď v exportu zdrojového úložiště (=SRC), nebo v exportu cílového úložiště (=DST). Parametr je volitelný, pokud není zadána operace. Pokud parametr není zadán, použije se ve výchozím nastavení hodnota SRC.
- [Operation] = ADD nebo DEL. Slouží k ověření přítomnosti atributu s dílčí operací ADD nebo DEL. Parametr je volitelný.

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

Vrátí 1, pokud je atribut nalezen, jinak vrátí 0.

**Způsob použití:**

- Klíčové slovo EXISTS lze použít ve všech polích typu „expression“, například v operacích COPY, MODVALUE atd., nebo v podmínkách provedení v pravidlech importu konektoru databáze.

**Příklady konfigurace:**

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

- Výsledek: dotaz SQL se provede pouze tehdy, pokud je atribut „wiki_mod_2“ přítomen ve zdrojovém úložišti s dílčí operací ADD.

## NOT

Vrací 1, pokud je výraz nepravdivý, a jinak 0.

**Syntaxe funkce:**

<NOT:[Expression]>

Výraz může obsahovat další klíčová slova.

**Způsob použití:**

- Klíčové slovo NOT lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Výrazy vracející logickou hodnotu se obvykle sestavují z kombinací klíčových slov, jako jsou CMP, IF atd.

**Příklady konfigurace:**

- Příklad:
    - <IF:<NOT:<CMP:<SyncAttSrc:STATUS>:Completed>>:Echec:Success>
    - Vrátí „Success“, pokud je stav roven „Completed“, jinak vrátí „Failure“, pokud stav není „Completed“.

## &NOT

Binární operace „NOT“.

**Syntaxe funkce:**

<&NOT:[Expression]>

Výraz může obsahovat další klíčová slova, například pro načtení hodnoty atributu.

**Způsob použití:**

- Klíčové slovo NOT lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Výrazy vracející logickou hodnotu se obvykle sestavují z kombinací klíčových slov, jako jsou CMP, IF atd.

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

- Binární hodnota

**Příklady konfigurace:**

- Příklad:
    - <&NOT:<CMP:<SyncAttSrc:STATUS>:512>>:Disabled:Enabled>
    - Vrátí „Enabled“, pokud je stav roven „Completed“, jinak vrátí „Failed“, pokud stav není „Completed“.

## AND

Vrátí 1 (pravda), pokud jsou výraz 1 i výraz 2 pravdivé, jinak 0.

**Syntaxe funkce:**

<AND:[Expression_1]:[Expression_2]>

**Způsob použití:**

- Klíčové slovo AND lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Obvykle se kombinuje s klíčovými slovy IF nebo SWITCH.

**Příklady konfigurace:**

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

## ANDX

Vrátí 1, pokud jsou všechny výrazy v seznamu pravdivé, jinak 0.

**Syntaxe funkce:** <ANDX:[Expression_1]:[Expression_2]:[Expression_n] >

**Způsob použití:**

- Klíčové slovo ANDX lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Obvykle se kombinuje s klíčovými slovy IF nebo SWITCH.

**Příklady konfigurace:**

- Příklad:

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

## &AND

Binární operace „AND“ mezi dvěma hodnotami.

**Syntaxe funkce:**

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

**Způsob použití:**

- Klíčové slovo &AND lze použít ve všech polích typu „expression“, například v operacích COPY, MODVALUE atd.
- Obvykle se kombinuje s klíčovými slovy IF nebo SWITCH.

**Výsledky:**

- Vrátí desítkovou hodnotu, která odpovídá výsledku binární operace „AND“ mezi oběma porovnávanými hodnotami.

**Příklady konfigurace:**

- Příklad:
- <&AND:7:11> dá výsledek = 3
- Přičemž 7 má binární hodnotu „111“ a 11 má binární hodnotu „1011“
- Výsledek binární operace „AND“ mezi 111 a 1011 je roven 11, tedy desítkové hodnotě 3.

## OR

Vrátí 1 (pravda), pokud je výraz 1 nebo výraz 2 pravdivý, jinak 0.

**Syntaxe funkce:**

<OR:[Expression_1]:[Expression_2]>

**Způsob použití:**

- Klíčové slovo OR lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Obvykle se kombinuje s klíčovými slovy IF nebo SWITCH.

**Příklady konfigurace:**

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

## ORX

Vrátí 1, pokud je kterýkoli z výrazů v seznamu pravdivý, jinak 0.

**Syntaxe funkce:**

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

**Způsob použití:**

- Klíčové slovo ORX lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Obvykle se kombinuje s klíčovými slovy IF nebo SWITCH.

**Příklady konfigurace:**

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

## &OR

Binární operace „OR“ mezi dvěma hodnotami.

**Syntaxe funkce:**

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

**Způsob použití:**

- Klíčové slovo &OR lze použít ve všech polích typu „expression“, například COPY, MODVALUE atd.
- Obvykle se kombinuje s klíčovými slovy IF nebo SWITCH.

**Výsledky:**

- Vrátí desítkovou hodnotu, která odpovídá výsledku binární operace „OR“ mezi oběma porovnávanými hodnotami.

**Příklady konfigurace:**

- Příklad:
- <&OR:7:11> dá výsledek = 15.
- Přičemž 7 má binární hodnotu „111“ a 11 má binární hodnotu „1011“.
- Výsledek binární operace „OR“ mezi 111 a 1011 je roven 1111, tedy desítkové hodnotě 15.

## SWITCH

Vyhodnotí výraz a poté jej porovná s každou položkou seznamu. Pokud některá z položek seznamu odpovídá (s rozlišením velikosti písmen), vrátí se přidružená hodnota. Pokud výrazu neodpovídá žádná položka seznamu a je definována položka „default“, vrátí se hodnota přidružená k této položce.

**Syntaxe funkce:**

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

**Způsob použití:**

- Klíčové slovo SWITCH lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Vyhodnocovaný výraz může obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

**Příklady konfigurace:**

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

## SWITCHI

Totéž co SWITCH, ale bez ohledu na velikost písmen. Vyhodnotí výraz a poté jej porovná s každou položkou seznamu. Pokud některá z položek seznamu odpovídá (bez rozlišení velikosti písmen), vrátí se přidružená hodnota. Pokud výrazu neodpovídá žádná položka seznamu a je definována položka „default“, vrátí se hodnota přidružená k této položce.

**Syntaxe funkce:**

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

**Způsob použití:**

- Klíčové slovo SWITCHi lze použít ve všech polích typu „expression“, například v operacích COPY, MODVALUE atd.
- Vyhodnocovaný výraz může obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

**Příklady konfigurace:**

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

## SWITCH_TABLE

Totéž co SWITCHi, ale prvky se nenačítají ze seznamu, nýbrž jsou uloženy v souboru definovaném parametrem. Vyhodnotí výraz a poté jej porovná s každou položkou seznamu obsaženou v souboru. Pokud některá z položek seznamu odpovídá (bez rozlišení velikosti písmen), vrátí se přidružená hodnota. Pokud výrazu neodpovídá žádná položka seznamu a je definována položka „default“, vrátí se hodnota přidružená k této položce.

**Syntaxe funkce:**

<SWITCH_TABLE:[Expression]:[file_path]>

Formát souboru je následující:

```
1
2
3
4
```

Položky seznamu se načítají postupně až po první chybějící číslo.

**Způsob použití:**

- Klíčové slovo SWITCH_TABLE lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Vyhodnocovaný výraz může obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

**Příklady konfigurace:**

- Příklad:
- Soubor:

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

## IF

Vyhodnotí výraz. Pokud je výsledek pravdivý (1), vrátí se jako výsledek první hodnota; jinak se vrátí druhá hodnota.

**Syntaxe funkce:**

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

**Způsob použití:**

- Klíčové slovo IF lze použít ve všech polích typu „expression“, například v operacích typu COPY, MODVALUE atd.
- Vyhodnocovaný výraz může obsahovat klíčová slova, která načítají hodnoty atributů, například SyncAttSrc nebo SyncAttDst.

**Příklady konfigurace:**

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