Working with workflows

Learn how to create event-triggered and reusable workflows with parameters and sequential action nodes to implement interaction logic in your Nordcraft app.

You can create a workflown on any event in Nordcraft. This can be a standard JavaScript event on an element, a custom event on a component or lifecycle events like On load or On attribute change.

Create a workflow

Live

To create a workflow on an event:

1. 1

   Select the event; this can be any event in Nordcraft
2. 2

   Add nodes to create your logic

If you have logic in your component that you need multiple times or if the logic tree is complex, you can create a reusable workflow from the data panel.

Create reusable workflow

Live

To create a reusable workflow:

1. 1

   With no element selected so that you can see the data panel, click the + button in the workflows section
2. 2

   Select a name for the workflow and add optional parameters
3. 3

   Add nodes to create your workflow logic

When a workflow is triggered by an event, you have access to the event's data within the formulas of the workflow, enabling you to react to the data of the event.

Use event data

In reusable workflows, you can define parameters. These are the inputs of the workflow and you can use them in any formula in the workflow. By defining parameters, you can create workflows that can cover multiple scenarios.

Create parameters

To create a parameter:

1. 1

   Click the + button
2. 2

   Choose a name for the parameter
3. 3

   Assign an optional test value; this value is only available in the editor and will not affect your application in production

A node is an action or a piece of logic that is executed sequentially. Nodes are the visual language in Nordcraft that you use to compose the desired logic. There are several built-in nodes like Set variable, Set session cookies or Switch. You can also call custom actions or reusable workflows. This way you can create nested workflows and individual pieces of logic that are composable.

Create nodes

To add a node:

1. 1

   Click on a + icon in the workflow
2. 2

   Pick a node from the list and click on it

Workflows execute their nodes sequentially. However, this does not necessarily mean each step waits for the previous one to finish completely, which is what synchronous execution would require.

Workflows execute nodes in the order they appear (sequential), but some nodes (like API calls) work asynchronously. This means:

• Nodes are always called in sequence (one after another)
• However, asynchronous nodes may not complete before the next node starts executing
• For asynchronous operations, you need to use callback events to handle their results

This is why some nodes have specific callback events like On success, On error, or tick. These callbacks allow you to define what happens after an asynchronous operation completes.