Utilities functions
Learn about utilities functions in the Digibee Integration Platform and how to use them.
The utilities functions make diverse operations, which don't fit any of the other categories, and are available for components that support Double Braces expressions. To know how to provide information to the components using this resource, refer to Double Braces Functions.
BASEDECODE
This function in Double Braces decodes a string in a base64 format.
Syntax
BASEDECODE(value:string, [charset:string - optional])
value: string to be decoded
charset: charset for the decodification (standard = UTF-8) (optional)
Let's say you need to decode a string. You can do the following:
{
"test": {{ BASEDECODE("eHB0bw==", "UTF-8") }}
}The expected result will be:
{
"test": "xpto"
}BASEENCODE
This function in Double Braces codes a string in a base64 format.
Syntax
BASEENCODE(value:string, [charset:string - optional])
value: string to be coded
charset: charset for the codification (standard = UTF-8) (optional)
Let's say you need to code a string. You can do the following:
{
"test": {{ BASEENCODE("xpto", "UTF-8") }}
}The expected result will be:
{
"test": "eHB0bw=="
}BASEURLDECODE
This function in Double Braces decodes a string in a Base64 format in the standard usage for URL.
Syntax
BASEDECODE(value:string, [charset:string - optional])
value: string to be decoded
charset: charset for decoding (default = UTF-8) (optional)
Let’s say you need to decode a string. You can do the following:
{
"test": {{ BASEURLDECODE("eHB0bw", "UTF-8") }}
}
The result will be:
{
"test": "xpto"
}
BASEURLENCODE
This function in Double Braces encodes a string in a Base64 format for use in URL’s.
Syntax
BASEENCODE(value:string, [charset:string - optional])
value: string to be encoded
charset: charset for encoding (default = UTF-8) (optional)
Let's say you need to encode a string. You can do the following:
{
"test": {{ BASEURLENCODE("xpto", "UTF-8") }}
}
The result will be:
{
"test": "eHB0bw"
}
UUID
This function in Double Braces generates a unique universal identifier - the number of 128 bits is used to identify information in systems.
Syntax
UUID()
Let's say you need to generate a unique identifier. You can do the following:
{
"test": {{ UUID() }}
}The expected result will be:
{
"test": "4caad555-09b5-479c-98b4-ac72ffbb486c"
}TOBOOLEAN
By using Double Braces, you can combine the function with the access to the input JSON element of a component.
The function allows you to convert a string value to boolean.
Syntax
TOBOOLEAN(value)
Let's say you need to convert the values below to boolean:
{
"string": "false",
"stringUpperCase": "TRUE",
"boolean": true,
"integer": 1,
"nullValue": null,
"object": {
"string": "abc"
}
}Converting the values:
{
"string": {{ TOBOOLEAN(message.string) }},
"stringUpperCase": {{ TOBOOLEAN(message.stringUpperCase) }},
"boolean": {{ TOBOOLEAN(message.boolean) }},
"integer": {{ TOBOOLEAN(message.integer) }},
"nullValue": {{ TOBOOLEAN(message.nullValue) }},
"object": {{ TOBOOLEAN(message.object) }}
}The result will be:
{
"string": false,
"stringUpperCase": true,
"boolean": true,
"integer": false,
"nullValue": false,
"object": false
}If the function is applied in strings with different values of "true", "false", "TRUE" and "FALSE", numerical fields, null fields, objects and arrays, the function will always return the result false.
SIZE
This function in Double Braces allows the size of strings, arrays and objects to be obtained.
Syntax
SIZE(value, [throwErrorOnUnexpectedType:boolean - optional])
value: value to be checked the size
throwErrorOnUnexpectedType: indicates whether an exception will be returned when the value parameter isn’t expected by the function. If not informed, a true value will be assumed and, when a false value is informed, the function's return will be null.
Let's say you need to get the size of a text from a comments property contained in your payload. You can use the following snippet in the JSON Generator component:
{
"commentsSize": {{ SIZE(message.comments) }}
}The result will be a numeric value corresponding to the number of characters contained in the text:
{
"commentsSize": 1000
}Now imagine there’s a JSON object in the following structure:
{
"body":{
"field1": "test",
"field2": {
"field2.1": "testing"
}
}
}The size of this object must be checked. If using JSON Generator again, the following snippet must be configured:
{
"bodySize": {{ SIZE(message.body) }}
}The result will be the amount of properties contained in the body object:
{
"bodySize": 2
}In this case, the function only considers properties that directly belong to the body object and doesn’t consider nested properties.
You can also check the size of an array:
{
"array": [
10,20,30
]
}Considering the array above, use JSON Generator one more time to configure the following snippet:
{
"arraySize": {{ SIZE(message.array) }}
}When executing the function, the result will represent the number of elements contained in the array:
{
"arraySize": 3
}The SIZE function expects string, array and object value types. When the value doesn’t match this requirement, an exception will be thrown. However, it’s also possible to configure the function not to throw an exception and simply return null. If that’s the case, just configure the second parameter of the function with the value false.
Consider the following payload:
{
"elements": 13
}And the following JSON Generator configuration:
{
"elementsSize": {{ SIZE(message.elements, false) }}
}The result of the function execution will be:
{
"elementsSize": null
}That way, no exception will be thrown and some verification logic can be adopted in your integration flow.
URIDECODE
This function allows you to decode a URI (string).
Syntax
URIDECODE( value:string, [charset:string - optional ] )
uri: string to be decoded
charset: charset for the decodification ( standard = UTF-8 ) ( opcional )
Let’s say you need to decode a URI. You can do the following:
{
"test": {{ URIDECODE("http%3A%2F%2Flocalhost%3A8080", "UTF-8") }}
}The result will be:
{
"test": "http://localhost:8080"
}URIENCODE
This function allows you to encode a URI (string).
Syntax
URIENCODE( value:string, [charset:string - optional ] )
uri: string to be encoded
charset: charset for the codification ( standard = UTF-8 ) ( opcional )
Let’s say that you need to encode a URI. You can do the following:
{
"test": {{ URIENCODE("http://localhost:8080", "UTF-8") }}
}
The result will be:
{
"test": "http%3A%2F%2Flocalhost%3A8080"
}Was this helpful?