Actions
Actions are nodes that add business logic and functionalities to your app. With actions, you can:
call external or internal services (with the HTTP Request action);
assign values to variables (with Set Variable and Get Variable);
create conditionals or cycles (with Branch);
perform mathematical operations (with Functions);
define error codes to track them on the transaction log (with Fail or Set Response Code).
There are different actions available in Studio. See below to learn how to use them.
Important
Before assigning values for each action, read Input and Output Parameters to learn how to transfer data in a transaction.
General
Compares two values (a & b) and returns true or false as a response depending on whether the condition is met or not. The value type can be: number, string, boolean or date. Conditions are equal or not equal, and if the values are numbers, there are two additional conditions, less than and greater than.
The Branch action is used when you need to create two paths. For example, you can use this action during the login verification and, instead, have a branch action that, if the user verification fails, logs the error in the transaction log.
To create a path for the "true" and "false" conditions, click the true or false tags below the Branch action, and drag them to their respective action nodes to connect with them.
After the true and false flows are executed, the transaction flow continues from the main flow, such as the End node in the example above.
Goes through an array to capture, use or edit its information and implements a custom logic path for each iteration.
For example, you have to implement a new bank benefit that only applies to those clients that are 65 years old or older. With the Iterator action, you can go through an array of accounts and, for each array row, run the while custom path, that is in charge of verifying if the user is 65 years old or less.
Once the array is verified, the transaction flow continues from the main flow, such as the Gets Benefits Get Variable action in the example above.
Defines a fixed value that can be used in the transaction flow by invoking it with other actions. The value can be a number, string, a boolean value or a date.
In the Iterator example, the number 64 is set as a constant and is then retrieved as input by the Branch action to compare this value with the user's age. This way, if the user is more than 64 years old, the true path assigns a promotion or benefit to the user, and if they are 64 of below, it doesn't.
Sets a response code and a message to a transaction when it fails and saves the value on the transaction log. This action can also finish the transaction's execution.
As opposed to the Set Response Code action, Fail can only be used at the end of a transaction.
Error code and message values are usually set by creating Constant actions, and by retrieving this information as Inputs. See below for an example of a Fail action node that is retrieving its inputs from two Constant actions.
Note
The response code and message set will appear on the transaction log when the transaction fails.
Advanced
It is used to build functions that are not yet available as actions, or to build complex logic in a compact way, such as decrypting users' information, or logging errors into the transaction log. It can also be used to interpret a service's response retrieved with an HTTP Request action.
When selecting the Script action node, the Script Editor opens, where you can directly paste and edit your script. See Create a Configurable Transaction to read about a scenario using the Script action.
Allows to invoke a service. This action complements the Script action's functionality, since you can create a request to the service with the Script action and then implement the HTTP Request to consume the service.
For example, you can invoke BRM's internal service and call any of its APIs. With a Script action, you set the endpoint with the url, method, headers and a body with all the parameters you are sending to the service. Then, with the Http Request action, you execute the service call that will return a .json with the results. You always need a Script action or a lambda process to interpret the Http Request's response.
