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).

attributes(AttributeName als xs:string) als attribute()* XP3.1 XQ3.1

Gibt alle Attribute zurück, die einen lokalen Namen haben, der mit dem im Input-Argument AttributeName angegebenen Namen identisch ist. Die Groß- und Kleinschreibung wird bei der Suche, die entlang der attribute:: Achse durchgeführt wird, beachtet. Das bedeutet, dass der Kontext-Node der Parent-Element-Node sein muss.

Beispiele

attributes(AttributeName als xs:string, SearchOptions als xs:string) als attribute()* XP3.1 XQ3.1

Gibt alle Attribute zurück, die einen lokalen Namen haben, der mit dem im Input-Argument AttributeName angegebenen Namen identisch ist. Die Groß- und Kleinschreibung wird bei der Suche, die entlang der attribute:: Achse durchgeführt wird, beachtet. Der Kontext-Node muss der Parent-Element-Node sein. Das zweite Argument ist ein String, der Options-Flags enthält. Zur Verfügung stehen die folgenden Flags:
r = wechselt zu einer Suche mittels Regular Expression; bei AttributeName muss es sich in diesem Fall um einen Regular Expression-Suchstring handeln;

f = Wenn diese Option definiert ist, liefert AttributeName eine vollständige Übereinstimmung; andernfalls muss AttributeName nur teilweise mit einem Attributnamen übereinstimmen, damit dieses Attribut zurückgegeben wird. Wenn f z.B. nicht definiert ist, gibt MyAtt MyAttribute zurück;
i = wechselt zu einer Suche ohne Berücksichtigung der Groß- und Kleinschreibung;

p = inkludiert das Namespace-Präfix in die Suche; AttributeName sollte in diesem Fall das Namespace-Präfix enthalten, z.B.: altova:MyAttribute.
Die Flags können in jeder Reihenfolge angegeben werden. Ungültige Flags erzeugen eine Fehlermeldung. Sie können ein oder mehrere Flags weglassen. Es ist auch der leere String zulässig. Das Resultat ist dasselbe wie bei Verwendung der Funktion mit nur einem Argument (siehe vorherige Signatur). Unzulässig ist jedoch die Verwendung einer leeren Sequenz als zweites Argument.

Beispiele

elements(ElementName als xs:string) als element()* XP3.1 XQ3.1

Gibt alle Elemente zurück, die einen lokalen Namen haben, der mit dem im Input-Argument ElementName angegebenen Namen identisch ist. Die Groß- und Kleinschreibung wird bei der Suche, die entlang der child:: Achse durchgeführt wird, beachtet. Der Kontext-Node muss der Parent-Node des gesuchten Elements sein.

Beispiele

elements(ElementName als xs:string, SearchOptions als xs:string) als element()* XP3.1 XQ3.1

Gibt alle Elemente zurück, die einen lokalen Namen haben, der mit dem im Input-Argument ElementName angegebenen Namen identisch ist. Die Groß- und Kleinschreibung wird bei der Suche, die entlang der child:: Achse durchgeführt wird, beachtet. Der Kontext-Node muss der Parent-Node des gesuchten Elements sein. Das zweite Argument ist ein String, der Options-Flags enthält. Zur Verfügung stehen die folgenden Flags:
r = wechselt zu einer Suche mittels Regular Expression; bei ElementName muss es sich in diesem Fall um einen Regular Expression-Suchstring handeln;

f = Wenn diese Option definiert ist, liefert ElementName eine vollständige Übereinstimmung; andernfalls muss ElementName nur teilweise mit einem Elementnamen übereinstimmen, damit dieses Element zurückgegeben wird. Wenn f z.B. nicht definiert ist, gibt MyElem MyElement zurück;
i = wechselt zu einer Suche ohne Berücksichtigung der Groß- und Kleinschreibung;

p = inkludiert das Namespace-Präfix in die Suche; ElementName sollte in diesem Fall das Namespace-Präfix enthalten, z.B.: altova:MyElement.
Die Flags können in jeder Reihenfolge angegeben werden. Ungültige Flags erzeugen eine Fehlermeldung. Sie können ein oder mehrere Flags weglassen. Es ist auch der leere String zulässig. Das Resultat ist dasselbe wie bei Verwendung der Funktion mit nur einem Argument (siehe vorherige Signatur). Unzulässig ist jedoch die Verwendung einer leeren Sequenz.

Beispiele

