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

# Tegnstrenge

## UPPER

Konverterer en tekststreng til store bogstaver.

**Syntaks for funktionen:**

<UPPER:[Expression]>

**Anvendelsesmåde:**

- Nøgleordet UPPER kan bruges i alle felter af typen ”expression”, for eksempel i operationer af typen COPY, MODVALUE osv.
- Det udtryk, der evalueres, kan indeholde nøgleord til at hente attributværdier, for eksempel SyncAttSrc eller SyncAttDst.

## LOWER

Konverterer en tekststreng til små bogstaver.

**Syntaks for funktionen:**

<LOWER:[Expression]>

**Anvendelsesmåde:**

- Nøgleordet LOWER kan bruges i alle felter af typen ”expression”, for eksempel i operationer af typen COPY, MODVALUE osv.
- Det udtryk, der evalueres, kan indeholde nøgleord til at hente attributværdier, for eksempel SyncAttSrc eller SyncAttDst.

## LEFT

**Syntaks for funktionen:**

<LEFT:[Character_number]:[Expression]>

**Anvendelsesmåde:**

- Nøgleordet LEFT kan bruges i alle felter af typen ”expression”, for eksempel i operationer af typen COPY, MODVALUE osv.
- Det udtryk, der evalueres, kan indeholde nøgleord til at hente attributværdier, for eksempel SyncAttSrc eller SyncAttDst.

## TOKLEFT

Henter det n'te objekt regnet fra venstre.

**Syntaks for funktionen:**

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

Et objekt står mellem to separatorer. Det er ikke nødvendigt at sætte en separator i begyndelsen og i slutningen af udtryksstrengen.

**Anvendelsesmåde:**

- Nøgleordet TOKLEFT kan bruges i alle felter af typen ”expression”, for eksempel i operationer af typen COPY, MODVALUE osv.
- Det udtryk, der evalueres, kan indeholde nøgleord til at hente attributværdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfiguration:**

- Eksempel:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Returneret resultat: Level 3

## RIGHT

Henter et antal tegn fra højre i en værdi.

**Syntaks for funktionen:**

<RIGHT:[Character_number]:[Expression]>

**Anvendelsesmåde:**

- Nøgleordet RIGHT kan bruges i alle felter af typen ”expression”, for eksempel i operationer af typen COPY, MODVALUE osv.
- Det udtryk, der evalueres, kan indeholde nøgleord til at hente attributværdier, for eksempel SyncAttSrc eller SyncAttDst.

## SHA256

Krypterer en tegnstreng i SHA256.

**Syntaks for funktionen:**

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

Hvor:

- [string_encoding]: ”UTF8” eller ”UTF16”. Kodningen skal angives efter det format, målapplikationen forventer. I de fleste tilfælde skal UTF8 bruges.
- [Hex_B64]: ”HEX” eller ”B64” til at vælge strengens format. HEX for hexadecimal, B64 for base 64.

**Anvendelsesmåde:**

- Nøgleordet SHA256 kan bruges i alle felter af typen ”expression”, for eksempel i operationerne COPY, MODVALUE osv.
- Det udtryk, der evalueres, kan indeholde nøgleord til at hente attributværdier, for eksempel SyncAttSrc eller SyncAttDst.

## TOKRIGHT

Henter en del af en tegnstreng fra det n'te objekt regnet fra højre.

**Syntaks for funktionen:**

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

Et objekt står mellem to separatorer. Det er ikke nødvendigt at sætte en separator i begyndelsen og i slutningen af udtryksstrengen.

**Anvendelsesmåde:**

- Nøgleordet TOKRIGHT kan bruges i alle felter af typen ”expression”, for eksempel i COPY, MODVALUE osv.
- Det udtryk, der evalueres, kan indeholde nøgleord til at hente attributværdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfiguration:**

- Eksempel:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Returneret resultat: Level 4/ Level 5

## CENTER

Henter tegnene i midten ved at fjerne et antal tegn til venstre og til højre.

**Syntaks for funktionen:**

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

**Anvendelsesmåde:**

- Nøgleordet CENTER kan bruges i alle felter af typen ”expression”, for eksempel i operationer af typen COPY, MODVALUE osv.
- Det udtryk, der evalueres, kan indeholde nøgleord til at hente attributværdier, for eksempel SyncAttSrc eller SyncAttDst.

## REWRITEURL

Omskrivning af en URL.

**Syntaks for funktionen:**

<REWRITEURL:[url]>

**Anvendelsesmåde:**

