Skip to content
Nappai Documentation

Run Project flow

Run a pre‑built project flow with optional tweaks and input

How it Works

When you add this component to your dashboard, it first pulls a list of all available flows from your Nappai system.
You choose one of those flows from the Flow Name dropdown.
The component then sends the text you type into Input Value (or the value you provide from another component) to the selected flow.
If you want to change any of the flow’s default settings, you can add those changes in the Tweaks field.
After the flow finishes, the component collects the results and presents them as a list of data items that can be used by other components in your workflow.

Inputs

  • Flow Name: The name of the flow you want to run.
  • Input Value: The text or data that the flow will process.
  • Tweaks: A set of optional key‑value pairs that override default flow settings.

Outputs

  • Run Outputs: A list of data objects produced by the flow. These can be passed to other components, displayed in the dashboard, or used to trigger further actions.

Usage Example

  1. Drag the Run Project flow component onto your canvas.
  2. In the Flow Name dropdown, pick the flow you want to execute (e.g., “Customer Onboarding”).
  3. Type a customer’s name or ID into Input Value.
  4. (Optional) Add a tweak such as {"send_email": true} to tell the flow to send a welcome email.
  5. Connect the Run Outputs to a component that displays results, like a table or a notification.
  6. Run the workflow and see the flow’s output appear in the connected component.
  • List Flows – Shows all available flows so you can see what can be run.
  • Run Flow – A more generic flow runner that can be used when you need to build a flow from scratch.
  • Display Data – Shows the output data in a readable format on the dashboard.

Tips and Best Practices

  • Keep the Tweaks field simple; only include keys that the flow actually uses.
  • Test a flow with a small sample input before connecting it to a live data source.
  • Use the Run Outputs to feed into a logging component so you can audit what data was produced.
  • If a flow requires authentication, make sure the user running the dashboard has the necessary permissions.

Security Considerations

  • Flows may access sensitive data; restrict who can run this component to trusted users.
  • Review any tweaks you pass to the flow to avoid unintentionally exposing or modifying data.
  • Ensure that the flow’s output is sanitized before displaying it in the dashboard to prevent injection attacks.