- Overview
- Common Parameters
- Options - Options Tab


- The utility set identifier for this utility is: oku_set04
- The utility identifier is: xmlpartitioning

The XML Partitioning utility allows you to extract and merge specific element text content or attribute value in supplemental files. This is useful when, for example, an XML document contain large element content or attribute values that are in HTML or another format. Such text content can be externalized to separate files, translated independently (using different filter settings), and then merged back into it original XML document.

Note that the content to extract must be text-only from the XML document viewpoint. If it contains child elements, you should be able to use the XML Filter to process the document.

Common Parameters

The common parameters are the options specified from the application calling the utility rather than in the options dialog box of the utility itself. For this utility the common parameters you need to specify are the following:

Files of the first input list - Needed (the XML files to process)
Root for the first input list - Not Needed
Files of the second input list - Not Needed
Root for the second input list - Not Needed
Files of the third input list - Not Needed
Root for the third input list - Not Needed
Input language - Not Needed
Output language - Not Needed
Input default encoding - Not Needed
Output default encoding - Not Needed
Location and names for output files - Needed

Options - Option Tab

Extraction mode -- Select this option to extract the specified element and attribute data into external files. The data is replaced by a prefix and the name of the extracted file. the output files created are raw copy of the data found in the XML original file. The externalized files are always in UTF-8 encoding.

Merging mode -- Select this option to merge back externalized data into it original file.

Enter the list of XPath expressions for the elements or attributes that should have their content processed for either extraction or merging. Any entry with its check mark not set is ignored during processing.

Extension -- Enter the extension to use for the file generated from the current XPath expression. The default is a .htm extension. Any extension can be used. It is just to provide a clue for further processing of the extracted files.

Add Item -- Click this button to add a new XPath expression in the list, and to switch to edit mode.

Apply Changes -- Click this button (which appears when you are in edit mode) to accept the changes entered in the edit field and set the expression currently selected to this new value.

Modify -- Click this button to edit the expression currently selected.

Cancel Changes -- Click this button (which appears when you are in edit mode) to discard the changes you have entered in the edit field.

Remove -- Click this button to remove the expression currently selected from the list.

Each expression must be a valid XPath expression pointing to one or more element or attribute nodes. The expression will be evaluated from the root of the document.

TODO: Info about how to handle Namespaces