> Source: https://docs.cyberelements.io/identity/7.1/hr/UserDocumentation/AutomaticProvisioningConnectorsManagement/KeywordsInOperations/CharacterStrings/

# Znakovni nizovi

## UPPER

Pretvara tekstni niz u velika slova.

**Sintaksa funkcije:**

<UPPER:[Expression]>

**Način upotrebe:**

- Ključna riječ UPPER može se koristiti u svim poljima tipa „expression“, kao što su operacije tipa COPY, MODVALUE itd.
- Evaluirani izraz može sadržavati ključne riječi za dohvaćanje vrijednosti atributa, na primjer SyncAttSrc ili SyncAttDst.

## LOWER

Pretvara tekstni niz u mala slova.

**Sintaksa funkcije:**

<LOWER:[Expression]>

**Način upotrebe:**

- Ključna riječ LOWER može se koristiti u svim poljima tipa „expression“, kao što su operacije tipa COPY, MODVALUE itd.
- Evaluirani izraz može sadržavati ključne riječi za dohvaćanje vrijednosti atributa, na primjer SyncAttSrc ili SyncAttDst.

## LEFT

**Sintaksa funkcije:**

<LEFT:[Character_number]:[Expression]>

**Način upotrebe:**

- Ključna riječ LEFT može se koristiti u svim poljima tipa „expression“, kao što su operacije tipa COPY, MODVALUE itd.
- Evaluirani izraz može sadržavati ključne riječi za dohvaćanje vrijednosti atributa, na primjer SyncAttSrc ili SyncAttDst.

## TOKLEFT

Dohvaća n-ti objekt brojeći slijeva.

**Sintaksa funkcije:**

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

Objekt se nalazi između dvaju razdjelnika. Nije potrebno postaviti razdjelnik na početak i na kraj niza izraza.

**Način upotrebe:**

- Ključna riječ TOKLEFT može se koristiti u svim poljima tipa „expression“, kao što su operacije tipa COPY, MODVALUE itd.
- Evaluirani izraz može sadržavati ključne riječi za dohvaćanje vrijednosti atributa, na primjer SyncAttSrc ili SyncAttDst.

**Primjeri konfiguracije:**

- Primjer:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Vraćeni rezultat: Level 3

## RIGHT

Dohvaća određeni broj znakova s desne strane vrijednosti.

**Sintaksa funkcije:**

<RIGHT:[Character_number]:[Expression]>

**Način upotrebe:**

- Ključna riječ RIGHT može se koristiti u svim poljima tipa „expression“, kao što su operacije tipa COPY, MODVALUE itd.
- Evaluirani izraz može sadržavati ključne riječi za dohvaćanje vrijednosti atributa, na primjer SyncAttSrc ili SyncAttDst.

## SHA256

Šifrira znakovni niz algoritmom SHA256.

**Sintaksa funkcije:**

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

Pri čemu je:

- [string_encoding]: „UTF8“ ili „UTF16“. Kodiranje treba navesti u skladu s formatom koji očekuje ciljna aplikacija. U većini slučajeva treba koristiti UTF8.
- [Hex_B64]: „HEX“ ili „B64“ za odabir formata niza. HEX za heksadecimalni, B64 za base 64.

**Način upotrebe:**

- Ključna riječ SHA256 može se koristiti u svim poljima tipa „expression“, kao što su operacije COPY, MODVALUE itd.
- Evaluirani izraz može sadržavati ključne riječi za dohvaćanje vrijednosti atributa, na primjer SyncAttSrc ili SyncAttDst.

## TOKRIGHT

Dohvaća dio znakovnog niza od n-tog objekta brojeći zdesna.

**Sintaksa funkcije:**

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

Objekt se nalazi između dvaju razdjelnika. Nije potrebno postaviti razdjelnik na početak i na kraj niza izraza.

**Način upotrebe:**

- Ključna riječ TOKRIGHT može se koristiti u svim poljima tipa „expression“, kao što su COPY, MODVALUE itd.
- Evaluirani izraz može sadržavati ključne riječi za dohvaćanje vrijednosti atributa, na primjer SyncAttSrc ili SyncAttDst.

**Primjeri konfiguracije:**

- Primjer:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Vraćeni rezultat: Level 4/ Level 5

## CENTER

Dohvaća znakove iz sredine brisanjem određenog broja znakova slijeva i zdesna.

**Sintaksa funkcije:**

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

**Način upotrebe:**

- Ključna riječ CENTER može se koristiti u svim poljima tipa „expression“, kao što su operacije tipa COPY, MODVALUE itd.
- Evaluirani izraz može sadržavati ključne riječi za dohvaćanje vrijednosti atributa, na primjer SyncAttSrc ili SyncAttDst.

## REWRITEURL

Prepisivanje URL-a.

**Sintaksa funkcije:**

<REWRITEURL:[url]>

**Način upotrebe:**

- Ključna riječ REWRITEURL može se koristiti u svim poljima tipa „expression“, kao što su COPY, MODVALUE itd.

**Primjeri konfiguracije:**

- Primjer:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Vraćeni rezultat: http://www.avencis.net

## GEN_PASSWORD

Generiranje lozinke na temelju maske, uz podršku za posebne znakove definirane u postavkama.

