|
|
|
|
|
|
|
|
|
|
Version 2004
APPLY XSLT TRANSFORMATION (xmlQuelle; xslSheet; Ergebnis)
| Parameter | Typ | Beschreibung | |
| xmlQuelle | String | BLOB |  | Name oder Zugriffspfad des |
| XML Quelldokuments oder BLOB | |||
| mit der XML Quelle |
| xslSheet | String | BLOB | | Name oder Zugriffspfad des Dokuments |
| mit XSL Stilvorlagen, oder | |||
| BLOB mit dem XSL Stilvorlagen | |||
| Ergebnis | String | BLOB | | Name oder Zugriffspfad des Dokuments |
| welches das Ergebnis der XSLT Umwandlung | |||
| erhält oder BLOB, welches das Ergebnis der | |||
| XSLT Umwandlung erhält |
Beschreibung
Der Befehl APPLY XSLT TRANSFORMATION führt eine XSLT Umwandlung auf ein Dokument oder BLOB mit XML aus und erstellt ein Dokument oder BLOB in Ergebnis. Dieser Befehl gilt für den aktuellen Prozess.
Hinweis: Weitere Informationen zur XSL bzw. XSLT Transformation finden Sie im Abschnitt Einführung in XML Befehle.
Der Befehl benötigt drei Parameter vom Typ BLOB oder Zeichenkette.
Warnung: Dieser Befehl akzeptiert nur Variablen oder Felder als Parameter.
Übergeben Sie eine Zeichenkette, bestimmen Sie ein Dokument. In diesem Fall können Sie nur den kompletten Zugriffspfad bzw. den Dokumentnamen übergeben – das Dokument muss neben der Strukturdatei der Datenbank liegen. Sie können im gleichen Aufruf verschiedene Parameterarten miteinander mischen. Sie können jedoch keinen leeren Parameter übergeben (BLOB oder Text).
• xmlQuelle muss die XML Quelle für die Umwandlung enthalten. Der Befehl prüft die Gültigkeit des XSL Code.
• xslSheet muss das XSL Style Sheet für die XSLT Umwandlung enthalten. Dieses Style Sheet kann manuell oder über eine spezielle Software erstellt worden sein. Der Befehl prüft die Gültigkeit des XSL Code.
• Ergebnis muss den Namen des Dokuments oder das BLOB enthalten, welches das Ergebnis der XSLT Umwandlung empfangen soll. Übergeben Sie den Namen eines Dokuments, das am angegebenen Ort nicht existiert, erstellt 4th Dimension es automatisch. Wurde das Dokument bereits im Schreibzugriff geöffnet, wird ein Fehler generiert.
Der Befehl durchläuft die XML Quelle und wandelt sie gemäß der Anweisungen im XSL Style Sheet um. Wird zuvor der Befehl SET XSLT PARAMETER verwendet, ersetzt der Befehl die durch deren Wert definierten Parameter. Das Ergebnis der Umwandlung wird in das Dokument oder BLOB, definiert in Ergebnis, geschrieben.
Hinweis: Für eine optimierte Performance dieses Befehls, besonders bei wiederholter Anwendung des gleichen XSL Sheet kompiliert und behält 4th Dimension die zuletzt verwendeten und abgespeicherteen XSL Sheets.
Beispiel
Siehe Beispiel unter dem Befehl SET XSLT PARAMETER.
Referenz
GET XSLT ERROR, SET XSLT PARAMETER.
Systemvariablen oder Mengen
Bei korrekt ausgeführter Transformation wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null).
|
|
|
|
|
|
|
|
|
|