Double Braces functions
Learn about Double Braces, an expression language developed by Digibee that users can take advantage of in order to reference and manipulate data within a pipeline
Was this helpful?
Learn about Double Braces, an expression language developed by Digibee that users can take advantage of in order to reference and manipulate data within a pipeline
Was this helpful?
Was this helpful?
You can use Double Braces functions to manipulate data in a pipeline.
Double Braces functions are enclosed within two sets of curly braces and a blank space, with the function name followed by a list of parameters enclosed in parentheses, like this:
{{ FUNCTIONNAME(param1, param2) }}Double Braces functions are case-insensitive, but we recommend writing them in upper case as a best practice.
You can use Double Braces function calls inside other functions, like this:
{{ OUTSIDEFUNCTION(INSIDEFUNCTION(param1,param2), param3) }}When you do this, the functions are executed from the inside to the outside. That is, in the example above, INSIDEFUNCTION is executed first and its output is used as a parameter for OUTSIDEFUNCTION, which is executed last.
Unlike programming languages, Double Braces expressions executes all functions at the same moment, regardless of whether the IF condition is true or false. This differs from programming languages, which usually execute functions only after checking the IF condition.
Input
{
"date": "2022-10-26T03:00:00Z"
}Double Braces expression
{
"format": {{ IF(EQUALTO(SIZE(message.date),20),FORMATDATE( message.date, "yyyy-MM-dd'T'HH:mm:ss'Z'", "dd/MM/yyyy"),FORMATDATE( message.date, "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'", "dd/MM/yyyy")) }}
}Output
{
"success": false,
"message": "Encountered a configuration error while generating JSON",
"error": "com.digibee.pipelineengine.exception.PipelineEngineConfigurationException: com.digibee.doublebraces.service.DoubleBracesConfigurationException: Syntax error parsing double braces expression {{ IF(EQUALTO(SIZE(message.date),20),FORMATDATE( message.date, \"yyyy-MM-dd'T'HH:mm:ss'Z'\", \"dd/MM/yyyy\"),FORMATDATE( message.date, \"yyyy-MM-dd'T'HH:mm:ss.SSS'Z'\", \"dd/MM/yyyy\")) }}: Could not parse date/time evaluating function FORMATDATE. Error: Text '2022-10-26T03:00:00Z' could not be parsed at index 19"
}Below, we have listed Double Braces functions by groups based on their usage.
Used to compare booleans inputs. To learn more, read the article Comparison Functions:
AND
NOT
OR
XOR
Used to manipulate numeric values. To learn more, read the article Numerical Functions:
FORMATNUMBER
TODOUBLE
TOINT
TOLONG
TONUMBER
RANDOMNUMBERS
The functions in this group return a value according to a specified criteria. To learn more, read the article Conditional Functions:
EQUALTO
GREATERTHAN
GREATERTHANEQUAL
IF
LESSTHAN
LESSTHANEQUAL
ISOBJECT
ISARRAY
ISBOOLEAN
ISSTRING
ISNUMBER
ISNULL
SWITCHCASE
Used to manipulate dates. To learn more, read the article Date Functions:
FORMATDATE
NOW
SUMDATE
TOISODATE
DIFFDATE
Used to query metadata and validate files. To learn more, read the article Comparison Functions:
FILEEXISTS
FILESIZE
Used to manipulate JSON objects. To learn more, read the article JSON Functions:
JSONPATH
TOJSON
UNESCAPEJSON
GETELEMENTAT
LASTELEMENT
REMOVEAT
NEWEMPTYOBJECT
NEWEMPTYARRAY
PUSH
POP
CARDINALITYONE
CARDINALITYMANY
Used to make mathematical operations. To learn more, read the article Math Functions:
ABS
CEIL
DIVIDE
LOG
MAX
MIN
MOD
MULTIPLY
POW
ROUND
SQRT
SUBTRACT
SUM
Used to manipulate strings. To learn more, read the article String Functions:
CAPITALIZE
CONCAT
ESCAPE
INDEXOF
JOIN
LASTINDEXOF
LEFTPAD
LOWERCASE
MATCHES
NORMALIZE
REPLACE
RIGHTPAD
SPLIT
SUBSTRING
TOSTRING
UPPERCASE
CONTAINS
DEFAULT
UNESCAPE
TRIM
STRINGMATCHES
RANDOMSTRINGS
Used to make operations that do not fit the other categories. To learn more, read the article Utilities Functions:
BASEDECODE
BASEENCODE
UUID
TOBOOLEAN
SIZE
BASEURLDECODE
BASEURLENCODE
URIDECODE
URIENCOD