USCSXSL.Apply2File

note

This article is about the Apply2File method of the USCSXSL internal component.

USCSXSL.Apply2File

Applies a specific, non-default transformation to an XML input document and writes the result to a file. The input document may contain calls to USCSXSL extension functions (this is an added possibility compared to calling USXSL.Apply2File).

If you use USCSXSL to process a USoft Blend script, then you apply to this script the default Batch.1.0.xsl transformation. Do this not by calling USCSXSL.Apply2File() but rather by calling USCSXSL.Blend().

Syntax

select uscsxsl.apply2file( *xml*, *xsl*, *xml-resultfilepath*  [ , *variable-name*, *variable-value* ... ] )

*xml*  :=  { *xml-filepath* | *xml-document* }
*xsl*  :=  ( *xsl-filepath* | *xsl-document* }

All arguments are single-quoted string values.

The required xml must be a valid XML document. You can submit this XML document either as a file on the file system that you reference by xml-filepath or inline as a literal xml-document string.

The required xsl must be a valid XSLT 1.0 transformation. You can submit this transformation either as a file on the file system that you reference by xsl-filepath or inline as a literal xsl-document string.

Optionally, you can pass any number of Blend input parameters as variable-name=variable-value pairs.

tip

From USoft 10.0.1I, xml-resultfilepath is allowed to be identical to xml-filepath. In this case, be aware that the result file is forceably overwritten, even if the transformation fails.

Example

select uscsxsl.apply2file( '<MyClipboardNow/>', 'c:\temp\PrintClipboard.xsl', 'c:\temp\Result.xml'  )

If the file content of the "c:\temp\PrintClipboard.xsl" file is:

<?xml version="1.0" encoding="windows-1252"?>
<xsl:stylesheet version="1.0"
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  xmlns:clipboard="USoft:ClipBoard"
>
<xsl:output method="xml" encoding="UTF-8" omit-xml-declaration="yes"/>

<xsl:template match="*|@*|comment()|processing-instruction()|text()">
  <xsl:copy>
    <xsl:apply-templates select="*|@*|text()|comment()|processing-instruction()"/>
  </xsl:copy>
</xsl:template>

<xsl:template match="MyClipboardNow">
  <xsl:copy>
    <xsl:value-of select="clipboard:GetText()"/>
  </xsl:copy>
</xsl:template>

</xsl:stylesheet>

and your clipboard currently contains "Hello World", then the contents of the Result.xml file will be:

<MyClipboardNow>Hello World</MyClipboardNow>