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

# Sensiliet ta’ karattri

## UPPER

Tikkonverti sensiela ta’ test f’ittri kbar.

**Sintassi tal-funzjoni:**

<UPPER:[Expression]>

**Mod ta’ użu:**

- Il-kelma ewlenija UPPER tista’ tintuża fl-oqsma kollha tat-tip “expression” bħall-operazzjonijiet tat-tip COPY, MODVALUE, eċċ.
- L-espressjoni evalwata jista’ jkun fiha kliem ewlieni biex jinkisbu l-valuri tal-attributi, pereżempju SyncAttSrc jew SyncAttDst.

## LOWER

Tikkonverti sensiela ta’ test f’ittri żgħar.

**Sintassi tal-funzjoni:**

<LOWER:[Expression]>

**Mod ta’ użu:**

- Il-kelma ewlenija LOWER tista’ tintuża fl-oqsma kollha tat-tip “expression” bħall-operazzjonijiet tat-tip COPY, MODVALUE, eċċ.
- L-espressjoni evalwata jista’ jkun fiha kliem ewlieni biex jinkisbu l-valuri tal-attributi, pereżempju SyncAttSrc jew SyncAttDst.

## LEFT

**Sintassi tal-funzjoni:**

<LEFT:[Character_number]:[Expression]>

**Mod ta’ użu:**

- Il-kelma ewlenija LEFT tista’ tintuża fl-oqsma kollha tat-tip “expression” bħall-operazzjonijiet tat-tip COPY, MODVALUE, eċċ.
- L-espressjoni evalwata jista’ jkun fiha kliem ewlieni biex jinkisbu l-valuri tal-attributi, pereżempju SyncAttSrc jew SyncAttDst.

## TOKLEFT

Tikseb l-oġġett numru n, magħdud mix-xellug.

**Sintassi tal-funzjoni:**

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

Oġġett huwa magħluq bejn żewġ separaturi. Mhux meħtieġ li tqiegħed separatur fil-bidu u fit-tmiem tas-sensiela tal-espressjoni.

**Mod ta’ użu:**

- Il-kelma ewlenija TOKLEFT tista’ tintuża fl-oqsma kollha tat-tip “expression” bħall-operazzjonijiet tat-tip COPY, MODVALUE, eċċ.
- L-espressjoni evalwata jista’ jkun fiha kliem ewlieni biex jinkisbu l-valuri tal-attributi, pereżempju SyncAttSrc jew SyncAttDst.

**Eżempji ta’ konfigurazzjoni:**

- Eżempju:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Riżultat mogħti: Level 3

## RIGHT

Tikseb numru ta’ karattri min-naħa tal-lemin ta’ valur.

**Sintassi tal-funzjoni:**

<RIGHT:[Character_number]:[Expression]>

**Mod ta’ użu:**

- Il-kelma ewlenija RIGHT tista’ tintuża fl-oqsma kollha tat-tip “expression” bħall-operazzjonijiet tat-tip COPY, MODVALUE, eċċ.
- L-espressjoni evalwata jista’ jkun fiha kliem ewlieni biex jinkisbu l-valuri tal-attributi, pereżempju SyncAttSrc jew SyncAttDst.

## SHA256

Tikkriptja sensiela ta’ karattri bl-algoritmu SHA256.

**Sintassi tal-funzjoni:**

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

Fejn:

- [string_encoding]: “UTF8” jew “UTF16”. Kodifikazzjoni li għandha tiġi speċifikata skont il-format mistenni mill-applikazzjoni tad-destinazzjoni. Fil-biċċa l-kbira tal-każijiet għandu jintuża UTF8.
- [Hex_B64]: “HEX” jew “B64” biex tagħżel il-format tas-sensiela. HEX għal eżadeċimali, B64 għal base 64.

**Mod ta’ użu:**

- Il-kelma ewlenija SHA256 tista’ tintuża fl-oqsma kollha tat-tip “expression” bħall-operazzjonijiet COPY, MODVALUE, eċċ.
- L-espressjoni evalwata jista’ jkun fiha kliem ewlieni biex jinkisbu l-valuri tal-attributi, pereżempju SyncAttSrc jew SyncAttDst.

## TOKRIGHT

Tikseb parti minn sensiela ta’ karattri billi tibda mill-oġġett numru n, magħdud mil-lemin.

**Sintassi tal-funzjoni:**

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

