Versions Compared

Key

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

Introduction

...

Basic mathematical functions






 

Advanced numerical mathematical functions

(warning) In numerical formulas, line breaks (Enter) are not permitted, as otherwise the calculation is not
performed and we are left with 0 as a result.

Function

Explanation

Examples


MIN/MAX

The function will display the smallest/largest number between two or more fields or numbers

Min(unit_id; 1000)

Max(unit_id; 13.5)

AVG

The function will display the average between two or more fields or numbers

AVG(a1; a2; a3; ...)

ABS

The ABS function returns the absolute value of the given number

ABS(-10)



IF

The “IF” function is a decision-making condition function between numerical fields.
Syntax: IF(a; b; c) -> if a is true, return b, else return c.

The following boolean operations are supported in numeric fields: "<", ">", "==", "!="

0 == 0 -> True

0 != 0 -> False




IF(unit_id > 1000; 10; 9)

Advanced Textual functions

(warning) All text/string in textual fields must be written inside single quotes, i.e., ‘Text’ (not including function names).  

...

(warning) Textual fields are case sensitive. For example, CONTAINS(‘OFFGRID’ ; ‘off’) returns false, but CONTAINS(‘OFFGRID’ ; ‘OFF) returns true.

(warning) To concatenate several And/Or conditions, add parentheses for each condition, as in the following example: IF(('unit_is_stationary' = 'Yes')&&('unit_is_stationary' = 'Yes'); 'OK';'Not OK')

(warning) Single quotes are supported inside a value only by prefixing them with the escape string(\) i.e. a formula
can look like this: 'unit_name' + ' Te\'st' and the result will be unit name Test

...

Function

Explanation

Examples

SWAP

The function will convert a numeric field to a text field

Swap(’real_time_status’ ; ‘0:Down’ ; ’999:Off Grid’)




IF

The “IF” function is a decision-making condition function between textual fields.

Syntax: IF(‘a’ ; ’b’ ; ‘c’) -> if “a” is true then “b” else “c”. We support the following Boolean operations in text fields:

‘a’ = ‘a’ -> True

‘a’ != ‘a’ -> False



IF('unit_name' = ‘arkadi test’ ; ‘true’ ; ‘false’)

CONTAINS

The function CONTAINS('String' ; 'Substring') returns True if 'String' contains 'Substring'. Most of the times will be sued inside an IF function, to check a specific substring in a system field.

CONTAINS('site_layout' ; 'OFFGRID') -> True/ False

IF(CONTAINS('site_layout' ; 'OFFGRID') ; 'off-grid' ; 'on-grid') -> 'off-grid'/ 'on-grid'

NUM

The function can be used to perform numeric calculations in a textual field. Most of the times will be used inside a function, to perform numeric comparisun and return a string. Note that the entire expression inside the NUM function should be inside single quotes. In addition, the entore expression inside the NUM function should follow the syntax of numeric fields, so the following boolean opearions are supported inside the function:

NUM('0 == 0') ->True

NUM('0 != 0') -> False

NUM('DG1FuelConsumed > 0') -> True/ False

IF(NUM('DG1FuelConsumed > 0') ; 'Fuel Consumed' ; 'No Fuel Consumed') -> 'Fuel Consumed'/ 'No Fuel Consumed'

+

Simple concatenation function

'Daniel Danielle Unit' + 'Test' -> 'Daniel Danielle Unit Test'


Calculation Field Creation

...