Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
minLevel3
outlinetrue
stylenone

 


Description

The if statement selects a statement for execution based on the value of a boolean expression.

...

Syntax Notes

Reserved keywords

Tag
if
then
else
condition=
  • The boolean expression is evaluated for determining the path to take for execution.
  • If the boolean expression yields true, control is transferred to the first embedded statement. When and if control reaches the end point of that statement, control is transferred to the end point of the if statement.
  • If the boolean expression yields false and if an else part if present, control is transferred to the second embedded statement. When and if control reaches the end point of that statement, control is transferred to the end point of the if statement.
  • If the boolean expression yields false and if an else part if not present, control is transferred to the end point of the if statement.
  • if statements can be nested.

...

Code Block
languagexml
themeEclipse
titleBoolean value stored in some user defined tags
<if condition="[:RuntimeParams.EnforceKey:]"> 
<then>
  <Log Message="I am in true block!"/>
</then>
<else>
  <Log Message="I am in false block!"/>
</else>
  </if>
</Query>

 

...

Using XPath Boolean Expressions

There are two ways in which XPath Expressions can be used as part of boolean expression.

a) XPath as part of individual operand of the expression. For example: $ContextData/projectkey below.

Code Block
languagexml
themeEclipse
titleBoolean Expression for string comparison.
<if condition="$ContextData/projectKey eq '[:RuntimeParams.ProjectSettings_ProjectKey:]'">
  <then>
  <Log Message="I am in true block!"/>
</then>
<else>
  <Log Message="I am in false block!"/>
</else>
</if>

b) Whole boolean expression itself can be XPath expression. This is done using by starting the expression with "/"

Code Block
languagexml
themeEclipse
titleEntire Boolean Expression as XPath
<if condition="/'[:$Macro.Argument.StopWid:]' != '' and '[:$Macro.Argument.StopTarget:]' != ''">
  <then>
  <Log Message="I am in true block!"/>
</then>
<else>
  <Log Message="I am in false block!"/>
</else>
</if>

Using Multiple operands

Take a special note in second expression the >= within boolean expression must be escaped. For example: >= is written as &gt;=

Code Block
languagexml
themeEclipse
titleMultiple Operands
<if condition="[:$Macro.Argument.RouteLoc:]/not(boolean(Site)) and '[:$Macro.Argument.SelfWid:]' != '' and '[:$Macro.Argument.StopTarget:]' != ''">
    <then>
  <Log Message="I am in true block!"/>
</then>
<else>
  <Log Message="I am in false block!"/>
</else>
</if>
 
<if condition="/'[:$Macro.Argument.SiteCur:]' = '[:CONFIG.CompanyId:]' or
                       [:$ProcessData.$BTV.Worker.SlackCounter:] &gt;= [:CONFIG.RULES.MaxWorkerSlack:] or
                       [:$LocalData.Rand:] &gt; [:$ProcessData.$BTV.Worker.SlackTendency:]">
 <then>
   <Log Message="I am in true block!"/>
 </then>
 <else>
   <Log Message="I am in false block!"/>
 </else>
</if>

Nested If Statements

Note that if you do not have else, usage of <then> is optional.

Code Block
languagexml
themeEclipse
titleMultiple Operands
<if condition="/'[:$Macro.Argument.StopWid:]' != '' and '[:$Macro.Argument.StopTarget:]' != ''">
        <Log Message="I am in true block!"/>
        <if condition="/'[:$Macro.Argument.SiteCur:]' = '[:CONFIG.CompanyId:]' or
                       [:$ProcessData.$BTV.Worker.SlackCounter:] &gt;= [:CONFIG.RULES.MaxWorkerSlack:] or
                       [:$LocalData.Rand:] &gt; [:$ProcessData.$BTV.Worker.SlackTendency:]">
        <Log Message="I am in true, true block!"/>
        </if>
</if>

Examples of "if" Statements

Various examples of "if" statements

Code Block
languagexml
themeEmacs
titleExamples of IF Statements
<!-- Combining number comparsion with non number comparison -->
<!-- Note here: count is a XPath function. This menthod essentially find number of Result Elements  -->
<!-- Note that CPUUtilization and MemoryUtilitzation must return boolean -->
<If condition="[:/boolean('[:$LocalData.MonitorData.Find/count(Result) ne 0:]'  
                and ('[:$ProcessData.CPUUtilization:]' 
                lt '[:$ProcessData.MemoryUtilization:]')):]">
	<Then>
	</Then>
</If>


Comparing Numbers from Context Data; 

Code Block
languagexml
themeEmacs
titleExamples of IF Statements
<Query>
  <SetContextData Key="AMB" Value="90"/>
  <If Condition="[:/[:$ContextData.AMB:] lt 100:]">
     <Then>
        <SetResponseData>
           <Key>Message.Value.AMBResult</Key>
           <Value>Less than 100</Value>
        </SetResponseData> 
     </Then>
     <Else>
        <SetResponseData>
           <Key>Message.Value.AMBResult</Key>
           <Value>Greater than 100</Value>
        </SetResponseData> 
     </Else>
  </If>
</Query>