find-first( (item()*), (CheckFunction( item() als xs:boolean) ) als item()? XP3.1 XQ3.1

Diese Funktion verwendet zwei Argumente. Das erste Argument ist eine Sequenz von einem oder mehreren Elementen eines beliebigen Datentyps. Das zweite Argument, Condition, ist eine Referenz zu einer XPath-Funktion, die ein Argument erhält. (hat einen Stellenwert 1) und einen Booleschen Wert zurückgibt. Jedes Element von Sequence wird der Reihe nach der in Condition referenzierten Funktion bereitgestellt. (Beachten Sie: Die Funktion hat ein einziges Argument.) Das erste Sequence Element, bei dem das Resultat von Condition true() ist, wird als das Ergebnis von find-first zurückgegeben. Anschließend wird die Iteration gestoppt.

Beispiele

find-first-combination((Seq-01 as item()*), (Seq-02 as item()*), (Condition( Seq-01-Item, Seq-02-Item as xs:boolean)) as item()* XP3.1 XQ3.1

Diese Funktion verwendet drei Argumente:

•Die ersten beiden Argumente, Seq-01 und Seq-02, sind Sequenzen von einem oder mehreren Elementen eines beliebigen Datentyps.

•Das dritte Argument, Condition, ist eine Referenz auf eine XPath-Funktion, die zwei Argumente erhält (d.h. eine Stelligkeit 2 hat) und einen Booleschen Wert zurückgibt.

Die Elemente von Seq-01 und Seq-02 werden als die Argumente der Funktion Condition in geordneten Paaren übergeben (je ein Element aus jeder Sequenz bildet ein Paar). Die Paare sind folgendermaßen geordnet.

If   Seq-01 = X1, X2, X3 ... Xn

And  Seq-02 = Y1, Y2, Y3 ... Yn

Then (X1 Y1), (X1 Y2), (X1 Y3) ... (X1 Yn), (X2 Y1), (X2 Y2) ... (Xn Yn)

Das erste geordnete Paar, bei dem die Funktion Condition zu true() ausgewertet wird, wird als Ergebnis von find-first-combination zurückgegeben. Beachten Sie: (i) Wenn die Funktion Condition durch die bereitgestellten Argumentpaare iteriert und nicht ein einziges Mal zu true() ausgewertet wird, so gibt find-first-combination Keine Ergebnisse zurück; (ii) Das Ergebnis von find-first-combination ist immer ein Elementpaar (eines beliebigen Datentyps) oder gar kein Element.

Beispiele

find-first-pair((Seq-01 als item()*), (Seq-02 als item()*), (Condition( Seq-01-Item, Seq-02-Item als xs:boolean)) als item()* XP3.1 XQ3.1

Diese Funktion erhält drei Argumente:

•Die ersten beiden Argumente, Seq-01 und Seq-02, sind Sequenzen von einem oder mehreren Elementen eines beliebigen Datentyps.

•Das dritte Argument, Condition, ist eine Referenz auf eine XPath-Funktion, die zwei Argumente erhält (d.h. eine Stelligkeit 2 hat) und einen Booleschen Wert zurückgibt.

Die Elemente von Seq-01 und Seq-02 werden als die Argumente der Funktion Condition in geordneten Paaren übergeben. Die Paare sind folgendermaßen geordnet.

If   Seq-01 = X1, X2, X3 ... Xn

And  Seq-02 = Y1, Y2, Y3 ... Yn

Then (X1 Y1), (X2 Y2), (X3 Y3) ... (Xn Yn)

Das erste geordnete Paar, bei dem die Funktion Condition zu true() ausgewertet wird, wird als Ergebnis von find-first-pair zurückgegeben. Beachten Sie: (i) Wenn die Funktion Condition durch die bereitgestellten Argumentpaare iteriert und nicht ein einziges Mal zu true() ausgewertet wird, so gibt find-first-pair Keine Ergebnisse zurück; (ii) Das Ergebnis von find-first-pair ist immer ein Elementpaar (eines beliebigen Datentyps) oder gar kein Element.

Beispiele

find-first-pair-pos((Seq-01 as item()*), (Seq-02 as item()*), (Condition( Seq-01-Item, Seq-02-Item as xs:boolean)) as xs:integer XP3.1 XQ3.1

Diese Funktion erhält drei Argumente:

•Die ersten beiden Argumente, Seq-01 und Seq-02, sind Sequenzen von einem oder mehreren Elementen eines beliebigen Datentyps.

•Das dritte Argument, Condition, ist eine Referenz auf eine XPath-Funktion, die zwei Argumente erhält (d.h. eine Stelligkeit 2 hat) und einen Booleschen Wert zurückgibt.

Die Elemente von Seq-01 und Seq-02 werden als die Argumente der Funktion Condition in geordneten Paaren übergeben. Die Paare sind folgendermaßen geordnet.

If   Seq-01 = X1, X2, X3 ... Xn

And  Seq-02 = Y1, Y2, Y3 ... Yn

Then (X1 Y1), (X2 Y2), (X3 Y3) ... (Xn Yn)

Als Ergebnis von find-first-pair-pos wird die Indexposition des ersten geordneten Paars, bei dem die Funktion Condition zu true() ausgewertet wird, zurückgegeben. Beachten Sie: Wenn die Funktion Condition durch die bereitgestellten Argumentpaare iteriert und kein einziges Mal zu true() ausgewertet wird, so gibt find-first-pair-pos Keine Ergebnisse zurück.

Beispiele

find-first-pos( (item()*), (CheckFunction( item() als xs:boolean) ) als xs:integer? XP3.1 XQ3.1

Diese Funktion verwendet zwei Argumente. Das erste Argument ist eine Sequenz von einem oder mehreren Elementen eines beliebigen Datentyps. Das zweite Argument, Condition, ist eine Referenz zu einer XPath-Funktion, die ein Argument erhält. (hat einen Stellenwert 1) und einen Booleschen Wert zurückgibt. Jedes Element von Sequence wird der Reihe nach der in Condition referenzierten Funktion bereitgestellt. (Beachten Sie: Die Funktion hat ein einziges Argument.) Das erste Sequence Element, bei dem das Resultat von Condition true() ist, wird als das Ergebnis von find-first-pos zurückgegeben. Anschließend wird die Iteration gestoppt.

Beispiele

for-each-attribute-pair(Seq1 als element()?, Seq2 als element()?, Function als function()) als item()* XP3.1 XQ3.1

Die beiden ersten Argumente identifizieren zwei Elemente, anhand deren Attribute Attributpaare gebildet werden, wobei das eine Attribut eines Paars aus dem ersten Element und das andere aus dem zweiten Element stammt. Die Attributpaare werden auf Basis ihres übereinstimmenden Namens ausgewählt und alphabetisch (nach ihren Namen) zu einer Gruppe geordnet. Falls es zu einem Attribut im anderen Element keine Entsprechung gibt, ist das Paar "nicht verbunden", d.h. es besteht nur aus einem Mitglied. Das Funktionselement (das dritte Argument Function) wird auf die einzelnen Paare (verbundene und nicht verbundene) in der Sequenz der Paare separat angewendet, wodurch als Ausgabe eine Sequenz von Einträgen erzeugt wird.

Beispiele

for-each-combination(FirstSequence als item()*, SecondSequence als item()*, Function($i,$j){$i || $j} ) als item()* XP3.1 XQ3.1

Die Elemente der zwei Sequenzen in den ersten beiden Argumenten werden miteinander kombiniert, so dass jedes Element in der ersten Sequenz der Reihe nach einmal mit jedem Element in der zweiten Sequenz kombiniert wird. Die als drittes Argument angegebene Funktion wird auf die einzelnen Kombinationen in der erzeugten Sequenz angewendet, wodurch als Ausgabe eine Sequenz von Elementen erzeugt wird (siehe Beispiel).

Beispiele

u

for-each-matching-attribute-pair(Seq1 als element()?, Seq2 als element()?, Function als function()) als item()* XP3.1 XQ3.1

Die beiden ersten Argumente identifizieren zwei Elemente, anhand deren Attribute Attributpaare gebildet werden, wobei das eine Attribut eines Paars aus dem ersten Element und das andere aus dem zweiten Element stammt. Die Attributpaare werden auf Basis ihres übereinstimmenden Namens ausgewählt und alphabetisch (nach ihren Namen) zu einer Gruppe geordnet. Falls es zu einem Attribut im anderen Element keine Entsprechung gibt, wird kein Paar gebildet. Das Funktionselement (das dritte Argument Function) wird auf die einzelnen Paare in der Sequenz der Paare separat angewendet, wodurch als Ausgabe eine Sequenz von Einträgen erzeugt wird.

Beispiele

substitute-empty(FirstSequence als item()*, SecondSequence als item()) als item()* XP3.1 XQ3.1

Wenn FirstSequence leer ist, wird SecondSequence zurückgegeben. Wenn FirstSequence nicht leer ist, wird FirstSequence zurückgegeben.

Beispiele