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

# Tester og sammenligninger

## CMP

Funksjon som sammenligner to tegnstrenger uten å ta hensyn til store og små bokstaver.

> **Merk**
>
> Fra og med versjon 7.1 skiller provisjoneringsmotoren ikke lenger mellom store og små bokstaver i sammenligninger av tegnstrenger. Operasjonen CMP skiller derfor ikke mellom store og små bokstaver, og operasjonen CMPi har ikke lenger noen nytte.

**Syntaks for funksjonen:**

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

Tegnstrengene kan være et attributt; i så fall må du bruke nøkkelordet <syncattsrc:[attribute_name]> eller <syncattdst:[attribute_name]>, avhengig av om operasjonen gjelder kilde- eller mål-repositoryet.

**Bruksmåte:**

- Nøkkelordet CMP kan brukes i alle felt av typen ”expression”, for eksempel i operasjoner av typen COPY, MODVALUE osv.
- Det kombineres vanligvis med nøkkelordene IF eller SWITCH.

**Mulige resultater:**

- True: hvis de to tegnstrengene er identiske.
- False: hvis de to tegnstrengene er forskjellige.

**Eksempler på konfigurasjon:**

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

## CMPi

> **Obs**
>
> Operasjonen CMPi er utgått fra og med versjon 7.1 og blir fjernet fra og med versjon 7.2. Bruk bare operasjonen CMP, som nå ikke skiller mellom store og små bokstaver.
>
> I versjon 7.1 blir CMPi **fortsatt gjenkjent** av motoren: eksisterende regler fortsetter å fungere. Omvendt vil en CMP-regel som ble skrevet før 7.1 for bevisst å **skille** mellom to verdier som bare er forskjellige i store og små bokstaver, ikke lenger gjøre dette skillet: kontroller disse reglene under oppgraderingen.

Funksjon som sammenligner to tegnstrenger uten å ta hensyn til store og små bokstaver.

**Syntaks for funksjonen:**

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

Tegnstrengene kan være et attributt; i så fall må du bruke nøkkelordet <syncattsrc:[attribute_name]> eller <syncattdst:[attribute_name]>, avhengig av om operasjonen gjelder kilde- eller mål-repositoryet.

**Bruksmåte:**

- Nøkkelordet CMPi kan brukes i alle felt av typen ”expression”, for eksempel COPY, MODVALUE osv.
- Det kombineres vanligvis med nøkkelordene IF eller SWITCH.

**Mulige resultater:**

- True: hvis de to tegnstrengene er identiske.
- False: hvis de to tegnstrengene er forskjellige.

**Eksempler på konfigurasjon:**

- Eksempel: <IF:<CMPi:<SyncAttSrc:STATUT>:Completed>:OK:KO>

## EXISTS

Funksjon som gjør det mulig å teste om et attributt finnes i en eksport.

**Syntaks for funksjonen:**

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

- [searched_attribute_name] = navnet på attributtet som skal kontrolleres for eksistens
- [DataSource] = SRC eller DST. Gjør det mulig å søke etter attributtet enten i eksporten fra kilde-repositoryet (=SRC) eller i eksporten fra mål-repositoryet (=DST). Parameteren er valgfri med mindre en operasjon er angitt. Hvis parameteren ikke er angitt, brukes verdien SRC som standard.
- [Operation] = ADD eller DEL. Brukes til å teste om attributtet finnes med en underoperasjon ADD eller DEL. Parameteren er valgfri.

**Mulige resultater:**

Returnerer 1 hvis attributtet blir funnet, ellers 0.

**Bruksmåte:**

- Nøkkelordet EXISTS kan brukes i alle felt av typen ”expression”, for eksempel i operasjonene COPY, MODVALUE osv., eller i utførelsesbetingelsene i importreglene til en DB-konnektor.

**Eksempler på konfigurasjon:**

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

- Resultat: SQL-spørringen utføres bare hvis attributtet "wiki_mod_2" finnes i kilde-repositoryet med en underoperasjon ADD.

## NOT

Returnerer 1 hvis uttrykket er falskt, og 0 ellers.

