Siemens A31003-S1730-U102-1-7619 User Manual

Documentation

OpenScape Alarm Response Professional
OScAR-Pro V3 R2 Classic Applications
OScAR-Pro-TT Dataimport-Tool

User Manual

A31003-S1730-U102-1-7619

Communication for the open minded

Siemens Enterprise Communications

www.siemens-enterprise.com

Our Quality and Environmental Management Sys­tems are implemented according to the require­ments of the ISO9001 and ISO14001 standard cer­tified by an external certification company.

Communication for the open minded

Siemens Enterprise Communications

www.siemens-enterprise.com

Copyright ©
Communications GmbH & Co. KG 2010
Hofmannstr. 51, 80200 München

Siemens Enterprise Communications GmbH & Co. KG
is a Trademark Licensee of Siemens AG

Reference No.: A31003-S1730-U102-1-7619

The information provided in this document contains
merely general descriptions or characteristics of
performance which in case of actual use do not
always apply as described or which may change as
a result of further development of the products. An
obligation to provide the respective characteristics
shall only exist if expressly agreed in the terms of
contract. Availability and technical specifications are
subject to change without notice.
OpenScape, OpenStage and HiPath are registered
trademarks of Siemens Enterprise
Communications GmbH & Co. KG.
All other company, brand, product and service
names are trademarks or registered trademarks of
their respective holders.

Siemens Enterprise

BHB_DATAIMPORT_IVZ.fm

Confidential Contents

Contents 0

1 Conventions and general instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

1.1 Reference manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

1.2 Conventions and symbols used in this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

1.3 Privacy and data security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

2 Description of functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

2.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

2.2 General description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

2.3 Start and operation of the OpenScape Alarm Response Professional . . . . . . . . . . . . 2-3

2.4 Plausibility checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

3 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

3.1 Installing the OpenScape Alarm Response Professional . . . . . . . . . . . . . . . . . . . . . . 3-2

3.2 Removing the OpenScape Alarm Response Professional . . . . . . . . . . . . . . . . . . . . . 3-6

4 Program activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

4.1 Starting the DAKS-TT Dataimport Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2

4.2 Initial startup of the DAKS-TT Dataimport Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2

4.3 Start the application in a dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

4.4 Start the application by entering the logon data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4

4.5 Start the application with automatic logon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5

4.6 The most important error messages during logon . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6

4.7 Define time-controlled program-cueing via “Scheduled tasks“ . . . . . . . . . . . . . . . . . . 4-8

4.8 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13

5 Operating the OpenScape Alarm Response Professional . . . . . . . . . . . . . . . . . . . . 5-1

5.1 Layout of the interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2

5.2 Description of the menu items and buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3

5.3 Start import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

5.4 Save output as. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

5.5 Select INI file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

5.6 Edit email properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5

5.6.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5

5.6.2 Window “Edit email properties“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6

5.6.3 Window “Relaying“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8

6 INI Editor of the DAKS-TT Dataimport-Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

6.1 Essential details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2

6.2 Layout of the INI Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

6.3 Menu items of the INI Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4

6.4 General fields of the INI Editor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5

6.5 Mode: Update subscribers only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8

07/2010
DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

0-1

BHB_DATAIMPORT_IVZ.fm

Contents Confidential

6.6 Table-dependent fields of the INI Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9

6.6.1 Table fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9

6.6.2 Special parameters of the subscriber table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12

6.6.3 Dynamic creation of broadcast member groups. . . . . . . . . . . . . . . . . . . . . . . . . . 6-13

6.7 Edit values of the table fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15

6.7.1 Edit an alpha-/numeric value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15

6.7.2 Edit a bitmask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16

6.7.3 Edit the display parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-17

7 Description of INI files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

7.1 Essential details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

7.2 The syntax of INI files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

7.3 Common trigger words . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3

7.4 Exemplary INI file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4

7.5 Table fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5

7.5.1 Description of the table “Subscribers“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6

7.5.2 Description of the table “Broadcasts“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-11

7.5.3 Description of the table “Broadcast members“ . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-15

7.5.4 Description of the table “Conference“. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-17

7.5.5 Description of the table “Conferees“. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-21

