XSLT APPLY TRANSFORMATION

Der Befehl XSLT APPLY 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 .

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 4D 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 XSLT SET 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.

Über den Parameter KompiliereSheet können Sie die XSLT Transformation optimieren, insbesondere bei sukzessiver Anwendung derselben XSL Stilvorlage. Ist KompiliereSheet übergeben und auf Wahr gesetzt, wird die XSL Datei xslSheet beim ersten Aufruf des Befehls durchlaufen, dann kompiliert und im Speicher abgelegt. Bei jedem späteren Aufrufen mit derselben XSL Stilvorlage verwendet der Befehl direkt die kompilierte Datei - außer bei Änderungen. Das beschleunigt den Vorgang. Die Optimierung berücksichtigt keine Änderungen in den importierten Dateien (via xsl:import). Wird eine Datei mit Referenz auf die XSL Datei geändert, muss die XSL Datei erneut kompiliert werden, d.h. der Befehl muss erneut aufgerufen und der Parameter KompiliereSheet auf Falsch gesetzt oder weggelassen werden.

Siehe Beispiel unter dem Befehl XSLT SET PARAMETER.

Bei korrekt ausgeführter Transformation wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null).