**Sintaksa funkcije:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Format lozinke mora se definirati sljedećim elementima:

- U Veliko slovo
- L Malo slovo
- A Veliko ili malo slovo
- N Znamenka
- S Poseban znak s popisa [special_characters]
- X Svi znakovi (U+L+N+S)

**Način upotrebe:**

- Ključna riječ GEN_PASSWORD može se koristiti u svim poljima tipa „expression“, kao što su operacije COPY, MODVALUE itd.

**Primjeri konfiguracije:**

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

## B64ENCODEASCII

Pretvara izraz u ASCII, a zatim vraća niz kodiran u B64.

**Sintaksa funkcije:**

<B64ENCODEASCII:[Expression]>

**Način upotrebe:**

- Ključna riječ B64ENCODEASCII može se koristiti u svim poljima tipa „expression“, kao što su operacije COPY, MODVALUE itd.
- Evaluirani izraz može sadržavati ključne riječi za dohvaćanje vrijednosti atributa, na primjer SyncAttSrc ili SyncAttDst.

## B64SID2STRING

Pretvara SID u Base64 i vraća niz u formatu Unicode.

**Sintaksa funkcije:**

<B64SID2STRING:[Expression]>

**Način upotrebe:**

- Ključna riječ B64SID2STRING može se koristiti u svim poljima tipa „expression“, kao što su operacije COPY, MODVALUE itd.
- Evaluirani izraz može sadržavati ključne riječi za dohvaćanje vrijednosti atributa, na primjer SyncAttSrc ili SyncAttDst.

## FIND

Funkcija za pronalaženje položaja znakovnog niza unutar drugog znakovnog niza. Vraća indeks položaja (počevši od indeksa 0) ako je niz pronađen, a u suprotnom vraća duljinu niza.

**Sintaksa funkcije:**

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

Indeks počinje od položaja 0.

**Način upotrebe:**

- Operacija FIND može se koristiti u svim poljima tipa „expression“, kao što su COPY, MODVALUE itd.
- Različiti nizovi koji se koriste u izrazu mogu sadržavati ključne riječi za dohvaćanje vrijednosti atributa, na primjer SyncAttSrc ili SyncAttDst.

**Primjeri konfiguracije:**

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

## SUBSTRING

Funkcija koja izdvaja znakovni niz iz drugog znakovnog niza. Vraća znakovni niz ako su proslijeđeni parametri valjani; u suprotnom vraća praznu vrijednost. **Sintaksa funkcije:**

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

Indeks počinje od položaja 0.

**Način upotrebe:**

- Operacija SUBSTRING može se koristiti u svim poljima tipa „expression“, kao što su COPY, MODVALUE itd.
- Različiti nizovi koji se koriste u izrazu mogu sadržavati ključne riječi za dohvaćanje vrijednosti atributa, na primjer SyncAttSrc ili SyncAttDst.

**Primjeri konfiguracije:**

- Primjer 1:
    - <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> uz <SyncAttSrc:DisplayName> = Carine HOPFNER
    - Rezultat = Carine

## LEN

Funkcija koja vraća duljinu znakovnog niza. Funkcija vraća 0 ako u konfiguraciji postoji pogreška.

**Sintaksa funkcije:**

<LEN:[chaîne_initiale]>

**Način upotrebe:**

- Operacija LEN može se koristiti u svim poljima tipa „expression“, kao što su COPY, MODVALUE itd.
- Različiti nizovi koji se koriste u izrazu mogu sadržavati ključne riječi za dohvaćanje vrijednosti atributa, na primjer SyncAttSrc ili SyncAttDst.

**Primjeri konfiguracije:**

- Primjer 1:
    - <LEN:<SyncAttSrc:DisplayName>> uz <SyncAttSrc:DisplayName> = Emilie Paris
    - Rezultat = 12

## REPLACE

Dostupno od verzije 7.0. Funkcija koja u zadanom nizu „initial_string“ zamjenjuje znakovni niz „string_to_replace“ nizom „destination_string“. Vraća izmijenjeni znakovni niz. Funkcija razlikuje velika i mala slova.

**Sintaksa funkcije:**

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

Boolean_all_or_first: može imati vrijednosti 0 ili 1. Ako je 0, zamjenjuje se samo prvo pronađeno pojavljivanje; ako je 1, zamjenjuju se sva pronađena pojavljivanja. Parametar nije obavezan; zadana vrijednost je 0.

Destination_string može biti prazan: u tom se slučaju niz koji treba zamijeniti jednostavno briše.

**Način upotrebe:**

- Operacija REPLACE može se koristiti u svim poljima tipa „expression“, kao što su COPY, MODVALUE itd.
- Različiti nizovi koji se koriste u izrazu mogu sadržavati ključne riječi za dohvaćanje vrijednosti atributa, na primjer SyncAttSrc ili SyncAttDst.

**Primjeri konfiguracije:**

- <REPLACE:XXXstringXXX:string:newString> vraća XXXnewStringXXX
- <REPLACE:XXXstringXXX:X::0> vraća XXstringXXX
- <REPLACE:XXXstringXXX:X::1> vraća string
- <REPLACE:XXXstringXXX:X:A:1> vraća AAAstringAAA
