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

# Łańcuchy znaków

## UPPER

Zamienia łańcuch tekstowy na wielkie litery.

**Składnia funkcji:**

<UPPER:[Expression]>

**Sposób użycia:**

- Słowo kluczowe UPPER można stosować we wszystkich polach typu „expression”, na przykład w operacjach typu COPY, MODVALUE itd.
- Oceniane wyrażenie może zawierać słowa kluczowe pobierające wartości atrybutów, na przykład SyncAttSrc lub SyncAttDst.

## LOWER

Zamienia łańcuch tekstowy na małe litery.

**Składnia funkcji:**

<LOWER:[Expression]>

**Sposób użycia:**

- Słowo kluczowe LOWER można stosować we wszystkich polach typu „expression”, na przykład w operacjach typu COPY, MODVALUE itd.
- Oceniane wyrażenie może zawierać słowa kluczowe pobierające wartości atrybutów, na przykład SyncAttSrc lub SyncAttDst.

## LEFT

**Składnia funkcji:**

<LEFT:[Character_number]:[Expression]>

**Sposób użycia:**

- Słowo kluczowe LEFT można stosować we wszystkich polach typu „expression”, na przykład w operacjach typu COPY, MODVALUE itd.
- Oceniane wyrażenie może zawierać słowa kluczowe pobierające wartości atrybutów, na przykład SyncAttSrc lub SyncAttDst.

## TOKLEFT

Pobiera n-ty obiekt licząc od lewej.

**Składnia funkcji:**

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

Obiekt znajduje się między dwoma separatorami. Nie jest konieczne umieszczanie separatora na początku i na końcu łańcucha wyrażenia.

**Sposób użycia:**

- Słowo kluczowe TOKLEFT można stosować we wszystkich polach typu „expression”, na przykład w operacjach typu COPY, MODVALUE itd.
- Oceniane wyrażenie może zawierać słowa kluczowe pobierające wartości atrybutów, na przykład SyncAttSrc lub SyncAttDst.

**Przykłady konfiguracji:**

- Przykład:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Zwrócony wynik: Level 3

## RIGHT

Pobiera pewną liczbę znaków od prawej strony wartości.

**Składnia funkcji:**

<RIGHT:[Character_number]:[Expression]>

**Sposób użycia:**

- Słowo kluczowe RIGHT można stosować we wszystkich polach typu „expression”, na przykład w operacjach typu COPY, MODVALUE itd.
- Oceniane wyrażenie może zawierać słowa kluczowe pobierające wartości atrybutów, na przykład SyncAttSrc lub SyncAttDst.

## SHA256

Szyfruje łańcuch znaków algorytmem SHA256.

**Składnia funkcji:**

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

Gdzie:

- [string_encoding]: „UTF8” lub „UTF16”. Kodowanie należy wskazać zgodnie z formatem oczekiwanym przez aplikację docelową. W większości przypadków należy użyć UTF8.
- [Hex_B64]: „HEX” lub „B64”, aby wybrać format łańcucha. HEX dla szesnastkowego, B64 dla base 64.

**Sposób użycia:**

- Słowo kluczowe SHA256 można stosować we wszystkich polach typu „expression”, na przykład w operacjach COPY, MODVALUE itd.
- Oceniane wyrażenie może zawierać słowa kluczowe pobierające wartości atrybutów, na przykład SyncAttSrc lub SyncAttDst.

## TOKRIGHT

Pobiera część łańcucha znaków od n-tego obiektu licząc od prawej.

**Składnia funkcji:**

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

Obiekt znajduje się między dwoma separatorami. Nie jest konieczne umieszczanie separatora na początku i na końcu łańcucha wyrażenia.

**Sposób użycia:**

- Słowo kluczowe TOKRIGHT można stosować we wszystkich polach typu „expression”, na przykład w COPY, MODVALUE itd.
- Oceniane wyrażenie może zawierać słowa kluczowe pobierające wartości atrybutów, na przykład SyncAttSrc lub SyncAttDst.

**Przykłady konfiguracji:**

- Przykład:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Zwrócony wynik: Level 4/ Level 5

## CENTER

Pobiera znaki ze środka, usuwając pewną liczbę znaków po lewej i po prawej stronie.

**Składnia funkcji:**

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

**Sposób użycia:**

- Słowo kluczowe CENTER można stosować we wszystkich polach typu „expression”, na przykład w operacjach typu COPY, MODVALUE itd.
- Oceniane wyrażenie może zawierać słowa kluczowe pobierające wartości atrybutów, na przykład SyncAttSrc lub SyncAttDst.

## REWRITEURL

Przepisanie adresu URL.

**Składnia funkcji:**

<REWRITEURL:[url]>

**Sposób użycia:**

- Słowo kluczowe REWRITEURL można stosować we wszystkich polach typu „expression”, na przykład w COPY, MODVALUE itd.

**Przykłady konfiguracji:**

- Przykład:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Zwrócony wynik: http://www.avencis.net

## GEN_PASSWORD

Generowanie hasła na podstawie maski, z obsługą znaków specjalnych zdefiniowanych w ustawieniach.

**Składnia funkcji:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Format hasła trzeba zdefiniować za pomocą następujących elementów:

