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

# Teckensträngar

## UPPER

Omvandlar en textsträng till versaler.

**Funktionens syntax:**

<UPPER:[Expression]>

**Användningssätt:**

- Nyckelordet UPPER kan användas i alla fält av typen ”expression”, till exempel i operationer av typen COPY, MODVALUE osv.
- Det utvärderade uttrycket kan innehålla nyckelord för att hämta attributvärden, till exempel SyncAttSrc eller SyncAttDst.

## LOWER

Omvandlar en textsträng till gemener.

**Funktionens syntax:**

<LOWER:[Expression]>

**Användningssätt:**

- Nyckelordet LOWER kan användas i alla fält av typen ”expression”, till exempel i operationer av typen COPY, MODVALUE osv.
- Det utvärderade uttrycket kan innehålla nyckelord för att hämta attributvärden, till exempel SyncAttSrc eller SyncAttDst.

## LEFT

**Funktionens syntax:**

<LEFT:[Character_number]:[Expression]>

**Användningssätt:**

- Nyckelordet LEFT kan användas i alla fält av typen ”expression”, till exempel i operationer av typen COPY, MODVALUE osv.
- Det utvärderade uttrycket kan innehålla nyckelord för att hämta attributvärden, till exempel SyncAttSrc eller SyncAttDst.

## TOKLEFT

Hämtar det n:te objektet räknat från vänster.

**Funktionens syntax:**

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

Ett objekt står mellan två avgränsare. Det är inte nödvändigt att placera en avgränsare i början och i slutet av uttryckets sträng.

**Användningssätt:**

- Nyckelordet TOKLEFT kan användas i alla fält av typen ”expression”, till exempel i operationer av typen COPY, MODVALUE osv.
- Det utvärderade uttrycket kan innehålla nyckelord för att hämta attributvärden, till exempel SyncAttSrc eller SyncAttDst.

**Konfigurationsexempel:**

- Exempel:
    - <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Returnerat resultat: Level 3

## RIGHT

Hämtar ett antal tecken från höger i ett värde.

**Funktionens syntax:**

<RIGHT:[Character_number]:[Expression]>

**Användningssätt:**

- Nyckelordet RIGHT kan användas i alla fält av typen ”expression”, till exempel i operationer av typen COPY, MODVALUE osv.
- Det utvärderade uttrycket kan innehålla nyckelord för att hämta attributvärden, till exempel SyncAttSrc eller SyncAttDst.

## SHA256

Krypterar en teckensträng i SHA256.

**Funktionens syntax:**

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

Där:

- [string_encoding]: ”UTF8” eller ”UTF16”. Kodningen anges enligt det format som målapplikationen förväntar sig. UTF8 bör användas i de flesta fall.
- [Hex_B64]: ”HEX” eller ”B64” för att välja strängens format. HEX för hexadecimal, B64 för base 64.

**Användningssätt:**

- Nyckelordet SHA256 kan användas i alla fält av typen ”expression”, till exempel i operationerna COPY, MODVALUE osv.
- Det utvärderade uttrycket kan innehålla nyckelord för att hämta attributvärden, till exempel SyncAttSrc eller SyncAttDst.

## TOKRIGHT

Hämtar en del av en teckensträng från det n:te objektet räknat från höger.

**Funktionens syntax:**

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

Ett objekt står mellan två avgränsare. Det är inte nödvändigt att placera en avgränsare i början och i slutet av uttryckets sträng.

**Användningssätt:**

- Nyckelordet TOKRIGHT kan användas i alla fält av typen ”expression”, till exempel i COPY, MODVALUE osv.
- Det utvärderade uttrycket kan innehålla nyckelord för att hämta attributvärden, till exempel SyncAttSrc eller SyncAttDst.

**Konfigurationsexempel:**

- Exempel:
    - <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    - Returnerat resultat: Level 4/ Level 5

## CENTER

Hämtar tecknen i mitten genom att ta bort ett antal tecken till vänster och till höger.

**Funktionens syntax:**

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

**Användningssätt:**

- Nyckelordet CENTER kan användas i alla fält av typen ”expression”, till exempel i operationer av typen COPY, MODVALUE osv.
- Det utvärderade uttrycket kan innehålla nyckelord för att hämta attributvärden, till exempel SyncAttSrc eller SyncAttDst.

## REWRITEURL

Omskrivning av en URL.

**Funktionens syntax:**

<REWRITEURL:[url]>

**Användningssätt:**

