How to use it
- Add it from Server actionsOpen the node library and choose Find roles from Server actions.
- Connect the workflow pathConnect Flow in from the previous step and Flow to the next step.
- Choose settings and connect valuesSet Entity, Mode, Value. 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.
| Setting | Starting value | What it controls |
|---|---|---|
| Entity | role | Chooses whether this node searches for a role. |
| Mode | name | Chooses whether to find the role by name or ID. |
| Value | Empty | Used when ID or name is not connected from an earlier node. |
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
Guild IDServer · Defaults to the current server
OptionalID or nameText
RequiredOutputs
Matching rolesList
OptionalMatch countNumber
OptionalOnly matchRole
OptionalWhat happens when it runs
When the workflow reaches this node, BotFrame uses the current server details and any connected IDs to perform the Discord action. The resulting Matching roles, Match count, Only match can be connected to later nodes.
You can use this item in a published BotFrame workflow. You can also test it in the simulator.