Funktionsname

Funktion

add

R = X + Y

subtract

R = X - Y

equalsA

R = true, falls der Wert X gleich dem Wert Y ist, false sonst. Die Werte werden numerisch interpretiert, der Wert 1.5 ist also gleich 1.50.

abs

O = absoluter Wert von I

sqrt

R ist die Quadratwurzel von X

sqr

R ist die Quadratzahl von X

sign

R = 1, wenn X eine positive Zahl ist

R = 0, wenn X gleich 0 ist

R = 1, wenn X eine negative Zahl ist.

neg

R = -X

1/x

R ist der Kehrwert von X

power

R = X^Y

less

true, wenn X < Y, false sonst

greater

true, wenn X > Y, false sonst

multiply

R = X * Y

divide

R = X / Y

max

R = Maximum der beiden Werte X und Y

min

R = Minimum der beiden Werte X und Y

ceil

O = Kleinstmöglicher Integer-Wert (bis minus 'unendlich'), der nicht kleiner ist als das Argument I. Entspricht der Java-Funktion java.lang.Math.ceil().

floor

O = Größtmöglicher Integer-Wert, der nicht größer ist als das Argument I. Entspricht der Java-Funktion java.lang.Math.floor().

round

O = Integer-Wert zurück, der am nächsten am Wert des Arguments I ist. Entspricht der Java-Funktion java.lang.Math.round().

counter

O = Anzahl der Aufrufe dieses Zielfeld-Mappings, wobei Sie den Initialwert und das Inkrement des Zählers bei den Funktionseigenschaften angeben.

FormatNum

Konvertiert I nach Anwendung einer Musters, das Sie über die Funktionseigenschaften festlegen. Die möglichen Muster sind die gleichen wie in der Java-Klasse java.text.DecimalFormat.

Funktionsname

Funktion

And

R ist true, wenn X und Y den Wert true haben, ansonsten ist R false.

Or

R ist true, wenn X oder Y den Wert true haben, ansonsten ist R false.

Not

·        O ist false, wenn I den Wert true hat

·        O ist true, wenn I den Wert false hat

Equals

Vergleicht die beiden booleschen Werte X und Y und gibt true zurück, wenn beide gleich sind, ansonsten false. Nicht boolesche Werte werden als false interpretiert (siehe oben).

Für den Vergleich von Strings verwenden Sie die Funktionen equalsS beziehungsweise compare der Kategorie Text.

notEquals

R = Not(Equals(X,Y))

if

·        Wenn Bedingung X erfüllt ist (true liefert): R = Y

·        Wenn Bedingung X nicht erfüllt ist (false liefert): R = Z

ifWithoutElse

Wenn Bedingung X erfüllt ist (true liefert): R = Y. Welchen Else-Wert die Funktion liefern soll, ist von verschiedenen Faktoren abhängig (siehe Detaildoku).

Funktion

Verwendung

Constant

O liefert eine beliebige String-Konstante, die Sie im Dialog für die Funktionseigenschaften eingeben.

CopyValue

Kopiert für ein mehrfach auftretendes Element den Wert an einer festgelegten Position der Ausgangsstruktur auf das zugeordnete Zielfeld.

sender

O liefert den Namen des Sender-Business-Systems. Bei einem Test des Message-Mappings im Integration Builder wird Test_Sender_System ausgegeben.

receiver

O liefert den Namen des Emfpänger-Business-Systems. Bei einem Test des Message-Mappings im Integration Builder wird Test_Receiver_System ausgegeben.

Funktion

Verwendung

FixValues

Ausführung eines Werte-Mappings über eine feste Wertetabelle, die Sie über die Funktionseigenschaften füllen. Die Tabelle wird zusammen mit dem aktuellen Message-Mapping gespeichert und ist nur ein mal verwendbar.

Value mapping

Führt ein Werte-Mapping für den eingegebenen Wert I aus. Bei den Funktionseigenschaften ordnen Sie den Eingabewert I und den Ausgabewert O jeweils einer Darstellung in der Werte-Mapping-Tabelle zu. Auf diese Weise können Sie Felder der Ausgangs- und Zielstruktur einer Darstellung zuordnen. Die Werte-Mapping-Tabelle füllen Sie in der Konfigurations-Pflege des Integration Builders. Da diese Einträge in der Design-Zeit noch nicht zur Verfügung stehen, wird das Abbildungs-Ergebnis beim Testen des Message-Mappings nur angedeutet. Siehe auch: Werte-Mapping.