Oġġett huwa magħluq bejn żewġ separaturi. Mhux meħtieġ li tqiegħed separatur fil-bidu u fit-tmiem tas-sensiela tal-espressjoni.

**Mod ta’ użu:**

- Il-kelma ewlenija TOKRIGHT tista’ tintuża fl-oqsma kollha tat-tip “expression” bħal COPY, MODVALUE, eċċ.
- L-espressjoni evalwata jista’ jkun fiha kliem ewlieni biex jinkisbu l-valuri tal-attributi, pereżempju SyncAttSrc jew SyncAttDst.

**Eżempji ta’ konfigurazzjoni:**

- Eżempju:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Riżultat mogħti: Level 4/ Level 5

## CENTER

Tikseb il-karattri li jinsabu fin-nofs billi tħassar numru ta’ karattri fuq ix-xellug u fuq il-lemin.

**Sintassi tal-funzjoni:**

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

**Mod ta’ użu:**

- Il-kelma ewlenija CENTER tista’ tintuża fl-oqsma kollha tat-tip “expression” bħall-operazzjonijiet tat-tip COPY, MODVALUE, eċċ.
- L-espressjoni evalwata jista’ jkun fiha kliem ewlieni biex jinkisbu l-valuri tal-attributi, pereżempju SyncAttSrc jew SyncAttDst.

## REWRITEURL

Kitba mill-ġdid ta’ URL.

**Sintassi tal-funzjoni:**

<REWRITEURL:[url]>

**Mod ta’ użu:**

- Il-kelma ewlenija REWRITEURL tista’ tintuża fl-oqsma kollha tat-tip “expression” bħal COPY, MODVALUE, eċċ.

**Eżempji ta’ konfigurazzjoni:**

- Eżempju:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Riżultat mogħti: http://www.avencis.net

## GEN_PASSWORD

Ġenerazzjoni ta’ password ibbażata fuq maskra u b’appoġġ għall-karattri speċjali definiti fis-settings.

**Sintassi tal-funzjoni:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Il-format tal-password għandu jiġi definit bl-elementi li ġejjin:

- U Ittra kbira
- L Ittra żgħira
- A Ittra kbira jew żgħira
- N Ċifra
- S Karattru speċjali mil-lista [special_characters]
- X Il-karattri kollha (U+L+N+S)

**Mod ta’ użu:**

- Il-kelma ewlenija GEN_PASSWORD tista’ tintuża fl-oqsma kollha tat-tip “expression” bħall-operazzjonijiet COPY, MODVALUE, eċċ.

**Eżempji ta’ konfigurazzjoni:**

- Eżempju:
    - <GEN_PASSWORD:ULNXXXXXXX:,$£!§&#>

## B64ENCODEASCII

Tikkonverti espressjoni fil-format ASCII u mbagħad tagħti lura s-sensiela kodifikata fil-format B64.

**Sintassi tal-funzjoni:**

<B64ENCODEASCII:[Expression]>

**Mod ta’ użu:**

- Il-kelma ewlenija B64ENCODEASCII tista’ tintuża fl-oqsma kollha tat-tip “expression” bħall-operazzjonijiet COPY, MODVALUE, eċċ.
- L-espressjoni evalwata jista’ jkun fiha kliem ewlieni biex jinkisbu l-valuri tal-attributi, pereżempju SyncAttSrc jew SyncAttDst.

## B64SID2STRING

Tikkonverti SID fil-format Base64 u tagħti lura s-sensiela fil-format Unicode.

**Sintassi tal-funzjoni:**

<B64SID2STRING:[Expression]>

**Mod ta’ użu:**

- Il-kelma ewlenija B64SID2STRING tista’ tintuża fl-oqsma kollha tat-tip “expression” bħall-operazzjonijiet COPY, MODVALUE, eċċ.
- L-espressjoni evalwata jista’ jkun fiha kliem ewlieni biex jinkisbu l-valuri tal-attributi, pereżempju SyncAttSrc jew SyncAttDst.

## FIND

Funzjoni biex tinstab il-pożizzjoni ta’ sensiela ta’ karattri ġewwa sensiela oħra ta’ karattri. Tagħti lura l-indiċi tal-pożizzjoni (li jibda mill-indiċi 0) jekk is-sensiela tinstab, inkella tagħti lura t-tul tas-sensiela.

**Sintassi tal-funzjoni:**

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

L-indiċi jibda mill-pożizzjoni 0.

**Mod ta’ użu:**

