Datacenter User Guide

Version 2.0 | Published November 02, 2023 ©

File

This section provides the steps to configure a File dataset.

  1. Create a new dataset of type File, specifying a name and (optionally) a prefix to use to identify the dataset and its values, respectively:

    images/download/attachments/120745736/image-2023-8-15_16-6-29.png
  2. Click Add. The dataset is added to the list, and it has an initial WARNING status as it contains no source file yet.

    images/download/thumbnails/120745736/image-2023-8-15_16-7-54.png
  3. You can now select a source file from the table in the Dataset configuration panel, by double clicking one of its rows. The table lists all recently used files.

    images/download/attachments/120745736/image-2023-8-15_16-11-5.png


    Alternatively, you can type a file location in the input box at the top of the table and press the plus sign. The file is added to the dataset source, and included in the Files table for future reference.

    images/download/attachments/120745736/image-2023-8-15_16-10-47.png

The input box supports autocomplete, listing the files in the folder alias that were setup while configuring the File provider in the Admin page.
Datacenter supports the following file types:

  • Text (key-value pairs, using the '=' or ':' char as separators).

  • Ini-file

  • JSON

Editing Recently Added Files

The table in the Dataset configuration panel lists all the recently added files. When adding a file, its values are set to default.

Follow these steps to edit those properties:

  1. Click on the file you want to edit, the corresponding row is highlighted in blue:

    images/download/attachments/120745736/image-2023-8-15_16-15-12.png
  2. Edit the properties listed, such as Name and Description.

    images/download/thumbnails/120745736/image-2023-8-15_16-16-11.png

Filtering a Dataset

Values read from a file into a dataset, can be filtered via the Filtering tool. To do so, select the dataset card, click on the hamburger menu and then press the Filter button.

images/download/attachments/120745736/image-2023-8-15_16-17-46.png

A dialog visualizing the file's payload schema opens, through which a user can filter the source data.
images/download/attachments/120745736/image-2023-8-15_16-20-24.png
Please refer to the Filtering and Manipulating the Dataset Entries page to learn how to enable, disable and edit the entries added.