XPath Expressions¶ Note WSO2 Integrator: MI will continue to support existing XPath expressions. However, it is recommended to use the new Synapse Expressions, as they simplify data extraction and provide a rich set of functions. XPath (XML Path Language) is a language used to navigate through elements and attributes in an XML document. It allows you to identify and extract specific portions of XML data, making it ideal for working with complex XML payloads, which are common in service integration scenarios. Note The WSO2 Integrator: MI supports standard XPath functions and variables through its underlying XPath engine. It supports XPath 1.0 by default whereas the support for XPath 2.0 can be introduced by adding the following property in <MI_HOME>/conf/deployment.toml. [mediation] synapse.enable_xpath_dom_failover=true XPath syntax¶ The syntax provides a way to select nodes such as elements and attributes in an XML document. Let's use the following payload: <order> <customer id="1100"> <name>John Doe</name> <email>[email protected]</email> </customer> <items> <item id="101"> <name>Smartphone</name> <price>300</price> </item> <item id="102"> <name>Laptop</name> <price>1200</price> </item> </items> <total>1500</total> </order> The following table summarizes sample XPath expressions and their outputs: Type Description Expression Result Node Selection Single Slash (/): Selects nodes from the root element. expression="//ns:order/ns:total" xmlns:ns="http://ws.apache.org/ns/synapse" 1500 Double Slash (//): Selects nodes in the document regardless of their depth or hierarchy. expression="//ns:total" xmlns:ns="http://ws.apache.org/ns/synapse" 1500 Attributes @: XPath can also be used to select attributes of elements. expression="//ns:customer/@id" xmlns:ns="http://ws.apache.org/ns/synapse" 1100 Predicates Square Brackets ([]): Used to apply conditions to narrow down the node selection. expression="//ns:item[@id='102']/ns:name" xmlns:ns="http://ws.apache.org/ns/synapse" Laptop Functions XPath includes various built-in functions to work with nodes and data. Refer to more functions. expression="sum(//ns:item/ns:price)" xmlns:ns="http://ws.apache.org/ns/synapse" 1500.0 Go to XPath syntax for more examples. How to retrieve the XML node itself instead of text contentWhen the result of an XPath evaluation results in a single XML node, the evaluator will return the text content of this node (similar to executing /root/body/node/text()). If you want to retrieve the node itself, you have to configure the Enrich mediator as shown in the following example. <inSequence> <log level="custom"> <property name="WHERE" value="before doing stuff"/> </log> <enrich> <source type="body" clone="true"/> <target type="property" property="ORIGINAL_PAYLOAD"/> </enrich> <property name="CHILD_PAYLOAD" expression="$body/child::node()" scope="default"/> <log level="custom"> <property name="WHERE" value="after doing stuff"/> <property name="ORIGINAL_PAYLOAD" expression="get-property('ORIGINAL_PAYLOAD')"/> <property name="CHILD_PAYLOAD" expression="get-property('CHILD_PAYLOAD')"/> </log> <enrich> <source type="property" clone="true" property="ORIGINAL_PAYLOAD"/> <target type="body" action="sibling"/> </enrich> <log level="full"/> </inSequence>