Item Range Filter

Definition

Description

If event matches Condition set FieldName to the item range from Number to Number in FieldName where items are separated by Delimiter.

 

 

Comments

If either FieldName or the Delimiter are missing, blank or invalid, do nothing.

The Delimiter is a single character.

Each newline ('\n') character is replaced with a single space before the input string is processed.

Item indexing starts from one, and if either Number is less than zero, that index counts backwards from the last item.

If the starting index is greater than the ending index the result is an empty string ("").

For the first number index, a value of zero is the same as a value of one.

For the second number index, a value of zero is the same as the last item.

Example 1 (simple indices):
First FieldName = "ev:setField"
Second FieldName = "ev:msg"
First, Second Number = 1,3
Delimiter = ":"
ev:msg = "the:whole: message:for: example: 1"
ev:setField = "the:whole: message"

Example 2 (negative indices):
First, Second Number = -3,-2

 

Example

<filter objectId="ItemRange.one" type="ItemRangeFilter">
	<parameter type="Condition">
		<negatePrimaryCondition>false</negatePrimaryCondition>
		<conditionRelation>Any</conditionRelation>
	</parameter>
	<parameter type="FieldName">ev:msg</parameter>
	<parameter type="Number">2</parameter>
	<parameter type="Number">-3</parameter>
	<parameter type="FieldName">ev:uniqueId</parameter>
	<parameter type="Delimiter">|</parameter>
</filter>