Header and Detail sections
Contents
An XML template has a Header section and a Detail section,
separated graphically by a line across the tree view.
The items in the Header section are generated only once when the
DataWindow is exported to XML, unless the DataWindow is a group
DataWindow. For group DataWindow objects, you can choose to generate
the contents of the header section iteratively for each group. For
more information, see Generating group
headers.
The Detail section contains the row data, and is generated
iteratively for each row in the DataWindow object.
The Detail Start
element
A line across the Export/Import Template view separates the
Header section from the Detail section. The first element after this
line, d_dept_list_row in the previous screenshot, is called the Detail
Start element.
There can be only one Detail Start element, and it must be
inside the document’s root element. By default, the first child of the
root element is the Detail Start element. It usually wraps a whole
row, separating columns across rows. When the DataWindow is exported
to XML, this element and all children and/or siblings after it are
generated iteratively for each row. Any elements in the root element
above the separator line are generated only once, unless the
DataWindow is a group DataWindow and the Iterate Group Headers check
box has been selected.
The Detail Start element can be a nested (or multiply-nested)
child of an element from the Header section, permitting a nested
detail. This might be useful for DataStores being packaged for
submission to external processes, such as B2B, that require company
and/or document information, date, or other master data preceding the
detail.
Moving the separator
You can change the location of the separator line by selecting
the element that you want as the Detail Start element and selecting
Starts Detail from its pop-up menu. The separator line is redrawn
above the new Detail Start element. When you export the data, the
Detail Start element and the children and siblings after it are
generated iteratively for each row.
If no Detail Start element is specified (that is, if the Starts
Detail option has been deselected), the template has only a Header
section. When you export the data, only one iteration of row data is
generated.