parse xml

Parse XML

Icon
Use When	An inbound text message in xml text format needs to be parsed into a model based message structure
Samples	DB Request to WSDL to DB Results
Description	The parse xml component takes an inbound text message in xml format and parses it into a model based outbound message.
Inbound Message Type	Model Based Message
Output Message Type	Model Based Message
Control Message Handling	Input: As text messages are received they are processed. Output: A single control message will be forwarded to downstream components once all messages have been processed through this step.

Properties

Name	Description
Output Model
Error Suspense Step	Whether to forward failed messages and continue processing. This is the name of a linked component to forward the failed messages to.
Enabled
Rows Per Message
Optimmize for speed. Supports only basic XPath	Whether to optimize the processing (available only on the Simple XML Parser)
Ignore namespaces for XPath matching	Whether to ignore the namespaces
Log Input
Log Output
Inbound Queue Capacity

Component Editor

Double clicking on the Parse XML component in the flow will result in the Parse XML editor being displayed as shown below.

The first step in configuring the parser is to specify the xml template that will be used to define the xml tag structure of the document. The XML template can be imported from an XSD or WSDL source that resides in a file or at a specified URL. Clicking the "Import Template" button opens the import dialog show below.

An XML template can also be manually entered by clicking the "Edit Template" button.

Once an XML template is defined XPath is used to map entities/attributes from the model to the xml template. See examples below.

Example 1. Parse Person XML to Entity

XML Template

<Persons>
    <Person>
        <Id></Id>
        <FirstName></FirstName>
        <LastName></LastName>
        <Gender></Gender>
    </Person>
</Persons>

XPath Mapping