Altova MobileTogether Designer

Altova-Erweiterungsfunktionen können in XPath/XQuery-Ausdrücken verwendet werden. Dadurch stehen neben den Funktionen in der Standardbibliothek der XPath-, XQuery- und XSLT-Funktionen zusätzliche Funktionen zur Verfügung.

•Um Altova-Erweiterungsfunktionen von Funktionen in der Standardbibliothek zu unterscheiden, wurde Altova-Erweiterungsfunktionen in dieser Dokumentation das Suffix [altova:] angehängt, z.B. add-years-to-date [altova:].

•Wenn Sie Altova-Erweiterungsfunktionen jedoch in Ihren XPath/XQuery-Ausdrücken verwenden, müssen Sie die Funktion genau wie jede andere XPath/XQuery-Standardfunktion ohne Präfix oder Suffix verwenden. Verwenden Sie eine Altova-Erweiterungsfunktion folgendermaßen: add-years-to-date(xs:date("2014-01-15"), 10).

generate-auto-number(ID als xs:string, StartsWith als xs:double, Increment als xs:double, ResetOnChange als xs:string) als xs:integer XP1 XP2 XQ1 XP3.1 XQ3.1

Generiert jedes Mal, wenn die Funktion aufgerufen wird, eine Zahl. Die erste Zahl, die beim ersten Aufruf der Funktion generiert wird, wird durch das Argument StartsWith definiert. Bei jedem erneuten Aufruf der Funktion wird eine neue Zahl generiert. Diese Zahl wird durch den im Argument Increment definierten Wert anhand der zuvor generierten Zahl inkrementiert. Auf diese Art erstellt die Funktion generate-auto-number einen Zähler, dessen Name durch das Argument ID definiert wird und der jedes Mal, wenn die Funktion aufgerufen wird, inkrementiert wird. Wenn sich der Wert des Arguments ResetOnChange seit dem vorherigen Funktionsaufruf geändert hat, so wird der Wert der zu generierenden Zahl auf den Wert StartsWith zurückgesetzt. Die Automatische Nummerierung kann auch mit der Funktion reset-auto-number zurückgesetzt werden.

Beispiele

reset-auto-number(ID als xs:string) XP1 XP2 XQ1 XP3.1 XQ3.1

Diese Funktion setzt die Zahl des im ID-Argument angegebenen Zählers zur automatischen Nummerierung zurück. Die Zahl wird auf die Zahl zurückgesetzt, die durch das Argument StartsWith der Funktion generate-auto-number, die den im ID-Argument genannten Zähler erstellt hat, definiert ist

Beispiele

hex-string-to-integer(HexString als xs:string) als xs:integer XP3.1 XQ3.1

Verwendet ein String-Argument, das das Base-16-Äquivalent einer Ganzzahl im Dezimalsystem (Base-10) ist, und gibt die dezimale Ganzzahl zurück.

Beispiele

integer-to-hex-string(Integer as xs:integer) as xs:string XP3.1 XQ3.1

Verwendet ein Ganzzahlargument und gibt das Base-16-Äquivalent als String zurück.

Beispiele

mt-format-number(Number als xs:numeric, PictureString als xs:string) als xs:string XP3.1 XQ3.1

Erhält als erstes Argument eine Zahl, formatiert diese entsprechend dem zweiten Argument (PictureString) und gibt die formatierte Zahl als String zurück. Diese Funktion eignet sich, um schwer lesbare Zahlen in einem lesbaren Format zu formatieren. Der Musterstring kann auch Zeichen wie z.B. Währungssymbole enthalten und kann auch verwendet werden, um Zeichen in die formatierte Ausgabe einzufügen. Wenn an einer Ziffernstelle, an der in der Input-Zahl keine Ziffer vorhanden ist, eine Null eingefügt werden soll, so verwenden Sie im Musterstring an dieser Ziffernstelle eine Null (siehe Beispiele unten). Wenn nicht zwingend eine Null (oder ein anderes Zeichen) eingefügt werden soll, verwenden Sie die Raute (#).

Ziffern vor dem Dezimaltrennzeichen werden nie gekürzt. Der Dezimalteil einer Zahl (rechts vom Dezimaltrennzeichen) sowie die Stelle für die Währung (erste Stelle links vom Dezimaltrennzeichen) werden abgerundet, wenn der Musterstring des Dezimalteils kürzer als die Anzahl der Dezimalstellen in der Input-Zahl sind.

Anmerkung: Das Gruppenstrennzeichen und das Dezimaltrennzeichen in der formatierten Ausgabe auf dem Mobilgerät entsprechen den Zeichen, die in der auf dem Mobilgerät eingestellten Sprache verwendet werden.

Beispiele