Delegate Database Import/Export; Introduction; Configuration; Layout Import/Export File - Bosch DCN Manual

External Interface Manual
4

Delegate Database import/export

4.1

Introduction

The Delegate Database DCN application can import and export a names file in ASCII format. This allows
external programs to produce or process DCN names files. These import/export names files are also used to
transfer a names file to a newer version of the DCN software. The old names file is exported from the old
database and then imported into the new one. Exported names files are "upwardly-compatible". This means
that newer DCN versions can read old files, but not the other way around.
4.2

Configuration

Some values in the import file may be left blank in which case they will be automatically set to default values.
These defaults are usually empty strings, 0 in case of numerical values or yes in case of the authorization
fields. The default separator for the fields in the import file is the comma.
Before a file is imported, new default values for the authorization fields and the import separator can be set by
adding a section to the DCN.INI file as described below (values shown are the defaults):
[Database]
ImportSeparator=,
Authorization=Yes
where:
ImportSeparator
Authorization
Note: Upon export of a names file, any separator character that appears as part of an exported text is
replaced by a single space. This ensures that the names file can be re-imported using the same
setting for the separator character.
4.3

Layout import/export file

The CSV files are ASCII based files and numerical values are represented by strings ( card code 1234 is
represented by the string 1234). When omitted fields are followed by other fields the separators of the omitted
fields must be present in the line. The separators of the fields omitted at the end of the line can be omitted
(also see examples in this section).
First line of the file:
DCN NAMES 5.0<SEP>filename<SEP>pinsize<SEP>width field1<SEP>field1<SEP> field2<EOL>
where:
DCN NAMES x.0
filename
pinsize
width field1
field1, field2
<SEP>
<EOL>
Bosch Security Systems B.V. | 2004 April | External Interface Manual
Defines the separator character between fields in the import file.
Determines the default value for the voting-, microphone- and
intercom-authorization (Yes or No).
Where x represents the DCN software version number. Fixed
text that indicates the type of file and the version of DCN that
produced the file. (Required entry.) In this fixed text, the letter
'x' represents the major version number of the DCN software
(Version 5.0 shown in the line above).
The name under which this file appears in the DCN application,
not the csv file name. String with length >0 and < 13 characters.
(Required entry)
Size of the pincode. Range: 3,4,5, default 3. (Can be omitted)
The size in characters of the first screen line field. Range: 0-30,
default 15. (When no value is given the default is used)
The fields to use for the first and second parts of the screen
line. These can be any of the following strings: Last Name, First
Name, Seat Number, Group, Country, Title, Interpretation, User
Display, Card Code, PIN Code, Vote Weight, Birthday,
Company, Street, Post Code, City, E-Mail, Fax, Phone. (Can be
omitted)
field1 and field2 defaults to [None].
Indicates a separator character.
Indicates an end of line (carriage return (0x0D) and newline
character(0x0A)).
en | 20