Item linking for node creators#

Use SMS-iT Workflow's item linking to access data from items that precede the current item. SMS-iT Workflow needs to know which input item a given output item comes from. If this information is missing, expressions in other nodes may break. As a node developer, you must ensure any items returned by your node support this.

This applies to programmatic nodes (including trigger nodes). You don't need to consider item linking when building a declarative-style node. Refer to Choose your node building approach for more information on node styles.

Start by reading Item linking concepts, which provides a conceptual overview of item linking, and details of the scenarios where SMS-iT Workflow can handle the linking automatically.

If you need to handle item linking manually, do this by setting pairedItem on each item your node returns:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

// Use the pairedItem information of the incoming item
newItem = {
	"json": { . . . },
	"pairedItem": {
		"item": item.pairedItem,
		// Optional: choose the input to use
		// Set this if your node combines multiple inputs
		"input": 0
}; // Or set the index manually
newItem = {
		"json": { . . . }
		"pairedItem": {
 "item": i,
 // Optional: choose the input to use
 // Set this if your node combines multiple inputs
 "input": 0
		},
};