- Nyckelordet REWRITEURL kan användas i alla fält av typen ”expression”, till exempel i COPY, MODVALUE osv.

**Konfigurationsexempel:**

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

## GEN_PASSWORD

Generering av ett lösenord utifrån en mask och med stöd för de specialtecken som fastställts i inställningarna.

**Funktionens syntax:**

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Lösenordets format måste fastställas med följande element:

- U En versal
- L En gemen
- A En versal eller en gemen
- N En siffra
- S Ett specialtecken från listan [special_characters]
- X Alla tecken (U+L+N+S)

**Användningssätt:**

- Nyckelordet GEN_PASSWORD kan användas i alla fält av typen ”expression”, till exempel i operationerna COPY, MODVALUE osv.

**Konfigurationsexempel:**

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

## B64ENCODEASCII

Omvandlar ett uttryck till ASCII och returnerar sedan strängen kodad i B64.

**Funktionens syntax:**

<B64ENCODEASCII:[Expression]>

**Användningssätt:**

- Nyckelordet B64ENCODEASCII kan användas i alla fält av typen ”expression”, till exempel i operationerna COPY, MODVALUE osv.
- Det utvärderade uttrycket kan innehålla nyckelord för att hämta attributvärden, till exempel SyncAttSrc eller SyncAttDst.

## B64SID2STRING

Omvandlar en SID till Base64 och returnerar strängen i Unicode-format.

**Funktionens syntax:**

<B64SID2STRING:[Expression]>

**Användningssätt:**

- Nyckelordet B64SID2STRING kan användas i alla fält av typen ”expression”, till exempel i operationerna COPY, MODVALUE osv.
- Det utvärderade uttrycket kan innehålla nyckelord för att hämta attributvärden, till exempel SyncAttSrc eller SyncAttDst.

## FIND

Funktion för att hitta positionen för en teckensträng inuti en annan teckensträng. Den returnerar positionens index (med början på index 0) om strängen hittas, annars returnerar den strängens längd.

**Funktionens syntax:**

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

Indexet börjar på position 0.

**Användningssätt:**

- Operationen FIND kan användas i alla fält av typen ”expression”, till exempel i COPY, MODVALUE osv.
- De olika strängar som används i uttrycket kan innehålla nyckelord för att hämta attributvärden, till exempel SyncAttSrc eller SyncAttDst.

**Konfigurationsexempel:**

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

## SUBSTRING

Funktion som extraherar en teckensträng ur en annan teckensträng. Den returnerar teckensträngen om de parametrar som skickas är giltiga; annars returnerar den ett tomt värde. **Funktionens syntax:**

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

Indexet börjar på position 0.

**Användningssätt:**

- Operationen SUBSTRING kan användas i alla fält av typen ”expression”, till exempel i COPY, MODVALUE osv.
- De olika strängar som används i uttrycket kan innehålla nyckelord för att hämta attributvärden, till exempel SyncAttSrc eller SyncAttDst.

**Konfigurationsexempel:**

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

## LEN

Funktion som returnerar längden på en teckensträng. Funktionen returnerar 0 om konfigurationen innehåller ett fel.

**Funktionens syntax:**

<LEN:[chaîne_initiale]>

**Användningssätt:**

- Operationen LEN kan användas i alla fält av typen ”expression”, till exempel i COPY, MODVALUE osv.
- De olika strängar som används i uttrycket kan innehålla nyckelord för att hämta attributvärden, till exempel SyncAttSrc eller SyncAttDst.

**Konfigurationsexempel:**

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

## REPLACE

Tillgänglig från version 7.0. Funktion som i en given sträng ”initial_string” ersätter teckensträngen ”string_to_replace” med strängen ”destination_string”. Returnerar den ändrade teckensträngen. Funktionen är skiftlägeskänslig.

**Funktionens syntax:**

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

Boolean_all_or_first: kan ha värdena 0 eller 1. Vid 0 ersätts bara den första förekomst som hittas; vid 1 ersätts alla förekomster som hittas. Parametern är valfri; standardvärdet är 0.

Destination_string kan vara tom: i detta fall tas den sträng som ska ersättas helt enkelt bort.

**Användningssätt:**

- Operationen REPLACE kan användas i alla fält av typen ”expression”, till exempel i COPY, MODVALUE osv.
- De olika strängar som används i uttrycket kan innehålla nyckelord för att hämta attributvärden, till exempel SyncAttSrc eller SyncAttDst.

**Konfigurationsexempel:**

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