• An XML document. The parsed document, its location, or its source is provided as an argument to the data source constructor.
• An XPath expression to select the node set that corresponds to the data source record list. The expression is passed to the data source as a constructor argument. The default XPath expression selects the document node itself. The XPath expression is executed when the data source is instantiated; each item in the resulting node set will generate a record in the data source.
• An XPath expression to select the field value for every field in the data set, when iterating through records. The field’s XPath expression is provided by the field description (<fieldDescription> element in JRXML).

• A sub–data source can be created for a new document that uses the current node as a root node.
• The same document can be reused for a new sub–data source, which would specify a different XPath expression for the main node set.

• the Number pattern - see the setNumberPattern(java.lang.String) method;
• the Date pattern - see the setDatePattern(java.lang.String) method;
• the Locale property - see the setLocale(java.util.Locale) method;
• the time zone - see the setTimeZone(java.util.TimeZone) method.

• XML_LOCALE
• XML_NUMBER_PATTERN
• XML_DATE_PATTERN
• XML_TIME_ZONE

  <Customers>
    <CustomerID>ALFKI</CustomerID>
    <CompanyName>Alfreds Futterkiste</CompanyName>
    <ContactName>Maria Anders</ContactName>
    <ContactTitle>Sales Representative</ContactTitle>
    <Address>Obere Str. 57</Address>
    <City>Berlin</City>
    <PostalCode>12209</PostalCode>
    <Country>Germany</Country>
    <Phone>030-0074321</Phone>
    <Fax>030-0076545</Fax>
  </Customers>

  <Orders>
    <OrderID>10643</OrderID>
    <CustomerID>ALFKI</CustomerID>
    <EmployeeID>6</EmployeeID>
    <OrderDate>1997-08-25</OrderDate>
    <RequiredDate>1997-09-22</RequiredDate>
    <ShippedDate>1997-09-02</ShippedDate>
    <ShipVia>1</ShipVia>
    <Freight>29.46</Freight>
    <ShipName>Alfreds Futterkiste</ShipName>
    <ShipAddress>Obere Str. 57</ShipAddress>
    <ShipCity>Berlin</ShipCity>
    <ShipPostalCode>12209</ShipPostalCode>
    <ShipCountry>Germany</ShipCountry>
  </Orders>

• CustomerID
• CompanyName
• ContactName
• Sales Representative
• ContactTitle
• Address
• City
• PostalCode
• Country
• Phone
• Fax

• OrderID
• CustomerID
• EmployeeID
• OrderDate
• RequiredDate
• ShippedDate
• ShipVia
• Freight
• ShipName
• ShipAddress
• ShipCity
• ShipPostalCode
• ShipCountry

  <field name="CustomerID" class="java.lang.String">
    <fieldDescription>CustomerID</fieldDescription>
  </field>
  <field name="CompanyName" class="java.lang.String">
    <fieldDescription>CompanyName</fieldDescription>
  </field>

  <subreport>
    <reportElement isPrintRepeatedValues="false" x="5" y="25" width="507" height="20" isRemoveLineWhenBlank="true" backcolor="#ffcc99"/>
    <subreportParameter name="XML_DATA_DOCUMENT">
      <subreportParameterExpression>$P{XML_DATA_DOCUMENT}</subreportParameterExpression>
    </subreportParameter>
    <subreportParameter name="XML_DATE_PATTERN">
      <subreportParameterExpression>$P{XML_DATE_PATTERN}</subreportParameterExpression>
    </subreportParameter>
    <subreportParameter name="XML_NUMBER_PATTERN">
      <subreportParameterExpression>$P{XML_NUMBER_PATTERN}</subreportParameterExpression>
    </subreportParameter>
    <subreportParameter name="XML_LOCALE">
      <subreportParameterExpression>$P{XML_LOCALE}</subreportParameterExpression>
    </subreportParameter>
    <subreportParameter name="XML_TIME_ZONE">
      <subreportParameterExpression>$P{XML_TIME_ZONE}</subreportParameterExpression>
    </subreportParameter>
    <subreportParameter name="CustomerID">
      <subreportParameterExpression>$F{CustomerID}</subreportParameterExpression>
    </subreportParameter>
    <subreportExpression class="java.lang.String">"OrdersReport.jasper"</subreportExpression>
  </subreport>

  <field name="Id" class="java.lang.String">
	<fieldDescription>OrderID</fieldDescription>
  </field>
  <field name="OrderDate" class="java.util.Date">
	<fieldDescription>OrderDate</fieldDescription>
  </field>
  <field name="ShipCity" class="java.lang.String">
	<fieldDescription>ShipCity</fieldDescription>
  </field>
  <field name="Freight" class="java.lang.Float">
	<fieldDescription>Freight</fieldDescription>
  </field>

  public void fill() throws JRException
  {
    long start = System.currentTimeMillis();
    Map params = new HashMap();
    Document document = JRXmlUtils.parse(JRLoader.getLocationInputStream("data/northwind.xml"));
    params.put(JRXPathQueryExecuterFactory.PARAMETER_XML_DATA_DOCUMENT, document);
    params.put(JRXPathQueryExecuterFactory.XML_DATE_PATTERN, "yyyy-MM-dd");
    params.put(JRXPathQueryExecuterFactory.XML_NUMBER_PATTERN, "#,##0.##");
    params.put(JRXPathQueryExecuterFactory.XML_LOCALE, Locale.ENGLISH);
    params.put(JRParameter.REPORT_LOCALE, Locale.US);

    JasperFillManager.fillReportToFile("build/reports/CustomersReport.jasper", params);
    System.err.println("Filling time : " + (System.currentTimeMillis() - start));
  }