This article will help you:
- get an overview over all available Nodes
- understand that Nodes are the building blocks of your modules and can either be author-facing only or visible to end-users
- find out how the 4 main Node types (Input, Value, Action, Result) differ from each other
- add Nodes on transitions or below existing Nodes
What is a Node?
Nodes are the basic building blocks of a module. Each Node stands for a step in a process - or a page in the end-user interface, and is linked to other steps through the use of Transitions. Further, Transitions represent the path from one Node to another. Authors can define and shape the logic of a module by adding Conditions to Transitions.
To get to a specific result in a module, an end-user will:
- Respond to the displayed questions (they are represented as Input Nodes)
- Enter data into Input Nodes (It can then be stored by Value Nodes or processed by Action Nodes)
- Move from one Node to another using Transitions
- Arrive at Result Nodes that can contain, e.g., an explanation of a business decision, a document for download, etc.
How can Nodes be used?
Create a Node
Open the BRYTER editor. When you create a new module, the editor automatically displays the first Node to help you get started. To add more Nodes, follow the steps below.
- Click the plus icon “ + ” on a node.
- Select New Node.
- In the attribute editor which opens, Single select is set as the default question type.
- Double-click New Node and give your node a name.
You should now see several empty parameters on the attribute editor. At this point, you can decide if you want to stick with the default single select node type or choose a different type of Node to obtain a different response type from your user. Learn more about populating the fields in the attribute editor from the article about each Node type.
Note that you can also select a Node and use the usual keyboard shortcuts to copy (CTRL-C (on Windows)/ CMD-V (on Mac)) and paste (CTRL-V (on Windows)/ CMD-V (on Mac)) Nodes.
Add Transitions between Nodes
When you create a new Node, a Transition is automatically placed to connect your new Node to your previous Node. Click on the dashed line between two Nodes to customize the Transition based on conditional logic, as shown below.
Finish off your module with Result nodes
Remember to create a Result node at the end of your module. A Result node represents an endpoint. Keep in mind that you can have multiple Result nodes. In our example, we have placed two Result Nodes ('Approved' and 'Prohibited') to account for two outcomes of our KYC Checker.
What if I add a Node by mistake?
Undo and redo
You can use the arrow icons in the bottom left of the canvas to undo and redo your actions.
Delete a Node or a Transition
Click into a Node or a Transition. Then, delete it by clicking on 'DELETE' in the bottom right corner of the attribute editor. Note that you can also simply hit the delete button on your keyboard.
Input Nodes
An Input is a type of Node that lets you pose questions and get responses from your user, as shown above. Each Node represents a 'slide' that users see when they interact with your module, as shown below.
What can Input Nodes do?
In general, you can use Input Nodes to pose a question and obtain a specific piece of information from your user.
There are several types of Inputs, each geared towards obtaining a different type of response. Learn more about each type of input below:
Single select - Ask your user to select one response.
Multiple select - Ask your user to choose one or more options.
Text - Ask your user to submit a string of text or a paragraph.
Email - Ask your user to submit their email.
Number - Ask your user to submit a numerical response.
File upload - Ask your user to upload a document or image.
Date - Ask your user to enter a date from a calendar date picker.
Content only - Display content only without asking for any user input.
Multi-input - Ask your user to submit multiple types of responses.
As each Input represents a 'slide' that users see when they use your module, you can establish connections between different Inputs to create a path for them through your module. For example, you can ask users to select a country of origin. Then, based on their response, you can choose to either terminate the module (if conducting business with their country is prohibited) or obtain more information from your user.