Expression Builder Node Troubleshooting Guide

1501

Expression cannot be blank.

This gets invoked when an expression is left blank. 

1502

Invalid operator '%s'.

--WIP--

1503

Invalid operand '%s'.

This gets invoked when an invalid operand is provided. In the example, we can see dateTime requires 7 operands (6 operands and one timezone) while we are giving values to three operands only and the timezone. So it will give us an Invalid operand error.

1504

Operator '%s' : An operand is missing.

This gets invoked when the operand is not present in the expression. In the example, we have a year function but we haven't specified a value (operand) to it.

1505

Operator '%s' : One of its operands is invalid.

This gets invoked when one of the operands is invalid. Like in the example, we are using the max function to compare between a string and a number which is not possible to achieve.

Sample Payload:

{ "expr": "concat(\"\#{ticket.subject}\",\"\#{ticket.subject}\")", "operand_values": { "ticket.subject": "abc" }, "return_type": "text" }

Response Body:

1507

Missing '%s'.

This happens when the expression misses an open parenthesis. Just like in the example.

1508

Operand '%s' : Missing '%s'.

This happens when a closing delimiter is missed. Like in the example, "}" is missing from the second operand.

1509

Operator '%s' : Found more operands than expected.

This gets invoked when there are more operands than required in the expression. For example, in addDays function, only two operands are needed, one is the date and the other is the number of days we want to add to it. Now, any other operand would be considered redundant here because the function itself needs only two operands. In such cases, we will get this error.

1510

Operand '%s' : Invalid data type.

This error gets invoked when there is an invalid data type during the validation of the expression. In this example, we are doing an arithmetic operation i.e., adding two operands. Now, since it is an arithmetic operation, both the operands should be numbers. But here we can see operand1 is of string format. So we are throwing an Invalid data type error.

1511

Operator '%s' : Found an extra '%c'.

This occurs when an extra delimiter is present in the expression. In the given example, we can see there is an extra "," in the expression.

1512

Invalid return type for expression.

This error gets thrown when the return type of the function is different from what's expected. Like in the example, we are using an abs function which gives the absolute value of an integer x or |x| (modulus) given as an argument to it removing any decimal part from it. So ideally here, the returned item should be an integer but we can see in the payload we can expect a boolean return type which isn't possible. In such cases, we will throw such errors.

1513

Invalid text '%s%s' in expression.

--WIP--

--WIP--

1514

Missing '%s'.

This happens when the expression misses a closed parenthesis. Just like in the example.

1515

Operator '%s' : Result of operator is infinitely large.

This happens when we get an infinitely large result from the expression. In this example case, we can see we are doing a multiplication of pow(10,308) to itself. Math.pow(10, 308) returns 1.0000000000000006e308 which is a very huge number. The value we're referring to, 10308, is an extremely large number and is beyond the range of typical floating-point representations used in programming languages. In most programming environments, attempting to calculate 10308 using the pow function or any other standard method will likely result in an overflow or an error due to the limitations of the data types used to represent numbers. So, since we are doing such a huge calculation, we will throw this error.

1516

Missing Operator between operands.

This happens when there is no operator between two operands. In the example, we can see there are two if conditions but they aren't separated with any operator such as &&, ||, etc.

1517

castOperandTypes meta does not support provided '%s' casting information

This error gets invoked when casting is not possible for a given expression. Just like in the example. Casting is only possible with text to number or text to boolean, hence if someone has given any other argument apart from the above ones, it will throw an error message.

Supported values for cast operand types:

• “text”:[“boolean”]

• “text”:[“number”]

• “text”:[“boolean”, “number”]

1601

Operator '%s' : Second operand's value cannot be 0.

This error gets thrown in cases when the second operand's value is not expected to be zero. Like in the example, we are doing a division by zero which will give us an undefined value and not an exact output. Hence, we will throw such an error.

1641

Operator '%s' : Second operand's value must be >= 0.

This error gets thrown in cases when the second operand's value is not expected to be less than zero. For example, there is a string "test". Now, we want a substring out of it. Now, the indexing of characters starts with 0. If we provide it with a value in negative, we won't be able to locate the index as the least index possible is zero. In such cases, we'll throw this error.

1642

Operator '%s' : Third operand's value must be <= first operand's length.

This error gets thrown in cases when the third operand's value is expected to be greater than or equal to the first operand's length. Like in the example, we have a string "test" whose length is 4 and the indexing would be from 0 to 3. Now, we are again trying to fetch a substring out of it. Now if we give an operand a value such as 7, like we have given it to operand3, since 7 is an index that isn't present in our string, we won't be able to pull out a substring out of it.

1643

Operator '%s' : Third operand's value must be > second operand's value.

This error gets thrown in cases when the third operand's value is expected to be greater than the second operand's value. For example, we have a string "test", and the first operator as 2 which would mean we are trying to pull out a substring from the 2nd index from the string that is "s". Now, the third operand is given as 1 which is less than the second operand. Now, we cannot get a substring from a higher index to a lower index which means, we can get a substring from index range 2 to 3 or 2 to 4, but cannot get a substring from 2 to 1 as it isn't possible.

Note that, the third operand i.e., the ending index is exclusive, which means the character at the ending index is not included in the substring. To summarize, when working with substrings and specifying indices, we typically provide the starting index (inclusive) and the ending index (exclusive) to define the range of characters you want to extract.

1661

Operator '%s' : Second operand's value must be >= 0 and < first operand's length.

This error is invoked when the second operand's value is expected to be greater than or equal to zero and less than the first operand's length. Like in the example, we have a string "test" whose indexing is in the range 0 to 3. Now, with charAt function, we are trying to get the 4th index of the string which isn't present. So, we will get this error.

1681

Operator '%s' : Operand's value must be >= -1 and <= 1.

This gets invoked when the operand's value is expected to be within the range of -1 to +1. In the example case, we are using the sine function. Since we know that values of sine range from -1 to +1 if we give a value exclusive from them, it won't honor it. That's when we'll get this error.

1701

Operator '%s' : First operand of the function must be of boolean type.

This error gets invoked when the first operand of the function is expected to be boolean. Like in the example case, we are expecting the first operand to be a boolean value. In such cases, we'll throw this error.

1702

Operator '%s' : Second and third operands value must be of same type.

This error gets invoked when we expect the second operand and third operand to be of the same type. Like in the example, we have given the second operand as a boolean and the third as a decimal which are both different. 

1721

Operator '%s' : %s

This error gets invoked when the date created in Params is invalid. Like in the example, we are trying to create a date of 30th February which is invalid because such date doesn't exist. In such cases, this error will be thrown.

1722

Operator '%s' : Invalid timezone.

This happens when the timezone is invalid. In the example, we are given the date and time details but haven't specified the timezone such as "Australia/Sydney". So in such cases when a timezone isn't specified or the timezone is wrong, such an error will be thrown.

1741

Operator '%s' : Operand value must be >=1 and <=18.

This error gets invoked when the operand value is expected to be within the range 1 to 19 (inclusive). Like in the example, we have a randomNumberOfLength function which takes values from 1 to 18. Now, if we specify the operand value to be 19 which is a number our function doesn't honor, we'll get such an error.