7.5.6 Description of the table “Call Profile“ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-22

7.5.7 Description of the table "Call Profile members" . . . . . . . . . . . . . . . . . . . . . . . . . . 7-26

7.5.8 Coding of iDispProps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-27

07/2010

0-2 DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

BHB_DATAIMPORT_LOF.fm

Confidential Images

Images 0

Image 2-1 Diagram of a data import. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Image 4-1 Log on to DAKS-TT Dataimport Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

Image 5-1 Layout of the interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2

Image 5-2 The email properties of DAKS-TT Dataimport-Tool . . . . . . . . . . . . . . . . . 5-6

Image 5-3 The relaying properties of the DAKS-TT Dataimport-Tool . . . . . . . . . . . . 5-8

Image 6-1 The INI Editor of the DAKS-TT Dataimport-Tool . . . . . . . . . . . . . . . . . . . . 6-3

07/2010
DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

0-3

BHB_DATAIMPORT_LOF.fm

Images Confidential

07/2010

0-4 DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

BHB_DATAIMPORT_LOT.fm

Confidential Tables

Tables 0

Table 1-1 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

Table 3-1 Installing the DAKS OScAR-Pro-TT Dataimport-Tool . . . . . . . . . . . . . . . . 3-2

Table 3-2 Uninstalling the DAKS OScAR-Pro-TT Dataimport-Tool. . . . . . . . . . . . . . 3-6

Table 4-1 Description of the fields of the "Logon" window . . . . . . . . . . . . . . . . . . . . 4-3

Table 4-2 The most important fault messages during logon . . . . . . . . . . . . . . . . . . . 4-6

Table 4-3 Creating a "Scheduled task" . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8

Table 5-1 Menu items and buttons of the OpenScape Alarm Response Professional 5-3

Table 5-2 Fields of the window “Email properties“ . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6

Table 5-3 Field of the window “Select relay server“ . . . . . . . . . . . . . . . . . . . . . . . . . 5-8

Table 6-1 Edit INI file with the INI Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2

Table 6-2 Menu items of the INI Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4

Table 6-3 General fields of the INI Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5

Table 6-4 General fields description of the window area “Table fields“: . . . . . . . . . . 6-9

Table 6-5 Special parameters of the subscriber table . . . . . . . . . . . . . . . . . . . . . . . 6-12

Table 6-6 Dynamic creation of groups for broadcast members. . . . . . . . . . . . . . . . 6-13

Table 6-7 Editing an alpha-/numeric value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15

Table 6-8 Example how to edit bitmasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16

Table 6-9 Description of the fields for the display outputs in the "Display" tab . . . . 6-17

Table 7-1 Trigger words of the DATAIMPORT.INI . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3

Table 7-2 Exemplary INI file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4

Table 7-3 Data fields of the “Subscriber“ table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6

Table 7-4 Data fields of the “Broadcast“ table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-11

Table 7-5 Date fields of the “Broadcast members“ table . . . . . . . . . . . . . . . . . . . . . 7-15

Table 7-6 Data fields of the “Conference“ table. . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-17

Table 7-7 The data fields of the table “Conferees“: . . . . . . . . . . . . . . . . . . . . . . . . . 7-21

Table 7-8 Data fields of the “Call Profile“ table . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-22

Table 7-9 Data fields of the table “Call Profile members“ . . . . . . . . . . . . . . . . . . . . 7-26

07/2010
DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

0-5

BHB_DATAIMPORT_LOT.fm

Tabl es Confidential

07/2010

0-6 DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

BHB_DATAIMPORT_01.fm

For internal use only Conventions and general instructions

1 Conventions and general instructions

Target audience and qualifications

This User Manual is written for service staff who are responsible for the initial installation and
startup of the OpenScape Alarm Response Professional.

In addition, it shall assist and support all those who set up and administer the Tool.

A basic knowledge of Windows and administrator skills are required to carry out the operations
described in this document.

Contents

The first chapter is divided into the following sections:

1.1 Reference manuals

1.2 Conventions and symbols used in this Manual

1.3 Privacy and data security

07/2010
DAKS OScAR-Pro-TT Dataimport-Tool, User Manual 1-1

