<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>DFDL |</title><link>https://kaoto.io/tags/dfdl/</link><atom:link href="https://kaoto.io/tags/dfdl/index.xml" rel="self" type="application/rss+xml"/><description>DFDL</description><generator>HugoBlox Kit (https://hugoblox.com)</generator><language>en-us</language><lastBuildDate>Fri, 13 Nov 2026 00:00:00 +0000</lastBuildDate><image><url>https://kaoto.io/media/logo_hu_1f7af02082a0d76a.png</url><title>DFDL</title><link>https://kaoto.io/tags/dfdl/</link></image><item><title>Mapping CSV data with the Kaoto DataMapper</title><link>https://kaoto.io/blog/2026/datamapper-csv-dfdl/</link><pubDate>Fri, 13 Nov 2026 00:00:00 +0000</pubDate><guid>https://kaoto.io/blog/2026/datamapper-csv-dfdl/</guid><description>&lt;p&gt;The Kaoto DataMapper maps between XML and JSON documents. A lot of real integrations start with something else, though, and CSV is probably the most common example. This post shows how to map CSV data with the DataMapper today, using the
data format to bridge the gap.&lt;/p&gt;
&lt;p&gt;If you would rather skip the walkthrough and run the result, the finished project is in
.&lt;/p&gt;
&lt;h2 id="the-idea"&gt;The idea&lt;/h2&gt;
&lt;p&gt;The DataMapper needs a schema for each side of the mapping, and it understands XML Schema and JSON Schema.
(Data Format Description Language) is a standard for describing text and binary formats, and a DFDL schema is an XML Schema extended with &lt;code&gt;dfdl:&lt;/code&gt; annotations that describe how the data is laid out on the wire. Because it is still an XML Schema, the DataMapper can load it, and because &lt;code&gt;camel-dfdl&lt;/code&gt; uses
to turn the structured text into XML using that same schema, the data and the schema always agree.&lt;/p&gt;
&lt;p&gt;So the route looks like this:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-fallback" data-lang="fallback"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;CSV → unmarshal (camel-dfdl) → XML → DataMapper → XML / JSON
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;This is the same approach that can be used for other structured text formats, such as X12 or HL7. See the links at the end of this post.&lt;/p&gt;
&lt;h2 id="why-not-use-an-existing-csv-dfdl-schema"&gt;Why not use an existing CSV DFDL schema?&lt;/h2&gt;
&lt;p&gt;There is a generic
in the DFDLSchemas project. It works, but it is deliberately generic. Every line becomes a &lt;code&gt;record&lt;/code&gt; with a list of anonymous &lt;code&gt;item&lt;/code&gt; elements:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-xml" data-lang="xml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;&amp;lt;record&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;item&amp;gt;&lt;/span&gt;smith&lt;span class="nt"&gt;&amp;lt;/item&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;item&amp;gt;&lt;/span&gt;robert&lt;span class="nt"&gt;&amp;lt;/item&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;item&amp;gt;&lt;/span&gt;brandon&lt;span class="nt"&gt;&amp;lt;/item&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;item&amp;gt;&lt;/span&gt;1988-03-24&lt;span class="nt"&gt;&amp;lt;/item&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;&amp;lt;/record&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Even when your CSV has a header line, the column names are lost. This is what you get when you attach this schema to a DataMapper document: the column values are all in a repeatable &lt;code&gt;item&lt;/code&gt; field, and the header line in a generic &lt;code&gt;title&lt;/code&gt;.&lt;/p&gt;
&lt;figure class="image"&gt;
&lt;button type="button" class="image-preview-button" aria-haspopup="dialog" data-modal-target="modal-fig-9e80506d135305873995d3d8839861e8-6"&gt;
&lt;img src="https://kaoto.io/blog/2026/datamapper-csv-dfdl/generic-csv.png" alt="Generic CSV DFDL schema is attached to the source body" class="expandable-image"&gt;
&lt;/button&gt;
&lt;figcaption&gt;Generic CSV DFDL schema is attached to the source body&lt;/figcaption&gt;
&lt;/figure&gt;
&lt;dialog id="modal-fig-9e80506d135305873995d3d8839861e8-6" class="image-modal" aria-label="Image preview"&gt;
&lt;form method="dialog"&gt;
&lt;button type="submit" class="modal-close" aria-label="Close preview" autofocus&gt;&amp;times;&lt;/button&gt;
&lt;/form&gt;
&lt;img class="modal-content" src="https://kaoto.io/blog/2026/datamapper-csv-dfdl/generic-csv.png" alt="Generic CSV DFDL schema is attached to the source body"&gt;
&lt;/dialog&gt;
&lt;p&gt;You can still map from it. Since the columns are only distinguished by their position, you refer to them as &lt;code&gt;item[1]&lt;/code&gt;, &lt;code&gt;item[2]&lt;/code&gt; and so on, and you have to keep track of which column each position stands for. If the layout can vary, for example when columns are optional or come in a different order, you can combine those positions with a &lt;code&gt;choose&lt;/code&gt; / &lt;code&gt;when&lt;/code&gt; / &lt;code&gt;otherwise&lt;/code&gt; condition to decide what to map in each case.&lt;/p&gt;
&lt;p&gt;That has its place. For a CSV with only a few columns it is manageable, and it can even be an advantage when the column specification is not strictly defined and you need to react to the data at mapping time. But for a large CSV with a well-defined structure it quickly becomes a nightmare: dozens of positional references, none of them self-explanatory, and every one of them breaks silently if a column is added or moved. For a well-structured CSV we want the columns to have names, which is what the rest of this post does.&lt;/p&gt;
&lt;h2 id="step-1-describe-your-csv-with-a-dfdl-schema"&gt;Step 1: Describe your CSV with a DFDL schema&lt;/h2&gt;
&lt;p&gt;Here is our sample CSV file, &lt;code&gt;orders.csv&lt;/code&gt;:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-csv" data-lang="csv"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="s"&gt;orderId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;customer&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;product&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;quantity&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;unitPrice&lt;/span&gt;&lt;span class="p"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="s"&gt;A-1001&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;Acme Corp&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;Widget&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;3&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;9.99&lt;/span&gt;&lt;span class="p"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="s"&gt;A-1002&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;Acme Corp&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;Gadget&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;24.50&lt;/span&gt;&lt;span class="p"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="s"&gt;A-1003&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;Acme Corp&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;Gizmo&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;10&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="s"&gt;2.75&lt;/span&gt;&lt;span class="p"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Creating the schema means turning the header into elements. Each column becomes a named element, and the whole file becomes a list of records:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-xml" data-lang="xml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;&amp;lt;xs:schema&lt;/span&gt; &lt;span class="na"&gt;xmlns:xs=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;http://www.w3.org/2001/XMLSchema&amp;#34;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="na"&gt;xmlns:dfdl=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;http://www.ogf.org/dfdl/dfdl-1.0/&amp;#34;&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:annotation&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:appinfo&lt;/span&gt; &lt;span class="na"&gt;source=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;http://www.ogf.org/dfdl/&amp;#34;&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;dfdl:format&lt;/span&gt; &lt;span class="na"&gt;representation=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;text&amp;#34;&lt;/span&gt; &lt;span class="na"&gt;encoding=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;UTF-8&amp;#34;&lt;/span&gt; &lt;span class="na"&gt;lengthKind=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;delimited&amp;#34;&lt;/span&gt; &lt;span class="err"&gt;...&lt;/span&gt; &lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/xs:appinfo&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/xs:annotation&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:element&lt;/span&gt; &lt;span class="na"&gt;name=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;orders&amp;#34;&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:complexType&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:sequence&lt;/span&gt; &lt;span class="na"&gt;dfdl:separator=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;%NL;&amp;#34;&lt;/span&gt; &lt;span class="na"&gt;dfdl:separatorPosition=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;postfix&amp;#34;&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:element&lt;/span&gt; &lt;span class="na"&gt;name=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;header&amp;#34;&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:complexType&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:sequence&lt;/span&gt; &lt;span class="na"&gt;dfdl:separator=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;,&amp;#34;&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:element&lt;/span&gt; &lt;span class="na"&gt;name=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;title&amp;#34;&lt;/span&gt; &lt;span class="na"&gt;type=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;xs:string&amp;#34;&lt;/span&gt; &lt;span class="na"&gt;maxOccurs=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;unbounded&amp;#34;&lt;/span&gt;&lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/xs:sequence&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/xs:complexType&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/xs:element&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:element&lt;/span&gt; &lt;span class="na"&gt;name=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;order&amp;#34;&lt;/span&gt; &lt;span class="na"&gt;maxOccurs=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;unbounded&amp;#34;&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:complexType&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:sequence&lt;/span&gt; &lt;span class="na"&gt;dfdl:separator=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;,&amp;#34;&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:element&lt;/span&gt; &lt;span class="na"&gt;name=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;orderId&amp;#34;&lt;/span&gt; &lt;span class="na"&gt;type=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;xs:string&amp;#34;&lt;/span&gt;&lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:element&lt;/span&gt; &lt;span class="na"&gt;name=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;customer&amp;#34;&lt;/span&gt; &lt;span class="na"&gt;type=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;xs:string&amp;#34;&lt;/span&gt;&lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:element&lt;/span&gt; &lt;span class="na"&gt;name=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;product&amp;#34;&lt;/span&gt; &lt;span class="na"&gt;type=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;xs:string&amp;#34;&lt;/span&gt;&lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:element&lt;/span&gt; &lt;span class="na"&gt;name=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;quantity&amp;#34;&lt;/span&gt; &lt;span class="na"&gt;type=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;xs:int&amp;#34;&lt;/span&gt;&lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;xs:element&lt;/span&gt; &lt;span class="na"&gt;name=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;unitPrice&amp;#34;&lt;/span&gt; &lt;span class="na"&gt;type=&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;xs:decimal&amp;#34;&lt;/span&gt;&lt;span class="nt"&gt;/&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/xs:sequence&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/xs:complexType&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/xs:element&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/xs:sequence&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/xs:complexType&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/xs:element&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;&amp;lt;/xs:schema&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;A few things are worth pointing out:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The outer &lt;code&gt;xs:sequence&lt;/code&gt; separates the lines of the file: &lt;code&gt;dfdl:separator=&amp;quot;%NL;&amp;quot;&lt;/code&gt;, with the separator after each line.&lt;/li&gt;
&lt;li&gt;The header line is consumed by the &lt;code&gt;header&lt;/code&gt; element, so it does not end up as a data row. Its content is generic (&lt;code&gt;title&lt;/code&gt;), and the real column names live in the &lt;code&gt;order&lt;/code&gt; element.&lt;/li&gt;
&lt;li&gt;Columns are matched to elements by position, not by name. The header names are not checked against the elements of &lt;code&gt;order&lt;/code&gt;. If a CSV file has its columns in a different order, the values silently end up in the wrong elements, so reorder the elements in &lt;code&gt;order&lt;/code&gt; to match the file.&lt;/li&gt;
&lt;li&gt;The inner &lt;code&gt;xs:sequence&lt;/code&gt; of &lt;code&gt;order&lt;/code&gt; separates the columns with &lt;code&gt;dfdl:separator=&amp;quot;,&amp;quot;&lt;/code&gt;. Change this if your file uses a different delimiter.&lt;/li&gt;
&lt;li&gt;This schema does not handle quoted fields. A value that contains the separator, such as &lt;code&gt;&amp;quot;Acme, Inc&amp;quot;&lt;/code&gt;, is split into extra fields and the row fails to parse. Use it only for CSV files whose values contain no separators.&lt;/li&gt;
&lt;li&gt;Each column is an &lt;code&gt;xs:element&lt;/code&gt; with a name and a type. Declaring &lt;code&gt;quantity&lt;/code&gt; as &lt;code&gt;xs:int&lt;/code&gt; and &lt;code&gt;unitPrice&lt;/code&gt; as &lt;code&gt;xs:decimal&lt;/code&gt; means the DataMapper knows they are numbers.&lt;/li&gt;
&lt;li&gt;The &lt;code&gt;dfdl:format&lt;/code&gt; annotation on the schema sets the defaults for everything else, such as the encoding and how numbers are represented. DFDL requires many properties to be defined, so the example spells them all out. The complete schema is in the
.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="step-2-try-it-with-camel"&gt;Step 2: Try it with Camel&lt;/h2&gt;
&lt;p&gt;Before involving the DataMapper, check that the schema works. This route reads the CSV and unmarshals it with &lt;code&gt;camel-dfdl&lt;/code&gt;:&lt;/p&gt;
&lt;div class="toggle-wrapper chroma"&gt;
&lt;input type="checkbox" id="img-toggle-9e80506d135305873995d3d8839861e8-3" class="toggle-input"&gt;
&lt;div class="toggle-image-block"&gt;
&lt;div class="tab-bar"&gt;
&lt;span class="tab active"&gt;Image Preview&lt;/span&gt;
&lt;label for="img-toggle-9e80506d135305873995d3d8839861e8-3" class="tab inactive"&gt;View YAML&lt;/label&gt;
&lt;/div&gt;
&lt;div class="content-area"&gt;
&lt;button type="button" class="image-preview-button" aria-haspopup="dialog" data-modal-target="modal-img-toggle-9e80506d135305873995d3d8839861e8-3"&gt;
&lt;img src="https://kaoto.io/blog/2026/datamapper-csv-dfdl/csv-to-xml-canvas.png" alt="Toggle preview" class="expandable-image"&gt;
&lt;/button&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;div class="toggle-code-block"&gt;
&lt;div class="tab-bar"&gt;
&lt;label for="img-toggle-9e80506d135305873995d3d8839861e8-3" class="tab inactive"&gt;View Image&lt;/label&gt;
&lt;span class="tab active"&gt;YAML Source&lt;/span&gt;
&lt;/div&gt;
&lt;label for="img-toggle-9e80506d135305873995d3d8839861e8-3" class="content-area"&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;- &lt;span class="nt"&gt;route&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;csv-to-xml&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;from&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;uri&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;timer&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;parameters&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;timerName&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;once&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;repeatCount&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;1&amp;#34;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;steps&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="nt"&gt;setBody&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;expression&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;constant&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;expression&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;resource:classpath:orders.csv&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="nt"&gt;unmarshal&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;dfdl&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;schemaUri&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;orders.dfdl.xsd&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="nt"&gt;log&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;message&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;${body}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;/label&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;dialog id="modal-img-toggle-9e80506d135305873995d3d8839861e8-3" class="image-modal" aria-label="Image preview"&gt;
&lt;form method="dialog"&gt;
&lt;button type="submit" class="modal-close" aria-label="Close preview" autofocus&gt;&amp;times;&lt;/button&gt;
&lt;/form&gt;
&lt;img class="modal-content" src="https://kaoto.io/blog/2026/datamapper-csv-dfdl/csv-to-xml-canvas.png" alt="Expanded preview"&gt;
&lt;/dialog&gt;
&lt;p&gt;Run it in Kaoto. Click the &lt;code&gt;Run: Workspace&lt;/code&gt; button:&lt;/p&gt;
&lt;figure class="image"&gt;
&lt;button type="button" class="image-preview-button" aria-haspopup="dialog" data-modal-target="modal-fig-9e80506d135305873995d3d8839861e8-7"&gt;
&lt;img src="https://kaoto.io/blog/2026/datamapper-csv-dfdl/csv-to-xml-run.png" alt="Run csv-to-xml Camel route from Kaoto" class="expandable-image"&gt;
&lt;/button&gt;
&lt;figcaption&gt;Run csv-to-xml Camel route from Kaoto&lt;/figcaption&gt;
&lt;/figure&gt;
&lt;dialog id="modal-fig-9e80506d135305873995d3d8839861e8-7" class="image-modal" aria-label="Image preview"&gt;
&lt;form method="dialog"&gt;
&lt;button type="submit" class="modal-close" aria-label="Close preview" autofocus&gt;&amp;times;&lt;/button&gt;
&lt;/form&gt;
&lt;img class="modal-content" src="https://kaoto.io/blog/2026/datamapper-csv-dfdl/csv-to-xml-run.png" alt="Run csv-to-xml Camel route from Kaoto"&gt;
&lt;/dialog&gt;
&lt;p&gt;The log shows the CSV as XML, with the column names as element names and the values typed according to the schema:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-xml" data-lang="xml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;&amp;lt;orders&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;header&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;title&amp;gt;&lt;/span&gt;orderId&lt;span class="nt"&gt;&amp;lt;/title&amp;gt;&amp;lt;title&amp;gt;&lt;/span&gt;customer&lt;span class="nt"&gt;&amp;lt;/title&amp;gt;&amp;lt;title&amp;gt;&lt;/span&gt;product&lt;span class="nt"&gt;&amp;lt;/title&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;title&amp;gt;&lt;/span&gt;quantity&lt;span class="nt"&gt;&amp;lt;/title&amp;gt;&amp;lt;title&amp;gt;&lt;/span&gt;unitPrice&lt;span class="nt"&gt;&amp;lt;/title&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/header&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;order&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;orderId&amp;gt;&lt;/span&gt;A-1001&lt;span class="nt"&gt;&amp;lt;/orderId&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;customer&amp;gt;&lt;/span&gt;Acme Corp&lt;span class="nt"&gt;&amp;lt;/customer&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;product&amp;gt;&lt;/span&gt;Widget&lt;span class="nt"&gt;&amp;lt;/product&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;quantity&amp;gt;&lt;/span&gt;3&lt;span class="nt"&gt;&amp;lt;/quantity&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;unitPrice&amp;gt;&lt;/span&gt;9.99&lt;span class="nt"&gt;&amp;lt;/unitPrice&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/order&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; ...
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;&amp;lt;/orders&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="step-3-map-it-with-the-datamapper"&gt;Step 3: Map it with the DataMapper&lt;/h2&gt;
&lt;p&gt;Now add a DataMapper step after the &lt;code&gt;unmarshal&lt;/code&gt; step.&lt;/p&gt;
&lt;figure class="image"&gt;
&lt;button type="button" class="image-preview-button" aria-haspopup="dialog" data-modal-target="modal-fig-9e80506d135305873995d3d8839861e8-8"&gt;
&lt;img src="https://kaoto.io/blog/2026/datamapper-csv-dfdl/add-datamapper.png" alt="Add DataMapper step" class="expandable-image"&gt;
&lt;/button&gt;
&lt;figcaption&gt;Add DataMapper step&lt;/figcaption&gt;
&lt;/figure&gt;
&lt;dialog id="modal-fig-9e80506d135305873995d3d8839861e8-8" class="image-modal" aria-label="Image preview"&gt;
&lt;form method="dialog"&gt;
&lt;button type="submit" class="modal-close" aria-label="Close preview" autofocus&gt;&amp;times;&lt;/button&gt;
&lt;/form&gt;
&lt;img class="modal-content" src="https://kaoto.io/blog/2026/datamapper-csv-dfdl/add-datamapper.png" alt="Add DataMapper step"&gt;
&lt;/dialog&gt;
&lt;p&gt;For this example, imagine the CSV is a batch order from a single customer, and the target is one invoice for the whole batch, described by a plain XML Schema, &lt;code&gt;invoice.xsd&lt;/code&gt;. It has the customer, one &lt;code&gt;line&lt;/code&gt; per CSV row, and a &lt;code&gt;grandTotal&lt;/code&gt; after the lines:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-xml" data-lang="xml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;&amp;lt;invoice&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;billTo/&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;line&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;orderId/&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;description/&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;quantity/&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;unitPrice/&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;lineTotal/&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/line&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;grandTotal/&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;&amp;lt;/invoice&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ol&gt;
&lt;li&gt;Open the DataMapper step and attach &lt;code&gt;orders.dfdl.xsd&lt;/code&gt; as the &lt;strong&gt;Source Body&lt;/strong&gt; schema. The DataMapper accepts it like any other &lt;code&gt;.xsd&lt;/code&gt;, and ignores the &lt;code&gt;dfdl:&lt;/code&gt; annotations.&lt;/li&gt;
&lt;li&gt;Attach &lt;code&gt;invoice.xsd&lt;/code&gt; as the &lt;strong&gt;Target Body&lt;/strong&gt; schema.&lt;/li&gt;
&lt;li&gt;Create the mappings. Because the source fields are named after the CSV columns, this is a normal visual mapping:
&lt;ul&gt;
&lt;li&gt;Use a &lt;code&gt;for-each&lt;/code&gt; on &lt;code&gt;order&lt;/code&gt; to produce one &lt;code&gt;line&lt;/code&gt; per CSV row. Inside it, map &lt;code&gt;orderId&lt;/code&gt;, &lt;code&gt;quantity&lt;/code&gt; and &lt;code&gt;unitPrice&lt;/code&gt; straight across, and build &lt;code&gt;description&lt;/code&gt; from the product and quantity with &lt;code&gt;concat(product, ' x ', quantity)&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;The CSV repeats the customer on every row, so map the &lt;code&gt;customer&lt;/code&gt; of the first &lt;code&gt;order&lt;/code&gt; to &lt;code&gt;billTo&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;code&gt;lineTotal&lt;/code&gt; and &lt;code&gt;grandTotal&lt;/code&gt; have no counterpart in the CSV, so compute them in the XPath editor. For &lt;code&gt;lineTotal&lt;/code&gt;, multiply &lt;code&gt;xs:decimal(quantity)&lt;/code&gt; and &lt;code&gt;xs:decimal(unitPrice)&lt;/code&gt; within the &lt;code&gt;for-each&lt;/code&gt;. For &lt;code&gt;grandTotal&lt;/code&gt;, add up the same product over all the orders: &lt;code&gt;sum(/orders/order/(xs:decimal(quantity) * xs:decimal(unitPrice)))&lt;/code&gt;. The values read from the XML are untyped, and XPath would otherwise multiply them as floating-point numbers, which can show rounding artifacts such as &lt;code&gt;2.3999999999999995&lt;/code&gt; instead of &lt;code&gt;2.4&lt;/code&gt;. Casting them to &lt;code&gt;xs:decimal&lt;/code&gt; keeps the amounts exact.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;figure class="image"&gt;
&lt;button type="button" class="image-preview-button" aria-haspopup="dialog" data-modal-target="modal-fig-9e80506d135305873995d3d8839861e8-9"&gt;
&lt;img src="https://kaoto.io/blog/2026/datamapper-csv-dfdl/datamapper-done.png" alt="Configured data mappings" class="expandable-image"&gt;
&lt;/button&gt;
&lt;figcaption&gt;Configured data mappings&lt;/figcaption&gt;
&lt;/figure&gt;
&lt;dialog id="modal-fig-9e80506d135305873995d3d8839861e8-9" class="image-modal" aria-label="Image preview"&gt;
&lt;form method="dialog"&gt;
&lt;button type="submit" class="modal-close" aria-label="Close preview" autofocus&gt;&amp;times;&lt;/button&gt;
&lt;/form&gt;
&lt;img class="modal-content" src="https://kaoto.io/blog/2026/datamapper-csv-dfdl/datamapper-done.png" alt="Configured data mappings"&gt;
&lt;/dialog&gt;
&lt;figure class="image"&gt;
&lt;button type="button" class="image-preview-button" aria-haspopup="dialog" data-modal-target="modal-fig-9e80506d135305873995d3d8839861e8-10"&gt;
&lt;img src="https://kaoto.io/blog/2026/datamapper-csv-dfdl/xpath-editor-grandTotal.png" alt="Editing grandTotal expression in XPath Editor" class="expandable-image"&gt;
&lt;/button&gt;
&lt;figcaption&gt;Editing grandTotal expression in XPath Editor&lt;/figcaption&gt;
&lt;/figure&gt;
&lt;dialog id="modal-fig-9e80506d135305873995d3d8839861e8-10" class="image-modal" aria-label="Image preview"&gt;
&lt;form method="dialog"&gt;
&lt;button type="submit" class="modal-close" aria-label="Close preview" autofocus&gt;&amp;times;&lt;/button&gt;
&lt;/form&gt;
&lt;img class="modal-content" src="https://kaoto.io/blog/2026/datamapper-csv-dfdl/xpath-editor-grandTotal.png" alt="Editing grandTotal expression in XPath Editor"&gt;
&lt;/dialog&gt;
&lt;p&gt;The route now has the shape setBody (CSV) → Unmarshal (XML) → DataMapper:&lt;/p&gt;
&lt;div class="toggle-wrapper chroma"&gt;
&lt;input type="checkbox" id="img-toggle-9e80506d135305873995d3d8839861e8-4" class="toggle-input"&gt;
&lt;div class="toggle-image-block"&gt;
&lt;div class="tab-bar"&gt;
&lt;span class="tab active"&gt;Image Preview&lt;/span&gt;
&lt;label for="img-toggle-9e80506d135305873995d3d8839861e8-4" class="tab inactive"&gt;View YAML&lt;/label&gt;
&lt;/div&gt;
&lt;div class="content-area"&gt;
&lt;button type="button" class="image-preview-button" aria-haspopup="dialog" data-modal-target="modal-img-toggle-9e80506d135305873995d3d8839861e8-4"&gt;
&lt;img src="https://kaoto.io/blog/2026/datamapper-csv-dfdl/csv-to-xml-datamapper-canvas.png" alt="Toggle preview" class="expandable-image"&gt;
&lt;/button&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;div class="toggle-code-block"&gt;
&lt;div class="tab-bar"&gt;
&lt;label for="img-toggle-9e80506d135305873995d3d8839861e8-4" class="tab inactive"&gt;View Image&lt;/label&gt;
&lt;span class="tab active"&gt;YAML Source&lt;/span&gt;
&lt;/div&gt;
&lt;label for="img-toggle-9e80506d135305873995d3d8839861e8-4" class="content-area"&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;- &lt;span class="nt"&gt;route&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;csv-to-xml&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;from&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;uri&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;timer&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;parameters&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;timerName&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;once&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;repeatCount&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;1&amp;#34;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;steps&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="nt"&gt;setBody&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;expression&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;constant&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;expression&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;resource:classpath:orders.csv&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="nt"&gt;unmarshal&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;dfdl&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;schemaUri&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;orders.dfdl.xsd&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="nt"&gt;step&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;kaoto-datamapper-3148ebc4&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;steps&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="nt"&gt;to&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;kaoto-datamapper-xslt-6547&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;uri&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;xslt-saxon:kaoto-datamapper-3148ebc4.xsl&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;parameters&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;failOnNullBody&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="nt"&gt;log&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;message&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;${body}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;/label&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;dialog id="modal-img-toggle-9e80506d135305873995d3d8839861e8-4" class="image-modal" aria-label="Image preview"&gt;
&lt;form method="dialog"&gt;
&lt;button type="submit" class="modal-close" aria-label="Close preview" autofocus&gt;&amp;times;&lt;/button&gt;
&lt;/form&gt;
&lt;img class="modal-content" src="https://kaoto.io/blog/2026/datamapper-csv-dfdl/csv-to-xml-datamapper-canvas.png" alt="Expanded preview"&gt;
&lt;/dialog&gt;
&lt;p&gt;The DataMapper generates the XSLT behind the scenes. Each &lt;code&gt;order&lt;/code&gt; element in the CSV becomes a &lt;code&gt;line&lt;/code&gt; of the invoice, and the &lt;code&gt;grandTotal&lt;/code&gt; adds them up.&lt;/p&gt;
&lt;p&gt;Running the route again gives one invoice for the whole batch:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-xml" data-lang="xml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;&amp;lt;invoice&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;billTo&amp;gt;&lt;/span&gt;Acme Corp&lt;span class="nt"&gt;&amp;lt;/billTo&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;line&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;orderId&amp;gt;&lt;/span&gt;A-1001&lt;span class="nt"&gt;&amp;lt;/orderId&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;description&amp;gt;&lt;/span&gt;Widget x 3&lt;span class="nt"&gt;&amp;lt;/description&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;quantity&amp;gt;&lt;/span&gt;3&lt;span class="nt"&gt;&amp;lt;/quantity&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;unitPrice&amp;gt;&lt;/span&gt;9.99&lt;span class="nt"&gt;&amp;lt;/unitPrice&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;lineTotal&amp;gt;&lt;/span&gt;29.97&lt;span class="nt"&gt;&amp;lt;/lineTotal&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;/line&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; ...
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;lt;grandTotal&amp;gt;&lt;/span&gt;81.97&lt;span class="nt"&gt;&amp;lt;/grandTotal&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;&amp;lt;/invoice&amp;gt;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="whats-next"&gt;What&amp;rsquo;s next&lt;/h2&gt;
&lt;p&gt;Writing the DFDL schema by hand is fine for a CSV with a handful of columns, like the one in this post. Real-world CSV files often have dozens or even hundreds of columns, and typing out one element per column is tedious and easy to get wrong, and it has to be repeated for every CSV layout you want to map. We are planning to automate it, and the work is tracked in
:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Upload a CSV file&lt;/strong&gt; in the DataMapper. A header line is enough; you do not need the whole file.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Generate the DFDL schema&lt;/strong&gt; from it. Each column in the header becomes a named field, and the rows are represented as an array of that field set, exactly as in the schema above.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Add the &lt;code&gt;camel-dfdl&lt;/code&gt; step automatically&lt;/strong&gt; inside the DataMapper step, so the CSV is converted to XML before the mapping and back again afterwards, without you having to configure it.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;These features are planned and are &lt;strong&gt;not available yet&lt;/strong&gt;. Until then, the manual approach in this post works with the DataMapper as it is today. Stay tuned!&lt;/p&gt;
&lt;h2 id="lets-build-it-together"&gt;Let&amp;rsquo;s build it together&lt;/h2&gt;
&lt;p&gt;CSV support in the DataMapper is tracked in
. Any kind of feedback is always more than welcome.&lt;/p&gt;
&lt;p&gt;Join the conversation in the
or
.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id="give-it-a-try"&gt;Give it a try&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;The
in kaoto-examples: the finished project from this post, ready to run with Camel JBang&lt;/li&gt;
&lt;li&gt;Kaoto is available as a
, where you can open the example and explore the DataMapper mapping&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="see-also"&gt;See also&lt;/h2&gt;
&lt;p&gt;The same &lt;code&gt;camel-dfdl&lt;/code&gt; and DataMapper combination works for other structured text formats. These proof-of-concept projects are good places to start:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
: converts X12 837 EDI messages to and from XML with DFDL, and maps them with the DataMapper&lt;/li&gt;
&lt;li&gt;
: converts HL7 messages to XML and back, and transforms them with the DataMapper&lt;/li&gt;
&lt;/ul&gt;</description></item></channel></rss>