Syntax

   FACTORY_DEF <ReaderKeyword> XFMapFactory 
   [FACTORY_NAME <factory name>] 
   [INPUT FEATURE_TYPE <feature type> 
      [<attribute name> <attribute value>]* 
      [<feature function>]*]*
   [XML_FILE <attribute name> | XML_STREAM <attribute name>] 
   [XFMAP_FILE <attribute name or value>]+ 
   [XFMAP_STREAM <attribute name or value>]+ 
   [XRS <value>] 
   [XML_SOURCE_NAME <value>] 
   [XML_SOURCE_VALUE <value>] 
   [FEATURE_COUNT_PER_XML <value>]
   [FEATURE_TYPE_ATTR <value>] 
   [REJECT_INVALID_GEOM (Yes|No)]
   [IGNORE_DATASET_EXTERNAL_DTD (Yes|No)]
   [DISABLE_EXTERNAL_ENTITY_PROCESSING (Yes|No)] 
   OUTPUT (MAPPED|INVALID|REJECTED) FEATURE_TYPE <feature type> 
      [<attribute name> <attribute value>]* 
      [<feature function>]*]* 

Overview

   This factory constructs features from XML documents. The XML data to map may 
   be specified wholly as a string with the XFMAP_STREAM clause or as a file 
   path with the XML_FILE clause.

   The XFMapFactory uses a set of rules to map XML data into FME features. These 
   mapping rules are defined in xfMap documents. One or more xfMaps can be 
   specified for this transformer via the XFMAP_FILE and/or XFMAP_STREAM 
   clauses. See the XML reader documentation for more information regarding the 
   xfMap.

   An XRS (XML Reader Switch) document allows the XFMapFactory to automatically 
   configure itself to read "known" XML datasets without the need to specify in 
   advance the appropriate xfMap(s). If no xfMap and no XRS are specified for 
   this factory, then the default XRS document is used. The default XRS document 
   is named xrs.xml, and it is located in the xml/xrs subdirectory of the FME 
   installation directory. See the XML reader documentation for more information 
   regarding the XRS.

   The optional XML_SOURCE_NAME and XML_SOURCE_VALUE clauses specify the name 
   and the value for the attribute that is to be added to the mapped features to 
   identify the XML source document. The default value for this attribute 
   depends on the clause that was used to specify the XML document, the default 
   value is the file path for the XML_FILE clause or the empty string for the 
   XML_STREAM clause. 

   The optional FEATURE_COUNT_PER_XML clause sets the name for the attribute 
   that enumerates features mapped per XML document. 

   The optional FEATURE_TYPE_ATTR clause sets the attribute to store the feature 
   type for the mapped features.

   The optional IGNORE_DATASET_EXTERNAL_DTD allows the underlying parser to 
   ignore the external dtd.

   The optional DISABLE_EXTERNAL_ENTITY_PROCESSING clause prevents the external
   entities to be substituted.

Output Tags

   The XFMap factory supports the following output tags.
   
   MAPPED   
   
      The features extracted from the XML source documents are output through 
      the MAPPED output tag.

   INVALID  
   
      The INPUT features containing an error in their XML source are output 
      through the INVALID output tag.