BHB_DATAIMPORT_01.fm

Conventions and general instructions For internal use only

Reference manuals

1.1 Reference manuals

Please also see our OScAR-Pro Release 7, HiPath OScAR-Pro V3 R1user manual for further
details and additional assistance when working with OScAR-Pro.

07/2010

1-2 DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

BHB_DATAIMPORT_01.fm

For internal use only Conventions and general instructions

Conventions and symbols used in this Manual

1.2 Conventions and symbols used in this Manual

Conventions

The following conventions apply to this User Manual:

Text

Password 123456 ... Details that appear in the continuous text and that are of particu-

global.cfg file Files and directories are indicated by the non-proportional

"Name" Field names, menu names and window descriptions are placed in

<Place holder> Entries or outputs, both of which may vary depending on the indi-

Table 1-1 Conventions

Symbols

The following symbols are used in this Manual:

The "i" is used to signal useful additional information.

All texts taken from the described files and any text you may enter
into these files will appear in the non-proportional Courier type-
face.

lar importance or must be heeded are output in bold print. But­tons are euqally marked in bold.

typeface Courier.

quotation marks.

vidual event and settings, are always placed in angle brackets and
written in italics.

>

07/2010
DAKS OScAR-Pro-TT Dataimport-Tool, User Manual 1-3

BHB_DATAIMPORT_01.fm

Conventions and general instructions For internal use only

Privacy and data security

1.3 Privacy and data security

Please note that the system described in this Manual uses and processes personal data.

In Germany, the processing and use of personal data are subject to various regulatory acts,
including the Federal Data Protection Act (Bundesdatenschutzgesetzes, BDSG) and other re­strictions. For your and any other country, please be careful to observe all pertinent laws and
regulations that are currently in force and applicable.

The first and foremost purpose of data protection is to protect the individual against any in­fringement of his/her personal rights through the misuse of his/her personal data.

On the other side, the protection of data privacy also has the aim to protect the data itself from
being misused during the different phases of its processing and in doing so ward off any in­fringement of outside or internal interests in need of protection.

Help safeguard data privacy and data security by being aware of these issues as you
work:

● Make sure that only authorized persons have access to personal data.

● Consistently make use of every opportunity to assign passwords; do not grant unauthor-

ized persons access to any passwords, e.g. by writing them down.

● Make sure that no unauthorized persons can manipulate, i.e. save, modify, communicate,

block, delete, or use personal data in any way.

● Always safeguard that no unauthorized persons have access to data storage mediums,

e.g. to back up diskettes or protocol printouts. This applies to service work as well as to
any storage or transport.

● Make sure that data storage media that are no longer needed are completely destroyed. In

this context, always check that you do not leave behind any papers that might become
openly accessible to others.

07/2010

1-4 DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

BHB_DATAIMPORT_02.fm

For internal use only Description of functions

Overview

2 Description of functions

2.1 Overview

With the OpenScape Alarm Response Professional, you can import data easily into tetronik
OScAR-Pro Release 7 or OScAR-Pro V3 R2 Classic Applications (OScAR-Pro = Open Scape
Alarm Response Professional) from customer-own databases using the original source files
in ASCII format.

With the help of a configuration file (INI file), the data import can be tailored so flexibly that
source data files can be read in from just about any database.

In a first step, you need to export the data you want the Dataimport-Tool to later import from the
customer-own database to the source file.

It is these source files that are then read in, verified, and, if fault-free, finally imported by the
OpenScape Alarm Response Professional in accordance with the INI file rules.

The DAKS-TT Dataimport Tool can be started either manually or e.g. via the Windows-Sched­uler.

Image 2-1 Diagram of a data import

07/2010
DAKS OScAR-Pro-TT Dataimport-Tool, User Manual 2-1

BHB_DATAIMPORT_02.fm

Description of functions For internal use only

General description

2.2 General description

● The OpenScape Alarm Response Professional is an independent Windows program, op-

erable under WINDOWS 2000/XP/2003.

● It accepts data (tables) from source files with corresponding setup and enters it into the

database via OScAR-Pro-TT Server.
For this purpose the program needs separate source files (with the relevant datasets) for
the following tables:

