Apply File Format; Dcn Ole Automation Server; Registering The Server; Start The Server - Bosch DCN Manual

External Interface Manual
5.3

Apply file format

The API function ApplyAll uses an import file that contains the delegate data. This file has the following
structure:
First line of the file:
DCN APPLY 5.0<SEP>filename<SEP>pinsize<EOL>
where:
DCN APPLY x.0
filename
pinsize
<SEP>
<EOL>
Example:
DCN APPLY 4.0,Test DB,4
This example gives the first line of a DCN 4.x apply file. The file will be called "Test DB" in the
DCN program. It uses 4-digit PIN-codes.
The other lines in the apply file give all the information for one delegate. Layout is as follows:
delegate id<SEP>lastname<SEP>screenline<SEP>seat number<SEP>group<SEP>display
language<SEP>card code<SEP>PIN code<SEP>authorization voting<SEP>authorization
microphone<SEP>authorization intercom<SEP>voting weight<EOL>
The delegate ID is a unique number that identifies this particular delegate. It is in the range 1-1000 for a
single CCU and 1-1500 for a multi-CCU system. The other fields correspond directly to the entry fields in the
Delegate Database application. The authorization voting field is set to either "Voting" or "NoVoting", the
authorization microphone field is set to either "Micro" or "NoMicro" and the authorization intercom field is set
to either "Intercom" or "NoIntercom". These texts are DCN language independent.
Delegate ID is necessary, but the other fields may be left blank or can be omitted.
Example:
1,Doe,My first name is John,A1,My group,English,12345678,123,Voting,NoMicro
This is the entry for Doe. He is sitting at seat A1 and has a screen line with the text "My first
name is John". He belongs to group "My group" and has English as the display language. His
card code is 12345678 with PIN code 123. He has voting but no microphone authorization
and all other fields are omitted and therefore contain the default values.
Note: The apply file format is a subset of the import file format. Because the data is not used in the
Delegate Database application, only the data that is relevant for the CCU is stored in the apply file.
Note: If the DCN is installed in a language other than English, the name entered in the display
language field is also translated. Refer to the corresponding entry field in the Delegate Database
application for the language names that are available in your version of the DCN software.
5.4

DCN OLE Automation Server

To use the automation server it must be registered with the windows environment first. After it is registered, it
can be started and it's methods can be used. When the calling application is finished with it, it must call the
terminate method to instruct the server to stop. The data imported into DCN will remain valid, also when the
automation server is stopped.
A sample database is installed into the sample directory during DCN installation, which shows the use of the
automation server.
5.4.1

Registering the server

Any OLE server needs to be registered in the Windows environment, the DCNOLE application has a build in
register mechanism. To register the server just run the server once, e.g. from the command line, or double
click on it in explorer. It will register itself so other applications can use it.
5.4.2

Start the server

Example in Visual Basic for Applications:
Bosch Security Systems B.V. | 2004 April | External Interface Manual
Fixed text that indicates the type of file and the version of DCN
for which the file was produced (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 of this file in the DCN Startup application. 8
characters maximum (Required entry.)
Size of the pincode. Range: 3,4,5, default 3.
Indicates a separator character.
Indicates an end of line (carriage return (0x0D) and newline
character(0x0A)).
en | 27