XMLNamespaceDeclarer
Declares missing namespaces in XML documents by matching prefixes from another sample XML file whose namespaces are fully declared.
Input Ports
Input features that contain the information of the XML documents.
Output Ports
If the XML namespaces of the input document are fixed and well-formed, it will be output through this port.
If a feature does not have a well-formed XML document, it will be output through this port.
Parameters
XML Input
Select from the pull-down list to enable the selection's corresponding parameter:
- Attribute Specifying XML Text/Attribute With XML Text: Once you connect the transformer, choose the attribute that contains XML text.
- XML Filename/XML File: Browse to an XML file.
- XML Text/XML Text: Opens an XML text editor.
The sample XML file that will be used as a reference for declaring missing namespaces in the XML input documents. If the sample file has more than one namespace with the same prefix but different URI, then the first one will always be used.
XML Output
Attribute to contain XML output/XML Output File: The XML features that have been successfully processed can be output to a feature attribute by specifying an attribute name in the Attribute to contain XML Output, or to a file by specifying the path to the file in XML Output File parameter.
Error and Warning List Name: Features with at least one warning or error will be output through the Failed port with a new list attribute added to the features. If the default _xml_error is the list name, the elements of the list attribute contain the following:
Elements of List Attribute | Description |
---|---|
_xml_error{}.type | WARNING, ERROR or FATAL ERROR |
_xml_error{}.file | the file where the warning or error occurs |
_xml_error{}.line | the line where the warning or error occurs |
_xml_error{}.col | the column where the warning or error occurs |
_xml_error{}.desc | the details about the warning or error |
Note: List attributes are not accessible from the output schema in Workbench unless they are first processed using a transformer that operates on them, such as ListExploder or ListConcatenator. Alternatively, AttributeExposer can be used.
Pretty Printing
The parameter specifies if the XML output should be pretty-printed with indentation.
This parameter specifies the size of a single indentation.
By default, the tab character is used for pretty printing, use this parameter to replace the tabs with spaces.
Example
<root>
<f:element1>
<f:element2> some text </f:element2>
<f:element3> some text </f:element3>
</f:element1>
</root>
and the sample XML file:
<root>
<f:element1 xmlns:f="http://www.w3schools.com/example">
<f:element2 xmlns:f=" http://www.w3schools.com/example"> some text </f:element2>
<f:element3 xmlns:f=" http://www.w3schools.com/example"> some text </f:element3>
</f:element1>
</root>
the output will look like this:
<root>
<f:element1 xmlns:f="http://www.w3schools.com/example">
<f:element2> some text </f:element2>
<f:element3> some text </f:element3>
</f:element1>
</root>
Editing Transformer Parameters
Using a set of menu options, transformer parameters can be assigned by referencing other elements in the workspace. More advanced functions, such as an advanced editor and an arithmetic editor, are also available in some transformers. To access a menu of these options, click beside the applicable parameter. For more information, see Transformer Parameter Menu Options.
Transformer Categories
FME Licensing Level
FME Professional edition and above
Search FME Community
Search for samples and information about this transformer on the FME Community.