Lodash Helper 1.0
Use the Lodash helper javascript library
OverviewCopy
With the Lodash connector it is possible to make use of the Lodash javascript library.
Note that use is limited to operations that don’t have a function as an argument, so the simple operations which accept arrays, objects, strings etc. as arguments can be used.
Examples of Lodash operations which can be used:
When utilizing Lodash operations in the Tray connector, exclude the underscore and the dot (_.) prefix when invoking these operations. Instead, use the operation name directly.
Example: Instead of: _.chunk, use chunk.
Operations | Description |
|---|---|
provides the length of an array or the count of own enumerable properties for objects. (see Example 1 below) | |
Splits a string into an array of substrings based on a specified delimiter. | |
Transforms each element in a collection using a specified function, returning a new array of the results. (e.g. give me the name of every item from a list of results) (see Example 2 below) | |
Returns a new array with unique elements, determined by a specific property, from the input collection. | |
Divides an array into smaller arrays of a specified size, creating a nested array structure. | |
Returns the difference between two arrays, using a custom comparator for element comparison. | |
Flattens a nested array to a single-level deep array. | |
Joins elements of an array into a string using a specified separator. | |
Creates an array of unique values by combining multiple arrays. | |
Transposes the elements of an array, effectively reversing the effect of | |
Combines multiple arrays into a single array of grouped elements. | |
Returns the current timestamp in milliseconds. | |
Recursively merges the properties of two or more objects. | |
Retrieves an array of object keys. | |
Converts a string to kebab case, separating words with hyphens. | |
Checks if an input variable is an array. Returns true or false |
Refer to the Lodash documentation for a complete list of Lodash operations.
We will continue to add more examples of uses here!
Example 1 - using the _.size operationCopy
The below example shows how you can use the Lodash _.size operation to get a total count on items output from another step.
In this case, we are counting the results returned from the Stripe List Customers operation:
From the debug output of a successful run you can see that the connector will return a simple count as a result:
This result can then be used in any downstream steps in your workflow.
Example 2 - using the _.map operationCopy
The below example shows how you can use the Lodash _.map operation to group all the values together for a particular parameter.
The below example imagines that we have just used the List Helpers connector to combine two project task lists from Asana (as per the List Helpers example tutorial).
Now we want to use the Lodash _.map operation to obtain the name of each task:
From the step editor on the right you can see that we just have to specify the $.steps.list-helpers-1.result and name as the parameter.
The debug output of a successful run will show you the result:
You will see that the result is to list the names of each task that is found in the combined list.
Example 3 - using the _.isArray operationCopy
This lodash operation can be used to check if an item of data is an array.
All you need to do is add a Lodash helper step and:
1. Set the 'Operation Name' to 'isArray'
2. Use the jsonpath output from a previous workflow step as a single 'Parameter' input to check if it is an array:
In this case the dummy array of customers pulled in from the previous step has resulted in a 'true' result.
Note: to initiate a true / false path based on this result you will still need to use the boolean connector to check whether the output was true or false!