- U Wielka litera
- L Mała litera
- A Wielka lub mała litera
- N Cyfra
- S Znak specjalny z listy [special_characters]
- X Wszystkie znaki (U+L+N+S)

**Sposób użycia:**

- Słowo kluczowe GEN_PASSWORD można stosować we wszystkich polach typu „expression”, na przykład w operacjach COPY, MODVALUE itd.

**Przykłady konfiguracji:**

- Przykład:
    - <GEN_PASSWORD:ULNXXXXXXX:,$£!§&#>

## B64ENCODEASCII

Konwertuje wyrażenie na ASCII, a następnie zwraca łańcuch zakodowany w B64.

**Składnia funkcji:**

<B64ENCODEASCII:[Expression]>

**Sposób użycia:**

- Słowo kluczowe B64ENCODEASCII można stosować we wszystkich polach typu „expression”, na przykład w operacjach COPY, MODVALUE itd.
- Oceniane wyrażenie może zawierać słowa kluczowe pobierające wartości atrybutów, na przykład SyncAttSrc lub SyncAttDst.

## B64SID2STRING

Konwertuje SID na Base64 i zwraca łańcuch w formacie Unicode.

**Składnia funkcji:**

<B64SID2STRING:[Expression]>

**Sposób użycia:**

- Słowo kluczowe B64SID2STRING można stosować we wszystkich polach typu „expression”, na przykład w operacjach COPY, MODVALUE itd.
- Oceniane wyrażenie może zawierać słowa kluczowe pobierające wartości atrybutów, na przykład SyncAttSrc lub SyncAttDst.

## FIND

Funkcja służąca do znalezienia pozycji łańcucha znaków w innym łańcuchu znaków. Zwraca indeks pozycji (licząc od indeksu 0), jeśli łańcuch został znaleziony, a w przeciwnym razie zwraca długość łańcucha.

**Składnia funkcji:**

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

Indeks zaczyna się od pozycji 0.

**Sposób użycia:**

- Operację FIND można stosować we wszystkich polach typu „expression”, na przykład w COPY, MODVALUE itd.
- Łańcuchy używane w wyrażeniu mogą zawierać słowa kluczowe pobierające wartości atrybutów, na przykład SyncAttSrc lub SyncAttDst.

**Przykłady konfiguracji:**

- Przykład 1:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> dla <SyncAttSrc:FIRSTNAME> = Emilie
    - Wynik = 0
- Przykład 2:
    - <FIND:I:<SyncAttSrc:FIRSTNAME>:0> dla <SyncAttSrc:FIRSTNAME> = Emilie
    - Wynik = 2
- Przykład 3:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> dla <SyncAttSrc:FIRSTNAME> = Paul
    - Wynik = 4

## SUBSTRING

Funkcja, która wyodrębnia łańcuch znaków z innego łańcucha znaków. Zwraca łańcuch znaków, jeśli przekazane parametry są poprawne; w przeciwnym razie zwraca wartość pustą. **Składnia funkcji:**

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

Indeks zaczyna się od pozycji 0.

**Sposób użycia:**

- Operację SUBSTRING można stosować we wszystkich polach typu „expression”, na przykład w COPY, MODVALUE itd.
- Łańcuchy używane w wyrażeniu mogą zawierać słowa kluczowe pobierające wartości atrybutów, na przykład SyncAttSrc lub SyncAttDst.

**Przykłady konfiguracji:**

- Przykład 1:
    - <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> dla <SyncAttSrc:DisplayName> = Carine HOPFNER
    - Wynik = Carine

## LEN

Funkcja zwracająca długość łańcucha znaków. Funkcja zwraca 0, jeśli konfiguracja zawiera błąd.

**Składnia funkcji:**

<LEN:[chaîne_initiale]>

**Sposób użycia:**

- Operację LEN można stosować we wszystkich polach typu „expression”, na przykład w COPY, MODVALUE itd.
- Łańcuchy używane w wyrażeniu mogą zawierać słowa kluczowe pobierające wartości atrybutów, na przykład SyncAttSrc lub SyncAttDst.

**Przykłady konfiguracji:**

- Przykład 1:
    - <LEN:<SyncAttSrc:DisplayName>> dla <SyncAttSrc:DisplayName> = Emilie Paris
    - Wynik = 12

## REPLACE

Dostępna od wersji 7.0. Funkcja, która w danym łańcuchu „initial_string” zastępuje łańcuch znaków „string_to_replace” łańcuchem „destination_string”. Zwraca zmieniony łańcuch znaków. Funkcja rozróżnia wielkie i małe litery.

**Składnia funkcji:**

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

Boolean_all_or_first: może przyjmować wartości 0 lub 1. Przy 0 zastępowane jest tylko pierwsze znalezione wystąpienie; przy 1 zastępowane są wszystkie znalezione wystąpienia. Parametr jest opcjonalny; wartość domyślna to 0.

Destination_string może być pusty: w tym przypadku łańcuch do zastąpienia jest po prostu usuwany.

**Sposób użycia:**

- Operację REPLACE można stosować we wszystkich polach typu „expression”, na przykład w COPY, MODVALUE itd.
- Łańcuchy używane w wyrażeniu mogą zawierać słowa kluczowe pobierające wartości atrybutów, na przykład SyncAttSrc lub SyncAttDst.

**Przykłady konfiguracji:**

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