If Tag

use the if tag to conditionally include part of a report when creating document templates you may also use the else tag within the body of the if tag to include a different section of the report when the condition is not met be sure to insert both the start and end tags suppose you want your report to display different things depending upon the data for example, you want the city name to be displayed only if the city is in north america you can use the if tag to do this the if tag is known as a conditional tag, and using the if tag boils down to two actions setting a condition determining what to do if the condition is met in simple terms, the if tag says, "if the condition that i set is met, then perform a particular action " it isn't enough to simply determine whether a condition is met; you must also tell the template what to do if the condition is met refer to your contact list table first, you insert an if tag that says, "see if the customer's city is in north america " then, you tell the report to display the city name if the condition is met if the condition is met in part one, you have to explicitly tell the template what to do next display the city name this may seem like an extra step, but it's a vital one – and it's one that gives the if tag great flexibility and power for example, you could tell the template that if the city is in north america to insert an image of the western hemisphere, to include a statement for residents in certain time zones, or to perform any number of actions the if tag will continue to act (just like the foreach tag continues to act) until it reaches an endif tag here's the table in our template first name last name city \<foreach tag> \<out tag> \<out tag> \<if tag> \<out tag> \<endif tag> \<endforeach tag> there are three tags in the city column the if tag sets the condition the out tag tells the report what to do if the condition is met (example display a piece of data) the endif tag tells the template to stop setting a condition and here's the report first name last name city lisa harris en jay hsu new york tomas ramirez kamala sharma if tag attributes select required (unless test is defined) the node that will be tested for existence an empty node is considered to exist notempty optional (only used with the select attribute) the node must exist and must not be empty in the if tag you can set the notempty property to true or false this property is only used for a sql select that returns null or an xpath select that returns a zero length string for the case of returning a node that exists but is empty notempty = true the if tag will return false because the node must not be empty to return true notempty = false the if tag will return true because the node exists and you are not requiring it be empty test required (unless select is defined) the boolean statement to evaluate valid operators for the test="" attribute are () + / div % mod == eq != ne < > <= le >= ge && and || or ! not valid variables are boolean (the text true or false no quotes) long double string strings must be in quotes you may include " inside a string, but no other escape sequences foreach row test a foreach loop can iterate over several rows of data at once (see the foreach tag for details on this) 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 but the last time 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 to test if a row exists, you use the following construct note that this is a test=, not a select= \<wr\ foreach =" /name" var=”items” step=”3”> \<wr\ if test=”${@items\[1]}”> second row exists \</wr\ if> \</wr\ foreach> the @items\[1] is the context for row \[1] in the foreach loop by definition this if will always be true for each time through the loop except the last time also, all other tags will return nothing if they are for a row that does not exist, so in many cases you do not need to use this if all row access aside from this use in if uses items\[1] while this uses @items\[1] the @ sign tells the system to check existence (a true/false value) instead of access the row’s data