General functions

General functions let you fine-tune your mapping in a . For example, you can select or leave out items in an array or apply conditional criteria to your mapping.

The following functions are available in the General functions tab in .

equal(value; value)

Compares values to see if they are equal.

set (object; path; value)

Sets or adds a value at a specific location in an array or object, leaving the rest of the structure unchanged.

get (object or array; path)

Returns the value path of an object or array. To access nested objects, use dot notation. The first item in an array is index 1.

if (expression; value1; value2)

Returns value 1 if the expression is evaluated to be true. Otherwise, it returns value 2.

ifempty (value1; value2)

Returns value 1 if this value is not empty. Otherwise, it returns value 2.

switch (expression; value1; result1; [value2; result2; ...]; [else])

Evaluates one value (called the expression) against a list of values, and returns the result corresponding to the first matching value.

omit (collection; key1; [key2; ...])

Removes elements with the given keys from a collection. Returns a collection with the remaining elements. Useful when you want to pass a collection to an API, which expects an exact number of elements in the collection. Using this function, you can make sure your collection meets the requirements of the API.

pick (collection; key1; [key2; ...])

Picks elements with the given keys from a collection. Returns a collection that contains only the picked elements. Useful when you want to pass a collection to an API, which expects an exact number of elements in the collection. Using this function, you can make sure your collection meets the requirements of the API.

The following keywords are available in the General functions tab in .

The erase pill inherits the parameter type of the item it replaces and provides correct error handling of the empty value.