- Nøgleordet REWRITEURL kan bruges i alle felter af typen ”expression”, for eksempel i COPY, MODVALUE osv.

**Eksempler på konfiguration:**

- Eksempel:
    - <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    - Returneret resultat: http://www.avencis.net

## GEN_PASSWORD

Generering af en adgangskode ud fra en maske og med understøttelse af de specialtegn, der er fastlagt i indstillingerne.

**Syntaks for funktionen:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Adgangskodens format skal fastlægges med følgende elementer:

- U Et stort bogstav
- L Et lille bogstav
- A Et stort eller lille bogstav
- N Et tal
- S Et specialtegn fra listen [special_characters]
- X Alle tegn (U+L+N+S)

**Anvendelsesmåde:**

- Nøgleordet GEN_PASSWORD kan bruges i alle felter af typen ”expression”, for eksempel i operationerne COPY, MODVALUE osv.

**Eksempler på konfiguration:**

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

## B64ENCODEASCII

Konverterer et udtryk til ASCII og returnerer derefter strengen kodet i B64.

**Syntaks for funktionen:**

<B64ENCODEASCII:[Expression]>

**Anvendelsesmåde:**

- Nøgleordet B64ENCODEASCII kan bruges i alle felter af typen ”expression”, for eksempel i operationerne COPY, MODVALUE osv.
- Det udtryk, der evalueres, kan indeholde nøgleord til at hente attributværdier, for eksempel SyncAttSrc eller SyncAttDst.

## B64SID2STRING

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

**Syntaks for funktionen:**

<B64SID2STRING:[Expression]>

**Anvendelsesmåde:**

- Nøgleordet B64SID2STRING kan bruges i alle felter af typen ”expression”, for eksempel i operationerne COPY, MODVALUE osv.
- Det udtryk, der evalueres, kan indeholde nøgleord til at hente attributværdier, for eksempel SyncAttSrc eller SyncAttDst.

## FIND

Funktion, der finder positionen af en tegnstreng inde i en anden tegnstreng. Den returnerer positionens indeks (begyndende ved indeks 0), hvis strengen findes, ellers returnerer den strengens længde.

**Syntaks for funktionen:**

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

Indekset begynder ved position 0.

**Anvendelsesmåde:**

- Operationen FIND kan bruges i alle felter af typen ”expression”, for eksempel i COPY, MODVALUE osv.
- De forskellige strenge, der bruges i udtrykket, kan indeholde nøgleord til at hente attributværdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfiguration:**

- 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

Funktion, der udtrækker en tegnstreng fra en anden tegnstreng. Den returnerer tegnstrengen, hvis de overførte parametre er gyldige; ellers returnerer den en tom værdi. **Syntaks for funktionen:**

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

Indekset begynder ved position 0.

**Anvendelsesmåde:**

- Operationen SUBSTRING kan bruges i alle felter af typen ”expression”, for eksempel i COPY, MODVALUE osv.
- De forskellige strenge, der bruges i udtrykket, kan indeholde nøgleord til at hente attributværdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfiguration:**

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

## LEN

Funktion, der returnerer længden af en tegnstreng. Funktionen returnerer 0, hvis konfigurationen indeholder en fejl.

**Syntaks for funktionen:**

<LEN:[chaîne_initiale]>

**Anvendelsesmåde:**

- Operationen LEN kan bruges i alle felter af typen ”expression”, for eksempel i COPY, MODVALUE osv.
- De forskellige strenge, der bruges i udtrykket, kan indeholde nøgleord til at hente attributværdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfiguration:**

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

## REPLACE

Tilgængelig fra version 7.0. Funktion, der i en given streng ”initial_string” erstatter tegnstrengen ”string_to_replace” med strengen ”destination_string”. Returnerer den ændrede tegnstreng. Funktionen skelner mellem store og små bogstaver.

**Syntaks for funktionen:**

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

Boolean_all_or_first: kan antage værdierne 0 eller 1. Ved 0 erstattes kun den første forekomst, der findes; ved 1 erstattes alle forekomster, der findes. Parameteren er valgfri; standardværdien er 0.

Destination_string må være tom: i dette tilfælde slettes den streng, der skal erstattes, ganske enkelt.

**Anvendelsesmåde:**

- Operationen REPLACE kan bruges i alle felter af typen ”expression”, for eksempel i COPY, MODVALUE osv.
- De forskellige strenge, der bruges i udtrykket, kan indeholde nøgleord til at hente attributværdier, for eksempel SyncAttSrc eller SyncAttDst.

**Eksempler på konfiguration:**

- <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
