Table of contents
- Introduction
- Guide
Introduction
Creating and managing Routes often requires navigating between multiple pages, such as Incoming, Route, and Outgoing configurations. The Route Builder provides a visual way to create and manage integrations by mapping out the full data flow, from Incoming data to final output, within a single screen.
It gives you a clear overview of how data moves through the Route and enables users to configure and adjust each step directly within the flow, making route creation more intuitive and efficient.
Guide
Step 1: Navigate to Integrations → Routes and click Create a new route. Switch to Route Builder (instead of Classic view) to start building visually.
Step 2: Click Start here, then Create an incoming configuration. Select an existing Incoming configuration from the list, or create a new one directly from this view.
Step 3: Click Add trigger above the Incoming configuration.
Choose one of the available options:
- Set up a scheduler (for periodic execution)
- Set up a webhook (for real-time triggers).
Step 4: After the Incoming configuration, you can add Transformers. Click the transformer block to select or configure transformations. Use this step to modify, filter, or enrich your data
Step 5: The New tasks step shows where processed data becomes tasks within Alumio.
Step 6: Add an Outgoing configuration by clicking Create an outgoing configuration. Select an existing outgoing configuration, or create a new one.
Step 7: Click Add Scheduler near the outgoing configuration if needed.
Step 8: Ensure the flow ends with Finished tasks, indicating successful processing.
Step 9: Adjust settings. Use the Enabled toggle (top right) to activate or deactivate the route. Open Advanced settings for additional configuration options.
The Advanced settings modal in Alumio provides granular control over how tasks are processed, retried, and scheduled within a specific route. These settings are essential for optimising performance and ensuring data integrity during complex integrations.
Task Retrying - This section allows you to automate the recovery of failed tasks.
- Enable task retrying: When toggled, Alumio will automatically attempt to re-run tasks that encounter errors.
- Attempted retries: Define the maximum number of times the system should try to process the task before marking it as permanently failed.
- Retry interval: Set the duration (in minutes) the system should wait between each retry attempt.
- Statuses: You can specify which specific error statuses should trigger a retry. If left empty, the system will retry for any failure-indicating status.
Note: For retrying to function, a scheduler must be specifically configured for this route.
Waiting Status - By default, Alumio marks processed tasks as “Finished.” Enabling this setting changes the post-processing status to “Waiting,” requiring a manual intervention to change the status to “Finished” or “Failed.” This is useful for workflows requiring human oversight or manual verification.
Real-time Processing - Enabling this allows Alumio to run the route immediately as tasks are created by the incoming data. When this is active, a scheduler is not required, as the integration reacts instantly to incoming data.
Parallel Processing - This allows for multiple data export processes to run concurrently, which can significantly speed up high-volume integrations.
Maximum parallel processes: Set the limit for how many processes can run at once.
Caution: This feature can’t be used simultaneously with "Real-time processing”. Improper configuration can lead to race conditions or data inconsistencies. Ensure multiple schedulers are set up for the route to support concurrent exports safely.
Step 10: Click Save & continue to store your configuration.
