Zum Inhalt

Zeichenketten

UPPER

Wandelt eine Textzeichenkette in Großbuchstaben um.

Syntax der Funktion:

<UPPER:[Expression]>

Verwendungsweise:

  • Das Schlüsselwort UPPER lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in Vorgängen des Typs COPY, MODVALUE usw.
  • Der ausgewertete Ausdruck kann Schlüsselwörter enthalten, um Attributwerte abzurufen, zum Beispiel SyncAttSrc oder SyncAttDst.

LOWER

Wandelt eine Textzeichenkette in Kleinbuchstaben um.

Syntax der Funktion:

<LOWER:[Expression]>

Verwendungsweise:

  • Das Schlüsselwort LOWER lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in Vorgängen des Typs COPY, MODVALUE usw.
  • Der ausgewertete Ausdruck kann Schlüsselwörter enthalten, um Attributwerte abzurufen, zum Beispiel SyncAttSrc oder SyncAttDst.

LEFT

Syntax der Funktion:

<LEFT:[Character_number]:[Expression]>

Verwendungsweise:

  • Das Schlüsselwort LEFT lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in Vorgängen des Typs COPY, MODVALUE usw.
  • Der ausgewertete Ausdruck kann Schlüsselwörter enthalten, um Attributwerte abzurufen, zum Beispiel SyncAttSrc oder SyncAttDst.

TOKLEFT

Ruft das n-te Objekt ab, von links gezählt.

Syntax der Funktion:

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

Ein Objekt steht zwischen zwei Trennzeichen. Es ist nicht erforderlich, am Anfang und am Ende der Ausdruckszeichenkette ein Trennzeichen zu setzen.

Verwendungsweise:

  • Das Schlüsselwort TOKLEFT lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in Vorgängen des Typs COPY, MODVALUE usw.
  • Der ausgewertete Ausdruck kann Schlüsselwörter enthalten, um Attributwerte abzurufen, zum Beispiel SyncAttSrc oder SyncAttDst.

Konfigurationsbeispiele:

  • Beispiel:
    • <TOKLEFT:/:3:Level 1/Level 2/Level 3/Level 4/ Level 5>
    • Zurückgegebenes Ergebnis: Level 3

Ruft eine Anzahl von Zeichen von rechts in einem Wert ab.

Syntax der Funktion:

<RIGHT:[Character_number]:[Expression]>

Verwendungsweise:

  • Das Schlüsselwort RIGHT lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in Vorgängen des Typs COPY, MODVALUE usw.
  • Der ausgewertete Ausdruck kann Schlüsselwörter enthalten, um Attributwerte abzurufen, zum Beispiel SyncAttSrc oder SyncAttDst.

SHA256

Verschlüsselt eine Zeichenkette in SHA256.

Syntax der Funktion:

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

Dabei gilt:

  • [string_encoding]: „UTF8“ oder „UTF16“. Die Codierung ist gemäß dem von der Zielanwendung erwarteten Format anzugeben. In den meisten Fällen ist UTF8 zu verwenden.
  • [Hex_B64]: „HEX“ oder „B64“, um das Format der Zeichenkette zu wählen. HEX für hexadezimal, B64 für Base 64.

Verwendungsweise:

  • Das Schlüsselwort SHA256 lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in den Vorgängen COPY, MODVALUE usw.
  • Der ausgewertete Ausdruck kann Schlüsselwörter enthalten, um Attributwerte abzurufen, zum Beispiel SyncAttSrc oder SyncAttDst.

TOKRIGHT

Ruft einen Teil einer Zeichenkette ab dem n-ten Objekt ab, von rechts gezählt.

Syntax der Funktion:

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

Ein Objekt steht zwischen zwei Trennzeichen. Es ist nicht erforderlich, am Anfang und am Ende der Ausdruckszeichenkette ein Trennzeichen zu setzen.