**Syntaks for funksjonen:**

<NOT:[Expression]>

Uttrykket kan inneholde andre nøkkelord.

**Bruksmåte:**

- Nøkkelordet NOT kan brukes i alle felt av typen ”expression”, for eksempel i operasjoner av typen COPY, MODVALUE osv.
- Uttrykk som returnerer en boolsk verdi, bygges vanligvis opp av kombinasjoner av nøkkelord som CMP, IF osv.

**Eksempler på konfigurasjon:**

- Eksempel:
    - <IF:<NOT:<CMP:<SyncAttSrc:STATUS>:Completed>>:Echec:Success>
    - Returnerer ”Success” hvis statusen er lik ”Completed”; ellers returneres "Failure" hvis statusen ikke er ”Completed”.

## &NOT

Binær operasjon ”NOT”.

**Syntaks for funksjonen:**

<&NOT:[Expression]>

Uttrykket kan inneholde andre nøkkelord, for eksempel for å hente verdien av et attributt.

**Bruksmåte:**

- Nøkkelordet NOT kan brukes i alle felt av typen ”expression”, for eksempel i operasjoner av typen COPY, MODVALUE osv.
- Uttrykk som returnerer en boolsk verdi, bygges vanligvis opp av kombinasjoner av nøkkelord som CMP, IF osv.

**Mulige resultater:**

- Binær verdi

**Eksempler på konfigurasjon:**

- Eksempel:
    - <&NOT:<CMP:<SyncAttSrc:STATUS>:512>>:Disabled:Enabled>
    - Returnerer ”Enabled” hvis statusen er lik ”Completed”; ellers returneres ”Failed” hvis statusen ikke er ”Completed”.

## AND

Returnerer 1 (sant) hvis uttrykk 1 og uttrykk 2 er sanne, ellers 0.

**Syntaks for funksjonen:**

<AND:[Expression_1]:[Expression_2]>

**Bruksmåte:**

- Nøkkelordet AND kan brukes i alle felt av typen ”expression”, for eksempel i operasjoner av typen COPY, MODVALUE osv.
- Det kombineres vanligvis med nøkkelordene IF eller SWITCH.

**Eksempler på konfigurasjon:**

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

## ANDX

Returnerer 1 hvis alle uttrykkene i listen er sanne, ellers 0.

**Syntaks for funksjonen:** <ANDX:[Expression_1]:[Expression_2]:[Expression_n] >

**Bruksmåte:**

- Nøkkelordet ANDX kan brukes i alle felt av typen ”expression”, for eksempel i operasjoner av typen COPY, MODVALUE osv.
- Det kombineres vanligvis med nøkkelordene IF eller SWITCH.

**Eksempler på konfigurasjon:**

- Eksempel:

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

## &AND

Binær operasjon ”AND” mellom to verdier.

**Syntaks for funksjonen:**

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

**Bruksmåte:**

- Nøkkelordet &AND kan brukes i alle felt av typen ”expression”, for eksempel i operasjonene COPY, MODVALUE osv.
- Det kombineres vanligvis med nøkkelordene IF eller SWITCH.

**Resultater:**

- Returnerer en desimalverdi som svarer til resultatet av den binære operasjonen ”AND” mellom de to sammenlignede verdiene.

**Eksempler på konfigurasjon:**

- Eksempel:
- <&AND:7:11> gir = 3
- Der 7 har binærverdien ”111” og 11 har binærverdien ”1011”
- Resultatet av den binære operasjonen ”AND” mellom 111 og 1011 er lik 11, altså desimalverdien 3.

## OR

Returnerer 1 (sant) hvis uttrykk 1 eller uttrykk 2 er sant, ellers 0.

**Syntaks for funksjonen:**

<OR:[Expression_1]:[Expression_2]>

**Bruksmåte:**

- Nøkkelordet OR kan brukes i alle felt av typen ”expression”, for eksempel i operasjoner av typen COPY, MODVALUE osv.
- Det kombineres vanligvis med nøkkelordene IF eller SWITCH.

**Eksempler på konfigurasjon:**

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

