Table of contents
- Introduction
- How to import configurations in Alumio
- Exporting all configurations from Alumio
Introduction
Importing and exporting configurations allows you to perform a number of actions with the configurations you have already set up or would like to start working on in Alumio. The simple workflow makes it possible to export almost everything within our application: Routes, Incoming and Outgoing configurations, Entity Transformers, HTTP Proxies, Webhooks, all existing Clients, Storages, Filesystems, Entity Schemas, Schedulers and so on.
As you can see, using such a feature as exporting and importing configurations you can make many different actions for the same configuration. Let’s see how it works.
How to import configurations in Alumio
Follow these steps to import configurations for your Alumio environment.
Step 1: Import a file by navigating More → System → Import / Export.
Step 2: Click on Choose a file. Select a file you want to import from the pop-up. Once imported, the file size is displayed for visibility.
Step 3: Review and resolve import issues.
After uploading, the system will analyse the file and may present different scenarios.
Scenario 1: No issues in the file import.
If the file contains no issues, a list of loaded configurations will be displayed. The Import configuration button becomes available, allowing you to proceed.
Scenario 2: Missing variables.
When the file is uploaded, the system may highlight missing variables in the file. To avoid any undesirable changes, you can create a new environment variable in parallel.
To do that, click on the Add button towards the list of missing variables. In the pop-up expanded, add a value to your missing variable and save it. This variable can be later found on the Environment variables overview page.
The Import configuration button becomes available, so you can save your file.
Scenario 3: Missing configurations.
If required configurations are missing, the system will indicate what needs to be added.
To do that, click on the Add button towards the list of missing configurations. A pop-up will be expanded, allowing you to select an existing configuration/transformers or create a new one.
The configuration will be available later in the relevant overview (e.g., Incoming, Outgoing, Transformers).
Once resolved, the Import configuration button becomes available.
Scenario 4: Invalid configurations.
Invalid configurations occur when required fields are incomplete.
To fix this, click on the Resolve button. A pop-up will be expanded to allow you to enter any mandatory information highlighted in the appropriate fields.
After fixing the issues, the Import configuration button becomes available.
How to export configurations in Alumio
Follow these steps to export configurations for your Alumio environment.
- Navigate to the Overview page of the functionality you need to make an export. For example, let’s navigate to the Routes overview page.
- Click on the “Actions” bar toward the Route you want to export.
- Select the “Export” option and click.
- The configuration will be automatically exported to you.
However, you are able to export multiple quantities of Routes by selecting the corresponding checkboxes. Once you select all the needed ones, the “Export” button will expand at the top of the page. Once you click on the button, as many Routes as selected will be exported immediately.
It’s also possible to export configurations without tests: once you click on the “Export” button if that configuration has the number of related configurations, they will be displayed in parent-children relations with tests included automatically. To exclude tests, select the “Exclude all optional” option in the expanded popup.
Exporting all configurations from Alumio
To export all configurations that exist in Alumio, follow this guide:
Step 1: Go to System > Import/Export page.
Step 2: Click on the “Export all configurations” button. A file with all existing configurations will be downloaded to you. It’s also possible to import this file to your Alumio environment.