Verwendungsweise:

  • Das Schlüsselwort TOKRIGHT lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in COPY, MODVALUE usw.
  • Der ausgewertete Ausdruck kann Schlüsselwörter enthalten, um Attributwerte abzurufen, zum Beispiel SyncAttSrc oder SyncAttDst.

Konfigurationsbeispiele:

  • Beispiel:
    • <TOKLEFT:/:2:Level 1/Level 2/Level 3/Level 4/ Level 5>
    • Zurückgegebenes Ergebnis: Level 4/ Level 5

CENTER

Ruft die Zeichen in der Mitte ab, indem links und rechts eine Anzahl von Zeichen entfernt wird.

Syntax der Funktion:

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

Verwendungsweise:

  • Das Schlüsselwort CENTER lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in Vorgängen des Typs COPY, MODVALUE usw.
  • Der ausgewertete Ausdruck kann Schlüsselwörter enthalten, um Attributwerte abzurufen, zum Beispiel SyncAttSrc oder SyncAttDst.

REWRITEURL

Umschreiben einer URL.

Syntax der Funktion:

<REWRITEURL:[url]>

Verwendungsweise:

  • Das Schlüsselwort REWRITEURL lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in COPY, MODVALUE usw.

Konfigurationsbeispiele:

  • Beispiel:

    • <REWRITEURL:http%3F%3A%3Awww.avencis.net>
    • Zurückgegebenes Ergebnis: http://www.avencis.net

GEN_PASSWORD

Erzeugung eines Passworts anhand einer Maske und mit Unterstützung der in den Einstellungen festgelegten Sonderzeichen.

Syntax der Funktion:

<GEN_PASSWORD:[pwd_format]:[special_characters]>

Das Format des Passworts ist mit den folgenden Elementen festzulegen:

  • U Ein Großbuchstabe
  • L Ein Kleinbuchstabe
  • A Ein Groß- oder Kleinbuchstabe
  • N Eine Ziffer
  • S Ein Sonderzeichen aus der Liste [special_characters]
  • X Alle Zeichen (U+L+N+S)

Verwendungsweise:

  • Das Schlüsselwort GEN_PASSWORD lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in den Vorgängen COPY, MODVALUE usw.

Konfigurationsbeispiele:

  • Beispiel:
    • <GEN_PASSWORD:ULNXXXXXXX:,$£!§&#>

B64ENCODEASCII

Wandelt einen Ausdruck in ASCII um und gibt die Zeichenkette dann in B64 codiert zurück.

Syntax der Funktion:

<B64ENCODEASCII:[Expression]>

Verwendungsweise:

  • Das Schlüsselwort B64ENCODEASCII lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in den Vorgängen COPY, MODVALUE usw.
  • Der ausgewertete Ausdruck kann Schlüsselwörter enthalten, um Attributwerte abzurufen, zum Beispiel SyncAttSrc oder SyncAttDst.

B64SID2STRING

Wandelt einen SID in Base64 um und gibt die Zeichenkette im Unicode-Format zurück.

Syntax der Funktion:

<B64SID2STRING:[Expression]>

Verwendungsweise:

  • Das Schlüsselwort B64SID2STRING lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in den Vorgängen COPY, MODVALUE usw.
  • Der ausgewertete Ausdruck kann Schlüsselwörter enthalten, um Attributwerte abzurufen, zum Beispiel SyncAttSrc oder SyncAttDst.

FIND

Funktion, um die Position einer Zeichenkette innerhalb einer anderen Zeichenkette zu finden. Sie gibt den Index der Position zurück (beginnend bei Index 0), wenn die Zeichenkette gefunden wird, andernfalls die Länge der Zeichenkette.

Syntax der Funktion:

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

Der Index beginnt bei Position 0.

Verwendungsweise:

  • Der Vorgang FIND lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in COPY, MODVALUE usw.
  • Die im Ausdruck verwendeten Zeichenketten können Schlüsselwörter enthalten, um Attributwerte abzurufen, zum Beispiel SyncAttSrc oder SyncAttDst.