Zu XI 3.0 hat sich die Laufzeit-Schnittstelle für Werte-Mappings geändert. XI 2.0 Message-Mappings mit Aufrufen der Funktion Value mapping funktionieren auch weiterhin über die alte Laufzeit-Schnittstelle. Mit der Drucktaste XI 3.0 Interface können Sie die Parameter der Funktion für die neue Laufzeit-Schnittstelle übernehmen.

Funktion

Verwendung

currentDate

Gibt das aktuelle Datum über O zurück. Diese Funktion gehört zu den erzeugenden Funktionen.

DateTrans

Konvertiert ein Datumsformat I in ein anderes Datums-Format O.

DateBefore

R = true, wenn das Datum X vor dem Datum Y liegt, false sonst

DateAfter

R = true, wenn das Datum X nach dem Datum Y liegt, false sonst

CompareDates

R = 1, wenn das Datum X nach dem Datum Y liegt
R = 0, wenn das Datum X gleich dem Datum Y ist
R = -1, wenn das Datum X vor dem Datum Y liegt

Funktion

Verwendung

createIf

Wenn in Ihrer Zielstruktur Elemente zur Struktuierung vorhanden sind, die es in der Ausgangsstruktur nicht gibt, können Sie solche Elemente mit dieser Funktion einfügen. Mit der Bedingung I können Sie steuern, ob das Element eingefügt wird oder nicht. Das Element in der Zielstruktur verbinden Sie mit O.

removeContexts

Verwerfen aller übergeordneten Kontexte eines Ausgangsfeldes. Auf diese Weise können alle Hierarchiestufen löschen und eine Liste erzeugen.

replaceValue

Ersetzt den Wert I durch einen Wert, den Sie im Dialog für die Funktionseigenschaften festlegen können.

exists

O = true, falls das dem Eingang I zugeordnete Ausgangsfeld in der XML-Instanz existiert. Ansonsten false.

SplitByValue

Fügt einen Kontextwechsel für ein Element ein.

collapseContexts

Löscht zunächst alle Werte aller Kontexte von der Eingangsqueue bis auf den ersten. Leere Kontexte (= ResultList.SUPPRESS) werden nur einen leeren String ersetzt. Es bleibt eine Queue übrig, die aus Kontexten mit jeweils einem Wert besteht. Schließlich werden alle inneren Kontextwechsel gelöscht, so dass alle Werte zu einem Kontext gehören.

useOneAsMany

Repliziert einen Wert eines einfach auftretenden Feldes, um ihn mit den Werten eines mehrfach auftretenden Feldes paarweise als Rekord kombinieren zu können.

sort

Sortiert alle Werte des mehrfach auftretenden Eingangsfeldes I innerhalb des bestehenden oder gesetzten Kontextes. Die Sortierung ist stabil (gleiche Elemente werden beim Sortieren nicht in ihrer Reihenfolge vertauscht) und sortiert die Werte in O(n*log(n)) Schritten. In den Funktionseigenschaften können Sie festlegen, ob die Werte numerisch oder lexikographisch (mit oder ohne Berücksichtigung von Groß-/Kleinschreibung) sortiert werden sollen, und ob aufsteigend oder absteigend.

sortByKey

Wie sort, nur mit zwei Eingangsparametern für die Sortierung von (Schlüssel, Wert)-Paaren. Sie können sich diese Sortierung wie die von einer Tabelle mit zwei Spalten vorstellen:

·        Mit dem ersten Parameter übergeben Sie Schlüsselwerte der ersten Spalte, nach denen die Tabelle sortiert werden soll. Falls Sie die Schlüsselwerte in den Funktionseigenschaften als numerisch klassifiziert haben, darf kein Schlüsselwert der Konstante ResultList.SUPPRESS entsprechen. Siehe auch: Das ResultList-Objekt.

·        Mit dem zweiten Parameter übergeben Sie die Werte der zweiten Tabellenspalte.

Wenn es mehr oder weniger Schlüssel als Werte gibt, löst die Mapping-Laufzeit eine Ausnahme aus. Die Funktion gibt als Ergebnis eine Queue mit den nach den Schlüsseln sortierten Werten zurück.

mapWithDefault

