Syntax

   FACTORY_DEF <ReaderKeyword> TextEncoderFactory
   [FACTORY_NAME <factory name>]
   [INPUT FEATURE_TYPE <feature type>
      [<attribute name> <attribute value>]*
      [<feature function>]*]*
   ACTION <action>
   RESULT_ATTR <result attribute>
   RESULT_ATTR_ENCODING <encoding name>
   (VALUE_TO_ENCODE <string value or FME function> |
      ATTR_TO_ENCODE <attribute name>)
   ATTR_TABLE <attribute table>
   [OUTPUT OUTPUT 
      FEATURE_TYPE <feature type>
      [<attribute name> <attribute value>]*
      [<feature function>]*]*

Overview

   This factory will encode/decode text using one of the following methods: URL 
   Encoding, XML/HTML character references, Base64 encoding and HEX encoding. 
   The results of the encoding/decoding will be placed into the attribute named 
   by the RESULT_ATTR keyword.

   The encoding method and direction (encode/decode) are specified in the ACTION 
   factory clause.  Possible values for this clause are given in this table:

      Encoding Method               Encode Action     Decode Action
      ~~~~~~~~~~~~~~~               ~~~~~~~~~~~~~     ~~~~~~~~~~~~~
      URL (Percent Encoding)        URL_ENCODE        URL_DECODE
      XML Character References      XML_ENCODE        XML_DECODE
      HTML Character references     HTML_ENCODE       HTML_DECODE
      Base64                        BASE64_ENCODE     BASE64_DECODE
      Hex                           HEX_ENCODE        HEX_DECODE
      Octal                         OCTAL_ENCODE      OCTAL_DECODE
   
   The value to encode/decode may be entered in two ways.  An attribute name may 
   be passed to the factory using the ATTR_TO_ENCODE or ATTR_TABLE clause.  
   A string value or FME function call which returns a string value may be passed 
   to the factory using the VALUE_TO_ENCODE clause.  These keywords are used for 
   both encoding and decoding.
   
   For decoding Base64 and HEX strings, the RESULT_ATTR_ENCODING clause is used 
   to specify the character set for the result attribute.  Decoding Base64 or 
   HEX produces a sequence of bytes.  The factory uses the RESULT_ATTR_ENCODING 
   clause to interpret the bytes as a text string.

Output Tags

   The TextEncoderFactory supports the following output tag.
   
   OUTPUT

      To be documented.

TO BE RESOLVED

   Output Tags section needs to be documented.