- L-operazzjoni FIND tista’ tintuża fl-oqsma kollha tat-tip “expression”, bħal COPY, MODVALUE, eċċ.
- Is-sensiliet differenti użati fl-espressjoni jista’ jkun fihom kliem ewlieni biex jinkisbu l-valuri tal-attributi, pereżempju SyncAttSrc jew SyncAttDst.

**Eżempji ta’ konfigurazzjoni:**

- Eżempju 1:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> fejn <SyncAttSrc:FIRSTNAME> = Emilie
    - Riżultat = 0
- Eżempju 2:
    - <FIND:I:<SyncAttSrc:FIRSTNAME>:0> fejn <SyncAttSrc:FIRSTNAME> = Emilie
    - Riżultat = 2
- Eżempju 3:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> fejn <SyncAttSrc:FIRSTNAME> = Paul
    - Riżultat = 4

## SUBSTRING

Funzjoni li toħroġ sensiela ta’ karattri minn sensiela oħra ta’ karattri. Tagħti lura s-sensiela ta’ karattri jekk il-parametri mgħoddija jkunu validi; inkella tagħti lura valur vojt. **Sintassi tal-funzjoni:**

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

L-indiċi jibda mill-pożizzjoni 0.

**Mod ta’ użu:**

- L-operazzjoni SUBSTRING tista’ tintuża fl-oqsma kollha tat-tip “expression” bħal COPY, MODVALUE, eċċ.
- Is-sensiliet differenti użati fl-espressjoni jista’ jkun fihom kliem ewlieni biex jinkisbu l-valuri tal-attributi, pereżempju SyncAttSrc jew SyncAttDst.

**Eżempji ta’ konfigurazzjoni:**

- Eżempju 1:
    - <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> fejn <SyncAttSrc:DisplayName> = Carine HOPFNER
    - Riżultat = Carine

## LEN

Funzjoni li tagħti lura t-tul ta’ sensiela ta’ karattri. Il-funzjoni tagħti lura 0 jekk ikun hemm żball fil-konfigurazzjoni.

**Sintassi tal-funzjoni:**

<LEN:[chaîne_initiale]>

**Mod ta’ użu:**

- L-operazzjoni LEN tista’ tintuża fl-oqsma kollha tat-tip “expression”, bħal COPY, MODVALUE, eċċ.
- Is-sensiliet differenti użati fl-espressjoni jista’ jkun fihom kliem ewlieni biex jinkisbu l-valuri tal-attributi, pereżempju SyncAttSrc jew SyncAttDst.

**Eżempji ta’ konfigurazzjoni:**

- Eżempju 1:
    - <LEN:<SyncAttSrc:DisplayName>> fejn <SyncAttSrc:DisplayName> = Emilie Paris
    - Riżultat = 12

## REPLACE

Disponibbli mill-verżjoni 7.0 ’il quddiem. Funzjoni li tissostitwixxi s-sensiela ta’ karattri “string_to_replace” f’sensiela partikolari “initial_string” bis-sensiela “destination_string”. Tagħti lura s-sensiela ta’ karattri modifikata. Il-funzjoni tagħmel distinzjoni bejn ittri kbar u ittri żgħar.

**Sintassi tal-funzjoni:**

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

Boolean_all_or_first: jista’ jieħu l-valuri 0 jew 1. Jekk 0, tiġi sostitwita biss l-ewwel okkorrenza misjuba; jekk 1, jiġu sostitwiti l-okkorrenzi kollha misjuba. Il-parametru huwa fakultattiv; il-valur default huwa 0.

Destination_string tista’ tkun vojta: f’dan il-każ, is-sensiela li għandha tiġi sostitwita sempliċement titħassar.

**Mod ta’ użu:**

- L-operazzjoni REPLACE tista’ tintuża fl-oqsma kollha tat-tip “expression”, bħal COPY, MODVALUE, eċċ.
- Is-sensiliet differenti użati fl-espressjoni jista’ jkun fihom kliem ewlieni biex jinkisbu l-valuri tal-attributi, pereżempju SyncAttSrc jew SyncAttDst.

**Eżempji ta’ konfigurazzjoni:**

- <REPLACE:XXXstringXXX:string:newString> jagħti lura XXXnewStringXXX
- <REPLACE:XXXstringXXX:X::0> jagħti lura XXstringXXX
- <REPLACE:XXXstringXXX:X::1> jagħti lura string
- <REPLACE:XXXstringXXX:X:A:1> jagħti lura AAAstringAAA
