ForEach Tag

use the foreach tag to automatically add a row to your report for each data item in a node (table) an example would be to add a row in an invoice for each product ordered a sample template, sample1, uses the foreach tag to generate rows in an invoice by looping through a data table refer to the samples section for a detailed explanation of this sample document template be sure to insert both the start and end tags! the generic format of a body tag which requires start and end tags is shown in report tags overview data tables are the most organized and easiest way to display data using the tag builder allows us to easily create these tables when an out tag # sends a command to a data source, the out tag is telling the data source to grab one piece of information from one of the data groups if you want the template to display all the data rather than just the first set, you can use a foreach tag the foreach tag tells the template to go to a data group and retrieve each data item in the group what's key in understanding how a foreach tag works is remembering that the foreach tag isn't a straight command that displays data, like the out tag instead, the foreach tag tells the template how to handle other tags in the template the foreach tag tells the template that when the report is run, it should look at the next tag after the foreach tag, retrieve the first piece of data for that data group, retrieve the second piece of data for that data group, retrieve the third piece of data for that data group, and continue doing so until it has retrieved each piece of data for that group this is often referred to as a foreach loop, since the template is looping through the data in a group in the example below, there's a foreach tag before the first out tag contacts first name last name city \<foreach tag> \<out tag> \<out tag> \<out tag> when you run the report, the table might look like this contacts first name last name city lisa harris roma en jay hsu new york tomas ramirez sydney kamala sharma delhi when running the report, the template then goes to the next tag and does the same thing retrieves each piece of data for that tag's data group it continues to do so until it knows it's time to stop looping the template knows when to stop looping and instead treat an out tag as a regular out tag because of the endforeach tag the endforeach tag says, "okay, stop looping through the data groups of any tag that comes after me " in other words, the foreach and endforeach tags act like bookends that say "for every tag between us, retrieve all the data in their data groups, not just one piece of data " tags are processed in the same order the english language is read (from left to right and from top to bottom) things to remember if you have a foreach tag, you must have a corresponding endforeach tag you can have multiple foreach loops in templates if you do not want a blank row as the last row make sure your endforeach tag is place outside the last row of the table out tags aren't the only tags that can be found inside a foreach loop they are the most basic and the easiest to understand, however, and that's why we use them to illustrate how foreach loops work foreach row access a foreach loop can iterate over several rows of data at once inside the loop row \[0] always exists but the additional rows may not exist in the last iteration of the loop for example, if the foreach is iterating over 7 rows of data and has step=’3’ then the first two times through the loop all 3 rows exist during the last time through the loop, only the first row exists rows access is 0 based so the first row is \[0] and the second row is \[1] the number inside the \[] is the offset from the start and the first row is the start of the rows you can use \[0] but it is redundant you can use the var= attribute in the foreach tag (ex \<wr\ foreach select=”/root” var=”items”>) to access any given row using the form items\[1] where this is the context for row \[1] in the foreach loop in the case of an sql query, you must use the form items\[1] colummname to access a column in a row items\[1] is column 1 in row \[0] use the foreach tag to iterate through a set of data items in a node (table), for example to automatically add a row to your report for each data item the sample template chapter shows an example that uses the foreach tag to add a row in an invoice for each product ordered be sure to insert both the start and end tags attributes select – required the data items (fields) to walk through, one per iteration var – optional identifies the node being stepped through can be used in other tags using ${name} each implementation may also contain ${name item} where item is a way of describing data returned by this node varstatus – optional returns index, first, last, count for the loop iteration can be used in other tags, including \<wr\ out value=…>, using ${name } as follows ${name index} the index in the collection of the item returned this is 0 based and identifies the underlying element regardless of begin and step for example, if begin="3" then the first value of index will be 3 ${name count} the number of elements returned so far this is 1 based and only counts elements actually returned (unlike index which includes all elements including those not returned ) ${name first} returns true() if on the first element to be returned otherwise returns false() ${name last} returns true() if on the last element to be returned otherwise returns false() begin – optional element to start with 0 based (default 0) the valid range is 0 4,294,967,295 the first element in the node is the 0th, the next is the 1st (and so on), such that 4 items would be numbered 0, 1, 2, and 3 select begin and enter the data item to start with the valid range is 0 4,294,967,295 step – optional process every step element (default 1) the valid range is 0 4,294,967,295 for example, to skip every other item, step by 2 the valid range is 1 4,294,967,295 end – optional element to end with (processes this element) set this attribute to the data item to end with this is the last element processed the default is the number of elements in the node the valid range is 0 4,294,967,295