– Subscriber list (obligatory)

– Broadcast groups (if needed)

– Contingency table for broadcast members (if needed)

– Conference groups (if needed)

– Contingency table for conference group members (if needed)

– Call Profiles (if needed)

– Contingency table for call profile group members (if needed)

● Every dataset that needs to be imported must have an unequivocal numeric code (identi-

fier) ranging between 0 and n - 1, with n constituting the maximum number of entries in the
table defined in the OScAR-Pro server's chipcard.

● The flexibility of the OpenScape Alarm Response Professional ensures that in the source

files:

– the fields of the table may be in random order,

– fields located anywhere and not needed by the OScAR-Pro-TT database will be ig-

nored,

– not all fields must be identical with those of the OScAR-Pro-TT database; missing

fields can be filled with absolute terms,

– specific subscriber data sets can be earmarked using unequivocal codes or referenc-

es (e.g. "Default values" from a Microsoft Access database), to safeguard that they will
be found again later after their import.

● Note that subscribers with administrative rights (user) can only be setup and administered

via the OScAR-Pro-TT Administrator Tool.
On condition that the subscriber identifier has not been changed, the administrative and
operative rigts already assigned to a subscriber are retained also after the data import.

● Subscribers can be also entered flexibly into existing broadcasts on the basis of specific

trigger words.

07/2010

2-2 DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

BHB_DATAIMPORT_02.fm

For internal use only Description of functions

Start and operation of the OpenScape Alarm Response Professional

● In order to be able to create or edit the INI file as faultless as possible, the DAKS-TT

Dataimport Tool has a corresponding editor with an intuitive user interface (Chapter 6, „INI
Editor of the DAKS-TT Dataimport-Tool“).

Note:

>

Bear in mind that for broadcasts or conferences that are launched via contact or
time-controlled processes, no corresponding references are retained when the
groups are imported.

2.3 Start and operation of the OpenScape Alarm Response Professional

● The OpenScape Alarm Response Professional can be started:

– manually,

