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

# Tekststrenger

## UPPER

Konverterer en tekststreng til store bokstaver.

**Syntaks for funksjonen:**

<UPPER:[Expression]>

**Bruksmåte:**

- Nøkkelordet UPPER kan brukes i alle felt av typen ”expression”, som operasjoner av typen COPY, MODVALUE osv.
- Uttrykket som vurderes, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

## LOWER

Konverterer en tekststreng til små bokstaver.

**Syntaks for funksjonen:**

<LOWER:[Expression]>

**Bruksmåte:**

- Nøkkelordet LOWER kan brukes i alle felt av typen ”expression”, som operasjoner av typen COPY, MODVALUE osv.
- Uttrykket som vurderes, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

## LEFT

**Syntaks for funksjonen:**

<LEFT:[Character_number]:[Expression]>

**Bruksmåte:**

- Nøkkelordet LEFT kan brukes i alle felt av typen ”expression”, som operasjoner av typen COPY, MODVALUE osv.
- Uttrykket som vurderes, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

## TOKLEFT

Henter det n-te objektet regnet fra venstre.

**Syntaks for funksjonen:**

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

Et objekt står mellom to skilletegn. Det er ikke nødvendig å plassere et skilletegn i begynnelsen og på slutten av uttrykksstrengen.

**Bruksmåte:**

- Nøkkelordet TOKLEFT kan brukes i alle felt av typen ”expression”, som operasjoner av typen COPY, MODVALUE osv.
- Uttrykket som vurderes, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfigurasjon:**

- Eksempel:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Resultat som returneres: Level 3

## RIGHT

Henter et antall tegn fra høyre i en verdi.

**Syntaks for funksjonen:**

<RIGHT:[Character_number]:[Expression]>

**Bruksmåte:**

- Nøkkelordet RIGHT kan brukes i alle felt av typen ”expression”, som operasjoner av typen COPY, MODVALUE osv.
- Uttrykket som vurderes, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

## SHA256

Krypterer en tekststreng i SHA256.

**Syntaks for funksjonen:**

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

Der:

- [string_encoding]: ”UTF8” eller ”UTF16”. Kodingen angis i samsvar med formatet målapplikasjonen forventer. UTF8 bør brukes i de fleste tilfeller.
- [Hex_B64]: ”HEX” eller ”B64” for å velge formatet på strengen. HEX for heksadesimal, B64 for base 64.

**Bruksmåte:**

- Nøkkelordet SHA256 kan brukes i alle felt av typen ”expression”, som operasjonene COPY, MODVALUE osv.
- Uttrykket som vurderes, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

## TOKRIGHT

Henter en del av en tekststreng fra det n-te objektet regnet fra høyre.

**Syntaks for funksjonen:**

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

Et objekt står mellom to skilletegn. Det er ikke nødvendig å plassere et skilletegn i begynnelsen og på slutten av uttrykksstrengen.

**Bruksmåte:**

- Nøkkelordet TOKRIGHT kan brukes i alle felt av typen ”expression”, som COPY, MODVALUE osv.
- Uttrykket som vurderes, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfigurasjon:**

- Eksempel:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Resultat som returneres: Level 4/ Level 5

## CENTER

Henter tegnene i midten ved å fjerne et antall tegn til venstre og til høyre.

**Syntaks for funksjonen:**

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

**Bruksmåte:**

- Nøkkelordet CENTER kan brukes i alle felt av typen ”expression”, som operasjoner av typen COPY, MODVALUE osv.
- Uttrykket som vurderes, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

## REWRITEURL

Omskriving av en URL.

**Syntaks for funksjonen:**

<REWRITEURL:[url]>

**Bruksmåte:**

- Nøkkelordet REWRITEURL kan brukes i alle felt av typen ”expression”, som COPY, MODVALUE osv.

**Eksempler på konfigurasjon:**

- Eksempel:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Resultat som returneres: http://www.avencis.net

## GEN_PASSWORD

Generering av et passord ut fra en maske og med støtte for spesialtegnene som er fastsatt i innstillingene.

**Syntaks for funksjonen:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Formatet på passordet må fastsettes med følgende elementer:

- U En stor bokstav
- L En liten bokstav
- A En stor eller liten bokstav
- N Et siffer
- S Et spesialtegn fra listen [special_characters]
- X Alle tegn (U+L+N+S)

