XPath/XQuery-Funktionen

www.altova.com Alle erweitern/reduzieren Dieses Kapitel drucken Vorherige Seite Eine Ebene nach oben Nächste Seite

Startseite >  Menübefehle > Projekt >

XPath/XQuery-Funktionen

ic_XPXQFunctions

 

Ruft das Dialogfeld "XPath-Funktionen" auf, in dem alle benutzerdefinierten XPath-Funktionen im Projekt aufgelistet sind. Diese XPath-Funktionen können in allen XPath-Ausdrücken im Projekt verwendet werden. Sie können Funktionen über die entsprechenden Symbolleisten-Schaltflächen des Dialogfelds hinzufügen und löschen. Um die Definition einer Funktion zu bearbeiten, klicken Sie auf die Schaltfläche XPath-Ausdruck bearbeiten der jeweiligen Funktion.

MTXPathFunctionsDlg

Hinzufügen einer neuen benutzerdefinierten XPath-Funktion

Um eine neue benutzerdefinierte Funktion hinzuzufügen, müssen zwei Schritte durchgeführt werden: (i) Deklarieren der Funktion und (ii) Definieren der Funktion.

 

Um eine neue Funktion hinzuzufügen, gehen Sie folgendermaßen vor: Klicken Sie in der Symbolleiste des Dialogfelds auf Hinzufügen (siehe Abbildung unten). Daraufhin wird das Dialogfeld "Neue XPath-Funktion" angezeigt (Abbildung unten).

MTNewXPathFunction

In diesem Dialogfeld können Sie den Namen der Funktion, die Anzahl der Funktionsparameter (Argumente) und ihren Typ sowie den Rückgabetyp der Funktion definieren. In der Abbildung oben wurde eine Funktion zum Konvertieren einer Dezimalzahl von Celsius in Fahrenheit deklariert. Die Funktion hat einen Parameter, nämlich den Celsius-Input-Wert als Dezimalzahl. Das Ergebnis der Funktion ist die Temperatur in Fahrenheit als Dezimalzahl. Im nächsten Schritt wird definiert, was die Funktion tun soll. Klicken Sie, nachdem Sie die Funktion deklariert haben (Abbildung oben), auf OK. Daraufhin wird das Dialogfeld "Funktion bearbeiten" (Abbildung unten) angezeigt. Es enthält die Vorlage der neu deklarierten Funktion, in der Sie nun die Funktion definieren können.

MTEditFunctionDlg

Geben Sie die Funktionsdefinition innerhalb der geschweiften Klammern ein. In der Definition in der Abbildung oben ist $a der Input-Parameter. Klicken Sie auf OK, wenn Sie fertig sind. Die Funktion wird daraufhin im Dialogfeld "XPath-Funktionen" zur Liste der benutzerdefinierten Funktionen hinzugefügt und kann nun in allen XPath-Ausdrücken im Projekt verwendet werden.

 

Anmerkung:Benutzerdefinierte XPath-Funktionen müssen nicht in einen separaten Namespace platziert werden, daher wird beim Definieren oder Aufrufen einer benutzerdefinierten Funktion auch kein Namespace-Präfix benötigt. Für alle XPath/XQuery-Funktionen einschließlich der Erweiterungsfunktionen und der benutzerdefinierten Funktionen wird der XPath-Standard-Namespace verwendet. Um die Funktionen eindeutig von den vordefinierten Funktionen unterscheiden zu können, empfehlen wir, benutzerdefinierte Funktionen mit Großbuchstaben zu schreiben.

 


© 2019 Altova GmbH