File configuration importer
Versio.io can import, historize and process monitoring data from File configurations.
Note that only OneImporter instances using NodeJS support the import of file configurations, Docker does not support this module.
Supported file formats
The following file formats are supported:
| Typ | File extension | Description |
|---|---|---|
| JSON (JavaScript Object Notation) | .json | |
| XML (Extensible Markup Language) | .xml | |
| YAML (Yet Another Markup Language) | .yaml .yml |
|
| Property file | .properties | Property files must have key-value pairs separated by ":", "=" or whitespace |
| Configuration file | .config .conf .cfg .cnf .cf .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 installed OneImporter: Installation instruction |
| Schedule time (cron format) | Determine the frequency of imports in CRON format | Learn more about CRON format: 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:
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 the entity defined by you. To view the imported instances in Versio.io, select 'Asset & 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:
Figure: Example of a file configuration instance