Tutorial videos are available here.
Visit our User Forum for discussions and solutions
Present repeating data to the user in a grid format – a bit like a spreadsheet. Command structure: «CaptureInGrid(Party,Yes)» Examples of usage: «ForEach(Party)» Full Name: «FullNames» Type: «ChooseFromList(Type,,Individual,Entity)»«Type» Contact number: «ContactNumber» «End()» «CaptureInGrid(Party,Yes)»
All XpressDox commands regarding repeating data Here is a consolidated list of all XpressDox commands regarding the handling of repeating data. Click on each command for a more detailed article. ForEach() Repeat data
Repeating data elements presents a challenge to the template author, especially in formulating sentences and descriptions where the number of parties or invoice items or other repeating data is unknown at the time of authoring the template. This recipe in the Cookbook demonstrates how XpressDox meets this challenge.
A common issue with repeating data is the requirement to refer to the items within the list by their ordinal values.
The central issue with repeating data is that the number of repeated data elements is not known at the time the template is authored, and so XpressDox offers the ForEach, List and Ordinal commands as a way of processing a variable number of repeated data elements.
The ForEach and If commands are called ‘block commands’ because they are terminated with a separate End command. Between the start and end of the block there are other Merge Fields. There is a special behaviour related to block commands to help with eliminating unwanted empty paragraphs when the start and end appear on different paragraphs.
When users enter repeating data into your XpressDox template, you can manage the number of occurrences of a repeater. “Repeaters” are otherwise called “complex elements” in XML, but are essentially items through which you can
XpressDox templates make use of XSLT functions The last() function inserts the value of the last repeating item in a given ForEach repeater. It is an XSLT function, but can be used in an XpressDox
Ensuring that plurals are correct on your XpressDox templates Generic documents such as contracts often have numerous places where constructs such as “is/are” or “child/children” appear, or else the singular is always used document has
Removes a table row in your XpressDox template if a certain condition is true. When your template contains a table and that table contains rows which should be only included if certain conditions are
The SetMultipleDocumentFilter empowers the template author to designate a filter which will apply when the Document per Repeated Item is used.
Add up repeating numbers using the Sum() function To simply add up all the numbers inside a ForEach, you can use the Sum() function as demonstrated below: «ForEach(Invoice_item)» «position()». «Desc»: «FormatNumber(Amount)» «End()» TOTAL: «FormatNumber(sum(Invoice_item/Amount))»