## ORX

Returnerer 1 hvis ett av uttrykkene i listen er sant, ellers 0.

**Syntaks for funksjonen:**

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

**Bruksmåte:**

- Nøkkelordet ORX kan brukes i alle felt av typen ”expression”, for eksempel i operasjonene COPY, MODVALUE osv.
- Det kombineres vanligvis med nøkkelordene IF eller SWITCH.

**Eksempler på konfigurasjon:**

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

## &OR

Binær operasjon ”OR” mellom to verdier.

**Syntaks for funksjonen:**

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

**Bruksmåte:**

- Nøkkelordet &OR kan brukes i alle felt av typen ”expression”, for eksempel COPY, MODVALUE osv.
- Det kombineres vanligvis med nøkkelordene IF eller SWITCH.

**Resultater:**

- Returnerer en desimalverdi som svarer til resultatet av den binære operasjonen ”OR” mellom de to sammenlignede verdiene.

**Eksempler på konfigurasjon:**

- Eksempel:
- <&OR:7:11> gir = 15.
- Der 7 har binærverdien ”111” og 11 har binærverdien ”1011”.
- Resultatet av den binære operasjonen ”OR” mellom 111 og 1011 er lik 1111, altså desimalverdien 15.

## SWITCH

Evaluerer uttrykket og sammenligner det deretter med hvert element i listen. Hvis ett av elementene i listen samsvarer (med skille mellom store og små bokstaver), returneres den tilknyttede verdien. Hvis ingen av elementene i listen samsvarer med uttrykket og et element ”default” er definert, returneres verdien som er knyttet til dette elementet.

**Syntaks for funksjonen:**

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

**Bruksmåte:**

- Nøkkelordet SWITCH kan brukes i alle felt av typen ”expression”, for eksempel i operasjoner av typen COPY, MODVALUE osv.
- Uttrykket som vurderes, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfigurasjon:**

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

## SWITCHI

Identisk med SWITCH, men uten å ta hensyn til store og små bokstaver. Evaluerer uttrykket og sammenligner det deretter med hvert element i listen. Hvis ett av elementene i listen samsvarer (uten skille mellom store og små bokstaver), returneres den tilknyttede verdien. Hvis ingen av elementene i listen samsvarer med uttrykket og et element ”default” er definert, returneres verdien som er knyttet til dette elementet.

**Syntaks for funksjonen:**

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

**Bruksmåte:**

- Nøkkelordet SWITCHi kan brukes i alle felt av typen ”expression”, for eksempel i operasjonene COPY, MODVALUE osv.
- Uttrykket som vurderes, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfigurasjon:**

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

## SWITCH_TABLE

Identisk med SWITCHi, men i stedet for at elementene hentes fra listen, lagres de i en fil som parameteren definerer. Evaluerer uttrykket og sammenligner det deretter med hvert av elementene i listen som finnes i filen. Hvis ett av elementene i listen samsvarer (uten skille mellom store og små bokstaver), returneres den tilknyttede verdien. Hvis ingen av elementene i listen samsvarer med uttrykket og et element ”default” er definert, returneres verdien som er knyttet til dette elementet.

**Syntaks for funksjonen:**

<SWITCH_TABLE:[Expression]:[file_path]>

Filformatet er som følger:

```
1
2
3
4
```

Elementene i listen leses i rekkefølge til et nummer mangler.

**Bruksmåte:**

- Nøkkelordet SWITCH_TABLE kan brukes i alle felt av typen ”expression”, for eksempel i operasjoner av typen COPY, MODVALUE osv.
- Uttrykket som vurderes, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfigurasjon:**

- Eksempel:
- Fil:

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

## IF

Evaluerer uttrykket. Hvis resultatet er sant (1), returneres den første verdien som resultat; ellers returneres den andre verdien.

**Syntaks for funksjonen:**

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

**Bruksmåte:**

- Nøkkelordet IF kan brukes i alle felt av typen ”expression”, for eksempel i operasjoner av typen COPY, MODVALUE osv.
- Uttrykket som vurderes, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfigurasjon:**

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