Defines an IF conditional step looking for matches on a source.

The IfIsIn step is one of Convertigo Sequencer conditional steps. This step is based on a source and one or more regular expression(s) called “Tests”. Child steps are executed only if the specified source exists and if tests match on that specified source.
Note: In Convertigo Studio, when an IfIsIn step is created in a sequence, it can be easily replaced by an IfIsInThenElse, using the right-click menu on the step and choosing the option Change to > IfIsInThenElse. The Source and Tests properties remain the same and the steps present in the IfIsIn are moved to the Then sub-step.

Property Type Category Description
Comment String standard Describes the object comment to include in the documentation report.
This property generally contains an explanation about the object.
Is active boolean standard Defines whether the step is active.
Output boolean expert Defines whether the XML generated by this step should be appended to the resulting XML.
Set this property to true to add the step’s resulting XML to the sequence’s output XML (default value for steps generating XML). Set this property to false to prevent the steps’s XML result to appear in the sequence’s output XML.
Setting this property to false does not prevent the step’s generated XML from being used as a source by other steps.
Source XMLVector expert Defines the source to work on.
This property allows defining a list of nodes from a previous step on which current step performs tests.
A source is defined as a reference on a step previously existing in the parent sequence, associated with an XPath applied on the step’s result DOM. At runtime, the XPath is applied on the step’s current execution result XML and extracts a list of XML nodes resulting from this execution.
If the XPath doesn’t match or if the source is left blank, the step has no data to work on: the test fails.
Tests XMLVector expert Defines match tests as regular expressions.
This property allows to define a list of tests that are applied on the source result.
For each test, two elements have to be set:

• Operator: value to choose between AND and NOT, the operator value is applied on the regular expression result to keep it (AND) or to inverse it (NOT).
• Regular exp: defines a regular expression to apply (inverted or not thanks to operator value) on the source result.

Notes:

• A new test can be added to the list using the blue keyboard icon. The tests defined in the list can be ordered using the arrow up and arrow down buttons, or deleted using the red cross icon.
• In order to be able to test the regular expressions on the source result, the defined source has to select a text node.
• For more information about regular expression patterns, see the following page: http://www.regular-expressions.info/reference.html.
• To test regular expressions, you can use the regular expression tester at the following URL: http://www.regular-expressions.info/javascriptexample.html.