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

# Merkkijonot

## UPPER

Muuntaa tekstimerkkijonon isoiksi kirjaimiksi.

**Funktion syntaksi:**

<UPPER:[Expression]>

**Käyttötapa:**

- Avainsanaa UPPER voi käyttää kaikissa tyypin ”expression” kentissä, kuten tyyppien COPY, MODVALUE jne. toiminnoissa.
- Arvioitu lauseke voi sisältää avainsanoja attribuuttien arvojen hakemiseen, esimerkiksi SyncAttSrc tai SyncAttDst.

## LOWER

Muuntaa tekstimerkkijonon pieniksi kirjaimiksi.

**Funktion syntaksi:**

<LOWER:[Expression]>

**Käyttötapa:**

- Avainsanaa LOWER voi käyttää kaikissa tyypin ”expression” kentissä, kuten tyyppien COPY, MODVALUE jne. toiminnoissa.
- Arvioitu lauseke voi sisältää avainsanoja attribuuttien arvojen hakemiseen, esimerkiksi SyncAttSrc tai SyncAttDst.

## LEFT

**Funktion syntaksi:**

<LEFT:[Character_number]:[Expression]>

**Käyttötapa:**

- Avainsanaa LEFT voi käyttää kaikissa tyypin ”expression” kentissä, kuten tyyppien COPY, MODVALUE jne. toiminnoissa.
- Arvioitu lauseke voi sisältää avainsanoja attribuuttien arvojen hakemiseen, esimerkiksi SyncAttSrc tai SyncAttDst.

## TOKLEFT

Hakee n:nnen objektin vasemmalta laskien.

**Funktion syntaksi:**

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

Objekti on kahden erottimen välissä. Erotinta ei tarvitse sijoittaa lausekemerkkijonon alkuun eikä loppuun.

**Käyttötapa:**

- Avainsanaa TOKLEFT voi käyttää kaikissa tyypin ”expression” kentissä, kuten tyyppien COPY, MODVALUE jne. toiminnoissa.
- Arvioitu lauseke voi sisältää avainsanoja attribuuttien arvojen hakemiseen, esimerkiksi SyncAttSrc tai SyncAttDst.

**Määritysesimerkkejä:**

- Esimerkki:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Palautettu tulos: Level 3

## RIGHT

Hakee tietyn määrän merkkejä arvon oikealta puolelta.

**Funktion syntaksi:**

<RIGHT:[Character_number]:[Expression]>

**Käyttötapa:**

- Avainsanaa RIGHT voi käyttää kaikissa tyypin ”expression” kentissä, kuten tyyppien COPY, MODVALUE jne. toiminnoissa.
- Arvioitu lauseke voi sisältää avainsanoja attribuuttien arvojen hakemiseen, esimerkiksi SyncAttSrc tai SyncAttDst.

## SHA256

Salaa merkkijonon SHA256-muotoon.

**Funktion syntaksi:**

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

Tässä:

- [string_encoding]: ”UTF8” tai ”UTF16”. Koodaus ilmoitetaan kohdesovelluksen odottaman muodon mukaisesti. Useimmissa tapauksissa käytetään UTF8:aa.
- [Hex_B64]: ”HEX” tai ”B64” merkkijonon muodon valintaan. HEX tarkoittaa heksadesimaalia, B64 base 64:ää.

**Käyttötapa:**

- Avainsanaa SHA256 voi käyttää kaikissa tyypin ”expression” kentissä, kuten toiminnoissa COPY, MODVALUE jne.
- Arvioitu lauseke voi sisältää avainsanoja attribuuttien arvojen hakemiseen, esimerkiksi SyncAttSrc tai SyncAttDst.

## TOKRIGHT

Hakee merkkijonon osan n:nnestä objektista oikealta laskien.

**Funktion syntaksi:**

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

Objekti on kahden erottimen välissä. Erotinta ei tarvitse sijoittaa lausekemerkkijonon alkuun eikä loppuun.

**Käyttötapa:**

- Avainsanaa TOKRIGHT voi käyttää kaikissa tyypin ”expression” kentissä, kuten COPY, MODVALUE jne.
- Arvioitu lauseke voi sisältää avainsanoja attribuuttien arvojen hakemiseen, esimerkiksi SyncAttSrc tai SyncAttDst.

**Määritysesimerkkejä:**

- Esimerkki:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Palautettu tulos: Level 4/ Level 5

## CENTER

Hakee keskellä olevat merkit poistamalla tietyn määrän merkkejä vasemmalta ja oikealta.

**Funktion syntaksi:**

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

**Käyttötapa:**

- Avainsanaa CENTER voi käyttää kaikissa tyypin ”expression” kentissä, kuten tyyppien COPY, MODVALUE jne. toiminnoissa.
- Arvioitu lauseke voi sisältää avainsanoja attribuuttien arvojen hakemiseen, esimerkiksi SyncAttSrc tai SyncAttDst.

## REWRITEURL

URL-osoitteen uudelleenkirjoitus.

**Funktion syntaksi:**

<REWRITEURL:[url]>

**Käyttötapa:**

- Avainsanaa REWRITEURL voi käyttää kaikissa tyypin ”expression” kentissä, kuten COPY, MODVALUE jne.

**Määritysesimerkkejä:**

- Esimerkki:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Palautettu tulos: http://www.avencis.net

## GEN_PASSWORD

Salasanan luonti maskin perusteella ja asetuksissa määritettyjen erikoismerkkien tuella.

**Funktion syntaksi:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Salasanan muoto on määritettävä seuraavilla elementeillä:

