BotFrame

Data · Workflow node

Get collection item

The Get collection item node as it appears in the workflow editor.

What it does

Read a list item or map value.

This node prepares a value for later steps and does not post or change anything in Discord by itself. It produces Value, Found, which you can connect wherever the workflow needs it.

Typical use

Read one item from a list or map and branch on whether the key or index was found.

How to use it

  1. Add it from DataOpen the node library and choose Get collection item from Data.
  2. Connect the workflow pathConnect Flow in from the previous step and Flow to the next step.
  3. Choose settings and connect valuesSet Collection, Key, Operation. Connections can also supply values produced by earlier nodes.

Settings

These are the options shown when you add this node. A connected value can replace a setting when the workflow runs.

SettingStarting valueWhat it controls
CollectionNoneUsed when Collection is not connected from an earlier node.
Key0Used when Key or index is not connected from an earlier node.
OperationgetChooses the calculation or change this node performs.

Value connections

Value connections pass information between nodes without changing the order of the workflow. When an input is not connected, BotFrame uses the value selected in the node or details from the starting Discord event when available.

Inputs

CollectionAny value
Required
Key or indexAny value
Required

Outputs

ValueAny value
Optional
FoundTrue / false
Optional

What happens when it runs

This node prepares a value for later steps and does not post or change anything in Discord by itself. It produces Value, Found, which you can connect wherever the workflow needs it.

You can use this item in a published BotFrame workflow. You can also test it in the simulator.

These details match the node currently available in the BotFrame workflow editor.