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