– via Windows Scheduler ("Planned tasks“) with two different trigger parameters.

● First, the DAKS-TT Dataimport Tool tries to logon to OScAR-Pro-TT Server with the de-

fined logon data.

Should another user already be logged on to OScAR-Pro-TT Server with the same

>

identification code, your logon attempt will be rejected. If you are using automatic
log-on (Section 4.1, „Starting the DAKS-TT Dataimport Tool“) in this instance, the
program will be ended.

● If the log-on was successful, the INI files are read in and checked for faultlessness.

● Next, the relevant import files are entered in keeping with the INI file rules and the data,

together with the data stock that already exists in the database, is checked for plausibility.

● Any faults or inconsistencies will be output in the display area of the application and, op-

tionally, recorded to individual logfiles.
In the event of a fault, the import process will be aborted.

● Once the data is checked and proves faultless, it is transferred to the database and saved.

● During the saving process, the following connections of OScAR-Pro-TT Server are cut:

– all connections to logged-on administrators, if any

– all connections to logged-on operators, if any

– all connections to OScAR-Pro servers.

07/2010
DAKS OScAR-Pro-TT Dataimport-Tool, User Manual 2-3

BHB_DATAIMPORT_02.fm

Description of functions For internal use only

Plausibility checks

2.4 Plausibility checks

In the plausibility check, the source files are examined for:

● redundant or multiple allocation of identifiers in one and the same table

● missing identifiers or identifiers that transgress areas pursuant to the chip-enable gating of

the OScAR-Pro server

● invalid allocations in the contingency tables

● assignments of invalid announcements

● errors in the value range of fields

● missing ‘PIN’ if the field for the operative rights of a subscribers does not equal 0 (zero).

07/2010

2-4 DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

BHB_DATAIMPORT_03.fm

For internal use only Installation

3 Installation

Overview

This chapter shows you how to install and, if you should need, remove the DAKS-TT Dataim­port Tool to and from your computer.

Contents

The chapter is divided into the following sections:

3.1 Installing the OpenScape Alarm Response Professional

3.2 Removing the OpenScape Alarm Response Professional

07/2010
DAKS OScAR-Pro-TT Dataimport-Tool, User Manual 3-1

BHB_DATAIMPORT_03.fm

Installation For internal use only

Installing the OpenScape Alarm Response Professional

3.1 Installing the OpenScape Alarm Response Professional

The entire OpenScape Alarm Response Professional can all be installed in one process.

Please bear in mind that under Windows 2000/XP/2003 Server, you must have ad-

>

Make sure that the following requirements are met before you begin to install the software on
your PC:

● Microsoft Windows 2000, Windows XP or Windows 2003 Server is already installed on

● You are familiar with the Windows operating system and know how to install software.

● OScAR-Pro Release 7 or OScAR V3 R2, respectively, are already installed on your com-

ministrative rights to install the OpenScape Alarm Response Professional!

your computer.

puter or network (see OScAR-Pro User Manual).

● OScAR-Pro-TT Server has already been connected at least once with the corresponding

OScAR-Pro server (been ’online’),

Follow the instructions issued by the program during the installation. Use Back to

>

return to the previous window and make changes, if necessary. You can terminate
the installation at any time with Cancel.

No. Task Window

1. Insert the installation CD in the CD-ROM
drive.

Should the installation software fail to start
automatically, start the CD installation manu­ally from the Windows interface with the
Run... menu command:

To do so, enter
<CD-ROM drive>:\cdsetup

e.g.: d:\cdsetup

in the command line and click OK.

Table 3-1 Installing the DAKS OScAR-Pro-TT Dataimport-Tool

07/2010

3-2 DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

BHB_DATAIMPORT_03.fm

For internal use only Installation

Installing the OpenScape Alarm Response Professional

No. Task Window

2. Click on the menu item
’Install dataimport software “Dataimport
V6.01’.

3. Select the language for the installation and
click on OK.

4. The Wizard is now ready to begin with the in­stallation.

Table 3-1 Installing the DAKS OScAR-Pro-TT Dataimport-Tool

07/2010
DAKS OScAR-Pro-TT Dataimport-Tool, User Manual 3-3

BHB_DATAIMPORT_03.fm

Installation For internal use only

Installing the OpenScape Alarm Response Professional

No. Task Window

5. Now click on Next to continue with definition
of the installation settings.

6. Enter the user name and the name of your
company, business or organization (here: ’or­ganization’).

Next, tick if you want the application to be in­stalled for anyone who uses this computer
computer or only for you.

After you have made all necessary entries
move to the next window by clicking on Next.

7. This window serves to define the destination
folder. If you want to install the application in
a different folder, click on Change... and se­lect a new folder in the next window.

After you have made all necessary entries,
click on Next to install the application to the
folder you have selected.

Table 3-1 Installing the DAKS OScAR-Pro-TT Dataimport-Tool

07/2010

3-4 DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

BHB_DATAIMPORT_03.fm

For internal use only Installation

Installing the OpenScape Alarm Response Professional

No. Task Window

8. Now click on Install to install the OpenScape
Alarm Response Professional on your com­puter.

The Wizard will now install the software in the
folder you selected. This may take severeal
minutes. The progress (’status’) of the instal­lation is output in a blue bar.

After the installation has been completed,
click on Next.

9. The software is being installed.

10. Click on Finish to complete the installation
and exit the Wizard.

As soon as the Wizard has successfully in­stalled the OScAR-Pro-TT Dataimport-Tool
on your computer, a corresponding program
symbol will appear in the Windows Program
Manager under the program group "tetronik
OScAR-Pro-TT".

Click on Finish.

Table 3-1 Installing the DAKS OScAR-Pro-TT Dataimport-Tool

07/2010
DAKS OScAR-Pro-TT Dataimport-Tool, User Manual 3-5

BHB_DATAIMPORT_03.fm

Installation For internal use only

Removing the OpenScape Alarm Response Professional

3.2 Removing the OpenScape Alarm Response Professional

No. Task Window

1. Open the Windows Control Panel.

2. Open "Add or Remove Programs".

3. Select the entry "tetronik OpenScape Alarm
Response Professional" and click on Re-
move.

The Wizard will now prepare the removal of
the application.

Table 3-2 Uninstalling the DAKS OScAR-Pro-TT Dataimport-Tool

07/2010

3-6 DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

BHB_DATAIMPORT_03.fm

For internal use only Installation

Removing the OpenScape Alarm Response Professional

No. Task Window

4. Click YES to confirm the removal of the tetro­nik OScAR-Pro-TT Dataimport-Tool from
your computer.

5. The Wizard will now remove the application.

Table 3-2 Uninstalling the DAKS OScAR-Pro-TT Dataimport-Tool

07/2010
DAKS OScAR-Pro-TT Dataimport-Tool, User Manual 3-7

BHB_DATAIMPORT_03.fm

Installation For internal use only

Removing the OpenScape Alarm Response Professional

07/2010

3-8 DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

BHB_DATAIMPORT_04.fm

For internal use only Program activation

4 Program activation

Overview

This chapter shows you how to start the DAKS-TT Dataimport Tool either manually or time-con­trolled and explains the special features that apply when the application is started for the very
first time.

Contents

The chapter includes the following sections:

4.1 Starting the DAKS-TT Dataimport Tool

4.2 Initial startup of the DAKS-TT Dataimport Tool

4.3 Start the application in a dialog

4.4 Start the application by entering the logon data

4.5 Start the application with automatic logon

4.6 The most important error messages during logon

4.7 Define time-controlled program-cueing via “Scheduled tasks“

07/2010
DAKS OScAR-Pro-TT Dataimport-Tool, User Manual 4-1

BHB_DATAIMPORT_04.fm

Program activation For internal use only

Starting the DAKS-TT Dataimport Tool

4.1 Starting the DAKS-TT Dataimport Tool

The OpenScape Alarm Response Professional can be invoked in three different ways:

● Start the application in a dialog, i.e. without prompting parameter

● Start the application by entering the logon data

● Start the application with automatic logon

4.2 Initial startup of the DAKS-TT Dataimport Tool

Log on to the DAKS-TT Dataimport Tool (Section 4.3, „Start the application in a dialog“).

Go to the menu item "Select ➝ INI file options“ and chose a valid INI file (Section 5.5 “Selecting
an INI-file“)..

