Mithilfe der Funktionen für Zeichenketten lassen sich Zeichenketten bearbeiten und abfragen. Zu den Funktionen für Zeichenketten gehören:

• char
• charAt
• decrypt
• encrypt
• endsWith
• format
• indexOf
• lastIndexOf
• length
• startsWith
• substring
• toHtml
• toLower
• toUpper
• trim
• unzipText

Grundlegende Informationen zu den allgemeinen Funktionen der System-Skriptsprache erhalten Sie im Dokument System-Skriptsprache: Allgemeine Funktionen.

char

Folgendes Beispiel aus der Aktivitätsdefinition help.char gibt das Unicode-Zeichen eines numerischen Codepunkts zurück:

function create()
{
var p_codepoint := parameters.CODEPOINT;
var r_char := char(p_codepoint);

result.VALUE := r_char;
}

charAt

Folgendes Beispiel aus der Aktivitätsdefinition help.charAt gibt den numerischen Codepunkt eines Unicode-Zeichens zurück:

function create()
{
var p_text := parameters.TEXT;
var p_index := parameters.INDEX;
var r_charAt := charAt(p_text, p_index);

result.IS_NULL := isNull(r_charAt);
result.VALUE := r_charAt;
}

decrypt

Folgendes Beispiel aus der Aktivitätsdefinition help.decrypt gibt mithilfe eines Schlüssels einen verschlüsselten Text unverschlüsselt zurück:

function create()
{
var p_encrypted_text := parameters.ENCRYPTED_TEXT;
var p_key := parameters.KEY;
var r_decrypted_text as String;

r_decrypted_text := decrypt(p_key, p_encrypted_text);

result.IS_NULL := isNull(r_decrypted_text);
result.DECRYPTED_TEXT := r_decrypted_text;
}

encrypt

Folgendes Beispiel aus der Aktivitätsdefinition help.encrypt verschlüsselt einen Text mithilfe eines Schlüssels:

function create()
{
var p_decrypted_text := parameters.DECRYPTED_TEXT;
var p_key := parameters.KEY;

var r_encrypted_text as String;

if(p_key <> "")
r_encrypted_text := encrypt(p_key, p_decrypted_text);
else
r_encrypted_text := encrypt(p_decrypted_text);

result.IS_NULL := isNull(r_encrypted_text);
result.ENCRYPTED_TEXT := r_encrypted_text;
}

endsWith

Folgendes Beispiel aus der Aktivitätsdefinition help.endsWith prüft, ob eine Zeichenkette mit einem bestimmten Suffix endet:

function create()
{
var p_text := parameters.TEXT;
var p_suffix := parameters.SUFFIX;
var r_endsWith := endsWith(p_text, p_suffix);

result.VALUE := r_endsWith;
}

format

Für eine Zahl stehen folgende Symbole für die Formatierung zur Verfügung:

Für ein CisDate und einen Zeitpunkt stehen folgende Symbole für die Formatierung zur Verfügung:

Sie können die Funktion formatz. B. für die folgenden Aufgaben verwenden:

• In der Aktivitätsbeschreibung sollen Ganzzahlen ohne Nachkommastellen geschrieben werden.
• Sie möchten Zahlen, CisDates und Zeitpunkte gemäß der Korrespondenzsprache des Empfängers einer E-Mail-Nachricht formatieren. Achten Sie darauf, dass die Funktion nullzurückgibt, wenn für die angegebene Sprache kein passendes Format existiert.
• Sie möchten für eine zu erzeugende Exportdatei einen eindeutigen Namen mit Zeitbezug vergeben.
• Sie möchten eine Importdatei erzeugen, um sie anschließend zu importieren. In diesem Fall können Sie eine Import-Vorlagendatei mit Platzhaltern im Knowledge Store hinterlegen und diese mithilfe der Funktion readTextFileVerwenden Sie anschießend format, um die Platzhalter mit konkreten Werten zu befüllen, und legen Sie dann die fertige Importdatei mithilfe der Funktion writeFilein den Knowledge Store für den Import ab.
• Sie möchten Textbausteine mit Platzhaltern in der Aktivitätsbeschreibung verwenden, um die Beschreibungen unabhängig von der Aktivitätsdefinition verwalten zu können.

