# CSV Tool

### Configuration Tooling <a href="#xdtxa4sudfeo" id="xdtxa4sudfeo"></a>

Work API tool bundle can be downloaded from the Admin panel.

### CSV tool <a href="#fdvq6mamd9ev" id="fdvq6mamd9ev"></a>

The CSV-tool is a command line interface that allows users to work on CSV files that are part of the Work API configuration process.

#### Installation <a href="#id-6mwku1dceq9u" id="id-6mwku1dceq9u"></a>

1. Download the CSV tool from the
2. Follow the installation guide to correctly install the tool in your environment.

#### Usage <a href="#id-1metmdrvpwq5" id="id-1metmdrvpwq5"></a>

Shell

{% code overflow="wrap" %}

```sh
csv-tool.exe --source-path <source-path> --write-path <write-path> [--extend-she-rules <settings-path>] [--delimiter <delimiter>] [--rules bool] [--requirements bool]
```

{% endcode %}

**Arguments**

* \--source-path: Path to CSV-file containing the requirements. Required.
* \--write-path: Path to directory where the output will be written. If omitted, the path of the source file is used. Optional.
* \--extend-on-rules: Path to already existing settings JSON-file. If given, new rules will only be created for tags that do not exist yet. Optional.
* \--delimiter: Character or string that separates data elements in the source file, or "automatic" to let the tool deduce the delimiter from the source file. Optional, defaults to a comma (",").
* \--rules: Boolean. Controls whether rules based on input CSV-file will be generated. Optional, defaults to True.
* \--requirements: Boolean. Controls whether requirements JSON-file is generated. Optional, defaults to True.

#### Examples <a href="#cxv3oa950myq" id="cxv3oa950myq"></a>

Shell

```shell
# Basic usage
CSV-tool.exe requirements_template.csv
# Extend on existing settings
CSV-tool.exe requirements_template.csv --extend-on-rules settings.json
# Use semicolon as delimiter, generate only requirements json-file
CSV-tool.exe requirements_template --delimiter ";" --rules False
```