![](<https://www.versio.io/img/icons/json.svg>)

# File configuration importer

Versio.io can import, historize and process data from configuration files.

Note that only OneImporter instances using Node.js support the import of file configurations; Docker does not support this module.

## Supported file formats

The following file formats are supported:

| Type | File extension | Description |
| --- | --- | --- |
| JSON (JavaScript Object Notation) | .json |  |
| XML (Extensible Markup Language) | .xml |  |
| YAML (Yet Another Markup Language) | .yaml<br>.yml |  |
| Property file | .properties | Property files must have key-value pairs separated by ":", "=" or whitespace |
| Configuration file | .config<br>.conf<br>.cfg<br>.cnf<br>.cf<br>.ini | Configuration files must have key-value pairs separated by ":", "=" or whitespace |

## Configuration

You can find the configuration option in Versio.io at `Environment settings > OneImporter > Configurations > File configuration`.

Here you can edit all existing configurations, create new configurations or delete existing configurations. Each configuration can import multiple files into a single specified entity. To add a new configuration, enter a `Name` and click `Add` to proceed to the configuration. To edit an existing configuration, click the arrow on the left of your importer name to expand the configuration options.

The following configuration options are available:

| Field | Description | Advice |
| --- | --- | --- |
| **Name** | Meaningful name | Include file name/type |
| **Active** | Option to activate and deactivate the configuration. Data is only imported if the configuration is activated. |  |
| **Entity name** | Entity that instances are assigned to | Determine standards about entity names before your first import |
| **Absolute file path** | Specify file path including file name |  |
| **Executing OneImporter** | Select a Versio.io OneImporter to import the data based on the importer configuration. | Requires an installed OneImporter: [Installation instructions](<https://docs.versio.io/setup-one-importer/index.md>) |
| **Schedule time (cron format)** | Determine the frequency of imports in CRON format | Learn more about CRON format: [https://en.wikipedia.org/wiki/Cron](<https://en.wikipedia.org/wiki/Cron>) |

*Table: File configuration parameters*

The following image is an example of a configuration in Versio.io for a file configuration:

![Versio.io configuration file configuration](<https://docs.versio.io/img/importer/file-configuration/file-configuration-configuration.png>) *Figure: Example of a configuration in Versio.io for a file configuration*

## Example

The Versio.io OneImporter imports the file configurations based on a specific configuration and stores the different instances in the entity defined by you. To view the imported instances in Versio.io, select 'Asset &amp; Configuration Repository → Instance Viewer'. There you can select your specific instance and click it for a detailed view in the instance history viewer.

The following image is an example of an imported file configuration instance:

![Versio.io configuration file instance](<https://docs.versio.io/img/importer/file-configuration/file-configuration-instance.png>) *Figure: Example of a file configuration instance*