**Bruksmåte:**

- Nøkkelordet GEN_PASSWORD kan brukes i alle felt av typen ”expression”, som operasjonene COPY, MODVALUE osv.

**Eksempler på konfigurasjon:**

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

## B64ENCODEASCII

Konverterer et uttrykk til ASCII og returnerer deretter strengen kodet i B64.

**Syntaks for funksjonen:**

<B64ENCODEASCII:[Expression]>

**Bruksmåte:**

- Nøkkelordet B64ENCODEASCII kan brukes i alle felt av typen ”expression”, som operasjonene COPY, MODVALUE osv.
- Uttrykket som vurderes, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

## B64SID2STRING

Konverterer en SID til Base64 og returnerer strengen i Unicode-format.

**Syntaks for funksjonen:**

<B64SID2STRING:[Expression]>

**Bruksmåte:**

- Nøkkelordet B64SID2STRING kan brukes i alle felt av typen ”expression”, som operasjonene COPY, MODVALUE osv.
- Uttrykket som vurderes, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

## FIND

Funksjon for å finne posisjonen til en tekststreng inne i en annen tekststreng. Den returnerer indeksen til posisjonen (som begynner på indeks 0) hvis strengen blir funnet, ellers returnerer den lengden på strengen.

**Syntaks for funksjonen:**

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

Indeksen begynner på posisjon 0.

**Bruksmåte:**

- Operasjonen FIND kan brukes i alle felt av typen ”expression”, som COPY, MODVALUE osv.
- De ulike strengene som brukes i uttrykket, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfigurasjon:**

- Eksempel 1:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> med <SyncAttSrc:FIRSTNAME> = Emilie
    - Resultat = 0
- Eksempel 2:
    - <FIND:I:<SyncAttSrc:FIRSTNAME>:0> med <SyncAttSrc:FIRSTNAME> = Emilie
    - Resultat = 2
- Eksempel 3:
    - <FIND:E:<SyncAttSrc:FIRSTNAME>:0> med <SyncAttSrc:FIRSTNAME> = Paul
    - Resultat = 4

## SUBSTRING

Funksjon som henter ut en tekststreng fra en annen tekststreng. Den returnerer tekststrengen hvis parameterne som sendes, er gyldige; ellers returnerer den en tom verdi. **Syntaks for funksjonen:**

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

Indeksen begynner på posisjon 0.

**Bruksmåte:**

- Operasjonen SUBSTRING kan brukes i alle felt av typen ”expression”, som COPY, MODVALUE osv.
- De ulike strengene som brukes i uttrykket, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfigurasjon:**

- Eksempel 1:
    - <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> med <SyncAttSrc:DisplayName> = Carine HOPFNER
    - Resultat = Carine

## LEN

Funksjon som returnerer lengden på en tekststreng. Funksjonen returnerer 0 hvis konfigurasjonen inneholder en feil.

**Syntaks for funksjonen:**

<LEN:[chaîne_initiale]>

**Bruksmåte:**

- Operasjonen LEN kan brukes i alle felt av typen ”expression”, som COPY, MODVALUE osv.
- De ulike strengene som brukes i uttrykket, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfigurasjon:**

- Eksempel 1:
    - <LEN:<SyncAttSrc:DisplayName>> med <SyncAttSrc:DisplayName> = Emilie Paris
    - Resultat = 12

## REPLACE

Tilgjengelig fra versjon 7.0. Funksjon som i en gitt streng ”initial_string” erstatter tekststrengen ”string_to_replace” med strengen ”destination_string”. Returnerer den endrede tekststrengen. Funksjonen skiller mellom store og små bokstaver.

**Syntaks for funksjonen:**

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

Boolean_all_or_first: kan ha verdiene 0 eller 1. Ved 0 erstattes bare den første forekomsten som blir funnet; ved 1 erstattes alle forekomstene som blir funnet. Parameteren er valgfri; standardverdien er 0.

Destination_string kan være tom: i så fall slettes strengen som skal erstattes, rett og slett.

**Bruksmåte:**

- Operasjonen REPLACE kan brukes i alle felt av typen ”expression”, som COPY, MODVALUE osv.
- De ulike strengene som brukes i uttrykket, kan inneholde nøkkelord for å hente attributtverdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfigurasjon:**

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