Folgendes Beispiel aus der Aktivitätsdefinition help.format zeigt, wie die Datentypen für Datum, Datum und Zeit und Zahlen formatiert werden. Das Beispiel zeigt auch, wie Sie die Funktion format verwenden, um Platzhalter in einer Zeichenkette durch konkrete Werte zu ersetzen.

function create()
{
var p_date as CisDate;
var p_timestamp as Timestamp;
var p_number := parameters.NUMBER;
var p_pattern := parameters.PATTERN;
var p_language := parameters.LANGUAGE;
var p_parameters := parameters.PARAMETERS;

var r_date as String;
var r_timestamp as String;
var r_number as String;

p_date := today();
p_timestamp := now();

/* format CisDate, Timestamp and Number according to pattern */
if (p_language = "") {
r_date:= format(today(), p_pattern);
r_timestamp := format(p_timestamp, p_pattern);
r_number := format(p_number, p_pattern);
} else {
r_date := format(today(), p_pattern, p_language);
r_timestamp := format(p_timestamp, p_pattern, p_language);
r_number := format(p_number, p_pattern, p_language);
}

/* return result if not null */
if (not isNull(r_date)) result.VALUE_DATE := r_date;
if (not isNull(r_date)) result.VALUE_TIMESTAMP := format(p_timestamp, p_pattern);
if (not isNull(r_date)) result.VALUE_NUMBER := format(p_number, p_pattern);
if (isNull(r_date)) result.VALUE_DATE := "null";
if (isNull(r_date)) result.VALUE_TIMESTAMP := "null";
if (isNull(r_date)) result.VALUE_NUMBER := "null";

/* replace parameters (placeholders) in a string */
var p_text := "p0={0}, p1={1}, p2={2}, p3={3}, p4={4}, p5={5}, p6={6}, p7={7}, p8={8}, p9={9}";
var pList := split(p_parameters, " ");
if (size(pList) = 1)
result.VALUE_STRING := format(p_text, p_parameters);
else
result.VALUE_STRING := format(p_text, pList);
}

/* Splits „p_text“ into an array at each occurence of „p_separator“ */
function split(p_text as String, p_separator as String) as String[]
{
if (p_separator = "")
p_separator := " ";
var increment := length(p_separator);
var sep as String;
var word as String;
var r_wordList as String[];
var i := 0;
var startPos := 0;

while (i + increment - 1 < length(p_text)) {
sep := substring(p_text, i, i + increment);
if (sep = p_separator) {
word := trim(substring(p_text, startPos, i));
i := i + increment;
startPos := i;
if (word <> "" and word <> p_separator)
add(r_wordList, word);
} else {
i := i + 1;
}
}

word := substring(p_text, startPos);
if (word <> "" and word <> p_separator)
add(r_wordList, word);

return r_wordList;
}

indexOf

Folgendes Beispiel aus der Aktivitätsdefinition help.indexOf gibt die Position des ersten Vorkommnisses einer Zeichenkette innerhalb einer anderen Zeichenkette zurück:

function create()
{
var p_text := parameters.TEXT;
var p_searchValue := parameters.SEARCH_VALUE;
var p_firstPos := parameters.FIRST_POS;
var r_indexOf as Number;

if (p_firstPos = 0)
r_indexOf := indexOf(p_text, p_searchValue);
else
r_indexOf := indexOf(p_text, p_searchValue, p_firstPos);

result.VALUE := r_indexOf;
}

lastIndexOf

