![](<https://www.versio.io/img/icons/files-folders-directory.svg>)

# Folder structure importer

Versio.io can inventory, monitor and process the metadata of folder structures including files.

## Configuration

You can find the configuration option in Versio.io at `Environment settings > OneImporter & OneGate > Configurations > Folder structure`.

Here you can edit all existing configurations, create new configurations or delete existing configurations. Each configuration can import one or multiple folder structures and files from one host 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 | Should include "Folder Structure" |
| **Active** | Option to activate and deactivate the configuration. Data is only imported if the configuration is activated. |  |
| **Root folder** | Specify the folder where the structure is imported from. Subfolders and files are imported automatically. | Separate folders with forward slashes (e.g. `C:/Users/myUser`). You can only specify one root folder. |
| **Exclude directories** | Exclude directories by defining regular expressions that will be excluded if they match the directory path. | Examples: `subfolder`, `\.git` |
| **Extensions** | Exclude one or multiple file formats from import (e.g. `.txt`, `.xml`) |  |
| **Capture Size** | The size of the folder or file in bytes is recorded. | Avoid frequent changes by disabling the import of the `size` attribute. |
| **Capture file** | Captures not only the directories but also the metadata for the files they contain. |  |
| **Exclude files** | Only available if the *capture file* flag is activated. Exclude files by defining regular expressions that will be excluded if they match the file name. | Examples: `\.txt`, `conf$` |
| **Capture file hashes** | Only available if the *capture file* flag is activated. Captures the checksum (MD5 hash) of the file for recognising changes at the binary level. | Blog post [Monitor the immutability of operating system and application files](<https://www.versio.io/blog-integrity-verification-of-binary-files.html>) |
| **Entity name** | Name of the entity that instances are assigned to (default: `folder-structure`) | Determine standards about entity names before your first import |
| **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: Folder structure import configuration parameters*

The following image is an example of a configuration in Versio.io for imports of folder structures:

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

## Example

The Versio.io OneImporter imports folder structures based on your specific configuration and stores the different instances in the entity defined by you (default: `folder-structure`). To view the imported instances in Versio.io, you can 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 folder structure:

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