> Source: https://docs.cyberelements.io/identity/7.0/sl/UserDocumentation/AutomaticProvisioningConnectorsManagement/KeywordsInOperations/CharacterStrings/

# Nizi znakov

## UPPER

Pretvori besedilni niz v velike črke.

**Sintaksa funkcije:**

<UPPER:[Expression]>

**Način uporabe:**

- Ključno besedo UPPER je mogoče uporabiti v vseh poljih vrste „expression“, na primer v operacijah vrste COPY, MODVALUE itd.
- Ovrednoteni izraz lahko vsebuje ključne besede za pridobivanje vrednosti atributov, na primer SyncAttSrc ali SyncAttDst.

## LOWER

Pretvori besedilni niz v male črke.

**Sintaksa funkcije:**

<LOWER:[Expression]>

**Način uporabe:**

- Ključno besedo LOWER je mogoče uporabiti v vseh poljih vrste „expression“, na primer v operacijah vrste COPY, MODVALUE itd.
- Ovrednoteni izraz lahko vsebuje ključne besede za pridobivanje vrednosti atributov, na primer SyncAttSrc ali SyncAttDst.

## LEFT

**Sintaksa funkcije:**

<LEFT:[Character_number]:[Expression]>

**Način uporabe:**

- Ključno besedo LEFT je mogoče uporabiti v vseh poljih vrste „expression“, na primer v operacijah vrste COPY, MODVALUE itd.
- Ovrednoteni izraz lahko vsebuje ključne besede za pridobivanje vrednosti atributov, na primer SyncAttSrc ali SyncAttDst.

## TOKLEFT

Pridobi n-ti objekt, štet z leve.

**Sintaksa funkcije:**

<TOKLEFT:[separator]:[Object_number]:[Expression]>

Objekt je med dvema ločiloma. Ločila ni treba postaviti na začetek in konec niza izraza.

**Način uporabe:**

- Ključno besedo TOKLEFT je mogoče uporabiti v vseh poljih vrste „expression“, na primer v operacijah vrste COPY, MODVALUE itd.
- Ovrednoteni izraz lahko vsebuje ključne besede za pridobivanje vrednosti atributov, na primer SyncAttSrc ali SyncAttDst.

**Primeri konfiguracije:**

- Primer:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Vrnjeni rezultat: Level 3

## RIGHT

Pridobi določeno število znakov z desne strani vrednosti.

**Sintaksa funkcije:**

<RIGHT:[Character_number]:[Expression]>

**Način uporabe:**

- Ključno besedo RIGHT je mogoče uporabiti v vseh poljih vrste „expression“, na primer v operacijah vrste COPY, MODVALUE itd.
- Ovrednoteni izraz lahko vsebuje ključne besede za pridobivanje vrednosti atributov, na primer SyncAttSrc ali SyncAttDst.

## SHA256

Šifrira niz znakov z algoritmom SHA256.

**Sintaksa funkcije:**

<SHA256:[string_encoding]:[Hex_B64]:[Expression]>

Pri čemer je:

- [string_encoding]: „UTF8“ ali „UTF16“. Kodiranje določite glede na obliko, ki jo pričakuje ciljna aplikacija. V večini primerov uporabite UTF8.
- [Hex_B64]: „HEX“ ali „B64“ za izbiro oblike niza. HEX za šestnajstiški zapis, B64 za base 64.

**Način uporabe:**

- Ključno besedo SHA256 je mogoče uporabiti v vseh poljih vrste „expression“, na primer v operacijah COPY, MODVALUE itd.
- Ovrednoteni izraz lahko vsebuje ključne besede za pridobivanje vrednosti atributov, na primer SyncAttSrc ali SyncAttDst.

## TOKRIGHT

Pridobi del niza znakov od n-tega objekta, štetega z desne.

**Sintaksa funkcije:**

<TOKRIGHT:[separator]:[Object_number]:[Expression]>

Objekt je med dvema ločiloma. Ločila ni treba postaviti na začetek in konec niza izraza.

**Način uporabe:**

- Ključno besedo TOKRIGHT je mogoče uporabiti v vseh poljih vrste „expression“, na primer COPY, MODVALUE itd.
- Ovrednoteni izraz lahko vsebuje ključne besede za pridobivanje vrednosti atributov, na primer SyncAttSrc ali SyncAttDst.

**Primeri konfiguracije:**

- Primer:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Vrnjeni rezultat: Level 4/ Level 5

## CENTER

Pridobi znake na sredini tako, da izbriše določeno število znakov na levi in desni.

**Sintaksa funkcije:**

<CENTER:[Number_of_characters_to_the_left_to_delete]:[Number_of_characters_to_the_right_to_delete]:[Expression]>

**Način uporabe:**

- Ključno besedo CENTER je mogoče uporabiti v vseh poljih vrste „expression“, na primer v operacijah vrste COPY, MODVALUE itd.
- Ovrednoteni izraz lahko vsebuje ključne besede za pridobivanje vrednosti atributov, na primer SyncAttSrc ali SyncAttDst.

## REWRITEURL

Prepis naslova URL.

**Sintaksa funkcije:**

<REWRITEURL:[url]>

**Način uporabe:**

- Ključno besedo REWRITEURL je mogoče uporabiti v vseh poljih vrste „expression“, na primer COPY, MODVALUE itd.

**Primeri konfiguracije:**

- Primer:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Vrnjeni rezultat: http://www.avencis.net

## GEN_PASSWORD

Ustvarjanje gesla na podlagi maske in s podporo za posebne znake, določene v nastavitvah.

**Sintaksa funkcije:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Obliko gesla je treba določiti z naslednjimi elementi:

