About Data Export and Import

Data Export and Import are simple utilities for managing data users, roles and cost centers .

The Data Export page is accessible from all pages under Actions in the Users section.

Data Export

On the left-hand side of the Data Export page, an administrator can select character encoding. On the right-hand side of the Data Export page, a user can select the scope of the data to export. The export is saved in a CSV file format.

CSV Character Encoding

The CSV file will be created according to the selected encoding listed below.

Action

Description

UTF-8

The data will be exported with UTF-8 encoding

Windows-1250

The data will be exported with Windows-1250 encoding

Windows-1252

The data will be exported with Windows-1252 encoding

ISO-8859-1

The data will be exported with ISO-8859-1 encoding

ISO-8859-2

The data will be exported with ISO-8859-2 encoding

Other

An administrator can select another encoding type

The Scope of the Data to Export

The CSV data will be exported according to the selected sources listed below.

Action

Description

Export Users

Export all users to a CSV file

Export Cost Centers

Export all cost centers to a CSV file

Export Roles

Export all roles to a CSV file

Data that is exported encrypted is marked with the prefix do_not_convert@@. When Dispatcher Paragon Management Service imports data from a CSV file via Data Import, it looks for this prefix when it tries to decide whether the input value must be converted via the currently set conversion method or not.

Data Import

In the upper part of the Data Import page, there is the basic file structure for CSV files. In the bottom part, there is the CSV file character encoding and the path to the CSV file with the data to import.

CSV Character Encoding

The CSV file will be created according to the selected encoding listed below.

Action

Description

UTF-8

The data will be exported with UTF-8 encoding

Windows-1250

The data will be exported with Windows-1250 encoding

Windows-1252

The data will be exported with Windows-1252 encoding

ISO-8859-1

The data will be exported with ISO-8859-1 encoding

ISO-8859-2

The data will be exported with ISO-8859-2 encoding

Other

An administrator can select another encoding type

CSV files format

  • Add/update/delete users – [100;add|del;username[,alias,...];name;surname;[card number, ...];cost center number;email;[home directory]]
  • Add/update/delete users – [100;add|del;username[,alias,...];name;surname;[card number, ...];cost center number;email;[home directory];[password]]
  • Add/update/delete users with PIN code – [100;add|del;username[,alias,...];name;surname;[PIN%pin_code%,...];cost center number;email;[home directory]]
  • Add/update/delete users with PIN code – [100;add|del;username[,alias,...];name;surname;[PIN%pin_code%,...];cost center number;email;[home directory];[password]]
  • Add/delete card numbers – [200;add|del|clear;username[;card number]]
  • Add/delete PINs – [200;add|del|clear;username[;PIN%pin_code%]]
  • Add/update/delete cost centers – [300;add|del;cost center number[;cost center name]]
  • Add/update/delete roles – [400;add|del;role name[;role description]]
  • Set email address for user – [201;username;email address]
  • Set cost center for user – [202;username;cost center number]

Data that is exported encrypted (for example, PIN codes or passwords) are marked with the prefix do_not_convert@@. When Dispatcher Paragon imports data from a CSV file, it looks for this prefix when it tries to decide whether the input value must be converted via the currently set conversion method or not.

If password field is missing for already existing user it's not removed but left untouched in Dispatcher Paragon.

The CSV separator used for separating columns is a configurable value located in System > Reports > Primary separator in files for export/import, the default is semicolon ';'.

The CSV separator used for separating multiple values within one column is a configurable value located in System > Reports > Secondary separator in files for export/import, the default is comma ','.

Additional Rules and Limitations

Add/update/delete users

  • If a user with a given username already exists, the user record will be overridden.
  • Aliases and card numbers can only be added but not changed or removed.
  • The username, name, surname and cost center fields must not be empty.
  • The email must be a valid email address.

CSV files examples

  • 300;add;5;Communication
  • 300;add;7;Enterprise and Industry
  • 100;add;villevirtanen;Ville;Virtanen;PIN5555;5;villevirtanen@test.com;;4MV0b
  • 100;add;villevirtanen;Ville;Virtanen;PIN5555;5;villevirtanen@test.com;
  • 100;add;jeandupont;Jean;Dupont;268742;7;jeandupont@test.com;\\share\users\jeandupont;B27Kf
  • 100;add;jeandupont;Jean;Dupont;268742;7;jeandupont@test.com;\\share\users\jeandupont
  • 200;add;villevirtanen;268743
  • 200;add;jeandupont;PIN7777
  • 200;add;johndoe;do_not_convert@@PINb59c67bf196a4758191e42f76670ceba
  • 400;add;marketing
  • 400;add;human resources;All the employees from Human Resources department
  • 400;del;sales