Configurable Transactions
Important
This section provides information about configurable transactions. To learn about native transactions and how to create them, refer to Create a Native Transaction.
Configurable transactions are logic flows created in Studio composed by a series of steps or nodes. Within each node, you can execute one or more actions, such as:
validating and manipulating data, like converting a .json to .xml, addition and subtraction operations, unifying names, etc;
invoking external and internal services;
defining error codes; and
accessing and modifying databases.
Configurable transactions are built within the Transactions Editor, a low-code tool that consists of a canvas and building elements in its left panel, such as action nodes, services, reusable actions, and more.
To build a transaction, you add action nodes to a canvas and connect them through input and output parameters to transfer data between them. Every transaction consists of a Start node, which receives the initial information, and an End node that marks the end of the flow. Both the Start and the End nodes are added by default to the canvas.
Transaction's execution, or logic flow, is represented in the canvas by a straight line that connects nodes. The logic flow reflects the order in which steps are executed in a transaction, one after the other. This is the flow visible by default. Data transfer from one node to another, or the data flow, is represented by a dashed line that connects a node's outputs to another node's inputs. Click a node in the canvas to display the data flow and see the data that enters and exits the selected node.
Note
The data flow may not be identical to the logic flow, since there are cases in which you might need to retrieve data from an action node (such as a Set Variable action) that does not need to be included in the transaction's logic flow.
Logic Flow | Data Flow |
|---|---|
 |  |
Every transaction is different. The actions and elements used in a transaction and their order vary depending on the functionality you want to build and on the client's requirements. For example, a login transaction is built differently from a transaction that retrieves a list of credit cards. To learn how to use a transaction based on a typical login scenario, read Create a Configurable Transaction.
Navigate the Transactions Editor
When accessing the transactions editor, you see its two main sections, the left panel and the top menu, and the canvas, with the Start and End nodes already created.
The top menu contains actions to save your transaction and run it, and zooming options to navigate the canvas. Click Save & continue at the left corner of the top menu to save changes without closing the editor. Click the down arrow to display more options in a drop-down menu:
Save & close | Click to save all changes and close the transaction. Always save your transaction before publishing it. |
Quick publish | Click to publish the transaction. If there is an error within the transaction, Studio shows a warning message and prevents you from publishing it. Refer to Errors to learn more about error management. |
Close without saving | Click to close the editor without saving updates. |
Save as libraries | Click to save the current transaction as an action library so that it can be reused. |
Next to the saving options, there is another set of actions to perform on the nodes in the canvas. Click Duplicate to create a replica of a selected node in the canvas (except for the Start and End nodes), or click Copy and Paste to copy a selected node and paste it into a different transaction (except for the Start and End nodes). You can also select any node added to the canvas and then click the trashcan icon to delete it from the transaction. Next to this set of options, the Run transaction icon allows you to publish and test the transaction's functionality.
At the right corner of the top menu, click - or + to decrease or increase the zoom level on the canvas respectively. The Fit to workflow option adjusts the zoom level so that the whole flow, from start to end, fits on the screen.
The left panel contains different elements that allow you to build your transaction and add the required business logic. These elements are: Actions, Action Libraries, Services, Variables and Procedures.