Please bear in mind that the installation of the Dataimport-Tool will automatically

>

generate the creation of an INI file "DATAIMPORT.INI“ with an example configuration
for your assistance.

Note that the application retains the INI files that were last accessed/edited in the Registry. It
will re-use these files whenever they are cued again later, irrespective of the way in which they
are invoked.

Now proceed to test the data import.

07/2010

4-2 DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

BHB_DATAIMPORT_04.fm

For internal use only Program activation

Start the application in a dialog

4.3 Start the application in a dialog

To operate the DAKS-TT Dataimport Tool in a user-controlled way, i.e. in form of a dialog, open
the Windows Program Manager under the program group "tetronik OScAR-Pro-TT" and click
on the DAKS-TT Dataimport Tool symbol.
Due to the fact that the DAKS-TT Dataimport Tool registers onto the OScAR-Pro server in the
same way as the OScAR-Pro-TT Administrator Tool, you can find further details on the regis­tration window in the OScAR-Pro Release 7, OScAR V3 R2 Classic Applications user manual.

Description of the fields in the "Logon" window

Input field Description

Image 4-1 Log on to DAKS-TT Dataimport Tool

Window area "Authentication"

User Input field to enter the ID of an administrator, max. 30 characters.

Password Input field to enter the password of the aforementioned user, max. 30 char-

acters.

Window area "Database"

IP address Input field to enter the IP address or the name of the computer on which

the OScAR-Pro-TT Server program runs, max. 30 characters.

IP port Input field to enter the IP Port that is used to link-up administration connec-

tions of the OScAR-Pro-TT Server (default: 2016).

Other fields

Save If this field is checked, the logon data is saved encrypted in the Registry.

Table 4-1 Description of the fields of the "Logon" window

Please bear in mind that to start the application with automatic logon, you must have

>

previously logged on successfully at least once to the DAKS-TT Dataimport Tool and
also ticked the box "Save".

07/2010
DAKS OScAR-Pro-TT Dataimport-Tool, User Manual 4-3

BHB_DATAIMPORT_04.fm