Konfigurationsbeispiele:

  • Beispiel 1:
    • <FIND:E:<SyncAttSrc:FIRSTNAME>:0> mit <SyncAttSrc:FIRSTNAME> = Emilie
    • Ergebnis = 0
  • Beispiel 2:
    • <FIND:I:<SyncAttSrc:FIRSTNAME>:0> mit <SyncAttSrc:FIRSTNAME> = Emilie
    • Ergebnis = 2
  • Beispiel 3:
    • <FIND:E:<SyncAttSrc:FIRSTNAME>:0> mit <SyncAttSrc:FIRSTNAME> = Paul
    • Ergebnis = 4

SUBSTRING

Funktion, die eine Zeichenkette aus einer anderen Zeichenkette entnimmt. Sie gibt die Zeichenkette zurück, wenn die übergebenen Parameter gültig sind; andernfalls gibt sie einen leeren Wert zurück. Syntax der Funktion:

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

Der Index beginnt bei Position 0.

Verwendungsweise:

  • Der Vorgang SUBSTRING lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in COPY, MODVALUE usw.
  • Die im Ausdruck verwendeten Zeichenketten können Schlüsselwörter enthalten, um Attributwerte abzurufen, zum Beispiel SyncAttSrc oder SyncAttDst.

Konfigurationsbeispiele:

  • Beispiel 1:
    • <SUBSTRING:<SyncAttSrc:DisplayName>:0:<FIND: :<SyncAttSrc:DisplayName>:0>> mit <SyncAttSrc:DisplayName> = Carine HOPFNER
    • Ergebnis = Carine

LEN

Funktion, die die Länge einer Zeichenkette zurückgibt. Die Funktion gibt 0 zurück, wenn die Konfiguration einen Fehler enthält.

Syntax der Funktion:

<LEN:[chaîne_initiale]>

Verwendungsweise:

  • Der Vorgang LEN lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in COPY, MODVALUE usw.
  • Die im Ausdruck verwendeten Zeichenketten können Schlüsselwörter enthalten, um Attributwerte abzurufen, zum Beispiel SyncAttSrc oder SyncAttDst.

Konfigurationsbeispiele:

  • Beispiel 1:
    • <LEN:<SyncAttSrc:DisplayName>> mit <SyncAttSrc:DisplayName> = Emilie Paris
    • Ergebnis = 12

REPLACE

Ab Version 7.0 verfügbar. Funktion, die in einer gegebenen Zeichenkette „initial_string“ die Zeichenkette „string_to_replace“ durch die Zeichenkette „destination_string“ ersetzt. Gibt die geänderte Zeichenkette zurück. Die Funktion unterscheidet Groß- und Kleinschreibung.

Syntax der Funktion:

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

Boolean_all_or_first: kann die Werte 0 oder 1 annehmen. Bei 0 wird nur das erste gefundene Vorkommen ersetzt; bei 1 werden alle gefundenen Vorkommen ersetzt. Der Parameter ist optional; der Standardwert ist 0.

Destination_string darf leer sein: in diesem Fall wird die zu ersetzende Zeichenkette einfach gelöscht.

Verwendungsweise:

  • Der Vorgang REPLACE lässt sich in allen Feldern des Typs „expression“ verwenden, etwa in COPY, MODVALUE usw.
  • Die im Ausdruck verwendeten Zeichenketten können Schlüsselwörter enthalten, um Attributwerte abzurufen, zum Beispiel SyncAttSrc oder SyncAttDst.

Konfigurationsbeispiele:

  • <REPLACE:XXXstringXXX:string:newString> gibt XXXnewStringXXX zurück
  • <REPLACE:XXXstringXXX:X::0> gibt XXstringXXX zurück
  • <REPLACE:XXXstringXXX:X::1> gibt string zurück
  • <REPLACE:XXXstringXXX:X:A:1> gibt AAAstringAAA zurück