- U Velika črka
- L Mala črka
- A Velika ali mala črka
- N Števka
- S Poseben znak s seznama [special_characters]
- X Vsi znaki (U+L+N+S)

**Način uporabe:**

- Ključno besedo GEN_PASSWORD je mogoče uporabiti v vseh poljih vrste „expression“, na primer v operacijah COPY, MODVALUE itd.

**Primeri konfiguracije:**

- Primer:
    - <GEN_PASSWORD:ULNXXXXXXX:,$£!§&#>

## B64ENCODEASCII

Pretvori izraz v ASCII in nato vrne niz, kodiran v B64.

**Sintaksa funkcije:**

<B64ENCODEASCII:[Expression]>

**Način uporabe:**

- Ključno besedo B64ENCODEASCII je mogoče uporabiti v vseh poljih vrste „expression“, na primer v operacijah COPY, MODVALUE itd.
- Ovrednoteni izraz lahko vsebuje ključne besede za pridobivanje vrednosti atributov, na primer SyncAttSrc ali SyncAttDst.

## B64SID2STRING

Pretvori SID v Base64 in vrne niz v obliki Unicode.

**Sintaksa funkcije:**

<B64SID2STRING:[Expression]>

**Način uporabe:**

- Ključno besedo B64SID2STRING je mogoče uporabiti v vseh poljih vrste „expression“, na primer v operacijah COPY, MODVALUE itd.
- Ovrednoteni izraz lahko vsebuje ključne besede za pridobivanje vrednosti atributov, na primer SyncAttSrc ali SyncAttDst.

## FIND

Funkcija za iskanje položaja niza znakov v drugem nizu znakov. Če je niz najden, vrne indeks položaja (začenši z indeksom 0), sicer vrne dolžino niza.

**Sintaksa funkcije:**

<FIND:[chaîne_recherchée]:[chaîne_initiale]:[index_de_départ]>

Indeks se začne pri položaju 0.

**Način uporabe:**

- Operacijo FIND je mogoče uporabiti v vseh poljih vrste „expression“, na primer COPY, MODVALUE itd.
- Različni nizi, uporabljeni v izrazu, lahko vsebujejo ključne besede za pridobivanje vrednosti atributov, na primer SyncAttSrc ali SyncAttDst.

**Primeri konfiguracije:**

- Primer 1:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> za <SyncAttSrc:FIRSTNAME> = Emilie
    - Rezultat = 0
- Primer 2:
    - <FIND:I:<SyncAttSrc:FIRSTNAME>:0> za <SyncAttSrc:FIRSTNAME> = Emilie
    - Rezultat = 2
- Primer 3:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> za <SyncAttSrc:FIRSTNAME> = Paul
    - Rezultat = 4

## SUBSTRING

Funkcija, ki izvleče niz znakov iz drugega niza znakov. Če so posredovani parametri veljavni, vrne niz znakov, sicer vrne prazno vrednost. **Sintaksa funkcije:**

<SUBSTRING:[chaîne_initiale]:[index_début]:[longueur_chaîne]>

Indeks se začne pri položaju 0.

**Način uporabe:**

- Operacijo SUBSTRING je mogoče uporabiti v vseh poljih vrste „expression“, na primer COPY, MODVALUE itd.
- Različni nizi, uporabljeni v izrazu, lahko vsebujejo ključne besede za pridobivanje vrednosti atributov, na primer SyncAttSrc ali SyncAttDst.

**Primeri konfiguracije:**

- Primer 1:
    - <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> za <SyncAttSrc:DisplayName> = Carine HOPFNER
    - Rezultat = Carine

## LEN

Funkcija, ki vrne dolžino niza znakov. Če je v konfiguraciji napaka, funkcija vrne 0.

**Sintaksa funkcije:**

<LEN:[chaîne_initiale]>

**Način uporabe:**

- Operacijo LEN je mogoče uporabiti v vseh poljih vrste „expression“, na primer COPY, MODVALUE itd.
- Različni nizi, uporabljeni v izrazu, lahko vsebujejo ključne besede za pridobivanje vrednosti atributov, na primer SyncAttSrc ali SyncAttDst.

**Primeri konfiguracije:**

- Primer 1:
    - <LEN:<SyncAttSrc:DisplayName>> za <SyncAttSrc:DisplayName> = Emilie Paris
    - Rezultat = 12

## REPLACE

Na voljo od različice 7.0 naprej. Funkcija, ki v danem nizu „initial_string“ zamenja niz znakov „string_to_replace“ z nizom „destination_string“. Vrne spremenjeni niz znakov. Funkcija razlikuje med velikimi in malimi črkami.

**Sintaksa funkcije:**

<REPLACE:[initial_string]:[string_to_replace]:[destination_string]:[Boolean_all_or_first]>

Boolean_all_or_first: ima lahko vrednost 0 ali 1. Pri 0 se zamenja samo prva najdena pojavitev, pri 1 pa vse najdene pojavitve. Parameter ni obvezen; privzeta vrednost je 0.

Destination_string je lahko prazen: v tem primeru se niz, ki ga je treba zamenjati, preprosto izbriše.

**Način uporabe:**

- Operacijo REPLACE je mogoče uporabiti v vseh poljih vrste „expression“, na primer COPY, MODVALUE itd.
- Različni nizi, uporabljeni v izrazu, lahko vsebujejo ključne besede za pridobivanje vrednosti atributov, na primer SyncAttSrc ali SyncAttDst.

**Primeri konfiguracije:**

- <REPLACE:XXXstringXXX:string:newString> vrne XXXnewStringXXX
- <REPLACE:XXXstringXXX:X::0> vrne XXstringXXX
- <REPLACE:XXXstringXXX:X::1> vrne string
- <REPLACE:XXXstringXXX:X:A:1> vrne AAAstringAAA