Ersetzt leere Kontexte der Eingangsqueue durch einen Default-Wert, den Sie in den Funktionseigenschaften angeben.

Beispiel:
Wenn „Default“ der Default-Wert ist und
A|B1,B2| |C| |D
die Eingangsqueue,
liefert mapWithDefault die folgende Ausgangsqueue:
A | B1,B2 | Default | C | Default |D.

Die Funktion entspricht folgender Kombination von Standardfunktionen:

If(
  []field,
  exists([]field),
  Constant([value=default]))

formatByExample

Diese Funktion hat zwei Eingangsqueues, bei denen die Anzahl der Werte gleich sein muss. Um die Ergebnisqueue zu erzeugen, übernimmt die Funktion die Werte der ersten Queue und kombiniert sie mit den Kontextwechseln der zweiten Queue.

Funktion

Verwendung

sum

R = Summe der Werte X₁ bis X_i eines Kontexts

average

R = Durchschnitt der Werte X₁ bis X_i eines Kontexts

count

R = Anzahl der Felder in einem Kontext (i)

index

R = Index i von X_i. Sie legen in den Funktionseigenschaften folgendes fest: Den Initialwert von i, das Inkrement und ob der Indexwert zu Beginn eines neuen Kontextes neu initialisiert werden soll oder nur ein Mal für die gesamte Ausgangsstruktur.

Funktion

Verwendung

substring

Gibt für einen String I einen Teilstring O zurück. Um die Position des Teilstrings anzugeben, verwenden Sie den Dialog für die Funktionseigenschaften. Beispiel: substring(„Hello“, 0,1) = „H“, das heißt, es wird der Teilstring vom Startindex 0 bis zum Endindex 1 (exklusive Position 1) gebildet.

concat

R = Verkettung der Strings X und Y (ohne Trennzeichen).

Beispiel: X = „Mrs.“; Y = „Miller“; R = „Mrs.Miller“. Verwenden Sie den Dialog für die Funktionseigenschaften, um ein Trennzeichen innerhalb der Verkettung einzufügen.

equalsS

R = true, falls der String X gleich dem String Y ist, false sonst.

indexOf
(2 Eingabeparameter)

R = Erste Position, an der der String Y in X gefunden wird und –1 falls er nicht darin vorkommt.

indexOf
(3 Eingabeparameter)

R = Erste Position ab der Position Z, an der der String Y in X gefunden wird und –1 falls er nicht darin vorkommt.

lastIndexOf
(2 Eingabeparameter)

R = Letzte Position, an der der String Y in X gefunden wird und –1 falls er nicht darin vorkommt.

lastIndexOf
(3 Eingabeparameter)

R = Letzte Position ab der Position Z, an der der String Y in X gefunden wird und –1 falls er nicht darin vorkommt.

compare

Vergleicht String X mit String Y:

R = 0, wenn die Strings gleich sind
R = positive Zahl i, wenn X lexikographisch größer als Y ist
R = negative Zahl i, wenn X lexikographisch kleiner als Y ist

i gibt lexikographisch die Differenz zwischen beiden Strings an.

Die Funktion verhält sich genauso wie die Methode compareTo() der JDK-Klasse java.lang.String.

replaceString

X: String, in dem etwas ersetzt werden soll

Y: Zeichenfolge, die in X zu ersetzen ist

Z: Zeichenfolge, die Y ersetzen soll

R = Zeichenfolge, in der jedes Auftreten von Y in X durch Z ersetzt ist.

X = "sparring with a purple porpoise"

Y = “p”

Z = “t”

R = "starring with a turtle tortoise"

length

O = Länge des Strings

endsWith

R = true, wenn Y die letzte Zeichenfolge in X ist;false sonst.

startsWith
(2 Eingabeparameter)

R = true, wenn Y die erste Zeichenfolge in X ist;false sonst.

startWith
(3 Eingabeparameter)

R = true, wenn Y in X ab Position Z übereinstimmt;false sonst.

toUpperCase

Konvertiert alle Kleinbuchstaben von I zu Großbuchstaben

trim

Entfernt alle Whitespace Zeichen (Leerzeichen, Tabs, Return) am Anfang und am Ende eines Strings. Verhält sich genauso wie die Methode trim() der JDK-Klasse java.lang.String.

toLowerCase

Konvertiert alle Großbuchstaben von I zu Kleinbuchstaben