Program activation For internal use only

Start the application by entering the logon data

4.4 Start the application by entering the logon data

The OpenScape Alarm Response Professional can be started with direct input of the logon da­ta. This is particularly useful when importing data in a time-controlled way usng the Windows
Scheduler.

For this purpose, you must transfer at the program start the trigger word /LOGON:, plus the ac­cess data [user name], [password], [IP address], and [port].

Please bear in mind that the logon window will here not open as described in the previous chap­ter; instead, the application will launch the dataimport process automatically or system-con­trolled.

Example:

"C:\tetronik\OScAR-Pro-TT Dataimport-Tool\OScAR-Pro-TT Dataimport-Tool.exe" /

LOGON:sys-adm,sysadm,192.168.123.123,2001

The following prerequisites must be met for this function:

● All files that shall be imported must be properly available.

● A valid INI file must be available and assigned.

● We recommend you test the data import manually beforehand to verify that it operates

properly and fault-free (Section 4.3, „Start the application in a dialog“).

Warning

>

Please remember that starting the application with these parameters bears the risk
of third parties reading out the logon data in plaintext, i.e. unencrypted.

07/2010

4-4 DAKS OScAR-Pro-TT Dataimport-Tool, User Manual

BHB_DATAIMPORT_04.fm

For internal use only Program activation

Start the application with automatic logon

4.5 Start the application with automatic logon

The OpenScape Alarm Response Professional can also be started with automatic logon. This
is again particularly useful if you want the data to be imported time-controlled using the Win­dows Schedu-ler.

To start the application with automatic logon, you must first logon successfully in a dialog (Sec­tion 4.3, „Start the application in a dialog“) with the box "Save" well ticked.

Next, go to the Windows Scheduler and transfer the trigger word /AUTOC: to the application
at the startup. The OpenScape Alarm Response Professional will read all logon data needed
from the Windows Registry.
The logon data is saved encrypted in the Windows Registry.

Please again bear in mind that the logon window will not open in the way described in the pre­ceding chapter. Instead, the program will launch the import process automatically or system­controlled.

For example:

"C:\tetronik\OScAR-Pro-TT Dataimport-Tool\OScAR-Pro-TT Dataimport-Tool.exe" /

AUTOC:

The following prerequisites must be met for this function:

● Valid logon data must be available in the Registry

(Section 4.3, „Start the application in a dialog“).

● The files that shall be imported must be properly available.

● A valid INI file must be available and assigned.

● We recommend you test the dataimport manually beforehand to verify that it operates

properly and fault-free (Section 4.3, „Start the application in a dialog“).

To change logon data stored in the Registry, start the OpenScape Alarm Response

>

Professional in the dialog (Section 4.3, „Start the application in a dialog“) and check
the box "Save".

07/2010
DAKS OScAR-Pro-TT Dataimport-Tool, User Manual 4-5

BHB_DATAIMPORT_04.fm

Program activation For internal use only

The most important error messages during logon

4.6 The most important error messages during logon

The below list covers the most important error messages that may appear during the
logon:

Field Description

Unable to set up TCP/IP connection to OScAR­Pro-TT Server.
Among other reasons, this message may surface
because:

– you entered a wrong IP address or IP

port

– the attempt to connect was forestalled by

a firewall on your local computer, on the
computer used for OScAR-Pro-TT Serv­er, or along the route

– the application OScAR-Pro-TT Server is

not active

The attempt of the OpenScape Alarm Response
Professional to log on to OScAR-Pro-TT Server
with the assigned user name failed because an­other application is already logged on with this
name.

The application is not enabled in the chipcard
data of OScAR-Pro-TT Server.
If this message appears, verify that:

– the OScAR-Pro server entered in OS-

cAR-Pro-TT Server is properly marked
as primary connection

– OScAR-Pro-TT Server has already been

connected successfully at least once
with the OScAR-Pro server (been ’on­line’)

– you have acquired the application right-

fully and the chipcard of your OScAR-Pro
server is equipped with the pertinent en­abled information

Table 4-2 The most important fault messages during logon

07/2010

4-6 DAKS OScAR-Pro-TT Dataimport-Tool, User Manual