- U Iso kirjain
- L Pieni kirjain
- A Iso tai pieni kirjain
- N Numero
- S Erikoismerkki luettelosta [special_characters]
- X Kaikki merkit (U+L+N+S)

**Käyttötapa:**

- Avainsanaa GEN_PASSWORD voi käyttää kaikissa tyypin ”expression” kentissä, kuten toiminnoissa COPY, MODVALUE jne.

**Määritysesimerkkejä:**

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

## B64ENCODEASCII

Muuntaa lausekkeen ASCII-muotoon ja palauttaa merkkijonon B64-koodattuna.

**Funktion syntaksi:**

<B64ENCODEASCII:[Expression]>

**Käyttötapa:**

- Avainsanaa B64ENCODEASCII voi käyttää kaikissa tyypin ”expression” kentissä, kuten toiminnoissa COPY, MODVALUE jne.
- Arvioitu lauseke voi sisältää avainsanoja attribuuttien arvojen hakemiseen, esimerkiksi SyncAttSrc tai SyncAttDst.

## B64SID2STRING

Muuntaa SID-tunnisteen Base64-muotoon ja palauttaa merkkijonon Unicode-muodossa.

**Funktion syntaksi:**

<B64SID2STRING:[Expression]>

**Käyttötapa:**

- Avainsanaa B64SID2STRING voi käyttää kaikissa tyypin ”expression” kentissä, kuten toiminnoissa COPY, MODVALUE jne.
- Arvioitu lauseke voi sisältää avainsanoja attribuuttien arvojen hakemiseen, esimerkiksi SyncAttSrc tai SyncAttDst.

## FIND

Funktio, joka etsii merkkijonon sijainnin toisen merkkijonon sisällä. Se palauttaa sijainnin indeksin (indeksointi alkaa nollasta), jos merkkijono löytyy, ja muussa tapauksessa merkkijonon pituuden.

**Funktion syntaksi:**

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

Indeksointi alkaa paikasta 0.

**Käyttötapa:**

- Toimintoa FIND voi käyttää kaikissa tyypin ”expression” kentissä, kuten COPY, MODVALUE jne.
- Lausekkeessa käytetyt eri merkkijonot voivat sisältää avainsanoja attribuuttien arvojen hakemiseen, esimerkiksi SyncAttSrc tai SyncAttDst.

**Määritysesimerkkejä:**

- Esimerkki 1:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0>, kun <SyncAttSrc:FIRSTNAME> = Emilie
    - Tulos = 0
- Esimerkki 2:
    - <FIND:I:<SyncAttSrc:FIRSTNAME>:0>, kun <SyncAttSrc:FIRSTNAME> = Emilie
    - Tulos = 2
- Esimerkki 3:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0>, kun <SyncAttSrc:FIRSTNAME> = Paul
    - Tulos = 4

## SUBSTRING

Funktio, joka poimii merkkijonon toisesta merkkijonosta. Se palauttaa merkkijonon, jos annetut parametrit ovat kelvollisia; muussa tapauksessa se palauttaa tyhjän arvon. **Funktion syntaksi:**

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

Indeksointi alkaa paikasta 0.

**Käyttötapa:**

- Toimintoa SUBSTRING voi käyttää kaikissa tyypin ”expression” kentissä, kuten COPY, MODVALUE jne.
- Lausekkeessa käytetyt eri merkkijonot voivat sisältää avainsanoja attribuuttien arvojen hakemiseen, esimerkiksi SyncAttSrc tai SyncAttDst.

**Määritysesimerkkejä:**

- Esimerkki 1:
    - <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>>, kun <SyncAttSrc:DisplayName> = Carine HOPFNER
    - Tulos = Carine

## LEN

Funktio, joka palauttaa merkkijonon pituuden. Funktio palauttaa 0, jos määrityksessä on virhe.

**Funktion syntaksi:**

<LEN:[chaîne_initiale]>

**Käyttötapa:**

- Toimintoa LEN voi käyttää kaikissa tyypin ”expression” kentissä, kuten COPY, MODVALUE jne.
- Lausekkeessa käytetyt eri merkkijonot voivat sisältää avainsanoja attribuuttien arvojen hakemiseen, esimerkiksi SyncAttSrc tai SyncAttDst.

**Määritysesimerkkejä:**

- Esimerkki 1:
    - <LEN:<SyncAttSrc:DisplayName>>, kun <SyncAttSrc:DisplayName> = Emilie Paris
    - Tulos = 12

## REPLACE

Käytettävissä versiosta 7.0 alkaen. Funktio, joka korvaa annetussa merkkijonossa ”initial_string” merkkijonon ”string_to_replace” merkkijonolla ”destination_string”. Palauttaa muutetun merkkijonon. Funktio erottaa isot ja pienet kirjaimet.

**Funktion syntaksi:**

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

Boolean_all_or_first: voi saada arvon 0 tai 1. Arvolla 0 korvataan vain ensimmäinen löytynyt esiintymä; arvolla 1 korvataan kaikki löytyneet esiintymät. Parametri on valinnainen; oletusarvo on 0.

Destination_string voi olla tyhjä: tässä tapauksessa korvattava merkkijono yksinkertaisesti poistetaan.

**Käyttötapa:**

- Toimintoa REPLACE voi käyttää kaikissa tyypin ”expression” kentissä, kuten COPY, MODVALUE jne.
- Lausekkeessa käytetyt eri merkkijonot voivat sisältää avainsanoja attribuuttien arvojen hakemiseen, esimerkiksi SyncAttSrc tai SyncAttDst.

**Määritysesimerkkejä:**

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