Importieren benutzerdefinierter XQuery 1.0-Funktionen
Wenn als Mapping-Transformationssprache XQuery ausgewählt ist, werden die für XQuery verfügbaren vordefinierten Funktionsbibliotheken im Fenster "Bibliotheken" angezeigt. Falls nötig, können Sie diese Liste durch benutzerdefinierte XQuery-Funktionen erweitern, indem Sie benutzerdefinierte XQuery 1.0-Bibliotheksmodule in MapForce importieren.
Um diese Funktionen in MapForce importieren zu können, muss eine XQuery-Datei die folgenden Voraussetzungen erfüllen:
•Es muss sich gemäß der XQuery-Spezifikation um ein gültiges Bibliotheksmodul handeln, d.h. es muss am Anfang eine Moduldeklaration wie module namespace <prefix>="<namespace name" haben.
•Alle im importierten Bibliotheksmodul deklarierten Funktionen müssen atomare Datentypen (z.B. Xs:string,, xs:boolean, xs:integer, usw) zurückgeben. Auch Funktionsparameter müssen einen atomaren Typ haben.
So importieren Sie ein XQuery-Bibliotheksmodul:
1.Klicken Sie im unteren Bereich des Fensters Bibliotheken auf die Schaltfläche Bibliotheken hinzufügen/entfernen. Daraufhin wird das Fenster Bibliotheken verwalten geöffnet (siehe Abbildung unten).
2.Um Funktionen als lokale Bibliothek (nur im Geltungsbereich des aktuellen Dokuments) zu importieren, klicken Sie auf die Schaltfläche Hinzufügen unterhalb des aktuellen Mapping-Namens. Um Funktionen als globale Bibliothek (auf Programmebene zu importieren, klicken Sie auf die Schaltfläche Hinzufügen neben Globale Bibliotheksimporte. Wenn Sie eine Bibliothek lokal importieren, können Sie den Pfad zur Bibliotheksdatei als relativ zur Mapping-Datei definieren. Bei gobal importierten Bibliotheken ist der Pfad zur importierten Bibliothek immer absolut.
3.Navigieren Sie zur .xq-oder .xquery-Bibliotheksdatei und klicken Sie auf Öffnen.
Die importierten Bibliotheksmoduls werden im Fenster "Bibliotheken" angezeigt. Anschließend können Sie einzelne Funktionen in den Mapping-Bereich ziehen und diese wie jede andere MapForce-Funktionskomponente verwenden, siehe auch Hinzufügen einer Funktion zum Mapping.
Wenn Sie das importierte XQuery-Bibliotheksmodul nicht sehen, stellen Sie sicher, dass Sie XQuery als Transformationssprache ausgewählt haben.