Folgendes Beispiel aus der Aktivitätsdefinition help.indexOf gibt die Position des letzten Vorkommnisses einer Zeichenkette innerhalb einer anderen Zeichenkette zurück:

function create()
{
var p_text := parameters.TEXT;
var p_searchValue := parameters.SEARCH_VALUE;
var p_lastPos := parameters.LAST_POS;
var r_lastIndexOf as Number;

if (p_lastPos = 0)

r_lastIndexOf := lastIndexOf(p_text, p_searchValue);
else
r_lastIndexOf := lastIndexOf(p_text, p_searchValue, p_lastPos);

result.VALUE := r_lastIndexOf;
}

length

Folgendes Beispiel aus der Aktivitätsdefinition help.length gibt die Länge einer Zeichenkette zurück:

function create()
{
var p_text := parameters.TEXT;
var r_length := length(p_text);

result.VALUE := r_length;
}

startsWith

Folgendes Beispiel aus der Aktivitätsdefinition help.startsWith prüft, ob eine Zeichenkette mit einem bestimmten Präfix beginnt:

function create()
{
var p_text := parameters.TEXT;
var p_prefix := parameters.PREFIX;
var r_startsWith := startsWith(p_text, p_prefix);

result.IS_NULL := isNull(r_startsWith);
result.VALUE := r_startsWith;
}

substring

Folgendes Beispiel aus der Aktivitätsdefinition help.substring gibt alle Zeichen einer Zeichenkette zwischen zwei Positionen zurück:

function create()
{

var p_text := parameters.TEXT;
var p_firstIncluded := parameters.FIRST_INCLUDED;
var p_firstExcluded := parameters.FIRST_EXCLUDED;
var r_substring as String;

if (p_firstExcluded = 0)
r_substring := substring(p_text, p_firstIncluded);
else
r_substring := substring(p_text, p_firstIncluded, p_firstExcluded);

result.IS_NULL := isNull(r_substring);
result.VALUE := r_substring;
}

toHtml

Folgendes Beispiel aus der Aktivitätsdefinition help.toHtml gibt eine Zeichenkette mit allen Sonderzeichen HTML-konform kodiert zurück:

function create()
{
var p_text := parameters.TEXT;
var r_toHtml as String;

r_toHtml := toHtml(p_text);

result.VALUE := r_toHtml;
}

toLower

Folgendes Beispiel aus der Aktivitätsdefinition help.toLower wandelt alle Großbuchstaben einer Zeichenkette in Kleinbuchstaben um:

function create()
{
var p_text := parameters.TEXT;
var r_toLower := toLower(p_text);

result.VALUE := r_toLower;
}

toUpper

Folgendes Beispiel aus der Aktivitätsdefinition help.toUpper wandelt alle Kleinbuchstaben einer Zeichenkette in Großbuchstaben um:

function create()

{
var p_text := parameters.TEXT;
var r_toUpper := toUpper(p_text);

result.VALUE := r_toUpper;
}

trim

Folgendes Beispiel aus der Aktivitätsdefinition help.trim entfernt Leerzeichen am Anfang und am Ende einer Zeichenkette:

function create()
{
var p_text := parameters.TEXT;
var r_trim as String;

result.VALUE := trim(p_text);
}

unzipText

Folgendes Beispiel aus der Aktivitätsdefinition help.unzipText entpackt eine Zeichenkette aus einem Textbaustein und gibt diese als Zeichenkette zurück:

function create()
{
var p_textModule := parameters.TEXT_MODULE;
var r_unzipText as String;
var p_language := getByBusinessKey(CisObject(com.cisag.app.general.obj.Language), parameters.LANGUAGE);

if (not isNull(p_language)) {
var textModule := getByBusinessKey(CisObject(com.cisag.app.general.obj.Text), p_language:guid, ZERO_GUID, p_textModule);
r_unzipText := unzipText(textModule:text);
result.IS_NULL := isNull(r_unzipText);
result.VALUE := r_unzipText;
}
}