Syntax

   FACTORY_DEF <ReaderKeyword> XSLTFactory
   [FACTORY_NAME <factory name>] 
   [INPUT FEATURE_TYPE<factory type>
      [<attribute name> <attribute value>]* 
      [<feature function>]*]* 
   [FACTORY_STYLESHEET <file path>] 
   (XML_DOC | XML_FILE | XML_STREAM) <attribute name> 
   [(STYLESHEET_DOC | STYLESHEET_FILE | 
      STYLESHEET_ATTRIBUTE) <attribute name>] 
   STYLESHEET_PRECEDENCE (FACTORY_SS|FEATURE_SS)
   [(RESULT_FILE <attribute name>]
   [(RESULT_STREAM <attribute name>] 
   [OUTPUT (TRANSFORMED|SKIPPED) 
      FEATURE_TYPE <feature type> 
      [<attribute name> <attribute value>]* 
      [<feature function>]*]*

Overview

   XSLT stands for XSL (eXtensible Stylesheet Language) transformations. This 
   factory is used to transform an XML document into another XML document using 
   an XSL stylesheet.

   Input, output and stylesheet sources may be either a file path name or a 
   string stored in an attribute. 

      Note: The factory asks for the attribute name that stores the file path 
      instead of the file path itself.

   The user can specify whether the input attribute is a file path or a string, 
   by using XML_FILE, XML_STREAM, STYLESHEET_FILE and STYLESHEET_STREAM to 
   explicitly declare FILE or STREAM types. Or if the attribute type is unknown, 
   then the user may choose to use XML_DOC and STYLESHEET_DOC to let the factory 
   decide whether it is a file or a string.

   FACTORY_STYLESHEET sets a stylesheet that is common to all features passing 
   into the factory. It will only be compiled once, hence provides faster 
   transformations when applied to multiple documents. STYLESHEET_ATTRIBUTE 
   contains the attribute name that sets the feature stylesheet. 
   STYLESHEET_PRECEDENCE determines if factory or feature stylesheet should be 
   used. If FEATURE_SS is selected, but no feature stylesheet is available, then 
   factory stylesheet will be used if there is one defined. 

   Each feature with an attribute of input XML document with a valid stylesheet 
   will either have been transformed successfully (send to TRANSFORMED output) 
   or unsuccessfully due to errors (send to SKIPPED). Transformed features will 
   either output as a file with the file path stored in the attribute specified 
   in the RESULT_FILE clause, or have a new attribute added to it with the 
   attribute name specified in the RESULT_STREAM clause (or both).

Clauses

   FACTORY_STYLESHEET <file path>   
   
      Sets the factory stylesheet. This will be applied to all incoming features 
      when FEATURE_PRECEDENCE is set to FACTORY_SS. Otherwise, it will apply to 
      features that do not have a stylesheet available.
      
      Default: None
   
      Example:FACTORY_STYLESHEET "stylesheet.xsl"
   
   (XML_DOC|XML_FILE|XML_STREAM) <attribute name>  
   
      Specifies the input attribute name. The attribute can stores a file path 
      name or an XML string. If XML_FILE is used, it will be treated as a file 
      path. If XML_STREAM is used, it will be treated as a XML string stored in 
      the attribute. However, if XML_DOC is used, the factory will try to 
      determine whether it is a file or a stream for the user.
      
      Default: None
      
      Example:XML_DOC xml_string
   
   (STYLESHEET_DOC|STYLESHEET_FILE|STYLESHEET_STREAM) <attribute name>  
   
      Specifies the feature stylesheet attribute name. The attribute can stores 
      a file path name or an XSL string. If STYLESHEET_FILE is used, it will be 
      treated as a file path. If STYLESHEET_STREAM is used, it will be treated 
      as a XSL string stored in the attribute. However, if STYLEHSEET_DOC is 
      used, the factory will try to determine whether it is a file or a stream 
      for the user.
      
      Default: None
      
      Example:STYLESHEET_FILE table_style
   
   STYLESHEET_PRECEDENCE (FACTORY_SS | FEATURE_SS) 
   
      Specifies which stylesheet to use.
      
      Default: FACTORY_SS 
      
      Example: STYLESHEET_PRECEDENCE FEATURE_SS
   
   RESULT_FILE <attribute name> & RESULT_STREAM <attribute name>
    
      Specifies the output result attribute name(s). If the attribute stores a 
      file path, then use RESULT_FILE. If the attribute will store the output 
      xml string, then use RESULT_STREAM. Unlike input and stylesheet sources, 
      RESULT_FILE and RESULT_STREAM can be set concurrently, resulting in both 
      an output file and a new attribute on the processed feature.
   
      Default: None 

Output Tags

   The XSLTFactory supports the following output tags
   
   TRANSFORMED 
   
      Features containing XML file or XML String attribute transformed succesfully using a XSLT stylesheet

   SKIPPED  
   
      Features containing XML file or XML String attribute failed to transform due to errors, such as incorrect file paths.