WinGuard

Integral Security and Building Management System

User Manual
 WinGuard Integral Security and
Building Management System

User Manual
System 8

Advancis Software & Services GmbH This publication is only intended for information purposes.
Monzastraße 4a The software is subject to change without notice.
D-63225 Langen Contents shall not be reproduced,
Phone: +49 (6103) 80735-10 either in full or in part, without our written authorisation.
Fax: +49 (6103) 80735-11
e-mail: [email protected] Issue: 09/05
Internet: www.advancis.de
WinGuard User Manual Contents

Contents
1 INTRODUCTION ........................................................................... 7
1.1 Field of application .............................................................................................. 7
1.2 Functioning .......................................................................................................... 7
1.3 System concept ................................................................................................... 8
1.4 Expansion stages ................................................................................................ 8
1.5 System requirements .......................................................................................... 9

2 INSTALLATION AND MAINTENANCE ...................................... 11

2.1 Installation of a WinGuard workstation.............................................................. 11
2.1.1 Installation process....................................................................................... 11
2.1.2 Dongle .......................................................................................................... 12
2.1.3 Different program versions........................................................................... 12
2.1.4 Program start................................................................................................ 14
2.1.5 Single workstation system............................................................................ 14
2.2 Network installation ........................................................................................... 14
2.2.1 Configuration requirements of the Windows network .................................. 14
2.2.2 Installation process....................................................................................... 15
2.3 Maintenance ...................................................................................................... 15
2.3.1 Data backup and data recovery ................................................................... 15
2.3.2 Tips, tricks and recommendations ............................................................... 16
2.3.3 Trouble-shooting .......................................................................................... 17

3 USER INTERFACE ..................................................................... 19

3.1 Menu.................................................................................................................. 20
3.2 Toolbars............................................................................................................. 21
3.2.1 Main window................................................................................................. 21
3.2.2 Subwindows ................................................................................................. 21
3.3 Explorer ............................................................................................................. 21
3.4 Statusbar ........................................................................................................... 22
3.5 Event list ............................................................................................................ 24
3.6 Shortcuts ........................................................................................................... 24

4 SYSTEM SETUP ......................................................................... 25

4.1 Windows system control.................................................................................... 25
4.2 Settings.............................................................................................................. 26
4.2.1 Local installation........................................................................................... 26
4.2.2 Global ........................................................................................................... 26
4.2.3 Workstations................................................................................................. 27
4.2.4 User profiles ................................................................................................. 27
4.3 Devices.............................................................................................................. 28
4.3.1 How to define devices .................................................................................. 29
4.3.2 Interface monitor .......................................................................................... 30
4.4 Workstations...................................................................................................... 30
4.4.1 How to define a workstation ......................................................................... 31
4.5 Event routing ..................................................................................................... 31

5 GENERAL FUNCTIONS ............................................................. 35

5.1 System access .................................................................................................. 35
5.1.1 Login............................................................................................................. 35
5.1.2 Logout .......................................................................................................... 35

3
Contents WinGuard User Manual

5.1.3 Change password......................................................................................... 35

5.1.4 Change profile .............................................................................................. 36
5.2 Printing functions ............................................................................................... 36
5.3 Help ................................................................................................................... 36

6 DATA SUPPLY............................................................................37
6.1 Overview............................................................................................................ 37
6.2 Commands ........................................................................................................ 38
6.3 Files ................................................................................................................... 40
6.3.1 Fundamentals............................................................................................... 40
6.3.2 File access.................................................................................................... 40
6.3.3 Datapoints .................................................................................................... 43
6.3.4 Persons ........................................................................................................ 50
6.3.5 User profiles ................................................................................................. 52
6.4 Graphic .............................................................................................................. 52
6.4.1 Overview....................................................................................................... 52
6.4.2 Graphics editor window ................................................................................ 53
6.4.3 How to administer graphic files .................................................................... 54
6.4.4 How to define the display window ................................................................ 55
6.4.5 Working with layers ...................................................................................... 56
6.4.6 Working with grids ........................................................................................ 58
6.4.7 How to insert objects .................................................................................... 58
6.4.8 How to edit objects ....................................................................................... 64
6.4.9 How to test a graphic.................................................................................... 64
6.4.10 Libraries........................................................................................................ 65
6.5 Text.................................................................................................................... 67
6.5.1 Overview....................................................................................................... 67
6.5.2 Text editor window........................................................................................ 68
6.5.3 How to administer text files .......................................................................... 68
6.5.4 How to insert objects .................................................................................... 69
6.5.5 How to process a text................................................................................... 75
6.5.6 How to test text............................................................................................. 76
6.6 Time definitions ................................................................................................. 77
6.6.1 Calendar ....................................................................................................... 77
6.6.2 Schedules..................................................................................................... 78
6.7 Lists ................................................................................................................... 80
6.8 Locations ........................................................................................................... 80
6.9 Sensor types...................................................................................................... 82
6.10 User defined surface ......................................................................................... 83
6.10.1 How to edit menus........................................................................................ 83
6.10.2 How to edit toolbars...................................................................................... 84
6.10.3 How to edit shortcuts .................................................................................... 85
6.10.4 How to edit commands................................................................................. 85
6.11 Rights................................................................................................................. 87
6.11.1 Overview....................................................................................................... 87
6.11.2 How to define rights...................................................................................... 88

7 WINGUARD IN USE ....................................................................91

7.1 Overview............................................................................................................ 91
7.2 Event processing ............................................................................................... 91
7.2.1 General functions for event processing........................................................ 93
7.2.2 Event list ....................................................................................................... 94
7.2.3 Event display ................................................................................................ 96
7.2.4 User alarm .................................................................................................... 98
7.2.5 Event simulation ........................................................................................... 99

4
WinGuard User Manual Contents

7.3 Device operation.............................................................................................. 100

7.3.1 Control graphics ......................................................................................... 100
7.3.2 Control panels ............................................................................................ 101
7.3.3 General control panel ................................................................................. 101
7.3.4 Camera control panel ................................................................................. 103
7.3.5 Intercom control panel................................................................................ 104
7.3.6 Control commands in the Datapoints explorer window.............................. 105
7.4 Documentation ................................................................................................ 105
7.4.1 Access to archive and logs ........................................................................ 105
7.4.2 Event archive.............................................................................................. 106
7.4.3 System log.................................................................................................. 108
7.4.4 Device log................................................................................................... 109
7.4.5 Reports....................................................................................................... 110
7.5 Other functions ................................................................................................ 111
7.5.1 Scheduled commands................................................................................ 111
7.5.2 Notification function .................................................................................... 115

5
WinGuard User Manual Introduction

1 Introduction
1.1 Field of application
The enormous range of various systems and installations used in modern buildings demands
a modern and holistic security concept. Only the effective interaction of all systems and a
standardised operating concept will permit maximum benefit and exclude security risks.
With its open system architecture specifically designed for heterogeneous environments,
WinGuard is the up-to-the-minute solution for this task. It integrates and interlinks safety and
building automation systems from a range of different manufacturers under a standardised,
user-friendly interface and serves as the central operating and control unit.
The linked installations remain autarkic systems but can be combined on a superordinate
level to relieve the operator.

1.2 Functioning
Incidents (alarms, faults, etc.) in the linked systems trigger corresponding events in
WinGuard. The events are saved in the order in which they reach the system, are displayed
in list form and can be selected for further processing.
One of WinGuard‘s essential tasks is that of providing the operator with comprehensive
additional information and assistance with regard to the individual events and supporting
him/her in performing the necessary steps.
• Therefore, each displayed event can be assigned both graphical and textual information
with hints and measures. Processing of the event is performed by interactively working
off the required measures and adding comments on the basis of the graphical and
textual information.
• Necessary commands such as switching cameras in the concerned area, switching
sensor groups, printing documents, dialling telephone numbers, sending information by
SMS etc. can be performed fully automatic or on request.
• A completely processed event as well as all commands and entered comments related
to it are saved in an archive. The archive can be accessed via variable filters, thus every
event in the archive can be completely redisplayed at any time.
• If the processing of an event cannot be completed immediately the event can be
“deferred” for later processing.

But event processing is only one of many features that WinGuard offers in supporting the
operator. In WinGuard, at predefined times, e.g. datapoints can be switched, reports can be
printed and any other command can be executed in the form of controlled sequences. The
state of datapoints and sensors can be clearly displayed and be influenced directly. All these
commands can also be performed using optional graphics and texts with interactive symbols.
A standardised operation of all linked installations is possible as well; optionally also via an
individual dialog provided by the interface module of the system.
All operator actions such as receiving or sending telegrams via the interface are saved in
logs. These logs can be displayed via adjustable filters and be summarised in freely defined
reports along with the information from the archive.

7
Introduction WinGuard User Manual

1.3 System concept

WinGuard is an open, modularly constructed system. A WinGuard installation can be
expanded step by step with additional workstations, interface modules and functional
modules, from a single user system up to a comprehensive network solution.

The devices to be connected can be linked with the WinGuard system via any workstation.
Up to four device linkages are possible per each workstation.
Each incoming event is transmitted to that workstation which is designated for its processing.
A parallel processing of events is possible as well. Then, an event is processed by that
workstation which has acknowledged it first.
The use of a dedicated file server is recommended for systems with more than two
workstations. For such systems, the use of a communication server for central device
linkage is recommended as well. Then, file and communication server form the autarkic
system core. Workstations can be enabled/disabled at any time without interrupting the
entire system.

1.4 Expansion stages

Security systems are connected to WinGuard via interfaces. Depending on type and
manufacturer, these devices may vary considerably. In order to enable WinGuard to
communicate with different devices, program modules are used which handle the specific
exchange of data on the interfaces and provide the necessary functions in a standardised
format that WinGuard uses internally. These program modules are also referred to as
interface modules. The functionality of the system is determined by the number and types of
installed interface modules.
In addition, the functionality can be expanded or reduced using optional functional modules.
Optional functional modules are, for example, event simulation, messaging (voice, fax, SMS,
e-mail), DWG/DXF graphics support and schedules module.
There are also differences in the number of workstations and monitors between:
• Single station systems
• Multiple station systems (network expanding module, workstation licenses)
• Single monitor / multiple monitor operation

8
WinGuard User Manual Introduction

1.5 System requirements

The following hardware and software requirements must be met by all servers / workstations:
• Standard PC from Pentium 4 / 2.8 GHz Processor (or comparable)
• 512 MB RAM
• Hard disk 40 GB
• CD-ROM drive
• Graphics card with at least 1024 * 768 pixels and 32MB RAM
• 17“ Monitor (19“ Monitor recommended)
• Sound card, loudspeaker
• Keyboard and mouse or touch screen
• Interfaces:
1 x Network connection (LAN / S-LAN / TCP/IP interfaces, e.g. OPC)
2 x USB Port
1 x LPT Port
1 x Com Port (serial interface for device linkage)
• MS Windows 2000 / Windows XP Professional pre-installed (installation of current service
packs is recommended).

The following options for the equipment of servers / workstations are possible:
• Windows network consisting of network cards for each workstation as well as network
cabling
• Modem (requires an additional serial interface) or ISDN card
• Graphics and log printer (require parallel, serial, USB or network interfaces)
• Four-port or eight-port interface card, serial (for additional device linkages)
• Video overlay card
• Second monitor for graphic display
• Removable hard drive, streamer and / or ZIP drive as backup system

9
Introduction WinGuard User Manual

10
WinGuard User Manual Installation and maintenance

2 Installation and maintenance

2.1 Installation of a WinGuard workstation

2.1.1 Installation process

For installing a WinGuard workstation, please proceed as follows:
Preparation
First, close all programs and make sure that, on Windows 2000 or Windows XP PCs, you
are logged in with administrator rights. Then, insert the WinGuard CD into the CD-ROM
drive.
The CD starts automatically and a dialog field appears showing, among others, details about
the program version and the release date of the CD.
Installing WinGuard
Click the Install WinGuard button or, if the CD has not started automatically, select the Run
menu item in the Windows start menu! Type the drive letter assigned to your CD-ROM drive
in the Open combobox, followed by “\SETUP.EXE“. If your CD-ROM drive is assigned the
letter “E”: enter “E:\SETUP.EXE“ and then click the OK button!
Interactive setup
The WinGuard installation program starts. All necessary entries will be made in dialog
windows. First, the Select a setup language window appears. Select the desired language
and confirm your entry with OK. In the subsequent windows you can select the buttons
Continue, Cancel and, if applicable, Back. Press Continue to complete the entry for the
currently displayed window. Click Cancel to finish installation after prompt for confirmation.
Use the Back button to reach the previously displayed window for checking or correcting
your entries.
Welcome
In the subsequently displayed Welcome window you are asked to continue installation. Click
the Continue button!
If WinGuard is already installed on your system you have here the possibility to change
installation. The following options are offered: Change program, Repair program and
Remove program.
Setup types
In the subsequently displayed Setup type window you can select which files should be
installed. In addition, you may here select the directory for the installation of WinGuard.
• Complete
If you select Complete as installation type all files will be saved on the hard disk of your
computer.
• User defined
If you select User defined setup type the Components window will open after clicking
the Continue button. Here, you can select which single files are to be installed. In
addition, you can select interfaces which should be installed. User defined setup type is
used, for example, for updating WinGuard to a new program version when Program
files and Devices are selected in the Components window.
• Target folder
Finally, you can specify a target folder for the installation of WinGuard on your local
workstation. The default target is “C:\Programs\WinGuard“. In order to change this

11
Installation and maintenance WinGuard User Manual

directory click the Search button; this will open a dialog which can be used to select
another directory.

After having selected the desired parameters, click the Continue button!
Click Continue button again!
Your selected installation settings will be displayed.
Check the settings! If they are OK start the installation with the Continue button!
After installation is completed it can be necessary to restart Windows. The installation
program indicates if a restart is necessary and, if desired, performs it for you.

2.1.2 Dongle
Before starting WinGuard for the first time, the supplied dongle must either be connected to
the printer port or to an USB port on your PC. After having connected the dongle to the
printer port, a printer can then in turn be connected to the dongle. This will not affect
functioning of the printer.
The dongle is required for determining the functionality of your WinGuard installation incl.
supported interface modules for device linkages. If your requirements grow you only need
the dongle to activate further program functions or to support further interface modules.

2.1.3 Different program versions

This manual describes the basic extent of WinGuard. Depending on your version, some
functions might not be available to you. There are differences in the maximum number of
datapoints and the optionally available functional modules. In addition, there is a special
version of WinGuard, the so-called WinGuard Light, which contains further special features.
You can display the functionality of your version by calling up ?|about.

2.1.3.1 Limitation of datapoint number

Datapoints represent all objects and datapoint groups defined in the system as well as their
subordinate sensors. If the maximum datapoint number is exceeded a corresponding hint will
be displayed when starting the system and the system will then start without working
interfaces.

12
WinGuard User Manual Installation and maintenance

2.1.3.2 Optional functions

Optional functions are:
Network
Supports an arbitrary number of workstations within a Windows network.
DWG / DXF
Supports the integration of DWG and DXF graphics.
Multiple monitor operation
Supports the operation with multiple monitors.
Event routing
Freely projectable routing of events to the different workstations within the network.
Notification function
Notifications can be sent between the workstations within the network.
Schedules
Calendar and schedules functions. Commands can be performed automatically at certain
times or time intervals. The behaviour of the system can be harmonised with schedules, e.g.
rosters or shift schedules.
User alarm
For each object, an alarm can be released manually from the user interface. This allows for
the consistent integration of special commands (for example notification of an alarm by
telephone) in the normal event processing process.
Event simulation
Offers the possibility to simulate any event in order to test the reaction of the system on
certain incidents. It can also be used for operator training.
Projecting
All editing functions (graphics editor, text editor, file editing etc.) are available. For the first
workstation of a WinGuard installation, this function is included in standard delivery. For
additional workstations, it is an optional function.

2.1.3.3 WinGuard Light

WinGuard Light is a special program version with a fix, not upgradeable, functionality. It
supports up to 1000 datapoints and only one interface module. Moreover, the control
function is limited to “acknowledge alarm” and “reset alarm”. Multiple station operation is not
possible. The other optional functions and the person file with flexible user management are
not available either. Instead of that, the three predefined user types “Administrator”, “Power
user” and “User” are offered. Each type is assigned a fix user interface. Login is made with
the Login at workstation dialog. Here you can select the user profile and enter the
password.
WinGuard Light user profiles:
User
The operator can only use a limited number of functions. He or she can get information
about the state of datapoints. Leaving the program is not possible.

13
Installation and maintenance WinGuard User Manual

Power user
The user interface for the Power User is similar to that of the User. But contrary to the User,
the Power User can view device logs and system logs and leave the program.
Administrator
The administrator can make use of all program functions of WinGuard Light. He or she can,
for example, edit and modify all program files. In addition, the administrator can determine
the passwords for the three user types.
In delivery state of WinGuard Light, all passwords are blank. The Define passwords dialog
window appears after having selected the System|Change password menu item. The
passwords for the three user types are then determined in the edit boxes User, Power user
and Administrator.

2.1.4 Program start

Your can start WinGuard either via the respective entry in the Windows start menu or via the
WinGuard icon on the desktop.
If, contrary to expectations, there should be problems which might be related to the dongle
you can check correct function of the dongle using a program which was saved in the control
panel during the installation of WinGuard. Call up the Windows control panel. There, you will
find the WIBU KEY program. Start this program and select the Test tab. To start the
functional test for the dongle, click the Start button! Should there be an error, the error
counter in the table element in the right column will be incremented and a signal will be
emitted by the loudspeaker of the PC. In this case, check again the correct connection of the
dongle.

2.1.5 Single workstation system

All the files which are required on the workstation are installed in the course of the
installation process mentioned before.
Check correct installation on the workstation by starting the WinGuard program!
Select the System/Settings menu item, start the Settings dialog, click the Local settings
folder and select Workstation type Standalone in the General area under System. Then
enter the respective name in the Workstation name field.

2.2 Network installation

If you want to use WinGuard in multiple workstation operation, you need to perform a
network installation for your system.

2.2.1 Configuration requirements of the Windows network

Network communication is done via TCP/IP. Therefore, the TCP/IP log must be installed on
all network workstations and each workstation must have a unique name within the network.

14
WinGuard User Manual Installation and maintenance

2.2.2 Installation process

For installing a multistation system in the network, proceed as follows:
Install WinGuard on each workstation as described above in section 2.1 Installation of a
WinGuard workstation.
All the files which are required on each workstation are installed in the course of this
installation process.
It is absolutely necessary that you install the same version of program files and interface
modules on each workstation. Otherwise, unpredictable problems may occur.
Check correct installation on each workstation by starting the WinGuard program!
First, log in as administrator on the server and then select the System|Settings menu item.
Then, click the Local Installation folder and select the System entry. During setup of the
server, make sure to enter the name of the computer (computer name or IP address) in the
Workstation name field under General. Select Server as Workstation type.
On the server, each workstation must be added under System|Workstations. To do so, call
up the System|Workstations menu item (see section 4.4 Workstations)! Select the
Workstations dialogue window and click the New button! Enter the name or the IP address
of the workstation in the Computer name field. For a client, you may select any name.
Specify a unique Number for the workstation. Confirm with OK! Enter all workstations in this
way!
Corresponding entries are then to be made at each client using the System|Settings menu
item in the Local installation folder under System in the General and Client settings
areas. Under Server Address, enter the computer name or the IP address of the WinGuard
server. Select Client as Workstation type and enter the corresponding name in the
Workstation name field.
Then, WinGuard must be restarted on all workstations to make the changes effective.
Quit WinGuard on all workstations and restart it!
The status indicators for all registered workstations should then appear in the statusbar of
each workstation.

2.3 Maintenance
As the database will continuously change during the use of WinGuard, a regular data backup
is recommended. Section 2.3.1 Data backup and data recovery describes this topic. In
section 2.3.2 Tips, tricks and recommendations, you will find tips for the work with WinGuard.
In case of problems with WinGuard, please refer to section 2.3.3 Trouble-shooting.

2.3.1 Data backup and data recovery

Usually, all data which are relevant for the use of WinGuard are saved in the subdirectories
of the WinGuard program directory. It should therefore be enough to perform a backup of
this directory and all its subdirectories in regular intervals. If you use additional files outside
these directories, e.g. ground plans in WMF format which are included by link, then you
should them backup as well.

15
Installation and maintenance WinGuard User Manual

The Backup dialog for data backup is called up by the System|Database|Backup

command.

The Restore dialog for data restore is called up by the command

System|Database|Restore.
If a backup becomes necessary due to data loss the further proceeding depends on the
current situation. Usually, a backup will restore the WinGuard program directory with all its
subdirectories to a current state. In cases where the data base WinGuard.mdb is damaged
and cannot be restored, it will be sufficient to copy only this file from the backup into the
original directory while leaving the other files unchanged. Thus, other files which have been
created or expanded after the last backup will not be overwritten.
Please remember when restoring data from a backup that files must not be write-protected
during the operation of WinGuard. For example, the writing of files on CD and the
subsequent import will create write-protected files. The write protections must then be
removed; an easy way to do this is, for example, by using the Windows Explorer as here it
is possible to remove write protection not only from a file but from complete tree structures.

2.3.2 Tips, tricks and recommendations

2.3.2.1 How to compress the database

The size of the WinGuard.mdb database grows in the course of time depending on the data
projected by you. You should therefore compress the database in regular intervals, for
example once per month and preferably directly after the creation of a backup copy. This is
done by means of the System|Database|Compress menu item. At the time of data
compression, it is advisable to have only that workstation active on which this command is
run.

16
WinGuard User Manual Installation and maintenance

2.3.2.2 How to save old archives and logs on external media

WinGuard administers system log and device log in the Log directory and the event archive
in the subdirectories of the Event directory. If you do not always need access to all old
events and logs, older archive and log files can be saved on external media.
The covered period of such a log file or subdirectory of the event archive can be recognised
from the respective name so that you can easily derive the files and directories that should
be saved on a backup medium. If you want to import backup files from external media please
make sure that they are not write-protected (see 2.3.1 Data backup and data recovery).

2.3.2.3 How to avoid link changes

Links play an important role in many functions of WinGuard. If a link target, for example a
graphic, is no longer existent a faulty behaviour may occur. Although WinGuard can
recognise when a link target does no longer exist and it can also inform the operator about
that but, of course, it cannot recognise when a link target was replaced with another one.
Here an example to illustrate this: Supposed that you assign an interface module to a device
number and then operate WinGuard with this configuration for a time. Then, some time you
release this number again and use it immediately or later for another interface module.
WinGuard will continue to function correctly but the event archive will show wrong results for
the period in which another interface module was projected under this number.
We therefore recommend to avoid such changes or to consider that a changed link may be
the cause of a surprising behaviour of the program.

2.3.3 Trouble-shooting

2.3.3.1 Printer does no longer work

If a printer does not correctly work with WinGuard, first remove the dongle and check
whether the printer functions correctly without dongle. This test can also be performed using
WinGuard since WinGuard also runs without dongle, however only as demo version.

2.3.3.2 No sounds after an update

The sounds used by WinGuard are registered in the Windows system. You can specify on
the Sounds tab of the Sounds and Multimedia program in the Windows system control
which sound file should be played for which event.
Although a new Sounds directory will be created if WinGuard is installed in another directory
during an update, the entries in the system control will be retained, i.e. the sound from the
directory of the previous installation will be used. If, however, this directory was renamed or
deleted the sounds will no longer be available. In this case, customise the WinGuard sound
assignment in the system control.

17
Installation and maintenance WinGuard User Manual

2.3.3.3 System settings have disappeared

If, after login, WinGuard does not function as it normally does and if, above all, the settings in
System|Settings seems to have disappeared, first check whether you are logged in as
another user than you normally are. In most cases, this is the cause of the problem as
WinGuard stores user-dependent settings in the Registry.

18
WinGuard User Manual System setup

3 User interface
The first window to appear in WinGuard is the main window with the name WinGuard. The
heading of the main window shows the name of the current display area.
A menu and a toolbar in the upper area are used to call up functions. The so-called explorer
on the left edge serves as central operating and control element. The lower area of the user
interface shows the statusbar with information about the status of the system as well as the
event list with all currently administered events. In the display area, one or more subwindows
can be opened. The appearance of the main window can be configured individually. You can
specify the appearance of the user interface for each user profile separately and you can
specify whether a menu and a toolbar should be displayed or not. In addition, you can define
menus, toolbars and shortcut keys which you want to use for each user profile and you can
determine their appearance and position in the main window. People with access to the
system, so called Users, are then assigned corresponding user profiles.
Example of a standard configuration:

Menu Toolbar

Explorer Display area

Event list Statusbar

19
System setup WinGuard User Manual

Example of a configuration which complies with the Austrian standard “Ö-Norm”:

Menu Toolbar

Explorer Display area

Multi-List

Statusbar

The following sections describe the individual elements of the main window in detail.

3.1 Menu
The menu entries are used to call up various program functions. If a menu is set for display it
will always be shown on the upper edge of the window. A user defined menu enables an
individual configuration of contents and arrangement of menu commands. For more
information, please refer to section 6.10.1 How to edit menus.
The menu can be operated with the mouse or the keyboard. For opening a submenu with the
keyboard, press <Alt> along with the letter that is underlined in the respective menu item.
The respective command will be executed after pressing the alphabetic key that is
underlined in the command.
During projecting, you can specify whether and which menus should be displayed. You may
either use a predefined standard menu or user defined menus. For more information about
the projecting of user profiles, please refer to section 6.3.5 User profiles.
Using the System|User interface command you can make the same settings for the current
session with regard to the menu as during the definition of user profiles.
Using the View|Menu command you can specify whether the menu bar should be displayed
or not. If the menu bar is visible the menu item will be checked off and the button will be
shown pressed in.

20
WinGuard User Manual System setup

3.2 Toolbars

3.2.1 Main window

The toolbar of the main window contains buttons which can be used to call up general
commands that are not dependent on the type of the displayed subwindows.
You can have displayed the toolbar of the main window on each edge of the window or even
in a separate window. With a user defined toolbar it is possible to individually configure the
number and arrangement of buttons. For more information, please refer to 6.10.2 How to edit
toolbars.
The toolbar can be moved with the mouse. To do so, click an area of the toolbar (between
beginning and end mark (two lines)) in which there are no buttons. Keep pressing the left
mouse key and move the pointer. During movement of the mouse pointer, the contours of
the toolbar will be visible. If you place the contours on an edge of the window and release
the mouse key the toolbar will be fixed to the respective edge. The toolbar can also be
moved and fixed to another area of the window. It will then be displayed in a separate
window which in turn will be put before all other windows on the screen.
During projecting, you can specify whether and which toolbars should be displayed. You can
also specify the position of the toolbar after login, the size of the buttons and how the text
should be displayed. You may either use a predefined standard toolbar or user defined
toolbars. For more information about the projecting of user profiles, please refer to section
6.3.5 User profiles.
The definition of the toolbar can be made with the System|Settings command.
Using the View|Toolbar command the visibility of the toolbar can be switched on or off.

3.2.2 Subwindows
Each subwindow displayed within the main window is also equipped with a toolbar for calling
up all essential functions of the subwindow. These toolbars can also be moved with the
mouse and fixed to the edges of the subwindow or, alternatively, positioned as separate
windows.
All subwindows can either be closed with the Close window button in the toolbar or with the
<Strg>+<F4> key combination.

3.3 Explorer
Many program functions cannot only be selected by menus and toolbars but also by means
of special explorer windows in the explorer. They facilitate operation of the program by
providing, for example, hierarchic displays, Drag & Drop mechanisms, clear display of device
states and direct control.

21
System setup WinGuard User Manual

Examples of explorer windows:

These illustrations and the illustrations at the beginning of section 3 User interface show
examples of the explorer. Each opened explorer window contains a title bar that is always
visible. Clicking the window name in the title bar will open the appropriate active explorer
window. In addition, the title bar of the Locations, Datapoints, Persons and Graphics
explorer windows contain buttons that can be used to execute individual commands or
define settings for the window.
Explorer windows which should be shown in the explorer can be defined either in the
View|Explorer window menu or in the context menu which opens by right mouse clicking
on any title bar or – if no explorer window is currently open – on the blank explorer. In the
context menu, you can only select those subwindows which can also be accessed via the
menu.
Using the View|Explorer command the visibility of the explorer can be switched on or off.
An explorer window can be closed by clicking the window symbol in the left corner of its title
bar. This is signalised by a red “X“ when moving the mouse over the symbol.

3.4 Statusbar
The statusbar gives information about the current state and settings of the system. In
addition, menu commands and functions can directly be executed by clicking some of the
fields.

22
WinGuard User Manual System setup

If you move the mouse pointer over a button in a toolbar or over the entry in a menu a short
help text will be displayed in the left area of the statusbar describing the function of the
button or the menu entry.
The statusbar contains the following elements:
• Printer selection
Here, the name of the currently selected printer is displayed. Clicking the field opens a
popup menu which can be used to directly change this selection.
• Local device, device within the network
Depending on settings, there is either a corresponding field with the name of the device
for each projected device or a common field for all devices. The cable symbol on the
lower edge identifies devices that are not connected to the local workstation but to a
workstation within the network. If a device does not work properly the corresponding
symbol will be marked with a red cross.
If there is a common field for all devices, this field will be named SST. In this case, a
crossed symbol indicates that at least one device does not work properly. Clicking the
field will open a popup menu which shows the state of all projected devices.
• Local workstation, workstation within the network
Depending on settings, there is either a corresponding field with workstation number for
each projected workstation or a common field for all workstations. The cable symbol on
the lower edge identifies the non-local workstations within a network. If there is no
connection to a workstation within the network, for example because it was switched off
or WinGuard was not started on that system, the respective symbol will be marked with a
red cross.
If there is a common field for all workstations, this field will show the current workstation.
Clicking the field will open a popup menu which shows the state of all workstations within
the network and, in addition, the identifications of the users currently logged in.
However, workstation fields have a further meaning. A blinking yellow envelope in the
symbol of the local workstation indicates the presence of unread notifications. In
addition, you can directly open the Notification control panel by clicking one of the
workstation fields. If there is a common field for all workstations, select the respective
workstation in the popup menu.
• Username
Here, the name of the currently logged in user is displayed. In addition, you can directly
call up the Login at workstation dialog by clicking this field.
• Time
Finally, the toolbar in the far right field gives information about the current date and time.
During projecting, you may specify for each user profile whether the statusbar should be
displayed or not. For more information about the projecting of user profiles, please refer to
section 6.3.5 User profiles.
The necessary settings can be made with the System|Settings command.
Using the View|Statusbar command, the display of the statusbar can be switched on or off.

23
System setup WinGuard User Manual

3.5 Event list

The event list is positioned in the lower area of the WinGuard window. It contains the list with
all events that are currently present in the system. The list also contains a number of buttons
that are required for processing events. For more information about the handling of the event
list and the processing of events, please refer to 7.2.2 Event list.

The size of the event list can be changed at any time by dragging with the mouse. During
projecting, you can specify for each user profile the settings for the display of the event bar.
For more information about the projecting of user profiles, please refer to section 6.3.5 User
profiles. Below the event list is a bar with state counters indicating the number of those
datapoints that are in the corresponding state.
The necessary settings can be made with the System|Settings command.
Using the View|Event list command, the visibility of the event list can be switched on or off.

3.6 Shortcuts
Shortcut keys are not visible components of the user interface. A shortcut is a key or a
combination of keys assigned to a function that activates this function in WinGuard via the
keyboard.
One set of these shortcuts is always active in WinGuard, thus specifying the function of the
keyboard on the user interface. In user defined sets, the functions assigned to shortcuts can
be freely defined. For more information, please refer to 6.10.3 How to edit shortcuts.
During projecting, you can specify for each user profile which set of shortcuts should be
active. You can either use a predefined set of standard shortcuts or the user defined sets of
shortcuts. For more information about user profiles, please refer to 6.3.5 User profiles.

24
WinGuard User Manual System setup

4 System setup
WinGuard is an open and widely configurable system that can be adapted to various
requirements. This adaptation is performed from the WinGuard user interface after
installation of the program. The System menu includes all functions that are required to
make the necessary settings.

4.1 Windows system control

The System|System control command from the WinGuard user interface calls up the
Windows system control in which Windows system settings can be performed. These are
some of the programs that are of special interest for WinGuard:
Date/Time
Here, you can set the time of your computer.
Sounds and Multimedia
The Sounds tab is used to determine which audio files should be played with certain events
in WinGuard. In older Windows versions, these settings can be performed in the system
control under Acoustic signals.
The following sounds are defined in WinGuard and can be selected.
• Alarm – Continuous tone
This sound is played as a sound loop for an incoming alarm event that is displayed
immediately.
• Alarm – Hint
This sound is played for other types of incoming alarm events.
• Fault – Continuous tone
This sound is played as a sound loop for an incoming fault event that is displayed
immediately.
• Fault – Hint
This sound is played for other types of incoming fault events.
• Event – Continuous tone
This sound is played as a sound loop for other types of incoming events which are
displayed immediately.
• Event – Hint
This sound is played for all other types of incoming events.
• Notification – Continuous tone
If a notification is received from another workstation while the Notification control
panel is not being displayed this sound is played as a sound loop.
WIBU-KEY
Here, you can check the function of the dongle supplied with WinGuard and, if necessary,
set some configurations. For more details about this topic, please refer to the online help of
the program.
For more information about the functions of the system control, please refer to the
documentation for your Windows version.

25
System setup WinGuard User Manual

4.2 Settings
Selecting the System|Settings menu point opens the Settings dialog which is used to
determine the basic settings of the WinGuard system. The settings that should be edited can
be selected by using the explorer on the left side of the dialog. Below the settings area is an
information field which shows additional information about the selected entry.

4.2.1 Local installation

The Local installation area is used to perform general settings for the local client. The
respective subitems System, Database and Current User are used, for example, to perform
settings for the workstation, the network and the database. If automatic login is selected in
the definition for the current user WinGuard will start with the corresponding rights of the
user.
Be cautious with the use of this option! Each person with access to the computer has also
access to WinGuard. We therefore recommend to register only users with minimal rights for
this option, or otherwise to protect Windows itself by passwords.

4.2.2 Global
Here, you can define the global, system-wide settings for all users. The definition for the
settings is divided in the areas System, Desktop, Explorer, Event list, Event handling,
Graphic, Video, Intercom and Messaging. Most of these settings can individually be
configured for workstations and user profiles.

26
WinGuard User Manual System setup

Possible settings in those ranges:

• System
General, queries, subdirectories, sounds, other
• User interface
General, two screen mode, menu, toolbar, shortcuts, statusbar, tooltips
• Explorer
General, locations, datapoints, state counter 1, state counter 2, state counter 12,
subcounter colours
• Event list
General, design, list 1, …, list 12
• Event handling
General, event window, event routing, archiving
• Graphic
Display, editor, default animation, DWG/DXF support
• Video
Control panel 1, control panel 2, overlay
• Intercom
General
• Messaging
SMS, pager, voice, fax, e-mail

4.2.3 Workstations
Most of the settings that should be defined here are already predefined by the settings from
the Global area. These inherited settings can here be changed or adapted for the
Workstations.
After selection of an entry, the Options inherited selection element will appear in the lower
area of the dialog if settings are inherited from the global definition. By deselecting the
inheritance, the settings for the whole area can be locally adjusted. Additional information
about the selected elements will be shown in the lower area of the dialog.
All areas that are adjusted to inheritance are grayed out and cannot be changed.
The settings for the Automatic backup that are included in the System area do not contain
settings from the global definition. These settings must here be defined for the respective
workstations.

4.2.4 User profiles

The User profile area is used to define user-specific settings. Here, all settings are
predefined.
After selection of an entry, the Options inherited selection element will appear in the lower
area of the dialog if settings are inherited from the global definition. By deselecting the
inheritance, the settings for the whole area can be locally adjusted. Additional information
about the selected elements will be shown in the lower area of the dialog.
All areas that are adjusted to inheritance are grayed out and cannot be changed.

27
System setup WinGuard User Manual

With a user profile, you can determine dedicated access authorisations and define the
appearance and behaviour of the WinGuard user interface for a person or a group of
persons. A user profile is defined via a data record in the User profile file. Each person with
access to the system can be assigned one or more user profiles (see 6.3.4 Persons). Upon
login in WinGuard (see section 5.1.1 Login) the person can select one of the assigned user
profiles; the standard profile of the person is the default profile. The selected profile will then
determine the access authorisations as well as the appearance and behaviour of the
program surface.
The Database|User profile command calls up the User profile window. This is a window for
processing files; its basic functions are described in section 6.3.2 File access.
In WinGuard, user profiles are not administered on the basis of their names but via an
internal, unique identification number. Thus, the name of a user profile can also be changed
subsequently without affecting the functionality of the program. But please consider that the
deletion of a profile cannot be undone by creating a new profile with the same name as this
would result in two different profiles with different internal identification numbers.

4.3 Devices
Security systems are connected to WinGuard via interfaces. Depending on type and
manufacturer, these interfaces may vary considerably. In order to enable WinGuard to
communicate with different devices, program modules are used which handle the specific
exchange of data on the interfaces and provide the necessary functions in a standardised
format that WinGuard uses internally. These program modules are also referred to as
interface modules.
WinGuard cannot recognise automatically which devices are connected to the individual
workstations. The interface modules that should be used must therefore be installed and
setup.
To do so, call up the System|Devices menu command. In the appearing Devices dialog you
can administer the used interface modules.

28
WinGuard User Manual System setup

The table of the dialog will show all interfaces that are defined in the system along with the
following information:
The first column contains the reference number (RefNo.) assigned to the device. A device is
system-wide identified by its reference number. The Name column contains the text that you
assigned to the device. The Module column shows the name of the used interface module.
And the Connection column shows the name of the workstation that is used to connect the
respective device to the system.
The editing functions Add, Change, Remove and Setup are used to setup the devices in
the system.
The following functions are additionally available:
• Monitor
With interface modules for the serial interface, this button can be used to open a window
that enables you to track, print and save the data traffic via the interface in a text file and
use the data as supporting evidence during start-up and trouble-shooting (see section
4.3.2 Introduction). This monitoring however is only possible on that workstation which
the device is actually connected to.
• Control panel
Some interface modules offer an individual control panel for accessing interface-specific
functions. Click this button to call up the Device control panel.
You can also create your own command (see 6.10.4 How to edit commands) for calling
up the Interface control panel and then add it to the used menu toolbar.
• Projecting
With some interface modules, it is possible to have datapoints automatically created in
WinGuard or to check an existing supply for consistency. These measures are then
controlled via a projecting dialog that is provided by the interface module. If an interface
module offers automatic projecting the corresponding dialog can be called up with this
button.
• Module restart
After clicking this button, the device will be reloaded at the respective workstation and
device administration will be restarted in the same manner as with initial startup of the
program.
• Complete restart
After clicking this button, all devices at all workstations will be reloaded and the device
administration will be restarted in the same manner as with initial startup of the program.
A restart is necessary after having modified the device configuration. The changes will then
be applied by the system. This also applies to modifications in the assignment of control
rights.

4.3.1 How to define devices

For Adding or Changeing a device, select the Devices dialog and then call up Define
device. Here, you can enter all the data necessary for defining a device.

29
System setup WinGuard User Manual

A device is system-wide identified by its reference number (RefNo.). You can select any
number that it is not yet assigned to another device. The Module field is used to assign the
device an interface module. In the Connection range you can specify the workstation which
the device should be connected to. The Name field serves for information purposes only and
is used, for example, for display in the statusbar.
By assigning rights classes to a device, the Control right for this device can be limited to
these rights classes (see 6.11 Rights). This edit box shows the assigned rights classes.
Settings are changed with the button right beside the edit box.

4.3.2 Interface monitor

Clicking the Monitor button in the Devices dialog opens a window with the name Interface
monitor <n> (<n> stands for the number of the device). Here, the data traffic via the device
can be tracked and used as supporting evidence during start-up and trouble-shooting.
Printing and saving of the data is possible as well.
In the left area of the window, the bytes are shown as a hexadecimal number and the right
area shows the respective ASCII presentation form. In order to be able to differentiate
between received and sent data, received data are displayed inverse – i.e. white letters on
black background.

4.4 Workstations
If you operate WinGuard within a network several computers are linked via the network.
Each of these computers which we refer to as workstations must be registered once in the
WinGuard system.
Selecting the System|Workstations menu point opens the Workstations dialog which is
used to administer the workstations. The table shows all the workstations that are defined in
the system.

30
WinGuard User Manual System setup

The entries can be edited using the functions New, Edit and Delete (see section 4.4.1 How
to define a workstation).
After each modification of the workstation configuration, WinGuard must be restarted to
make the changes effective.
Clicking this button opens the Net monitor window. In this window, the network
communication can be tracked for test purposes.

4.4.1 How to define a workstation

The Define workstation dialog is called up from the Workstation dialog when a workstation
is being newly created or changed and serves for entering the necessary workstation data.

Here, a Number is entered for unique identification of the workstation. This number can be
assigned only once in the system. The Name of the workstation is entered as well. This
name is freely selectable. It is recommended, however, to use the name of the respective
workstation computer. This name can be detected by calling up the Windows system control.

4.5 Event routing

If you use WinGuard as multiple station system you can determine the routing of the
incoming events to the individual workstations. This assignment is done by means of the
event routing. If the event routing is not specified all events will, by default, be routed to
workstation 1 and be displayed there.

31
System setup WinGuard User Manual

Calling up the System|Event routing command opens the Commands for event routing
window. This window is used to enter text; its appearance and function are quite similar to
those in WinGuard text editor but the toolbar does not include all commands of the text
editor.
In the Commands for event routing window you automatically edit the Eventrouting.wgt
text file in the Texts\Commands subdirectory. These data can also be edited after having
loaded them in the text editor. For a detailed description of all functions in the text editor,
please refer to section 6.5 Text.
The Eventrouting.wgt text file is used to determine commands for incoming events.
Therefore, the most important objects required for this text are conditional elements and
commands. Functions for adding and editing these objects are available in the toolbar.

Using the Text|Insert|Conditional element commands, conditional elements can be

inserted in the text. For more information about conditional elements, please refer to section
6.5.4.9 How to insert conditional elements.
Clicking the If button or calling up the menu command displays the Condition Properties
dialog window. For more information about this dialog window, please refer to section
6.5.4.9.2 How to define conditional elements.
An If element is created by selecting the If checkbox in the Type area in this dialog window.
With the four comboboxes on the right edge of the window you can define a condition and
accept it by using the <<and / <<or button. A condition for the event routing can, for
example, be used for assigning certain alarm types to certain workstations. For this purpose,
use a query like this
If Variable Status type == Alarm
The assignment can also be made in dependence of the type of the reporting object.
If Variable Object type == Fire
Or events of individual datapoints can be clearly assigned to certain workstations.
If Variable Object t == Group 1
For more information about the creation of conditions, please refer to section 6.5.4.9.2 How
to insert conditional elements.
Using the End element you can select the end of the text parts of a condition. If the condition
does not apply, and therefore other parts of the text should be performed this other text block
is determined using the Else element.
Using the Text|Insert|Command element, commands can be inserted in the text. WinGuard
always executes such commands during the working off of a text. After selecting the button
or menu item the Command Properties dialog window will open. The command which
should be inserted can then be selected in the Function area.
For example, for allocating events to a workstation use the Choose workstation command.
The then appearing combobox will show all projected workstations so that you can select
one of them.

32
WinGuard User Manual System setup

If several Choose workstation commands are performed within a text only the last
command will be effective.
In addition to determining a workstation for an event you can use the Notify workstation
command to inform any desired workstation about this incoming event.
There are two other sensible commands in event routing: Print text and Print graphic. In
this case, you can enter „<TEXT>“, „<GRAPHIC1>“, „<GRAPHIC2>“ … up to
„<GRAPHIC5>“ instead of a file in order to print the documents related to the currently
reporting object.
Other commands like, for example, sending a switching command etc. can also be inserted
in the event routing. All WinGuard commands are available. For more information about this
topic, please refer to section 6.2 Commands.
When closing the window, all modifications on the text for event routing will be saved
automatically.

33
System setup WinGuard User Manual

34
WinGuard User Manual General functions

5 General functions
5.1 System access
After starting WinGuard, a strongly simplified user interface will be displayed initially. No
menu is available. Using the four buttons on the top edge of the window, you can only
register, finish the program and call up program information or help texts.
Access to further functions is only possible after registration of a user. For this purpose,
identifications and passwords are assigned to the users of the system. They are defined in
the Persons file (6.3.4 Persons) which is used to administer all personal data. If a person is
assigned an identification and a password in this file he or she can login with them in
WinGuard.
WinGuard uses profile-dependent surfaces and access rights. In the User profile file (see
6.3.5 User profiles) you can define individual profiles and assign one or more profiles to each
user. Each profile defines a specific user interface and specific access rights. During login,
the user can choose from these profiles. If a user has not be assigned a profile a predefined
standard user interface with standard access rights will appear after login.

5.1.1 Login
Login in WinGuard is performed by selecting the System|Login command or by clicking the
field with the key symbol in the statusbar. The Login at workstation dialog will open.
Enter your user name in the User field and your password in the Password field. Under
Profile you can select one of the user profiles which have been assigned to you (or your
identification).
If the program is newly installed you can login without entering an identification or password.
The example data contain a person with the identification “00000000“ and a blank password.
This person has the highest access rights. This means that you as administrator have to
assign an identification and a password to yourself and delete the above mentioned example
person from the Persons file afterwards. You have to remember your password because if
you enter it wrong you will not be able to access the system with administrator rights.

5.1.2 Logout
A logged in person can log out at any time. This is done with the System|Logout command.
After selecting this command, the user interface will be displayed just as it appears when
starting the program. A user does not have any access to further functions of WinGuard. If a
person leaves the workstation he or she should log out. This avoids that unauthorised
persons could access the system.

5.1.3 Change password

A user can change his or her own password for login in WinGuard at any time. For this
purpose, select the System|Change password command which will open the Change
password dialog window.
Enter your previously valid password in the Old password field and the new password in the
New password and Repeat new password fields.

35
General functions WinGuard User Manual

5.1.4 Change profile

If the current user is assigned more than one user profiles (see 6.3.5 User profiles) the
desired profile can be selected using the System|Change profile command.

5.2 Printing functions

The contents of most of the subwindows can at any time be exported to a printer. For this
purpose, WinGuard uses the normal mechanism for printing under Windows.
Selecting the System|PrintSetup command calls up the PrintSetup standard dialog which
is available in any Windows application. In this dialog window, you can modify the
presettings for the printer and determine the paper and format that should be used.
The name of the currently selected printer will be shown in the status bar next to the symbol.
Clicking this field opens a popup menu which also allows a modification of the printer
presettings.
The System|Print preview command leads you to the print preview. There, you can see
what your pages of the document would look like when being printed on the currently
selected printer. You can scroll through the pages, increase their size or start printing, if
desired.
Selecting the System|Print command starts printing on the currently selected printer without
further prompt for confirmation. This is the print command which is included in the standard
toolbar.

5.3 Help
WinGuard provides an extensive online help. Selecting the ?|Online help command or <F1>
calls up the online help. In the table of contents in the left area of the window you can select
the topic you are interested in or browse for keywords. Calling up the online help with the
<F1> button will automatically show the section which fits to the respective program context.
For example, if you open the online help while a dialog window is open the online help will
show that section which describes the respective dialog window. If you click a button the
online help will show the description of this command, and so on.
The online help has been conceived as modern HTML help. Therefore, Internet Explorer
from Version 4.0 must be installed on your computer.
Finally, you can display an information window about WinGuard using the ?|about
command. This window will show, among others, the functionality and the version number of
your installation.

36
WinGuard User Manual Data supply

6 Data supply
6.1 Overview
A system such as WinGuard obtains the majority of its functions through the supply of data –
or projecting, as it is also called. Although WinGuard communicates with the linked systems
and accepts their events without your help, you have to advise the system about its expected
behaviour in reacting on such events, in displaying information, in reacting automatically etc.
This is the basis for the future function of the system. Therefore, a large part of the
investment costs for a device are associated with data supply and data administration.
During the development of WinGuard, much importance was attached to a simple and
effective data supply and data administration. Two important factors are a program surface
with intuitive operation and a clear organisation of the database. With regard to these topics,
WinGuard offers a high amount of flexibility, thus providing an effective solution for different
applications.
In order to be able to use WinGuard in a correct and optimal way, it is essential that you
become familiar with the available functions. Especially those faults that are made at the
beginning can hardly be corrected in later use. Before supplying data, please read this
section of the manual carefully. First, experiment with the supply of some sensor groups and
only then start with the entry of extensive data amounts.
The data supply can be divided into three large main areas.
• Files
Files contain, among others, the definition of the persons and datapoints administered
by the system. For more information about this topic, please refer to section 6.3 Files.
• Graphics
Graphics can be assigned to datapoints and inform about their location during incoming
events. Equipped with animated symbols and interactive buttons, graphics can be
implemented as a universal means for information and controlling. For more information
about graphics, please refer to section 6.4 Graphic.
• Texts
WinGuard uses texts in varied ways. As pure text, for example, they inform about the
necessary measures in case of an event; equipped with corresponding fields they serve
as a form for entering information and with inserted conditions and commands they
control and automate the program behaviour. For more information about texts, please
refer to section 6.5 Text.
During data supply, you will often see the concept of “Commands” which is used for starting
functions. Commands are, for example, saved in the buttons of graphics and texts. They can
be directly inserted in texts and can also be used for defining self-defined commands.
Commands are always defined in the same manner. An introductory survey on this topic is
included in section 6.2 Commands.
The other sections about data supply describe the creation of elements for use in the text
(6.6 Time definitions, 6.7 Lists), the location register for the arrangement of datapoints (6.8
Locations), the definition of sensor types (6.9 Sensor types), the creation of elements for the
user defined interface (6.10 User defined surface) and the rights administration (6.11
Rights).

37
Data supply WinGuard User Manual

6.2 Commands
Commands are a unified concept and any program function in WinGuard is executed using
such a command. They are used at different points in the program. Commands are for
example saved in buttons in graphics and texts. They can also be used as elements and be
directly inserted in texts.
Then, such command texts can, for example, be used as scheduled commands that are
executed once at a certain time or in certain time intervals (see 7.5.1 Scheduled commands)
or serve for defining reactions during the reception and processing of events either at the
datapoint itself or in the superordinate event routing (see 4.5 Event routing).
And commands can also be used to define commands that can be called up from the
WinGuard user interface via user defined menus, toolbars and shortcut sets (see 6.10.4 How
to edit commands).
In WinGuard, commands are always defined in the same manner. Supported commands can
be selected from the Command combobox. The windows for entering command parameters
may vary depending on the selected command.
Please consider that not all of the commands can be used in any context. For example, it
doesn’t make sense to show text in event routing, and so on.
Survey of the available commands:
• No command
No command will be executed.
• Control datapoint
A switch command for a datapoint will be executed in a similar way as via the General
Control Panel.
• Send voice message
A voice message will be sent to the telephone number of a person who is registered in
the person file.
• Send SMS
A SMS message will be sent to the telephone number of a person who is registered in
the person file.
• Send Fax
A fax document will be sent to the telephone number of a person who is registered in the
person file.
• Send Email
An e-mail will be sent to the e-mail address of a person who is registered in the person
file.
• Send to Pager
A notification will be sent to the telephone number of a person who is registered in the
person file.
• Switch text
A different text file will be shown in the text display.

38
WinGuard User Manual Data supply

• Show text
With this command, you can have displayed a text field. The size of the text field is
determined by the number of characters; once you press a key or the mouse button, the
text field will be closed again. You can use this command to display certain additional
information which is not to be shown in the graphic or text itself.
• Execute text
WinGuard texts may contain commands. If you execute a WinGuard text, all commands
contained therein will be performed in succession. Thus, using a single command, you
can automatically execute several predefined commands in succession.
• Print text
A text file will be printed on the selected printer.
• Switch graphic
A different graphic file will be shown in the graphic display.
• Print graphic
A graphic file will be printed on the selected printer.
• Show graphic
The corresponding window will show a graphic file as information graphic or control
graphic. This window will be opened, if necessary. But the Event display window will be
closed automatically.
• Print documents
With this function, you can print texts and graphics. When entering file names, please
separate them with a comma.
• Execute menu command
Any menu command will be executed.
• Change user profile
The current user profile will be changed.
• Start application
Any application program (.exe) will be started.
• Show control panel
The Device Control Panel for a device will be displayed or closed provided that the
respective interface module offers such a control panel.
• Create report
A report will be opened in a new window.
• Generate event
An event will be generated.
• Event Simulation
This command corresponds to the Generate event command but the generated
command will be marked as simulation.
• Choose workstation
The current event will be assigned to a workstation. This command has only a function in
the text for event routing (see 4.5 Event routing).

39
Data supply WinGuard User Manual

• Notify workstation
Analogous to the Choose workstation command, you can here determine an additional
workstation at which the event will be signalised by an audible signal and be shown in
the Event display window.
• Ignore event
Here, the incoming event will completely be ignored and none of the commands defined
at the datapoint will be executed.
• Delete event
The event will normally be created and the commands defined at the datapoint will be
executed; afterwards, the event will directly be moved to the archive without further
prompt for confirmation.
• Don’t save event
The command for an event will be executed; afterwards, the event will not be archived
but deleted completely.
The Send Fax, Send Email, Send SMS and Send voice message functions require a
messaging interface module installed in the system. In addition, the number of this interface
module must be entered in the Global|Messaging range under System|Settings. The
system will then forward the commands for transmitting the data to the respective module.
For more information about the functionality, please refer to the description of the messaging
module.

6.3 Files

6.3.1 Fundamentals
WinGuard administers a part of the project data in a database. Thus, for example,
information about the projected datapoints, persons and user profiles are saved in the
database. The database is a file in Microsoft Access format. This WinGuard.mdb file is
contained in the Data subdirectory. With a multiple workstation installation, the database –
and all other files – will be centrally administered at one workstation.
From the view of the user, the project data saved in the database can be divided into three
main areas which in the following will be referred to as Files. In the Datapoints file, all
sensor groups, cameras, intercoms etc. that are managed by WinGuard are being projected
and administered in a standardised manner (see 6.3.3 Datapoints). In the Persons file, the
data of all persons who are in contact with WinGuard are saved (see 6.3.4 Persons). And in
the User profile file (see 6.3.5 User profiles) you can define individual user profiles. Each
profile defines a specific user interface and specific access rights. Each user can be
assigned one or more profiles.

6.3.2 File access

In WinGuard, the work with files is based on a unified concept; the database can be
accessed with optional use of the explorer (see 6.3.2.3 File access using the explorer).
The window for editing the desired file is called up via the respective entry in the Database
main menu. This window will first show a table view with a listing of all datasets contained in
the file. For editing an existing dataset or creating a new dataset, switch to form view. The
contents of the local toolbar related to this window depends on the currently selected view.

40
WinGuard User Manual Data supply

6.3.2.1 Table view

In table view, the window contains a listing of all datasets in table form. Each line of the table
represents a dataset, i.e. an entry of the file. The table columns show a part of the field
contents of the respective dataset. The fields are designed in a way to show the user the
essential information about the dataset and to enable him or her to clearly identify the entry.
By clicking the heading of a table column, the lines in this column will be sorted in ascending
order.
You can select an individual dataset by clicking the respective line of the table with the
mouse pointer. The background colour of the selected line will change to blue.
The appearance of the toolbar partly depends on the processed file but the following buttons
for calling up standard commands are always available.
• Edit <Enter key>
With this command, you can edit the dataset selected in the table. This function can also
be called up by double clicking the desired dataset in the table view. After calling up the
function, the appearance of the window will change: The window switches from table
view to form view where an input mask will be displayed. The field contents of the
selected dataset are preset in the respective edit boxes. But you can change them.
• Previous dataset / Next dataset
For navigating in the table view, use these two buttons or the cursor keys.
• New
With this button, you can create a new dataset. The window also changes to form view;
first, the fields of the input mask are blank or initialised with default values. You can
complete the fields and change the default contents.
• Copy
This button creates a copy of the current dataset (for reasons of clearness, slight
modifications of key fields may occur) and changes to form view where this copy can be
edited. This enables easy creation of a new dataset whose contents is, for the most part,
identical to an already saved dataset.
• Delete <Del>
With this button, you can delete the dataset marked in the table. For safety reasons, a
prompt for confirmation will be shown.

6.3.2.2 Form view

In form view, the window shows an input mask which is used for entering or changing values
of the dataset. The appearance of the input mask depends on the currently processed file.
The following descriptions will give you an overview of the functions which support an explicit
or implicit saving of the current dataset in the database. Such a saving is only possible if the
dataset meets certain criteria. For example, some edit boxes must not be blank. In addition,
some field contents of different datasets must be unique. For example, the name of a
datapoint may be assigned only once for each datapoint type. A corresponding hint dialog
will be displayed in cases where saving is not possible. Before exiting the dataset you have
to make corresponding corrections, press the Undo Modifications button or remove the
dataset by means of the Delete button.

41
Data supply WinGuard User Manual

The appearance of the toolbar partly depends on the processed file but the following buttons
for calling up standard commands are always available.
• Table view
The data of the current dataset are saved in the database without further prompt for
confirmation and the window switches to table view.
• Previous dataset / Next dataset
With these two buttons, you can switch to the previous or next dataset in the table view.
The data of the current dataset are saved in the database without further prompt for
confirmation.
• New
First, the data of the current dataset are saved in the database without further prompt for
confirmation. Then, a new dataset whose fields are partly initialised with default values
will be created. This dataset will be displayed in form view.
• Copy
First, the data of the current dataset are saved in the database without further prompt for
confirmation. Then, a copy of the current dataset will be created (for reasons of
clearness, slight modifications of key fields may occur). This dataset will be displayed in
form view.
• Delete <Del>
With this button, you can delete the currently displayed dataset from the database. For
safety reasons, a prompt for confirmation will be shown.
• Undo modifications
All modifications which have been made since the last saving will be undone. This
function is only available if at least one modification was made.
• Save
The current dataset will be saved in the database. This function is only available if at
least one modification was made since the last saving of this dataset.

6.3.2.3 File access using the explorer

You can access a file of the database through the explorer by opening the window related to
the file in the explorer. Just as in table view, this window shows all entries of the database
but some files will be displayed in a hierarchic structure. A special case is the Datapoints
file; here, the explorer window does not only enable the selection of all datasets but also the
direct selection of the individual sensors of the sensor groups datasets.
Just as in table view, an entry can be selected for editing in form view by double clicking.
And you can navigate in the explorer window using the cursor keys or select the current
entry (with a blue background) for editing by pressing the Enter key.
If, during the display of a dataset in form view, another dataset is selected for display in the
explorer window, the currently displayed dataset will, if possible, be saved without further
confirmation (see section 6.3.2.2 Form view).
The selection of a dataset in table view in a file window may be identical to the selection of a
dataset in the explorer window, i.e. when selecting a dataset in the explorer window, this
dataset will automatically also be displayed in the file window and vice versa.
In the explorer window, a context menu can be opened for each dataset entry by clicking the
entry with the right mouse button. There, you can also select the New, Copy and Delete
functions described in section 6.3.2.2 Form view. Selecting the Editing function in the
context menu corresponds to a double click on the dataset entry, i.e. the file window will be
opened (if it is not yet open) and switch to form view.

42
WinGuard User Manual Data supply

6.3.3 Datapoints
In addition to sensor groups, WinGuard also administers other devices like, for example,
cameras, intercoms, doors etc. In WinGuard, all these devices are referred to as Datapoints
and they are all defined in the Datapoints file.
Sensor groups are the most important element of these datapoints. They project datapoints
like, for example, sensor groups by creating a separate dataset for each datapoint. The most
important specification – in addition to datapoint type and datapoint name – is the link, i.e.
the information about how the data of the datatpoints can be received or sent. Moreover, you
can specify which graphic and text document should be displayed when an event is received
or which commands should be executed in reaction to an event, and so on.
Calling up the Database|Datapoints command opens the Datapoints window. This window
is used for processing files. Its basic functions are described in the previous section 6.3.2
File access.

6.3.3.1 Table view

The table lists the datasets of the Datapoints file. The columns of the table contain selected
field contents for each dataset like, for example, Symbol, Name, Device, Data type, Location
etc.

In table view, the toolbar of the window contains additional elements.

You can use the combobox at the right edge of the toolbar to define which data types should
be displayed in the table. All data types (“Fire“, “Intrusion“, “Panic“ etc.) are available. After
selecting “All”, the table will show all datapoints that are contained in the file. With this
selection possibility, you can systematically access certain datasets out of a variety of
projected datapoints.
Pressing the Automatic button activates the automatic projecting which, depending on the
used interface module, enables you to have the datapoints created automatically. Most
interface modules also allow the display of events from those datapoints which have not
been projected. Normally, the name of the datapoint is created with the formula
“[Device]:[Node]-[Address]”. You can then have created the corresponding datapoint
automatically by means of automatic projecting. The name will be the same as the result of
above mentioned formula and the type of the new datapoint will be “Other”. If a datapoint
with this name already exists, a running number will be appended to the name. In addition,
the link fields will be filled with the appropriate values. No further entries will be made in the
fields of the dataset. To even facilitate projecting, it is possible to use the supply of an
already existing datapoint as basis for a new datapoint that should be created automatically.
In such a case, only the datapoint name and the link fields will be overwritten, all other

43
Data supply WinGuard User Manual

supply data will be accepted unchanged. If a datapoint is marked in the table it will always be
used as basis (as described before). A new datapoint will only be created under “Other” if no
datapoint is marked in the table.
To avoid disturbances during projecting, we recommend to prevent automatic display of
events during this time (System|Settings) or to determine another workstation than the local
one (event routing). Deletion of the events is then simply done by deleting the event files
(.mld) in the Events/Current subdirectory.
Automatic creation of a new datapoint is only possible for those devices which are directly
connected to the respective workstation.
The appearance of an event for the selected or edited datapoint can be displayed both in the
table and the input view. Thus, you can easily check whether the assignment of graphics and
texts is correct. For this purpose, you can define an event which should be displayed. Thus,
you can easily check whether texts and graphics will be displayed as desired.
Clicking the Event button opens the Define event for document view dialog window. Here,
you can set the parameters for the view by selecting Type and by entering values in the
state and sensor fields.
Clicking the View button opens the Document view window whose appearance
corresponds to the event display (7.2.3 Event display). Only the pushbuttons for event
processing are not included in the button bar. Assigned texts and graphics will be displayed
in the same manner as they would be in event display if the event selected in the Define
event for document view window occurred. You can use and test all interactive elements of
texts and graphics.

44
WinGuard User Manual Data supply

6.3.3.2 Form view

In form view, the window shows an input mask which is used for entering or changing data of
the datapoint. In the upper area of the mask you can enter general details about the
datapoint like, for example, type, name and link. The central area of the mask is used to
define individual sensors for the datapoint. The lower area of the input mask contains several
tabs for entering further settings. The Documents, Priorities, Rights and Commands tabs
are available for each datapoint. For some datapoint types (“Lock”, “Monitor”, “Intercom”),
you can make use of another tab which is only displayed after the corresponding datapoint
has been selected. The interface module can also provide an additional tab for some data
types. For details about this topic, please refer to the documentation of the respective
interface module.
Datapoint definition:

The upper left region of the input window (Datapoint area) is used to set the general
definitions for the datapoint. First, select the datapoint Type and then enter a unique Name
for this datapoint. Additional information can be entered in the Remark field.
The Link area on the right side is used to enter information about the connection of the
datapoint to the system. Here, you inform WinGuard about the link to the respective devices
for receiving and sending data. After having selected the Device and the data type, the
Node and Address edit boxes are used to define the corresponding parameters. If the
desired device is not yet listed it must first be added to the system. A new device is defined
using the System|Devices menu item (see 4.3 Devices).
Such a link must, of course, be clearly assigned to a datapoint. If you try to assign a
datapoint a link which is already used for another datapoint a hint will be shown indicating
that the saving of the dataset is not possible.
The central area of the input mask is used to self-define individual sensors for the datapoint
or the datapoint itself. Each sensor is determined by a unique sensor number and a sensor
type. If no sensor number is entered (blank field) the whole datapoint will be selected.
Using the New, Change No. and Delete functions, the corresponding sensor can be newly
created, deleted or the sensor number can be changed.

45
Data supply WinGuard User Manual

6.3.3.2.1 Documents tab

Using the edit boxes of the Documents tab, you can specify the information that should be
displayed upon reception of an event. In particular, you can select which of the graphics and
texts that you created before in a WinGuard compatible format should be shown in the event
display. For more information about texts and graphics, please refer to the sections 6.5 Text
and 6.4 Graphic. The Documents tab contains the following edit boxes:
In the Locations box, the selected datapoint can be assigned a sensor or a location.
Control rights that are assigned to a location (see 6.11 Rights) will limit the control access to
all datapoints assigned to this location. The control rights for individual sensors are not
determined by their own location but by the location of the datapoint which they belong to.
Therefore, different control rights for sensors of one and the same datapoint are not
possible.
In the edit boxes of the Graphics area, you can enter up to five graphics that should be
displayed if an event is received from the selected datapoint or sensor. The first graphic will
be directly shown. With the three buttons in the event window, you can then call up further
graphics or switch between the graphics. The display of graphics is an option. It is not
mandatory to link an event to a graphic. If you want to add a graphic, enter its name (with the
ending .wgd) in the edit boxes. The specification of the ending .wgd is optional. If no path is
defined, the file will be searched in the graphics subdirectory. Such a graphic file can
optionally be completed with a parameter set which explicitly defines layers of the respective
graphic to be visible for screen and printer output (see 6.4.5.4 Explicit specification of the
visibility of layers).
In the Text field, you can enter the name of a text file in WinGuard Text (.wgt) format that
should be displayed when an event is received from the datapoint or sensor. The
specification of the ending .wgt is optional. If no path is defined, the file will be searched in
the Texts directory.
In the edit boxes of the Textmacros area, you can enter up to five text macros that should
be inserted in the event text during event display. A text macro can either be the text itself
that is written in the edit box or a text file in the WinGuard text (.wgt) format. Here, the
specification of the ending .wgt is decisive as it indicates that this is a text file. In text files
that are used for event display, you can use variables of Textmacro 1 ... Textmacro 5 type.
In event display, these variables are then replaced with the respective text macro.
When you create a new sensor, all edit boxes of the Documents tab will be inilialised with
default values of its group. For the Documents tab, the following applies in addition: The
field can be individually completed both for the group itself and for single sensors. But if you
change the field contents for the group, the field contents for all sensors which had the same
contents as the group will be changed as well. However, those sensors of the group which
had different field contents will retain them.

46
WinGuard User Manual Data supply

6.3.3.2.2 Priorities tab

In the Priorities tab you can define a priority for each of the six possible event types that
might be received from this datapoint or sensor.
Each of the event types Alarm, Pre-alarm, Warning, Fault, Event, Deactivation can be
assigned a priority between “-1” and “999”. Thus, default priority settings for individual
datapoints that were set during the installation of the interface module can optionally be
overwritten.
The priority specifies which event is displayed first in case several events are received
simultaneously. The higher the set value, the higher the priority of the event. Upon reception
of an event with higher priority than the currently displayed event, WinGuard will immediately
show the event with higher priority. The priorities “-1” and “0” are of special meaning. Priority
“-1” means that an event of this type will not be generated for this datapoint. “0” means that
the respective event will never be attached automatically.

6.3.3.2.3 Rights tab

With the Rights tab you can limit the control access to the current datapoint. By assigning
rights classes to a datapoint, the control right can be limited to these rights classes (see 6.11
Rights). The edit box shows the assigned rights classes. Settings are changed with the
button right beside the edit box.
If the datapoint is a group of sensors, the assignment of rights classes will apply to all
sensors of a group. Therefore, you cannot assign different rights to the individual sensors of
a group.

6.3.3.2.4 Commands tab

In the Commands tab, you can determine commands that should be executed during event
processing. Commands are worked off at different times: when an event is received, when it
is displayed and when the event display is being closed. Thus, you can, for example,
determine that the live picture of a camera is attached to a certain monitor when an event is
being displayed and that the monitor will switch off again when the event display is being
closed.

The edit box for entering commands is quite similar to the WinGuard text editor (see 6.5
Text) but it offers only limited functions. You can enter conditional elements and commands.
Moreover, you can enter a text in WinGuard Text (.wgt) format which can be created with
the text editor and which in turn may contain conditional elements and commands. This
proceeding is recommended when you want to enter complex command sequences.
Using the Text|Insert|Conditional element commands buttons, conditional elements can be
inserted. For more information about conditional elements, please refer to section 6.5.4.9
How to insert conditional elements.

47
Data supply WinGuard User Manual

Clicking the If button opens the Condition Properties dialog window. An If element is
created by selecting the If checkbox in the Type area in this dialog window. Using the
comboboxes, you can define a condition and accept it with the <<and / <<or buttons. Should
there be several conditions, this button can also be used to define the logical link of the new
condition to the previous ones. With the >> button you can delete the marked conditions.
As the commands of the datapoint are worked off at different times, you can use the
conditions, for example, to execute a command only at certain times. For this purpose, use a
query like this
If Variable Execution time == Event Reception
The commands behind the If element will be executed if the condition applies. An End
element is inserted at the end of the command block. Use the End button to insert such an
element.
You can also insert an action block that will be executed if the condition does not apply. The
Else element is used for this purpose. First, insert an If element. Then insert the commands
that should be executed if the condition applies. These commands are followed by the Else
element which is inserted with the Else button. Then, insert the commands that should be
executed if the condition does not apply. The last part of the command block is the End
element.
Commands can be inserted using the Text|Insert|Command element which opens the
Command Properties dialog window. All supported commands are available in the
Command combobox in the Function area. The displayed windows for entering command
parameters may vary depending on the selected command. For more information about
commands, please refer to section 6.2 Commands.
Using the Text|Insert|Text command, you can also insert a text in WinGuard Text (.wgt)
format which, in turn, contains commands and conditional elements. Such a text can be
created with the text editor (see 6.5 Text).
If, in the edit box, you position the cursor before an element (conditional element, command
or text) and click the Text|Format|Properites button the same dialog window will be opened
as during the creation of the respective element. The individual fields contain the values of
the selected element; the properties can be modified subsequently.

6.3.3.2.5 Value tab

The Value tab will be displayed if “Value” was selected as datapoint type. The fields for the
Range are used to define the minimal and maximal possible value – i.e. the range – for this
datapoint. These values and the stated unit are used for chart representations in the
WinGuard graphic. For this reason, the number of the positions after decimal point of the
“from” and “to” entries are important. The maximum of these two numbers of positions after
the decimal point determines the number of positions after the decimal point used for the
display of the value in WinGuard.

48
WinGuard User Manual Data supply

The fields for the Limits (Max-Hi, Max-Lo, Min-Hi, Min-Lo) and the event are used to define
the limits for the normal working area of the value. The two limit pairs Max-Hi/-Lo and Min-
Hi/-Lo are used for event triggering: If the value rises above the value which was determined
in Max-Hi the command that was defined beside under “Event if higher” will be executed (the
values for state and priority are optional and will overwrite the default settings). If the value
drops below Max-Lo, end event will be generated. The same applies vice versa to Min-
Hi/Min-Lo.

6.3.3.2.6 Lock tab

The Lock tab will be displayed if “Lock” was selected as datapoint type. In the Arming
command field, you can define which of the possible commands for these datapoints should
lead to an arming of the area.
This is the background of this command: If the area of a burglar alarm system is internally
armed all related groups of sensors which are not in resting state, e.g. due to an open
window, will not be included in the monitoring. If the burglar sensors have been linked with a
Lock (see section 6.3.3.3 Explorer window for datapoints) WinGuard will check all groups of
sensors related to the Lock during the execution of the arming command. If applicable, a
dialog window will open and show a list of all groups of sensors which are not in resting
state.

6.3.3.2.7 Monitor tab

The Monitor tab is used to define settings for a datapoint of “Monitor” type.
In the three comboboxes of the Show in control panel at area, all projected workstations
are available for selection. For more information about the projecting of workstations, please
refer to section 4.4 Workstations. Only if you select a workstation from these fields will you
be able to access the monitor via the camera control panel (see 7.3.4 Camera control panel).
Select the Local display with overlay card marking field if the respective monitor output is
switched to the input of an overlay card. The Camera Control Panel will then use another
symbol for the monitor. In addition, the overlay area in the control panel will open
automatically when the monitor is being selected.

6.3.3.2.8 Intercom tab

Datapoints of type “Intercom” are also assigned an additional tab – Intercom – which can be
used for further settings.
With the Handle call as emergency call checkbox, you can determine that each call from
this intercom should be handled as emergency call. In WinGuard, an emergency call is
displayed as event.
Mark all intercoms that are connected to the workstations using the Control station
checkbox.
Each workstation can be assigned a local intercom under System|Settings on the Intercom
tab. Check off the Control station checkbox for each of the assigned intercoms.
Use the comboboxes in the Operating range to define which commands should be executed
when operating the buttons for opening and closing in the Intercom Control Panel (7.3.5
Intercom control panel). A datapoint can be switched both when the corresponding button is
being pressed (beginning) and when the button is being released (end). If there is only a
command for the beginning, this command will be executed when the button is being
released. The edit boxes Datapoint-type, Datapoint-Name and Command are available for
the four possible commands.

49
Data supply WinGuard User Manual

6.3.3.3 Explorer window for datapoints

The Datapoints explorer window shows the datapoints in a tree structure, with the datapoint
types on the topmost hierarchy level. The lower levels contain the individual datapoints. They
can, as usually, be selected for processing in the form view. If sensors are assigned to a
datapoint they will also be shown in the explorer window, on the hierarchy level below the
datapoint which they are assigned to. The processing of the datapoint can be done by
means of the form. All commands in the form have an immediate effect on the explorer
window.
The datapoints can be organised in any hierarchical structure. This can be done by drag &
drop: just click an entry, keep pressing the mouse button, drag it on another entry and
release the mouse button. The form of the mouse pointer will give a visual indication of
whether it is possible to drag an entry to a certain position. Each datapoint can either be
directly subordinated to the datapoint entry which it is assigned to – this applies to all
datapoints in the second hierarchy level – or it can be subordinated to another datapoint
whose datapoint type may be different – this applies to the datapoints in the third hierarchy
level and lower. For example, this hierarchy determines directly which datapoints of the
Intrusion type belong to which Lock.
Selecting the command button far right in the title bar calls up a menu which contains all
possible control commands for the currently selected datapoint / currently selected sensor
and, in addition, enables the execution of the commands.
The context menu which opens after clicking an entry with the right mouse button offers an
extended functionality: With datapoint and sensor entries, it is not only possible to select
general functions (see 6.3.2.3 File access using the explorer) but it is also possible to directly
call up the test view for alarm, fault or event without the necessity of entering corresponding
parameters. Moreover, the names of datapoints can directly be changed in the explorer
window.
If a datapoint or sensor is dragged from the explorer to a graphics editor window (see 6.4.2
Graphics editor window) using drag & drop the related sensor type symbol (see 6.9 Sensor
types) will automatically be inserted along with the corresponding link.

6.3.4 Persons
In the Persons file, you can save the data of all persons and organisations that are in
contact with WinGuard. For each person, you can optionally define an identification number
and a password through which he or she can then register in WinGuard. Each user is
granted certain access rights on the basis of the assignment of one or more user profiles
(see 6.3.5 User profiles). Furthermore, the data of saved persons can be inserted in texts
(6.5.4.3 How to insert personal data). Thus, you can, for example, centrally file the name and
address of a person who should be notified in case of an alarm.
For as long as no person is saved in the Persons file and only a person with the
identification “00000000“ and a blank password is defined, a login will be possible without
entering an identification and a password. The example data contain such a person with the
identification “00000000“ in order to enable access to the system after first-time installation.
This person has the highest access rights. This means that you as administrator have to
assign an identification and a password to yourself and delete the above mentioned example
person from the Persons file afterwards. You have to remember your password because if
you enter it wrong you will not be able to access the system with administrator rights.
Calling up the Database|Persons command opens the Persons window. This is a window
for processing files. Its basic functions are described in section 6.3.2 File access.

50
WinGuard User Manual Data supply

6.3.4.1 Table view

The table lists all datasets of the Persons file. The columns of the table contain the contents
of following fields for each dataset: Comp./Group, Name, First Name, Phone Office, Phone
Private, Substituted and User.
The toolbar does not contain any additional elements; only the basic functions for processing
files are available (see 6.3.2 File access).

6.3.4.2 Form view

In form view, the window shows an input mask which can be used for entering or changing
data of a person. There are edit boxes for different data like, for example, Name,
Department, Address, Phones, Internet, and so on. Some of the edit boxes are necessary for
login in WinGuard.

The User edit box is used to enter the identification through which the user can login in
WinGuard.
If you make an entry in the User field the respective person will be able to login in WinGuard
with this identification and work with the system. If you do not make an entry in this field the
person will not be able to login in WinGuard. Therefore, if data about certain persons are
entered for information purposes leave this field blank.
The Password field is used to assign a person a password for login in WinGuard. The
password can be changed by the user himself/herself at any time (see 6.3.5 User profiles).
The Sdt Profile field is used to determine the standard user profile for the person (see 6.3.5
User profiles). And it can be used for selecting a user profile that should be added to the list
of available profiles.
The Available Profiles field lists all user profiles assigned to the current person.

6.3.4.3 Persons explorer window

For the purpose of clarity, the Persons explorer window shows the persons sorted according
to their Company/Group dataset entry. A corresponding ordering entry will automatically be

51
Data supply WinGuard User Manual

inserted for each company/group and all persons from the respective company/group will be
assigned to this entry. If a person is not assigned to such a company/group he/she will be
assigned to the “Other” ordering entry which will always be inserted at the end of the list.
Selecting the telephone button far right in the title bar will display all phone numbers that
have been entered for a person.
Furthermore, the general functions for file access through the explorer are available (see
6.3.2.3 File access using the explorer).

6.3.5 User profiles

With a user profile, you can determine dedicated access authorisations and define
appearance and behaviour of the WinGuard user interface for a person or a group of
persons. A user profile is defined via a data record in the User profile file. Each person with
access to the system can be assigned one or more user profiles (see 6.3.4 Persons). When
the person logs in in WinGuard (see 5.1.1 Login), he/she can select from the user profiles
that are assigned to him/her. The field for selecting a user profile will be initialised with the
standard profile of the person. The selected profile will then determine the access
authorisations as well as the appearance and behaviour of the program surface.
The Database|User profile command calls up the User profile window. This is a window in
table form. The table lists all datasets that are defined in the User profile file. The columns
of the table contain the contents of following fields for each dataset: Name, Remark and
Information about the latest modifications.
The explorer can be used to create, edit or delete new profiles in the User profile area.
Here, only the rights for the individual user profiles can be edited. The definition of all further
data of the user profiles like System, User interface, Explorer, Event list etc. is done in the
System|Settings area.
Modifications on the assignment of rights classes relating to the profile you are currently
logged in with will become effective only after a re-login (see 5.1.1 Login) or at least after a
profile change (see 5.1.4 Change profile) to the currently selected profile.

6.4 Graphic

6.4.1 Overview
In addition to texts, graphics are the second important instrument which is used for the
display and processing of events and other information. Graphics can contain interactive
elements. WinGuard uses its own data format for graphics, WinGuard graphics, with the
ending .wgd.
Each datapoint can be directly assigned up to five different graphics. Upon reception of an
event from the respective datapoint, the first of these graphics will be shown, the other ones
can be called up by the user.
Buttons enable the interactive creation of graphics. For example, you can insert buttons for
calling up further graphics. Thus, you can easily display survey views and detail views of a
building etc. Any graphic can be assigned any number of other graphics.
In addition, graphics can be defined independent of an event to display the current state of
datapoints, for example as background graphic (see 7.3.1 Control graphics).
You can create WinGuard Graphics with the integrated graphics editor. WinGuard’s
graphics editor works object-oriented and is based on vector graphics. Each geometric figure
that you create represents a drawing object which can be edited and assigned certain

52
WinGuard User Manual Data supply

attributes (for example colour, point size etc.). In addition, you can combine objects into
groups which then behave like a drawing object and and can be edited collectively.
The use of other objects, in addition to geometric figures, is possible as well. These are
import graphics, symbols, buttons and a video overlay range.
The Area, Frame and Powerclip functions provide the possibility to use parts of a graphic in
other graphics. For example, you can use single sections of a ground plan in other graphics
and insert additional objects.
You can use existing graphic files as basis for your new graphics by inserting them as link.
Such a proceeding may frequently be useful since the graphics for event display such as
plans of site, ground plans etc. are often already available in digital form or can be converted
to digital form using a scanner. WinGuard directly supports vector formats (wmf, dxf, dwg,
dgn) as well as pixel graphics (bmp, jpg). Other formats can also be converted to one of the
formats supported by WinGuard and be imported afterwards. For conversion, you can use all
common conversion or graphics programs.
You can use symbols to display the state of datapoints in the graphic. In addition, you can
attach a link to any graphic element and thus provide a direct relation to a datapoint or
location.
And you can also insert a video overlay range in the graphics, i.e. a range which shows a
video image.
WinGuard’s graphics editor offers all functions that are needed to create or edit existing
graphics in the course of projecting. On the WinGuard user interface, all these functions are
contained in the Graphics menu.

6.4.2 Graphics editor window

Toolbar Drawing area

Display area

Layer selection

53
Data supply WinGuard User Manual

The upper and left edge of the graphics editor window contain local toolbars. The most
important functions of the editor can either be called up with the buttons in these toolbars or
via the Graphics menu. The main area of the window is the drawing area. The display area
within the drawing area is provided with a frame. This area will then be visible when a
graphic is being displayed or printed, for example during the display of an event.
When being displayed, the size of a graphic will always be increased in order to fit the
respective window optimally. With the display area, you determine the part of the graphic
that should be visible in any case.
The predefined drawing size (paper size) can be modified in the WinGuard system settings
(see 4.2 Settings). With existing graphics, you can adapt the paper size and the size of the
display area via the Graphic|Properties command. Call up this command without having
marked an object in the drawing area.
To call up the dialogs for graphic Properties (incl. display area), proceed as follows: mark
the respective object, press the right mouse button and select properties in the subsequently
displayed context menu. For example, this is the Properties dialog for the basic settings of
the graphic:

6.4.3 How to administer graphic files

6.4.3.1 How to administer graphic files using the menu

All common commands for creating and saving graphics are available in the Graphics menu
point.
• Graphic|New
Opens a graphics editor window with blank drawing area for the creation of a new
graphic.
• Graphic|Open
Calls up the Open graphic file dialog which can be used to open a saved graphic for
editing.

54
WinGuard User Manual Data supply

• Graphic|Save
Saves the currently displayed file under the previous name. The previous file will be
overwritten without prompt for confirmation.
• Graphic|Save as
Calls up the Graphic save as dialog which is used to save the current graphic under a
new file name.

6.4.3.2 How to administer graphic files using the explorer

The Graphics explorer window shows all files and directories that are contained in the
Graphics subdirectory of the WinGuard program directory.
You can open a context menu for each file or directory by clicking it with the right mouse
button. These context menus offer following standard functions: New, Copy, Delete and
Rename. But please note that directories cannot be copied. Moving files and directories is
possible using drag & drop.
With the Edit function in the context menu you can directly open the graphics editor for the
selected file (corresponds to the Graphic|Open menu command). In contrast, selecting the
Display function will only show the file in a display window. From there, you can again select
a context menu and changeover to the graphics editor, if required. A double click on a file
entry corresponds to the Display function in the context menu.
Using the button far right in the title bar of the explorer window, you can determine which file
types should be listed in the explorer window. The current setting can be recognised from
the symbol shown on the button. By default, All files is selected; this means all graphic files
will be listed. If WinGuard Graphics, Vector Graphics or Bitmap Graphics is selected only
the files of the respective type will be displayed.
If a graphic file is moved from the explorer window to a graphics editor window using drag &
drop it will directly be inserted at the intended position.

6.4.3.3 How to administer the graphic structure using the explorer

The explorer offers an additional explorer window with the graphic structure of the currently
displayed graphic. This window lists all layers and the graphic objects contained therein.
Thus, you have the possibility to access individual objects in a quick and direct way.
After having selected an object, you can use the context menu to execute the corresponding
editing functions. You can either use the standard functions such as Cut, Copy, Delete etc.
or copy/move objects to other layers. The dialog for editing object properties is available as
well.

6.4.4 How to define the display window

In order to define the display range of a graphic, open the Properties dialog of the graphic.
To do so, click a blank area of the graphic, press the right mouse button and select
Properties. The settings for the display are contained in the Page tab.
Using the command Graphic|Tool|Zoom or the Magnifier, you can define the zoom in level
and, in addition, the visible section of the graphic. For zooming in / zooming out, first use the
magnifier tool. Then click on the graphic. Use the left mouse button for zooming in and the
right mouse button for zooming out. The scroll-wheel of the mouse (if present) can also be
used for zooming in or zooming out. The zoom in levels correspond to those predefined in
the Graphic|Tool|Zoom menu. The point on which you clicked becomes the centre of the
new display window. The menu bar will show the current magnification level of a graphic.

55
Data supply WinGuard User Manual

Using the magnifier, the display window can also be moved. To do so, click on the drawing
area and keep pressing the mouse button. The mouse pointer will change to a hand. If you
move the mouse the display window will move accordingly.

6.4.5 Working with layers

6.4.5.1 Layer concept

With the WinGuard graphics editor it is possible to define individual layers of a graphic and
edit them separately. Layers are like transparent sheets on which drawings can be created.
You can design certain parts of a drawing on each of these sheets. The final drawing is then
created by superimposing the individual layers. By changing the order in which the layers are
superimposed upon each other, you can determine which objects should be covered by
other objects. In addition, you can define whether a layer should be displayed on the screen
or printed on the printer. Thus, you can determine different appearances of a graphic, in
dependence of the output device.

6.4.5.2 How to edit layers

Below the drawing area you will find a palette for selecting the layers. The order of the layers
is defined as follows: the far left layer on the palette is the topmost layer of the image. The
next button to the right represents the layer below the topmost layer and so on.
At first, only one layer will be defined when a new graphic has been created. Its name is
“Layer 1”. If an already existing graphic is being displayed the name of the layers will be
shown.
Clicking one of the tabs activates the respective layer for editing. If you want to edit several
layers simultaneously, simply select them with left mouse button click with pressed <Ctrl>
key. The buttons left to the layer palette can be used to activate/deactivate the layer control
panel, to activate/deactivate all layers for common editing and to screen off inactive layers.
All drawing actions that you perform will only affect the active layer(s).
In addition, the tabs will show, in form of symbols, whether the respective layers are locked
or whether printer output is disabled.
The order of the layers can be changed as follows: select a layer, keep pressing the mouse
button, press the <Ctrl> button and move the layer to the desired position.
All functions for editing layers are available in the context menus assigned to the individual
layers. Layers can also be edited by means of the layer control panel.
The active layer cannot be deleted. Layers which are locked can neither be activated nor
deleted.

56
WinGuard User Manual Data supply

6.4.5.3 Layer control panel

Layers in a graphic are administered via the Layer control panel which offers all necessary
functions in the form of buttons. You can open and close this window via the button with the
window icon in the layer palette. When the Layer control panel is open, this button will be
shown pressed.
In the list, the individual layers are numbered, beginning with “1”. The name of the respective
layer will be displayed next to the number; the default names are “Layer 1”, “Layer 2” etc.
One of the layers is marked with a red dot. This layer is active. This means that all drawing
actions which you perform will only affect this layer.
The symbols right beside the names of the layers indicate whether a layer will be shown on
the screen or printed on the printer. The monitor symbol indicates that the layer will be
shown on the screen when the graphic is being displayed. The printer symbol indicates that
the respective layer will also be printed on the printer.
The lock symbol indicates that a layer is locked. In this case, the layer cannot be modified.
Therefore, a locked layer cannot be selected as current layer.
The available functions (buttons) enable the following modifications: create a new layer,
delete a layer, rename a layer, change order of the layers etc.

6.4.5.4 Explicit specification of the visibility of layers

As described above, you can define for each individual layer of a WinGuard graphic file the
visibility for screen display or print-out. Thus, you can determine the presetting of the
respective graphic file. But there may be cases when you want to display the same graphic
with a different visibility setting. Then, the implicit setting, i.e. the layer configuration specified
in the graphic file, can be overwritten by an explicit setting.
WinGuard offers this possibility for all points where links to graphic files are entered, for
example for the location hierarchy, the Edit locations function (see 6.8 Locations),
datapoints (see 6.3.3 Datapoints), the Documents tab and for those commands (see 6.2
Commands) which use a graphic file as parameter.
At all these points, the visibility of the individual layers of the graphic can be explicitly
specified by inserting one or more parameter sets behind the selected graphic file name. A
parameter set has the following form /L<Layer name or Layer number>:S<+|->P<+|->. If a
layer name or a layer number is inserted behind the /L the command will affect the
corresponding layer – provided that a layer with the identical name or number is present in
the graphic. If no layer name or layer number is inserted in the parameter set the command
will affect all layers of the graphic.
The colon is followed by S+ or S- in order to switch the visibility of the respective layer for
screen display on or off. If this specification is missing S+ will be implicitly assumed. Same
applies for P+ or P- relating to the visibility for print-out.
If several parameter sets are entered in succession they will be worked off from left to right.
For example, the parameter specification /L:S+P-/LEscape route:S-P- will at first switch off
the visibility on screen display and switch on the visibility for print-out for all layers. Then, the
visibility for the layer with the name “Escape route” will explicitly be switched off for screen
display.
If you select another graphic by button the current parameter specification will also affect this
newly loaded graphic. If, after selection by button, you enter a parameter specification for the
visibility of layers in the graphic parameter field this parameter specification will be applied
additionally. Thus, a parameter set consisting of the parameters for the original graphic and
the parameters for the new graphic will be applied for this new graphic. This behaviour will

57
Data supply WinGuard User Manual

continue, i.e. if you switch over from the second to the third graphic and then to the fourth
graphic, the respective parameter sets will be added and completely applied to the new
graphic.

6.4.6 Working with grids

The WinGuard graphics editor enables the use of drawing grids. A grid is placed over the
graphic and will not be visible when the graphic is displayed on the screen or printed out. Its
lines are separated by an equal horizontal and vertical distance. If a grid is active, objects
can only be placed on the intersections of the grid lines and the size of these objects must
be a multiple of the corresponding line distance. A grid helps you create drawing objects and
orient them to one another, e.g. when a building outline should be located along an
alignment.
With the help of the Settings dialog in the grid area you can specify the properties of the
grid.
With the Graphic|Options|Adjust to grid command, the use of the grid can be switched on
and off. If the grid is active, all subsequently inserted and moved objects will be aligned
along the grid. Selecting this command again will switch off the grid so that all inserted
objects can be positioned freely and independent of the grid.

6.4.7 How to insert objects

To insert drawing objects, use the corresponding buttons in the left area of the toolbar.
These commands can also be called up with the menu entries Graphic|Tool or
Graphic|Insert.
The button of the selected object type will be displayed with a background colour. To insert
an object, move the graphic cursor over the drawing area to the position where you want to
place the object. An exact position adjustment is not necessary as each drawing object can
be moved subsequently. To do so, keep pressing the left mouse button. Size and form of the
object can then be determined by moving the mouse. Subsequent editing of object
properties is possible as well. In order to open the corresponding Properties dialog, first
select the object. Then, use the Graphic|Properties command or press the right mouse
button and select Properties.
The properties of the last edited object will be used for the drawing of further objects. If you
want to draw a new object that should have the same properties as an already drawn object,
simply open the properties dialog for the existing object and close it again with OK. When
you create a new object it will have the same properties as the last one.
A special kind of objects is available under Display area and Frame. Using these objects you
can, for example, create uniform borders for your graphics or display parts of a certain
graphic in other graphics.

58
WinGuard User Manual Data supply

6.4.7.1 How to insert display areas

In WinGuard, you can use graphics in connection with display areas. After having created a
graphic, there is always a display area for the graphic. This is the area that should be visible
when the graphic is being displayed. As a rule, the name of the display area is Default. Each
display area is indicated by a border (with dotted lines). WinGuard gives you the possibility of
defining and naming arbitrary display areas in a graphic. These display areas can then be
displayed in another graphic. And, during the assignment of datapoints, they can also be
defined as graphics that should be displayed
Example: Let’s assume that you have the drawing of a building outline and you want to
display parts of this outline at other points of the program (commands). The definition of
display areas on the outline allows you, in case of an alarm, to only display or print one of
the display areas, i.e. you can use the same graphic for a large number of graphics/displays.
A display area can be defined by selecting the Graphic|Tool command and clicking
Range/Frame with the left mouse button. Then, you define the appropriate area in your
graphic by tracing up a rectangle with the left mouse button. With the help of the Settings
dialog you can name this area and additionally assign a link.

If you want to assign a graphic to another graphic or to a datapoint, first select the
appropriate graphic. If this graphic contains additional display areas or frames (see 6.4.7.2
How to insert frames) you can select one of them for display. The display area with the name
Default is used by default. If, in turn, these embedded graphics contain display areas or
frames, they can also be integrated in the display. Thus, graphics can be interlaced
according to your wishes.

59
Data supply WinGuard User Manual

6.4.7.2 How to insert frames

In WinGuard, so-called frames can be used in graphics. Frames are used to include
additional graphics information in a graphic. With this technique, it is possible, for example,
to zoom a part of a certain graphic area and then integrate it in another graphic. The areas
that should be integrated must be defined as area or frame in these graphics. Each frame is
indicated by a border (long dashed line).
A frame can be defined by selecting the Graphic|Tool command and clicking Range/Frame
with the left mouse button. Then, you define the appropriate area in your graphic by tracing
up a rectangle with the right mouse button. With the help of the Properties dialog you can
name the frame and, in addition, assign a parameter, e.g. a link.
Example: Let’s assume, you would like to create graphics with a uniform appearance in
event display. For this purpose, you can, for example, use three appropriate frames to define
a uniform layout for the heading, for the graphic that should be displayed and for the legend.
When you select graphics for display, first assign the template graphic to the display area.
These defined frames can then be assigned display areas or frames of other graphics (see
6.4.7.1 How to insert display areas).
If you want to assign a graphic to another graphic or to a datapoint, first select the
appropriate graphic. If this graphic contains additional display areas or frames, you can
select one of them for display. The display area with the name Default is used by default. If,
in turn, these embedded graphics contain display areas or frames, they can also be
integrated in the display. Thus, graphics can be interlaced according to your wishes.

6.4.7.3 How to insert PowerClips

By working with PowerClips, WinGuard offers the possibility to integrate parts of graphics
into other graphics. The functionality of PowerClips can be compared with a template that is
placed on an existing graphic, i.e. the other sections of the graphic will be hidden. This new
graphic can later be edited just like an object. A further advantage of the use of PowerClips
is that their form can be arranged almost arbitrarily.
In order to define a PowerClip, first specify the shape it should have, e.g. a rectangle, an
ellipse, a closed loop etc. Then, mark the objects that should be inserted in the PowerClip
object and select the Graphic|Powerclip|Place inside container command. The mouse
pointer will change to a wide arrow. To insert the marked area into the PowerClip object,
move the mouse to the edge of the PowerClip object (the form of the mouse pointer will
change) and click the right mouse button. Then, only those areas which are not covered by
the PowerClip object will still be visible. In the Tailor mode, the PowerClip can be modified at
any later time. If this mode is not active, the PowerClip object can be edited just as any other
object. For example, the object can also be assigned a link or a command.

6.4.7.4 How to insert inscriptions

To insert inscriptions in a graphic, use the Graphic|Insert|Text command. The text is
positioned by clicking on a point on the drawing area. This will select the corresponding
Properties dialog.

60
WinGuard User Manual Data supply

6.4.7.5 How to insert variables

When the graphic is displayed in the course of event processing, variables will be replaced
with information from the context. You may, for example, enter the current date and current
time in the graphic or information about the datapoint which triggered the displayed event as
well as a wide range of other information. When editing a graphic with the graphics editor,
the variable type will be shown in angular parenthesis.
In order to insert a variable, call up the Graphic|Insert|Variable command. The variable is
positioned by clicking on a point on the drawing area. This will select the corresponding
Properties dialog.
You can use almost the same variables (datapoint name, datapoint type, sensor number,
state, location, date etc.) as are used for inserting variables in texts (see 6.5.4.2 How to
insert variables).

6.4.7.6 How to insert import graphics

In WinGuard, you can use existing graphics (building plans, ground plans etc.) as the base
for a new graphic. The desired graphic is simply inserted in the graphic that should be
created.
To insert a graphic that is available as file, either select the Graphic|Insert|Graphic
command; if not yet visible, the explorer will then be shown and the Graphics explorer
window will open. Or you can manually open and select the corresponding Graphics window
in the explorer.
Select the file that you want to insert in the graphic from the explorer and simply move it by
drag & drop into the window of the graphics editor, i.e. click the file in the explorer, keep
pressing the mouse button, move the mouse pointer in the graphics editor window and
release the mouse button. An exact positioning of the graphic can be achieved by clicking
the graphic again and moving it to the desired position using the mouse.
The import graphic is always inserted in the active layer of the target graphic. When
importing a graphic that is in WinGuard Graphic (.wgd) format, containing layer information
may get lost.
If your graphics are in another format, then they must first be converted into a format that is
supported by WinGuard. This can be done by means of a conversion program or a common
graphics program. Most graphic programs are able to save files in the file formats required
by WinGuard.
Imported graphics are not by default saved as part of the new WinGuard graphic but will be
reloaded when the graphic is being displayed. Therefore, you must not rename the file path
in which the import graphic is saved and you must not delete it from the hard disk or move it
into another directory.
Thus, later changes to the import graphic will also be visible in those WinGuard graphics that
use the import graphic. This facilitates the administration of graphics. If you don’t want to use
this feature, the data of the imported graphic can also be saved as part of the WinGuard
graphic (Save data inside document option).
If a graphic in the formats Windows Metafile (.wmf) or Windows Bitmap (.bmp) is
contained in the clipboard, it can also be inserted in the edited graphic using the Edit|Insert
<Ctrl>+<V>, <Shift>+<Ins> command. The mouse pointer will be shown as insert pointer
and you can click the position at which the import graphic should be inserted.

61
Data supply WinGuard User Manual

Contrary to an inserted graphic file, a graphic that is inserted from the clipboard will always
be saved as part of the new WinGuard graphic.
The properties of an import graphic can subsequently be changed using the
Graphic|Properties command. This dialog can also be opened by clicking the graphic,
pressing the right mouse button and selecting Properties.

6.4.7.7 How to insert symbols

Symbols can be used for displaying the state of datapoints and sensors or for displaying
frequently used parts of graphics. As a rule, symbols are small graphics that are stored in a
library. You can, at any time, add your own symbols to the library by saving a graphic in the
GraphicsSymbols directory. For more information about libraries, please refer to section
6.4.10 Libraries.
In order to visualise datapoints and their states, you can link symbols to these datapoints.
The display of the symbol will then depend on the state of the linked datapoint. Clicking a
symbol in the graphic will usually call up the appropriate control panel.
WinGuard is supplied with a wide range of symbols. You can, at any time, complete this
library with your own symbols. To do so, symbols must be created with the graphics editor
(consider certain conventions) and saved in the library.
To insert a symbol in a graphic, either select the Graphic|Insert|Symbol command; if not
yet visible, the explorer will then be shown and the Symbols explorer window will open. Or
you can manually open and select the corresponding Symbols window in the explorer. This
window does not only offer a hierarchy display of all WinGuard graphic files in the
Graphics\Symbols directory and its subdirectories but it also shows a short preview of the
corresponding symbols. Symbols are always in the WinGuard Graphics (.wgd) format; their
file names will therefore be displayed without the „wgd“ ending.
You can open a context menu for each symbol or each directory by clicking it with the right
mouse button. These context menus offer the following standard functions: New, Copy,
Delete and Rename. But please note that directories cannot be copied. However, you can
make use of the Edit function which is offered in the context menu of a symbol entry in the
Symbols explorer. Thus, the selected symbol file can directly be opened in the graphics
editor.

62
WinGuard User Manual Data supply

Select the symbol that you want to insert in the graphic from the explorer and simply pull it by
drag & drop into the window of the graphics editor, i.e. click the symbol in the explorer, keep
pressing the mouse button, move the mouse pointer in the graphics editor window and
release the mouse button. An exact positioning of the symbol can be achieved by clicking
the symbol again and moving it to the desired position using the mouse.
The properties of a symbol can subsequently be changed using the Graphic|Properties
command or the right mouse button which opens the Symbol Properties dialog.

6.4.7.8 How to insert buttons

Buttons are interactive elements which can be used to call up certain commands during the
display of a graphic. WinGuard offers a wide range of commands that can be linked with
buttons. Commands form a basic concept of WinGuard. Commands are, for example, also
used by buttons in texts or as elements in texts. For more information about commands,
please refer to section 6.2 Commands.
Using the Graphic|Insert|Button command, you can insert a button in your graphic. This
command will open the corresponding Properties dialog. This dialog is also used for the
subsequent modification of button properties.
Here, you can enter commands (and their parameters) that should be executed when the
button is being clicked.
Depending on the selected command, boxes for entering the parameters of the command
will be displayed. For more information about commands, please refer to section 6.2
Commands.

6.4.7.9 How to insert a video overlay

By inserting a video overlay area, you can show a video image in a rectangular area of the
graphic.
To do so, call up the Graphic|Insert|Videooverlay command. The mouse pointer in the
drawing area will then be displayed as insert pointer. Click on the point where you want to
position the left upper edge of the overlay field. This will insert an overlay field which, in
editing mode, will be shown as blue rectangle with the inscription “videooverlay”.
The properties of a video overlay can subsequently be changed using the
Graphic|Properties command. This is done by means of the corresponding Properties
dialog.

63
Data supply WinGuard User Manual

6.4.8 How to edit objects

First, select the desired object. This will then be marked with pull type side lays (small black
squares). Basically, the object that was inserted last will automatically be selected.
Using the Graphic|Tool|Selection command, you can systematically select one or more
objects. After calling up this function, simply click on the desired object.
If you keep pressing the <Shift> button while clicking several objects one after the other, all
these objects will be selected. Selection of several objects can also be done by clicking on
the drawing area while keeping the mouse button pressed. You can then trace a rectangle
on the drawing area. If you release the mouse button again, all objects that are completely
within the rectangle will be selected. Objects are edited using the same functions as used for
inserting objects.
After insertion of an object, the editor will automatically switch to the selection mode.
You can combine several objects into a group. Such a group will show the same behaviour
as a single object. Therefore, you can move and edit the group as a single object. By forming
groups, you can create complex objects. And in turn, groups can be used as objects within
other groups.
Using the “Edit all layers” mode, you can select several objects from different layers and thus
combine them into a group. But since a group is also an object, it must be assigned to a
layer. This is done during the formation of the group: the group and all contained objects will
be assigned to the topmost layer that is present in the group.

6.4.9 How to test a graphic

Already during creation of a graphic, it is possible to test whether the interactive elements,
such as buttons, symbols, variables etc. will show the desired behaviour. This is done in the
test mode. In addition, you can determine an event which should be triggered for testing
graphics for event display.
Using the Graphic|Set Test Parameters menu command you can optionally determine an
event that should be triggered in the test mode. Selecting the above command will open the
Set Test Parameters dialog where you can enter all necessary data for the test.

64
WinGuard User Manual Data supply

You can test the behaviour of the graphic using the Graphic|Test graphic command. After
calling up this function, the graphic will be displayed in the same manner as it would be
shown in the Event display window. No further drawing actions can be performed. Clicking
buttons will call up the corresponding commands. The symbol of the datapoint that was
selected for the test will be displayed in accordance with the preset state.
By calling up the command again, you can change from test mode back to editing mode.

6.4.10 Libraries
WinGuard offers a wide range of symbols for sensors, datapoints and buttons. You can, at
any time, complete these libraries according to your requirements. The libraries contain
graphics in the WinGuard Graphic (.wgd) format. During their creation, you have to
consider certain conventions. In order to add your own symbols to the libraries, save them in
the given directories.

6.4.10.1 Symbol/Datapoint type

The symbols library is contained in the Graphics\Symbols directory. For inserting a symbol
(see 6.4.7.7 How to insert symbols) you can select from the graphic files that are saved in
this directory and in all subdirectories.
You can create your own symbols in the graphics editor and save them in one of the library
directories. To do so, proceed as follows:
First, select the Graphics|New menu command. The proceeding may vary slightly,
depending on whether the symbol is static or animated.
Static symbols
With symbols which only serve for information and are not linked with an object, only the
topmost contained drawing object will be displayed.
First, draw the symbol in the drawing area. If the symbol consists of several drawing objects,
select all objects by clicking them with pressed <Shift> key. Then, combine all drawing
objects into a group and save the graphic in one of the library directories. The file name will
be used as symbol name.
Animated symbols
Datapoint and sensor may show different states. Therefore, animated symbols that should
be assigned to sensors must have different representations for the individual states. You can
create your own representations for each of the following eight states / state groups.
1. Silence
2. Alarm
3. Fault
4. Event
5. Switched off, Disarmed, Locks, Revision
6. Active
7. Unknown state
8. Prealarm
You must therefore create a graphic that consists of eight objects which in turn may consist
of groups with several objects. First, draw the object for a state. To do so, you can combine
several single objects into a group. The objects for the other seven states are created in the
same way.
Then, you have to determine which object should be assigned to which state. Symbols are
arranged successively. The symbol in the foreground will be assigned to the Silence state,
the 2nd symbol to the Alarm state, the 3rd symbol to the Fault state, the 4th symbol to the
Event state, and so on.

65
Data supply WinGuard User Manual

First, click the object that should be assigned to the Silence state and move it to the
foreground. Then, click the object for the Alarm state and move it to the background.
Proceed in the same way with the other objects (move them to the background), observing
the above mentioned order.
Finally, save the graphic in one of the subdirectories of the Graphics\Symbols\Sensors
directory. The selected name without the ending .wgd will be used as symbol name.

6.4.10.2 Button library

The graphics of the button library are saved in the Graphics\Buttons directory. When
inserting a button you can select from these graphics.
A graphic for the button library is created in the same way as a graphic for a non-static
symbol (see 6.4.10.1 Symbol/Datapoint type).
First, create a new graphic selecting the Graphic|New command. Then, draw the desired
symbol for the button. Combine all drawing objects into a group. Finally, save the graphic in
the Graphics\Buttons directory. When selecting a button graphic, the file name without the
ending .wgd will be displayed as name.

66
WinGuard User Manual Data supply

6.5 Text

6.5.1 Overview
In WinGuard, texts are used in varying ways. First of all, graphics (and texts) are used for
visualising and processing events. They inform, for example, about the measures to be
taken. Each datapoint or sensor can be assigned a text which will be displayed upon
reception of an event from this datapoint. In addition, texts are also used for creating and
displaying reports (see 7.4.5 Reports). But texts and graphics are not limited to the mere
display. When being associated with corresponding fields, they serve, for example, as form
for entering information. And texts with conditional elements and commands will help to
control and automate the program behaviour at many points. For texts, WinGuard uses its
own data format, WinGuard Text, with the ending .wgt.
Texts can contain static elements, dynamic text objects, interactive objects, conditional
elements and commands. In developing the WinGuard text format, one of our aims was to
end up with a minimum of text files for event display. These few files, however, can adapt to
different contexts due to different elements for runtime. Thus, you need to maintain only a
few text documents for the event display.
Dynamic text objects
Dynamic text elements will not be replaced with values from the context until the display.
Using variables, you can, for example, insert date, time, datapoint name and a variety of
other information into the text. Person and phone fields can be used to insert data from the
Person file. And list fields are used to insert abstracts from archive and logs (see 7.4
Documentation).
Interactive objects
Using buttons, you can execute any interactive command; interactive dialog elements enable
you to create forms. The input elements are the same as in Windows. In case of texts for
event display, the inputs in these elements will be archived along with the texts.
Conditional elements
Conditional elements are used to define parts of the text in dependence of conditions. Since
conditional elements are created using symbols no special knowledge of a programming
language is necessary.
Commands
Commands which are inserted in a text will be worked off one after the other when the text is
being executed. Texts with commands are used, for example, to define reactions during the
reception and processing of events (see 4.5 Event routing) or to define automatic commands
(see 7.5.1 Scheduled commands).
WinGuard offers a complete text editor with extensive functions. Thus, you can project all
parts that are used by WinGuard. You can call up the functions of the text editor via the
WinGuard user interface by selecting the Text menu.

67
Data supply WinGuard User Manual

6.5.2 Text editor window

As with all windows in WinGuard, a local toolbar is present at the upper edge of the text
editor window. The most important functions of the editor can be called up either by using
the buttons in this toolbar or by selecting the Text menu. In the main area of the window, you
can enter your texts exactly as you do in other text processing programs.
The end of the processed text is marked with the • sign, the end of a paragraph by the ¶ sign
and a line break without paragraph change by the « sign. A line break is inserted in the text
by simultaneously pressing the <Shift>+<Enter> keys. When the text is being displayed,
these formatting symbols will not be visible.
A blinking cursor indicates the current typing position. Text which is entered via the keyboard
is by default entered at the current typing position. Using the <Ins> key you can pass from
insert mode to overwrite mode and vice versa. You can move the typing position by clicking
with the mouse or by using the cursor keys.
If you want to mark text parts with the mouse, proceed as follows: click on the text, keep
pressing the mouse button and move the cursor with the mouse. If you want to mark text
parts with the keyboard, proceed as follows: keep pressing the <Shift> key and move the
cursor with the cursor keys. The marked area will be shown inverted.
Those text elements that will be displayed different than designed will have a coloured
background in the editor.

6.5.3 How to administer text files

6.5.3.1 How to administer text files using the menu

In order to create a new text, call up the Text|New command. A text editor window with a
blank text page will open. For processing several texts at once, you can have several text
editor windows open.
A saved text file can be opened with the Text|Open command. After having selected this
command, the Text open file dialog will be shown. Here, you can select and load files in the
WinGuard Text (.wgt) format. Then, the text editor will open a new window containing the
selected text document.

68
WinGuard User Manual Data supply

Using the command Text|Save, you can save the processed text under its previous name.
The previous file will be overwritten without prompt for confirmation. If the text has not been
saved before (new text) the Save Text As dialog will pop up to let you specify a file name.
Using the Text|Save as command, you can save the currently displayed text under a new
name. The Text Save As dialog will be displayed. There, you can specify the name of the
file.

6.5.3.2 How to administer text files using the explorer

The Texts explorer window shows all files and directories that are contained in the Texts
subdirectory of the WinGuard program directory.
You can open a context menu for each file or directory by clicking it with the right mouse
button. These context menus offer following standard functions: New, Copy, Delete and
Rename. But please note that directories cannot be copied. Using drag & drop you can
move files and directories to another position: click on the respective entry, keep pressing
the mouse button, move the file/directory to its intended location and release the mouse
button.
With the Edit function in the context menu you can directly open the text editor for the
selected file. This function corresponds to the Text|Open menu command. In contrast,
selecting the Display function will only show the file in a display window. From there, you
can again select a context menu and changeover to the text editor, if required. A double click
on a file entry corresponds to the Display function in the context menu.

6.5.4 How to insert objects

In addition to static text, WinGuards offers a variety of different objects that will help you
create texts in a more flexible manner. When calling up the respective inserting functions,
the corresponding object will be placed in the text at the location of the cursor.
The menu bar contains different buttons for inserting objects.

6.5.4.1 How to insert texts

You can insert an existing text file in the WinGuard Text (.wgt) format as text module in
another text file. To do so, call up the Text|Insert|Text command which will open the Select
text file dialog. There, you can select a file in the WinGuard Text format. This file will be
inserted at the current cursor position. During design, the text editor will only show the file
name of the embedded graphic on a yellow background. The contents of the text file will not
be imported and shown until the text is being displayed.

69
Data supply WinGuard User Manual

6.5.4.2 How to insert variables

When the text is being displayed, variables will be replaced with information from the
context. You may, for example, enter the current date and current time in the text or
information about the datapoint which triggered the displayed event as well as a variety of
other information. In the editor mode, the variable type for a variable will be shown on a
yellow background.
In order to insert a variable, call up the Text|Insert|Variable command which will open the
Variable properties dialog window.
The Minimum width field is used to determine a minimum width for the text that should be
displayed instead of the variable. The minimum width is defined in pixels. This width will then
be reserved for the display of the text. Succeeding text will be displayed after this range. If
the text that should be displayed instead of the variable is wider than the stated minimum
width the succeeding text will be displayed directly after this text. If you state “0” (default
value) as minimum width the succeeding text will, in any case, be displayed directly after the
variable text. In editing mode, the reserved range will be shown as field with a yellow
background.
The Type combobox determines the variable type and the variable type will determine the
information displayed in the text. Variable types are, for example, datapoint name, datapoint
type, sensor, sensor number etc. When the text is being displayed, variables will be replaced
with the corresponding data.
With some variable types, the information that should be displayed can additionally be
specified in the Option field.

6.5.4.3 How to insert personal data

You may also enter data from the Persons file (see 6.3.4 Persons) in the text. When the text
document is being loaded the currently saved contents of the field will be inserted. In editing
mode, the desired field contents will immediately be displayed but on a yellow background.
In order to insert personal data, select the Text|Insert|Person/Phone command which will
open the Person/Phone Properties dialog.

6.5.4.4 How to insert lists

WinGuard saves all activities in the system in the archive or in logs (see 7.4 Documentation).
The System log saves all commands that are executed by the operators. The Device log
contains all data transfers via the devices of the system. And the Archive saves all
processed events. You can display an abstract of the archive or the logs in the form of a list
as part of texts. This is especially helpful in creating reports (see 7.4.5 Reports).
In order to insert a list, call up the Text|Insert|List command which will open the List
properties dialog.
The following list types are available:
List System Protocol
If you selected “List System Protocol“ as list type the Select System Log Entries dialog
window will open. It corresponds to a large extent to the search screen when accessing the
System log (see 7.4.3 System log).

70
WinGuard User Manual Data supply

You can use the individual fields of this window to state selection criteria for filtering the log
entries. Then, all entries which meet all criteria will be displayed, i.e. a logical AND operation
will be performed. Blank fields will not be recognised.
List Interface Protocol
If you selected “List Interface Protocol“ as list type the Interface System Log Entries dialog
window will open. It corresponds to a large extent to the search screen when accessing the
Interface log (see 7.4.4 Device log).
List Event Archive
If you selected “List Event Archive“ as list type the Select Archive Entries dialog window
will open. It corresponds to a large extent to the search screen when accessing the Event
archive (see 7.4.2 Event archive).

6.5.4.5 How to insert buttons

Buttons are interactive elements that can be used to call up certain commands during the
display of a text. WinGuard offers a variety of such commands which can be linked to a
button. Commands form a basic concept of WinGuard. Commands are, for example, also
saved in the buttons of graphics. For more information about commands, please refer to
section 6.2 Commands.
Using the Text|Insert|Button command, you can insert a button in the text. Selecting this
command opens the Button Properties dialog which can be used to define the button
properties.
For creating graphic buttons, WinGuard supports Windows Bitmap (.bmp) graphics with up
to 256 colours. Some bitmaps are already contained in the standard delivery of WinGuard.
But you can also create your own bitmaps. To do so, you can use any drawing program like,
for example, the Windows Paint program.
Such a graphic button can also be used without assigned command, for example if you
merely want to display a bitmap in the text.

6.5.4.6 How to insert edit boxes

Editboxes enable the user to make his/her own written comments in the text. In case of an
alarm, the user can thus add important information to the text used for event display. The
entries in the text fields will be saved when the event is being archived.
In order to insert an editbox variable, call up the Text|Insert|Editbox command.
Selecting this command opens the Editbox Properties dialog which can be used to define
the properties of the editbox.
If the editbox offers only space for one line the Multiline option cannot be used. In this case,
either increase the height of the box or activate the Automatic vertical scrolling option.

6.5.4.7 How to insert comboboxes

Comboboxes are used for selecting previously defined alternatives or for enabling the user
to make his/her own entries. Clicking the button opens a list with the predefined alternatives
which the user can select from. These alternatives, however, must first be defined in a list.
For more information about creating and editing lists, please refer to section 6.7 Lists.

71
Data supply WinGuard User Manual

In order to insert a combobox in the text, select the Text|Insert|Combobox command.

Selecting this function opens the Combobox Properties dialog window which can be used
to define the properties of the combobox.
If the height of the combobox is set too low, some elements of the list might not appear. In
such a case, increase the height of the combobox!

6.5.4.8 How to insert checkboxes

Checkboxes give the user the possibility to check off different points. They can, for example,
be used to define reactions that must be worked off upon reception of an alarm. After
completion, the single steps can then be checked off. These entries incl. text will be saved in
the event archive.
You can select from two types of checkboxes: Simple checkboxes can be selected
independent of other checkboxes. With linked checkboxes, you can select one checkbox
from a group of checkboxes. Here, you can realise a selection from several alternatives.
In order to insert a checkbox in the text, select the Text|Insert|Checkbox command.
Selecting this function opens the Checkbox Properties dialog window which can be used to
define the properties of the checkbox.
The Function range can be used to determine whether it should be a linked checkbox and
to define which values should be set when the box is clicked.
To enable the user to differentiate between the two types of checkboxes, checkboxes
without link are displayed square and checkboxes with link are displayed round in editing
mode. In the event display that can also be checked using the test mode (see 6.5.6 How to
test text) of the text editor, all checkboxes which are linked together and exclude each other
for selection are displayed round, checkboxes without link are displayed square.

6.5.4.9 How to insert conditional elements

Conditional elements are used to display or execute text parts in dependence of conditions.
Thus, you can, for example, define the type of information which should be displayed in texts
for event display, in dependence of the type of the event. Conditional elements are an
essential part of WinGuard enabling you to visualise a variety of events with only a few text
documents. Furthermore, the execution of commands can be made dependent on certain
conditions, thus enabling you to define complex and conditioned command sequences.
In order to insert conditional elements in the text, select the Text|Insert|Conditional
element commands. Selecting this menu command or clicking the If button opens the
Condition Properties dialog window which can be used to define a condition for the If or
Else If element. For detailed information about this dialog window, please refer to section
6.5.4.9.2 How to define conditional elements. By clicking the Else or End button, you can
directly insert an Else or End element in the text.

72
WinGuard User Manual Data supply

6.5.4.9.1 Conditional element types

You can select from four different types of conditional elements: the If element, the End
element, the Else element and the Else If element.
There are some simple rules for the use of conditional elements.
If .. End
The most simple way for using conditional elements is the display or the execution of a text
part if a condition is true. For this purpose, you have to use an If or an End conditional
element.
If <Condition>
<Text>
End
When the condition becomes true the text between the If and the End element will be
displayed or executed. Those texts which are inserted before and after the text block
between the If and the End elements will be displayed / executed in any case. The purpose
of such a text block is to display or execute an additional text when a condition becomes
true.
If .. Else .. End
If the condition does not become true, you can alternatively have another text part shown or
executed. The Else element is used for this purpose. For such a block, first insert an If
element, then an Else element and finally an End element.
If <Condition>
<Text1>
Else
<Text2>
End

When the condition becomes true text1 between the If and the Else element will be
displayed or executed. When the condition does not become true text2 between the Else
and the End element will be displayed or executed.
The text which is used within a conditioned block may also contain conditional elements.
Thus, you can interlace the conditions.
If .. Else If .. Else ..End
The Else If element is used to have the text displayed or executed in dependence of
different conditions (several alternatives).
If <Condition>
<Text1>
Else If <Condition>
<Text2>
Else If <Condition>
<Text3>
Else
<Text4>
End

73
Data supply WinGuard User Manual

If condition1 becomes true text1 will be displayed or executed. If condition1 does not
become true condition2 will be checked. If condition2 becomes true, text2 will be displayed
or executed. If condition2 does not become true condition3 will be checked, and so on. If
neither of the conditions become true the text behind the optional Else element will be
displayed or executed.

6.5.4.9.2 How to define conditional elements

Conditional elements are defined in the Condition Properties dialog window. This dialog
window is used both for inserting and modifying the properties of a conditional element.

In the Type range, you can select which type of conditional element you want to define.
These types are available:
• If An If element.
• Else An Else element.
• Else If An Else If element.
• End An End element.
In the Condition range you can state the condition for an If or an Else If element. The
condition can consist of logically linked single conditions.
The display field shows the currently defined condition. A condition can thereby consist of
several single conditions which are linked with a logical And or a logical Or. With a logical
And, the condition is met when all linked single conditions become true at the same time.
With a logical Or, the condition is met when at least one condition becomes true. That
means that this is not an exclusive Or.
Using the << and / << or buttons, you can accept the condition in the comboboxes. You can
logically link several conditions. The logical linkage will be established depending on the
selected button. It is also possible to interlace conditions. In this case, the combined
conditions will be put in parenthesis. The conditions of the parenthesis levels will be
evaluated from the deeper parenthesis level up. In order to put conditions in parenthesis,
mark those conditions that have already been defined. This is done by means of the cursor
keys. If a new condition is added the marked conditions will be put in parenthesis and linked
with the new condition.
Clicking the >> button will again remove all single conditions marked in the display field.

74
WinGuard User Manual Data supply

The following options can be used for defining a condition.

• Variable
The Variable type is used if you want to query information from the displayed or
executed text. For this purpose, the following variable types can be selected in the
second combobox:
• Schedule
With Schedule you can query whether the display or the execution of a text is performed
within a certain period of a schedule (see 6.6.2 How to edit schedules). For this purpose,
the second combobox offers all projected schedules and the fourth combobox offers all
periods of the selected schedule.
• State type
With State type you can query the current state of datapoints. For this purpose, the
second combobox offers all projected datapoints for selection. After this selection, the
fourth combobox will show the possible states of the datapoint.

6.5.4.10 How to insert commands

Commands that are inserted in a text will be worked off one after the other when the text is
being executed. If the text is only displayed the commands will not be executed. Texts with
commands are used, for example, to define reactions upon the reception and processing of
events (see 4.5 Event routing) or to define automatic commands (see 7.5.1 Overview).
In order to insert a command, use Text|Insert|Command.
Selecting this function opens the Command Properties dialog window which can be used to
define the respective command data.
The Visible / Invisible option is primarily used for defining automatic commands. With
automatic commands, it is possible to display text with commands prior to the execution.
This option enables you to select whether the commands themselves should be displayed or
only an additionally inserted explanatory text.
The fields for entering the parameters of the command are displayed in dependence of the
selected command. For more information about commands, please refer to section 6.2
Commands.

6.5.5 How to process a text

The properties of the different text components can be changed subsequently at any time.

6.5.5.1 How to change the background colour

You can select white or gray as background colour of the text. Texts with gray background
serve for the definition of forms.
Using the Text|Format|Background command, you can switch over the background colour
of the text from white to gray and vice versa.

75
Data supply WinGuard User Manual

6.5.5.2 How to define the font

The font of a text can also be changed subsequently. To do so, mark the text and select the
Text|Format|Font command. This will open the Font dialog which is quite similar to the font
dialogs in common text processing programs.
Font changes will affect static texts, variables, personal data, buttons in the “Text” display
mode and lists. A changed font will not affect other objects, like embedded text files or edit
boxes.

6.5.5.3 How to change the properties of objects

You can at any time change the properties of all objects that are inserted in the text like, for
example, variables, lists, buttons etc. To do so, position the cursor before the respective
object or mark the object. Then call up the Text|Format|Properties command. This function
can also be called up by double click or clicking the object with the right mouse button.
Depending on the type of the selected object, a properties dialog will be shown afterwards.
This is the same dialog window that is displayed when creating a corresponding object. For
more information about these dialog windows, please refer to section 6.5.4 How to insert
objects.
The WinGuard text editor offers the same functions for deleting texts or working with the
clipboard as all other parts of WinGuard or other Windows applications.

6.5.6 How to test text

The function of a text can already be tested at the time of creation using the test mode. In
addition, you can determine an event which should be triggered for testing texts for event
display.
Using the Text|Set Test Parameters menu command you can optionally determine an event
that should be triggered in the test mode. Selecting the above command will open the Set
Test Parameters dialog. Here, you can set the parameters for the test like, for example,
datapoint name, datapoint type, sensor, sensor type etc.

76
WinGuard User Manual Data supply

The test is started with the Text|Test text command. After calling up this function, the text
will be displayed in the same manner as it would be shown in the Event display window. No
further text can be entered. You can operate the inserted dialog elements and, by clicking
buttons, call up the respective commands.
By calling up the command again, you can change from test mode back to the editing mode.

6.6 Time definitions

6.6.1 Calendar
The calendar in WinGuard is used to inform the system about leisure days. The data of the
calendar are primarily used in connection with scheduled commands (see 7.5.1 Scheduled
commands) in order to differentiate between working days and leisure days.
Selecting the Other|Calendar command will open the Calendar dialog window.

The dialog will show the calendar sheets of the months for the selected year. If you click on
an individual date this will change its colour from black to red and vice versa. The red
marked days are leisure days. Using the Fill button, certain weekdays can automatically be
entered as leisure days. Clicking the Fill button will open the Enter Leisure days dialog
window where you can perform the corresponding definitions.
The individual weekdays can be selected as leisure days. By default, Sunday is defined as
leisure day. Public holidays that occur on the same date every year can automatically be
entered using the Holidays checkbox. Holidays that do not fall on a fixed date or regional
holidays must be entered manually.

77
Data supply WinGuard User Manual

6.6.2 Schedules
Schedules serve to define periods. Depending on the current time, it is often necessary to
take different measures in case of an event. With a schedule, you can, for example,
differentiate between working hours and leisure hours (periods when nobody is in the
building) or you can enter rosters or shift schedules of persons who are to be notified.
WinGuard can administer any number of schedules; in turn, each of these schedules can
contain up to 12 periods. With conditional elements of the “Period” type, (see 6.5.4.9 How to
insert conditional elements) you can check whether certain points in time fall in a certain
period of a schedule. Information which should be displayed or commands which should be
executed can then be adapted accordingly. Using schedules, you can control the behaviour
of the system in dependence of the time.

6.6.2.1 How to edit schedules

Selecting the Other|Schedules command opens the Edit schedules dialog window which
can be used to create and edit schedules.

You can use the combobox at the left upper edge of the window to select the schedule which
you want to see or edit. This box contains all schedules that have been defined before. The
comboboxes directly adjacent are used to select the month whose data should be displayed
in the field below.
The legend below the schedule field shows 12 different periods with name and related bar
colour. You can select a period by clicking the corresponding field in the legend which will
then be shown with a gray background. Clicking a field that is already marked will open the
Period dialog window which can be used to change the name and colour of the period.
If you have created a new schedule you should first define all periods that you want to use.

78
WinGuard User Manual Data supply

6.6.2.2 How to define periods

Periods are defined from their beginning marks. A period ends either by the beginning mark
of the following period or by the years end. Since each time point must be clearly assigned to
a period, the period spanning from the beginning of each calendar year up to the first
beginning mark – if available – must always be assigned to period 1.
This kind of period definition does not have effects on copying and deleting periods, as really
are the beginning marks and not the periods themselves which are copied and/or deleted. If,
for example, you want to copy the period definitions of a day, whose first beginning mark is
not placed on 0 o'clock to another day, then thereafter both days begin at the period on
which the previous day ended – and they can be completely different periods. If such an
effect is not desired, it is recommended to assign to each day which you define, a suitable
period beginning mark at 0 o'clock.
You can insert and/or move the beginning of a period in the schedule by different ways:
One way is by pulling and releasing with the mouse (drag & drop). For inserting a new
period beginning you must click first on one of the periods below the schedule field and keep
the left mouse button pressed. If you move the mouse pointer into the schedule field, the
mouse pointer symbol changes. Insert the beginning of the period into the schedule by
releasing the mouse button in the place in which you want it to be. On same way you can
also move the beginning of a period. For this you simply click on the appropriate beginning
mark in the schedule window and move it by pressing and holding the left mouse button up
to the desired position. If the mouse pointer is moved out of the schedule field and released,
the beginning of the period will be deleted from the schedule.
When establishing beginning marks for time intervals with the mouse only exact quarter of
an hour numerical data inputs are possible. For minute exact numerical data inputs you must
recur to Direct input.
You can copy an entire day definition by drag & drop. To do this, click on the current date to
be copied and keep the left mouse button pressed. If you move the pointer of mouse to
another current date and release the mouse button there, the copied daily definition is
inserted on that day.
You can also insert and/or move the beginning of a period via the edit box or by clicking the
button at the top right of the schedule. For inserting you select first the day and period with
the mouse. In the edit box you enter the time in either the [HH:MM] or [HH.MM] (this is,
“12:15”" or “12.15”). If you now click on the button or press the <Enter> key, you will insert
the beginning of a period on the selected day at the appropriate time. For moving the
beginning of a period you must first mark the appropriate beginning mark in the schedule
field by clicking on it with the mouse. The time is then transmitted to the edit box. There you
can change and move the time by clicking the buttons and/or by pressing the <Enter> key at
the beginning of the period accordingly. You can also completely delete the marked
beginning of a time interval with the <Del> key.

6.6.2.3 How to fill periods in the schedule

Defining the schedule for a whole year would be very complex, if you had to make the
corresponding adjustments for each day. However, the succession of periods in a certain
day or week usually repeats itself. Therefore there is the possibility of automatically filling the
periods of the schedule and of transferring there the updated selected daily intervals for one
or for several days starting with the updated selected day to other periods.
For this, first select one day whose definitions you would like to copy or start from the
definitions of a sequence of several days which you would like to copy Click on the Fill
button! The Fill period dialog window will be opened for you to select the appropriate data
from it.

79
Data supply WinGuard User Manual

6.6.2.4 How to delete a period from the schedule

In order to delete the definitions for certain periods, click the Delete button. This will open the
Delete Period dialog window which can be used to select the respective period.

6.7 Lists
Lists serve to predefine options for user inputs. A list consists of any number of character
strings as entries. During the installation of the example data, the “Alarmtype” will, for
example, be created. This list contains the entries “Real-alarm” and “Test-alarm”. When
projecting texts for event display (see 6.5 Text) you can, for example, insert comboboxes as
interactive objects. Such a combobox is then assigned a list. During the event display, the
user can then select among the entries of the list. Furthermore, you can insert checkboxes in
the text and assign them a list and an entry from the list. Clicking the checkbox during event
display will select the assigned list entry. Such user entries will be saved in the archive,
along with the event, in the form of “Datatype/Value”. “Datatype” corresponds to the name of
the list and “Value” corresponds to the selected entry. Later on, you can directly search for
such entries in the Event archive (see 7.4.2 Event archive).
Selecting the Other|Lists command opens the Edit lists dialog window which can be used
to create and edit lists.

The combobox top left in the window offers all defined lists for selection. The functions in the
buttons are used for editing the lists.
Changes on the list entries are only saved when you click on the Save button. If the dialog is
closed with the Close button changes on list entries will not be saved. In contrast, if lists are
created, copied or deleted these actions will be performed immediately.

6.8 Locations
During projecting, each datapoint or individual sensor defined in WinGuard can be assigned
a location (see 6.3.3 Datapoints). On the one hand, this serves for information purposes, for
example during event display; on the other hand, it enables, at many points of the program,
a direct access to datapoints and events from certain areas.

80
WinGuard User Manual Data supply

In WinGuard, all locations are centrally administered in a hierarchically structured location

register. This register contains up to four hierarchy levels that can be used according to your
needs. For example, on the topmost level you can roughly indicate the location (e.g. areas of
the company grounds); the next levels can be used to define the buildings or buildings
complexes within these areas, the floors within a building, the rooms on each floor etc. The
location definitions on the second, third and fourth level are optional. You can also use only
one or two levels.
The location register is accessed by means of the explorer. The Locations explorer window
shows the location hierarchy. Each location entry can optionally be assigned a graphic and a
text. Furthermore, the control rights for this location can be limited (see 6.11 Rights). You
can open a context menu for each location entry by clicking it with the right mouse button.
These context menus offer the standard functions New, Copy, Delete and Rename as well
as the additional Display function that can also be selected with a double click on the
respective location entry.
The right button in the title bar of the Locations explorer window is used both for defining
the small symbols that precede the names of the location entries in the location hierarchy
and for defining the effect of the Display function. The following three functions are
available:
• Display graphics
If the Display function is selected in the context menu and the current location entry is
assigned a graphic, then this graphic will be displayed in the Location graphic display
window. If the current location entry is not assigned a graphic, then the graphic of the
superordinate location entry will be displayed, and so on. If none of the superordinate
location entries is assigned a graphic, then this function will have no effect.
• Display texts
If the Display function is selected in the context menu and the current location entry is
assigned a text, then this text will be displayed in the Location text display window. If
the current location entry is not assigned a text, then the Location text display window
will remain blank.
• Edit locations
If the Display function is selected in the context menu, then the complete location
dataset will be displayed in the Location data window where it can be edited, depending
on the user rights.
Clicking a location entry in the opened Location text display window corresponds to
selecting the Display function in the context menu.
In the location hierarchy, location entries that are assigned a graphic and/or a text are
marked with filled symbols that precede the location name. If no graphic or text is assigned
location entries will be marked with unfilled symbols.
Definition of locations is performed in the Location data window which is opened using the
Database|Locations function. The upper area shows a form which can be used to enter the
location name, the assigned graphic and the assigned text. In addition, this window is used
to assign conrol rights to the location entries.
By assigning rights classes to a location (see 6.11 Rights), the control right for this location
and all subordinate locations will be limited. The control right for a location is defined as
follows: If no rights classes have been assigned to the location or its superordinate locations,
then there will be no limited control right for this location. Otherwise, the control right will be
determined by the rights classes that are assigned to the location itself or its superordinate
locations.
If applicable, the lower area of the Location data window will show the assigned graphic
and the assigned text as preview. Context menus enable the editing of graphics and texts.

81
Data supply WinGuard User Manual

The assignment of a graphic or a text to a location entry can also be performed by selecting
the desired file from the Graphics explorer or Texts explorer and moving it by drag & drop to
the respective preview window.
The toolbar of the Location data window offers different functions (buttons) for additional
editing of location entries.
Using the moving functions (buttons with arrows), the selected location entry can be moved
to the hierarchy.
If you change the locations hierarchy levels subsequently, then the system will no longer be
able to assign the links, previously defined in the Datapoints file (see 6.3.3 Datapoints), to
the respective locations. In this case, the respective links will become invalid. A message
box will inform you about this problem. You can then decide whether you really want to move
this entry or whether you want to cancel the command.
If you use the context menu to perform changes on the location hierarchy the Edit locations
function will be selected automatically and the Location data window will be opened.
Changes on the location hierarchy must be saved before the Show graphic and Show text
functions can be seleted again.

6.9 Sensor types

In WinGuard, each defined datapoint or sensor can be assigned a datapoint type. Upon
definition of a datapoint type, a symbol will be indicated. If a sensor is moved from the
explorer to a graphic using drag & drop this symbol will be inserted in the graphic.
Calling up the Other|Sensor types command will open the Sensor types dialog which
shows the assignment of all sensor types defined in the system to a corresponding symbol.

The table of the dialog lists all sensor types that are defined in the system. The symbol that
is assigned to the currently selected entry will be displayed in the lower right corner of the
dialog. The columns of the table contain the following information for each entry:
• Symbol/Datapoint type
The first column shows the symbol for the datapoint type.
• Name
This column contains the names of the individual datapoint types.
• Name as
This column contains an optional name for each datapoint type. If the datapoint type
variable is used in the text or in the graphic this name will be displayed.

82
WinGuard User Manual Data supply

Using the available functions (buttons) New, Copy and Edit, the sensor types can be edited
in the Define Sensor Type dialog.

6.10 User defined surface

WinGuard allows the user to configure the program surface as required. You can define a
separate program surface for each user profile (6.3.5 User profiles) and determine which
menu (6.10.1 How to edit menus), which toolbar (6.10.2 How to edit toolbars) and which
shortcut table (6.10.3 How to edit shortcuts) should be used. Menus, toolbars, shortcut
tables and selectable functions can be defined according to your wishes. For this purpose,
you can make use of all predefined program commands or create your own commands
(6.10.4) for executing any desired action in the program.
With an individually created program surface, you can ensure that certain users can only
access those program functions that are relevant for their work. And you can adapt the
usage of the surface to the special requirements of a workstation. If you intend to use a
touch screen, then you can, for example, create a surface which, to a large extent, can be
controlled via buttons.

6.10.1 How to edit menus

Selecting the Other|Menus command opens the Edit menus dialog window which is used
for defining menus.

The combobox at the upper edge of the window is used to select the menu that should be
edited. This comobox will show all menus that are defined in the system.
The selected menu will then be shown in a tree structure. When opening the dialog, all main
menu entries will be shown. As a rule, all these entries contain appropriate submenus.
You can edit the menus using the available functions (buttons). The two comboboxes and
the edit box at the right edge of the dialog are used to define the function and appearance of
a menu entry.
Changes on the menu entries are only saved when you click on the Save button. If the
dialog is closed with the Close button changes on menu entries will not be saved. In
contrast, if menus are created, copied or deleted these actions will be performed
immediately.

83
Data supply WinGuard User Manual

6.10.2 How to edit toolbars

Selecting the Other|Toolbars command opens the Edit toolbars dialog window which can
be used to create and edit toolbars.

The combobox at the upper edge of the window is used to select the toolbar that should be
edited. This combobox will show all toolbars that are defined in the system.
The selected toolbar will be displayed in the list field. In the left column, the buttons are
shown in the same way as in the toolbar. The column right beside the symbols displays the
corresponding commands.
With the option boxes on the lower edge of the dialog, you can define the appearance of the
buttons.
Changes on toolbars are only saved when you click on the Save button. If the dialog is
closed with the Close button changes on toolbars will not be saved. In contrast, if toolbars
are created, copied or deleted these actions will be performed immediately.
The two comboboxes and the edit box at the right edge of the dialog are used to define an
entry of the toolbar. The order of the entries in the toolbar can be modified at any time.

84
WinGuard User Manual Data supply

6.10.3 How to edit shortcuts

In order to define and administer shortcut tables, select the Other|Shortcuts menu item
which will open the Edit Shortcuts dialog window.

The combobox at the upper edge of the window is used to select the shortcut table that
should be edited. This combobox will show all shortcut tables that are defined in the system.
Subsequently, the entries of the currently selected shortcut table will be listed along with
shortcut and assigned command:
Changes on shortcut tables are only saved when you click on the Save button. If the dialog
is closed with the Close button changes on shortcut tables will not be saved. In contrast, if
shortcut tables are created, copied or deleted these actions will be performed immediately.
Using the Category and Command comboboxes, you can select the command that should
be assigned to a shortcut.

6.10.4 How to edit commands

During the definition of menus, toolbars and shortcut tables, each entry is assigned a
command. The available commands are divided in different categories. These categories
correspond to the main menu points of the WinGuard standard menu. The “User defined”
category is additionally available to enable the creation of user defined commands.
You have the possibility to modify menu texts and symbols that are assigned to predefined
commands and you can create new user defined commands in the “Self-defined” category.

85
Data supply WinGuard User Manual

To do so, call up the Other|Commands menu command which will open the Edit
Commands dialog window.

Using the Category combobox, you can select one of the command categories that are
available in WinGuard. The categories “System“, “Edit“, “View“, “Functions“, “Files“,
“Graphic“, “Text“, “Other“, “Window“ and “Help“ correspond to the main menu points of the
WinGuard standard menu. These catagories contain commands that can also be selected
via the entries of the appropriate menu as well as further commands that belong to the same
area. The “Self-defined” category will be blank at first. In this category, you can save your
own commands that should be used in menus, toolbars or shortcut tables.
The list field shows the commands of the selected category with name and assigned symbol.

6.10.4.1 How to define a command

For defining the properties of a command, open the Define Command dialog window. Using
this dialog, all data that are necessary for the definition of the respective areas like, for
example, Command, Display and Function can be edited and saved.
The Bitmap small and Bitmap large edit boxes are used to enter or select the name of a
bitmap graphic that should be used for the display of the command in toolbars, either with
small or large buttons. All bitmap graphics that are saved in the Graphics\Buttons directory
will be listed. The size of the small bitmap graphic should be 20x20 pixels and the size of the
large bitmap graphic 32x32 pixels. Otherwise, the bitmaps would be enlarged or reduced in
size when being displayed. You don’t need to make an entry in both boxes. If only one
bitmap is entered, this will be used both for the small and the large display. If no bitmap is
entered the command will not be available for insertion in a toolbar. The “bmp” ending can
optionally be indicated. If you do not specify a path, the graphics will be searched in the
Graphics\Buttons directory.
For displaying buttons, WinGuard uses graphics in the Windows Bitmap (.bmp) format.
Some bitmaps are already contained in the standard delivery of WinGuard. Additional
bitmaps can be created using any drawing program like, for example, the Windows Paint
program.

86
WinGuard User Manual Data supply

6.11 Rights

6.11.1 Overview
Each user can be assigned certain rights via his/her user profile. On the one hand, these
rights control the access to certain program functions; on the other hand, rights are used to
control the access to certain resources like, for example, the manual control right for certain
datapoints, locations etc.
The assignment of individual rights to user profiles is done flexibly via rights classes. Each
profile can be assigned several rights classes which, in turn, contain different individual
rights.
The following graphic shows the rights assignment in WinGuard:

Person

User profile

Surface

Rights class 1 Rights class 2 ..... Rights class n

Manual
control

Delete Control right Control right

events Location A Device 1

Edit Control right Control right

personal data Location B Device 2

Control right Control right Control right

Object MG 1 Object MG 2 Object MG 3

Each person with access to the system is assigned at least one user profile (see 6.3.5 User
profiles). If a person is logged in, one of the user profiles assigned to him/her will be active.
This profile determines both the appearance of the user interface and the rights of the
person who is logged in with this profile.
In order to avoid that each user profile must be assigned numerous so-called single rights,
rights assignment is done via rights classes. WinGuard administers up to 32 rights classes.
Each user profile can be assigned an arbitrary number of rights classes defined in the
system; each rights class, in turn, contains an arbitrary number of single rights. This means
that a user profile is assigned all those single rights that are contained in at least one of the
rights classes that are assigned to him/her.
Basically, a single right can be seen as a permission to execute a program function, e.g.
“Edit personal data”, as a right to control all datapoints of a location defined in the system, as

87
Data supply WinGuard User Manual

a right to control a datapoint defined in the system or as a right to control a device defined in
the system.
In order to be able to control a datapoint, a user must be assigned the following rights:
control rights for the respective datapoint, corresponding rights for the location at which this
datapoint is located and control rights for the device which the object is linked to.
If a datapoint is assigned rights classes, the control right for this datapoint will be limited to
persons with these rights classes; otherwise, the access will not be limited.
Same applies for the control right of a device (see 4.3.1 How to define devices).
By assigning rights classes to a location (see 6.8 Locations), the control right for this location
and all subordinate locations will be limited. The control right for a location is defined as
follows: if no rights classes have been assigned to the location or its superordinate locations,
then there will be no limited control right for this location. Otherwise, the control right will be
determined by the rights classes that are assigned to the location itself or its superordinate
locations.
Although it is possible to assign different locations to each single sensor of a datapoint,
control rights do not depend on the location of the single sensor but on the location of the
datapoint which the sensor is assigned to.
If a user profile is not assigned any specific rights class, the respective person will be
implicitly assigned all possible single rights and thus a total access to the complete system.
Let’s look at a simple example: If you have projected two buildings in your system and you
want to assign a group of users only control access to building 1, another group only control
access to building 2 and the third group control access to both buildings, you have to define
a rights class with access rights to building 1 and another rights class with access rights to
building 2. The first rights class is assigned to a user profile that is used by the first group of
users; the second rights class is assigned a user profile that is used by the second group of
users. Finally, the two rights classes are assigned to a user profile that is used by the third
group of users.

6.11.2 How to define rights

Use the Other|Rights command to call up the Define rights dialog window:

88
WinGuard User Manual Data supply

If you are in the “Profiles” mode and you select a profile from the left list field, the centre list
field will show which rights classes are assigned to this user profile. You can change the
assignment by placing checkmarks in or removing them from the boxes before the individual
rights classes. The right list field will then show the respective effects on the single rights.
Those single rights that are assigned to at least one of those rights classes that, in turn, are
assigned to the current user profile will be checked off.
If you are in the “Rights classes” mode and you select a rights class from the centre list field,
the left list field will show the profile(s) that this class is assigned to. This assignment can be
directly changed. The right list field will show the single rights that are assigned to the
respective rights class. This assignment can be directly changed as well. But please note
that not all single rights can be selected independent of each other. For example, it is not
very meaningful to enable a user to delete an event while he/she is not allowed to process
an event. Therefore, if the single right “Delete events” is assigned, the single right “Edit
events” will automatically be assigned as well.
Modifications on the assignment of rights classes relating to the profile you are currently
logged in with will become effective only after a re-login (see 5.1.1 Login) or at least after a
profile change (see 5.1.4 Change profile) to the currently selected profile.
If you are in the “Single rights” mode and you select a single right from the right list field, the
centre list field will show the rights class(es) that this single right is assigned to. This
assignment can be changed in the centre list field by placing checkmarks in or removing
them from the checkboxes before the respective rights classes. The left list field will then
show which user profiles this single right is assigned to.
The single rights for program functions that are defined in the right list field relate, for the
most part, to the permission for changing data. The read access on the respective data
cannot be limited by rights. If you want to create a user profile in the way that even a read
access on certain data is not allowed, then the menus, toolbars and shortcuts that are
assigned to this user profile must be defined to exclude the access to the corresponding
program functions.

89
Data supply WinGuard User Manual

In the Define rights dialog window you can neither view nor change control rights for
datapoints, locations or devices. These are directly defined at the corresponding datapoints
(see 6.3.3 Datapoints), locations (see 6.8 Locations) and devices (see 4.3.1 How to define
devices).

90
WinGuard User Manual WinGuard in use

7 WinGuard in use
7.1 Overview
After the system has been installed and provided with data, it fulfils its actual task in daily
use. It interlinks safety and building automation systems and serves as the central operating
and control unit. Furthermore, it can link the connected devices on a superordinate level.
Part of the functionality will already be predefined during projecting, for example when
defining commands in event routing and at datapoints that should be executed upon the
reception or display of an event. At this point, the user can no longer influence the system.
The functions which are accessible to the user can be divided into three main task areas.
Event processing
Event processing will be described first. Events are triggered by the relevant interface
module as a consequence of corresponding incidents in the linked systems. WinGuard
administers events in a uniform manner, independent of the affected subsystem. As a rule,
events require a reaction from the user. One of WinGuard‘s essential tasks is to provide the
user with comprehensive additional information or help about the individual events and to
support him/her in performing necessary steps. For more information about event
processing, please refer to section 7.2 Event processing.
Device operation
Furthermore, WinGuard offers the possibility to get information about the state of certain
objects and areas, independent of event processing, and to operate the linked devices in a
comfortable way. For more information about this topic, please refer to section 7.2 Event
processing.
Documentation
The third task of WinGuard is to document all activities in the system in a traceable way and
to enable a systematic investigation in the saved data files. The mentioned functions are
described in section 7.4 Documentation.
And WinGuard comes with some further functions. You can, for example, define scheduled
command that will be carried out at a specific point in time once or in specific intervals (see
7.5.1 Scheduled commands). In addition, the “Notification function” enables a
communication between distant network workstations (see 7.5.2 Notification function).

7.2 Event processing

External events
Incidents in the linked systems lead to the triggering of corresponding events in WinGuard.
The responsible interface module assigns one of the categories “Alarm”, “Prealarm”,
“Warning”, “Fault” or – for all other incidents – “Event” to each event. In addition, each event
is assigned a state text (freely definable). Depending on the interface module, you can thus
receive more exact information about the respective incident which triggered the event. In
addition, the interface module assigns a priority between -1 and +999 to each event. With
some interface modules, this priority will directly be applied from the linked device; or it can
optionally be determined for the individual event categories of an interface module, either
globally for all event categories or individually for each single datapoint. The interface
module will then transmit the event along with this and further information to WinGuard for
further processing.

91
WinGuard in use WinGuard User Manual

Internal events
In addition to events triggered by incidents in the linked systems, WinGuard enables also the
manual release of so-called user alarms (see 7.2.4 User alarm) from the WinGuard user
interface or the simulation and any event (see 7.2.5 Event simulation). User alarms will be
assigned the priority that was projected for alarms at the corresponding object and they will
receive the state text “USRAL”. Generally, simulated events will have the lowest priority (-1)
and the state text will be “SIM-“ followed by an abbreviation for the respective event type,
e.g. “SIM-AL”. In the further course of processing, such events will be handled in the same
way as events from the linked systems.
Event routing
Upon reception of an event, WinGuard will first execute the text for event routing (see 4.5
Event routing). There, you can define corresponding commands and determine, for example,
the workstation that should be responsible for the processing of the event. If no special
workstation has been defined, workstation 1 which is set by default will perform the
processing. In addition, it is also possible to determine that „<No workstation>“ is
responsible. In addition, you can also define workstations that should be alarmed, i.e. you
can determine workstations at which the event should be signalised by an audible signal and
shown in the event display window.
Projected actions
The actions that have been defined at the datapoint which triggered the event will then be
executed for the first time. The execution moment can be queried in the event routing script
via a corresponding condition.
Event list
Afterwards, the event will be entered into the event list (see 7.2.2 Event list) in the stack of
“current events” where it can be selected for further processing. The event will be visible in
the event list only if the respective workstation is responsible for the processing of the event
or if “<No workstation>“ was defined for the processing of the event or if the “All Events”
option is selected.
Event display
From the event list, each event can be displayed along with the assigned text and graphic
documents (see 7.2.3 Event display). The event will automatically be displayed at the
workstation which is responsible for the processing of the event, provided that no other event
with higher priority is processed at the same time. In addition, an audible signal will notify the
operator at this workstation about the reception of the event. Text and graphic that should be
shown in event display must be defined separately for each datapoint during projecting.
Since WinGuard supports also the possibility to inform any workstation – in addition to that
workstation which is responsible for event processing – by an audible signal or via the event
display about the reception of an event, it is also possible, depending on the user rights (see
6.11.2 How to define rights), to fetch the event and direct it to another workstation than that
which is responsible for the processing. This means that another workstation is manually
defined as responsible workstation.
In any case, each event can only be processed by one workstation. It is not possible that
several workstations process the same event at the same time. However, the completion of
forms in the text documents that are assigned to the event is only possible from the currently
responsible workstation. Depending on the set rights, all other workstations may have read
access but not write access to the corresponding interactive text elements.
Processing
At the responsible workstation, both the event list and the event display will offer the
functions “Accept“, “Fetch“, “Control“, “Reset All“, “Explore“, “Defer/Attend“ and “Complete“
for processing the event (see 7.2.1 General functions for event processing). With “Delete”,
the event will be removed from the event list and transmitted to the event archive (see 7.4.2
Event archive).

92
WinGuard User Manual WinGuard in use

Workstations that are not responsible for the processing of the event will show a deviating
behaviour. Direct display of the event will only be performed at alarmed workstations. If
another workstation is determined as responsible, the event list will offer the “Fetch” function
instead of the “Acknowledge” function.
The actual behaviour during event processing may slightly deviate from the described
sequence. Options for this topic can be selected in the WinGuard system control on the
Event tab (see 4.2 Settings) in the Settings dialog.

7.2.1 General functions for event processing

You will immediately be informed by an audible signal when the system receives an event
that meets the definitions for your workstation (Responsible workstation, Notify workstation).
Using the Horn off command in the toolbar, you can switch off this signal.
The following general functions are offered for event processing:
Accept
With Accept, you confirm that you have noticed an event. Accepted events will no longer
flash in the event list. The time at which you accepted the event and your user name will be
noted; this makes you responsible for this event and it’s further processing. The
acknowledgement of an event is only possible at the responsible workstation or if the event
was not yet assigned a workstation. In this case, your workstation will be considered
responsible after you have acknowledged the event.
When an event is being acknowledged, the audible signal both at the responsible
workstation and at the alarmed workstations will be stopped automatically. And the event
display of the alarmed workstations will no longer show this event. In addition, a message
will be sent to the responsible interface module. Depending on the used interface module, a
command may be executed as reaction to the acknowledgement of the event.
Fetch
By selecting the Fetch command, you will take the processing of an event that was
previously assigned to another workstation. Your workstation will be considered responsible
for this event and from then on it will be your task to process the event. By selecting the
Fetch command, the event will not automatically be acknowledged.
Commands
The availability of this action is dependent on the interface module, the respective event and
the state of the datapoint. You will receive a list will all possible, event-dependent
commands.
Explore
Selecting the Explore command starts the exploration after an alarm has been received. The
availability of this action is dependent on the interface module, the respective event and the
state of the datapoint.
ResetAll
With this command, you can reset complete devices or individual datapoints. This button is
only enabled if this action is necessary for an event and supported by the alarm system. The
exact function of the button depends on the used interface module.
Defer
The Defer command is used to defer an event for further processing. In this case, the event
will be transferred from the stack with “current events” to the stack with “deferred events”
from where it can be selected again at any time.
Attend
With this button, a deferred event can be fetched back again. In this case, the event will be
transferred from the stack with “deferred events” to the stack with “current events”. This
function is only available from the list of the deferred events.

93
WinGuard in use WinGuard User Manual

Complete
Selecting this command will complete the event processing. The event will be removed from
the event list and, if applicable, transferred to the event archive. In order to determine which
events should be archived, select the Global folder in the Settings dialog and make your
definitions in the Archive area under Event handling (see 4.2 Settings). An event can at any
time be displayed again by selection in the event archive. For more information about the
event archive, please refer to section 7.4.2 Event archive. Upon completion of event
processing, an unaccepted event will, at first, be acknowledged automatically and a
message will be sent to the responsible interface module. Depending on the used interface
module, a command may be executed as reaction to the acknowledgement of the event.

7.2.2 Event list

During their processing, incoming events will be saved in the event list which is shown at the
lower edge of the main window. Depending on their state or progress of processing, events
will then be administered in the stacks “Alarm“, “Fault“, “Active“, “Other“, “All“ etc. and can be
listed according to time or priority. The display of the individual stacks is selected with the
corresponding tabs below the event list. The tabs are marked with the type and the number
of events. With the additionally available buttons, you can, for example, call up the general
functions for event processing (see 7.2.1 General functions for event processing).
If not yet visible, the event list with the corresponding stack will automatically be displayed
upon reception of an event. Using the View|Event list command the visibility of the event list
can be switched on or off at any time. If the event list is visible the menu point will be
displayed with a different background colour.

The size of the event list can be changed at any time using the Windows common
mechanisms.
The corresponding tables will list all events of the selected stack according to time or priority.
The last received event or the event with the highest priority will be displayed topmost. The
individual columns of the table contain the following information:
• Symbol
Type of datapoint
• Datapoint
Name of datapoint or sensor.
• State
State text of the event (freely definable). Depending on the interface module, this gives
more exact information about the respective incident which triggered the event.
• Location
Location that was assigned to the datapoint or the individual sensor during projecting.
• Begin
Date and time of event reception.

94
WinGuard User Manual WinGuard in use

• End
Date and time of end event. Events for which no end event is expected will be marked
with “-----“.
• Prio
Priority of the event.
• WS
Number of the workstation which is responsible for the processing of the event.
Clicking the table with the right mouse button will open a context menu which offers the Print
function. This enables you to print the list on the currently selected printer.
Depending on their state or progress of processing, events will be administered in different
stacks that can be selected via the corresponding tabs below the event list. The tabs will also
show the number of events that are contained in the respective stack.
Sorting
By clicking the column headings of the table, the data in the columns can be sorted in
ascending/descending order. This is indicated by a small arrow on the right side of the
column heading. By clicking the same column heading again, you can switch from ascending
to descending order and vice versa.
Local workstation / All workstations
With this two buttons, you can select whether the events for all workstations or only the
events for the local workstation should be displayed. Events which are not assigned a
workstation will be handled like events for the local workstation. The button of your selection
will be displayed with a background colour. If you have selected the display of events for the
local workstation and your workstation is notified about an event that is assigned to another
workstation, the display will then automatically switch to the “All workstations” mode –
provided that you are assigned corresponding user rights.
Display
Clicking on an event will open the Event display window (see 7.2.3 Event display) which
shows the text and graphic documents that are linked to the event.
The functions for processing the event list are described in section 7.2.1 General functions
for event processing.

95
WinGuard in use WinGuard User Manual

7.2.3 Event display

The Event display window shows an event incl. the text and graphic documents that are
assigned to it. Under certain circumstances, this window will open automatically upon
reception of a new event; in addition, it can be called up from the event list.

Infobar Toolbar

Graphic display Text display

Toolbar
Just as all other subwindows in WinGuard, the Event display window contains a local toolbar
at the upper edge of the window. With this toolbar, you can call up all important functions for
displaying and processing the shown event. However, the display of the toolbar in this
window can optionally be selected.
Infobar
The display of the infobar below the toolbar is also optional. This infobar will again show the
most important information about the event like, for example, the time of event reception, the
name of the datapoint which triggered the event, the state text of the event and the remark
that is entered for the datapoint. Since all this information is also visible in the event list, the
infobar will not be displayed by default.
The visibility of toolbar and infobar can be configured via the WinGuard system control in the
Settings dialog (see 4.2 Settings).
Display area
The display area of the window shows a graphic or a text or even graphic and text next to
each other. The division of the display area can be determined freely; to do so, click on the
boundary line in the centre of the display area and move it with pressed mouse button.
Graphic
If you open the window or select a new event for display, the first of the five graphics that are
assigned to the datapoint will be displayed in the left part of the display area. Using the
corresponding buttons in the toolbar and the interactive buttons and areas in the graphic,
you can switch to other graphics and call up further functions. The symbols in the graphic will
inform you about the event state of the datapoint and enable optionally the selection of an
associated control panel.
Text

96
WinGuard User Manual WinGuard in use

The right section of the display area will show the text that is assigned to the datapoint. The
interactive fields of the text can be used for marking entries and the interactive buttons
enable you to select other texts for display or call up further functions.
If a datapoint has not been assigned a graphic the assigned text will cover the complete
display area. Same applies if only a graphic but no text has been assigned to the datapoint.
The toolbar of the window offers the following functions:
Graphic 1 / Graphic 2 / … / Graphic 5
Using these buttons, you can switch over to one of up to five graphics that are assigned to
the datapoint which triggered the event. The first graphic will be displayed by default. If no
corresponding graphic has been defined the respective button will be displayed with a
background colour.
If a different graphic is displayed after having selected a button, then the original graphic file
is not longer available and cannot be loaded.
Graphic|Tool|Zoom
During display, the size of a graphic will be adjusted by default so that it can be displayed
completely while using the available area in an optimal way. Using the zoom function, which
can be called up with this button, you can increase or reduce the size of the graphic display
and fix the display window that is visible when zooming in. When the function is enabled the
button will be shown pressed and the mouse pointer will change to a magnifier when moving
it over the graphic. If you click the graphic with the left mouse button it will be zoomed in; if
you click with the right mouse button the graphic will again be zoomed out. The point on
which you clicked becomes the centre of the new display window. If you click the graphic
with pressed mouse button the graphic will move with the movement of the mouse. First, the
movement will be indicated as a line; the command will be executed only after release of the
mouse button. To finish the magnifier function, press the button again. The window will then
show the complete graphic in maximum size.
When the magnifier function is enabled, it is not possible to click interactive buttons or areas
in the graphic.
Current states
Using this button, the current states for the displayed graphic can be switched on or off. If
this mode is enabled, the button will be displayed with a background colour. The normal
display will only show the symbols of the respective datapoint in event state. The symbols of
the other datapoints will be hidden. When displaying a graphic in the information and control
mode, the symbols of all datapoints will be displayed showing the current state of the
datapoints. The remaining graphic functions are identical.
Back
If you selected one of the buttons in the toolbar or the graphic to switch over to another
graphic, clicking this command will bring you back to the last displayed graphic.
Graphic only
If you select this button the complete display area will be used for displaying the graphic.
Graphic and Text
If you select this button graphic and text will be displayed simultaneously. The display area
will be divided in two sections. The left section will show the graphic and the right section will
show the text.
You can modify the sizes of the sections for graphic and text. This division will remain active
until the user logs in again.
Text only
If you select this button the complete display area will be used for displaying the text.
Text|Back

97
WinGuard in use WinGuard User Manual

If you had switched over to another text this command will bring you back to the last
displayed text.
Back
With this button, you can reset the group of sensors or the complete alarm system. This
button is only enabled if this action is necessary for an event and supported by the alarm
system. The exact function of the buttons depends on the used interface module.

7.2.4 User alarm

The user alarm can be used to manually trigger an alarm for a datapoint from the WinGuard
surface. Special incidents like, for example, an alarm transmission via telephone can be
integrated into the normal event processing process, thus enabling an optimal use of the
system resources. For this purpose, you can create special datapoints along with necessary
text and graphic documents that are not linked via an interface and release the user alarm
manually.
Selecting the Functions|User alam command will open the Trigger alert dialog window
which is used to trigger a user alarm.

In the Selection area, you can select certain datapoints. The selection criteria will be linked
together by a logical AND-linkage, i.e. only those datapoints will be selected that meet all
criteria simultaneously.
Using the three location comboboxes, you can select the datapoints via their locations. The
first combobox will offer all locations that are at the topmost level in the location hierarchy
(see 6.8 Locations). If the next level in the hierarchy also contains locations for the selected
location, these will be offered in the second combobox, and so on.
If you select a location from one level the entries in the comboboxes of the subordinate
levels will be deleted. This is helpful when you want to change a location selection.
The table will show all objects that meet the selection criteria.
The OK button will release a user alarm for the datapoint selected in the table and finish the
dialog. A double click on a datapoint in the table has the same effect.
The Cancel button will finish the dialog without releasing the user alarm.

98
WinGuard User Manual WinGuard in use

7.2.5 Event simulation

WinGuard offers the possibility to simulate any event. You can test the reaction of the
system to certain incidents in advance. Event simulations are an important tool in system
setup and, in addition, provide an effective training program for the operators.
Selecting the Functions|Simulation command will open the Event simulation dialog
window which is used to trigger an event simulation.

In the Selection area, you can select certain datapoints. The selection criteria will be linked
together by a logical AND-linkage, i.e. only those datapoints will be selected that meet all
criteria simultaneously.
Using the three location comboboxes, you can select the datapoints via their locations. The
first combobox will offer all locations that are at the topmost level in the location hierarchy
(see 6.8 Locations). If the next level in the hierarchy also contains locations for the selected
location, these will be offered in the second combobox, and so on.
If you select a location from one level the entries in the comboboxes of the subordinate
levels will be deleted. This is helpful when you want to change a location selection.
The table will show all objects that meet the selection criteria.
The Sensor combobox will list the projected sensors of the datapoints that have been
selected in the list. If you want to simulate an event for a single sensor, the respective sensor
must be selected from this list.
In the checkboxes Alarm, Fault etc., you can select which kind of event you want to
simulate.
The OK button will release a simulation event for the datapoint selected in the table and
finish the dialog. A double click on a datapoint in the table has the same effect.
The Cancel button will finish the dialog without releasing the simulation event.

99
WinGuard in use WinGuard User Manual

7.3 Device operation

In WinGuard, it is possible, even outside event processing, to get informed about the state of
certain objects and areas and to operate the linked devices.
This can either be done using specially defined graphics with interactive symbols and control
buttons (see 7.3.1 Control graphics) or via the control panels that WinGuard offers for the
various subsystems (see 7.3.2 General control panel).

7.3.1 Control graphics

WinGuard uses graphics for displaying an event in the Event display window (see 7.3.2
General control panel). The display will then only show the symbols of the respective object
in event state. The symbols of the other objects will be hidden. When displaying a graphic in
the information and control mode, the symbols of all objects will be displayed showing their
current state. The remaining graphic functions are identical.
The information/control mode for the displayed graphic can be switched on or off using the
Current states command in the Event display window. If the mode is enabled, the button
will be displayed with a background colour.
In addition, you can display any graphic in the display/control mode independent of the
processing of events. The display will then be effected in a separate window. A graphic
which is assigned to an intercom can, for example, be called up from the intercom control
panel (see 7.3.5 Intercom control panel). You can also create self-defined commands (see
6.10.4 How to edit commands, display them with Show graphic and insert them in the menu
or toolbar that you use.
The toolbar of the graphic window offers the same functions as the event display:
Graphic|Tool|Zoom
With this command, you can define the zoom in level and, in addition, the visible section of
the graphic. If you have selected this function the button will be shown with a background
colour and the mouse pointer will change to a magnifier. If you click the graphic with the left
mouse button it will be zoomed in; if you click with the right mouse button the graphic will be
zoomed out. The point on which you clicked the graphic will become the centre of the new
display window. If you click the graphic with pressed mouse button the graphic will move with
the movement of the mouse. First, the movement will be indicated as a line; the command
will be executed only after release of the mouse button.
Back
If you selected, for example, the Switch graphic action to switch over to another graphic,
clicking this command will bring you back to the last displayed graphic.
In WinGuard, only one window will remain open for graphic display. Therefore, the Event
display window will be closed automatically when you execute a command with the Show
graphic action; the graphic display window, in turn, will be closed when you call up the
Event display.

100
WinGuard User Manual WinGuard in use

7.3.2 Control panels

The control panels in WinGuard are used to query the state of sensor groups and other
objects as well as to operate the linked devices. Control panels are dialog windows that do
not interrupt the program and can thus be used at any time to control the linked devices.
WinGuard offers three control panels of this kind. With the General Control Panel, you can
get information about the state of all objects that are defined in the system and execute the
possible control commands for each object. The Camera Control Panel enables the control
of a connected video cross bar and, if a video overlay card is installed, the overlay of a video
image. And with the Intercom Control Panel you can control a linked intercom system.
Some interface modules offer an individual device control panel in addition to these three
preintegrated control panels.
Handling is identical for all control panels. A control panel is opened and closed via the
corresponding entry in the menu or toolbar. Upon display of the control panel, the menu item
will be checked and the button will be shown pressed. The corresponding control panel can
also be opened by clicking an object symbol in the graphic. If there is a device control panel
for this object, this will be enabled; otherwise, the suitable integrated control panel will be
opened. When being opened, a control panel will always appear at the same place where it
was last time when it was used.

7.3.3 General control panel

With the General Control Panel, you can get information about the state of all objects that
are defined in the system and execute the possible control commands for each object.
Using the View|General control panel command, you can display the General control
panel and hide it again. When the control panel is visible, the menu item will be shown with
a different background colour. You can change the size of the General control panel by
pulling with the mouse on one of its edges or corner handles.

The comboboxes at the upper edge of the window are used to enter selection criteria.
Datapoints which meet the criteria will then be shown in the list. The entries in the individual
comboboxes will be linked together by a logical AND-linkage, i.e. only those datapoints will
be listed that meet all criteria simultaneously. In addition, you can also select “All” in any of
the comboboxes. If you select “All”, there will be no limitations for the respective criterion.
When a selection criterion is changed, the list of the datapoints will be updated immediately.

101
WinGuard in use WinGuard User Manual

Selection criteria:
• Datapoint type
• Device
• State
• Location hierarchy
If you select a location from one level the entries in the comboboxes of the subordinate
levels will be deleted. This is helpful when you want to change a location selection.
The table will show all datapoints that meet the selection criteria. The list consists of three
columns. A symbol indicates the type of the datapoint. The name of the datapoint will be
displayed beside the symbol. And, finally, the state of the datapoint will be indicated by one
or more symbols. If individual sensors have been defined for a datapoint, this will be
indicated by a + on the symbol for the datapoint type. If you click the +/- the entries for the
appropriate sensors will be displayed or hidden again.
When selecting an entry from the list with datapoints and sensors, the lower edge of the
window will show the complete location and the remark that you entered for this object or
sensor during projecting.
The list at the right edge of the control panel shows all possible control commands for the
selected datapoint or sensor, e.g. “On”, “Off”, and so on. Selection is done by clicking on the
respective datapoint or sensor.
If required, the two edit boxes above the list with the control commands are used to enter
two additional parameters for the control command. Please consult the documentation of
your interface module to see whether a control command requires parameters and which
meaning is attached to them.
Using the Execute button, you can execute the chosen control command for the selected
datapoint or sensor. Control commands can also be executed in the Datapoints explorer
window (see 7.3.6 Control commands in the Datapoints explorer window).
There is a slight difference between the control via the General control panel and the
control via the Datapoints explorer window. When being opened, the General control panel
will no longer recognise modifications on the database like, for example, the deletion,
creation or renaming of objects. The Datapoints explorer window, however, will at any time
show the current database.
When pressing the Print button, the contents of the window will be printed on the currently
selected printer.
When pressing the Hints button, an additional edit box will be shown at the lower edge of
the General control panel; this edit box can be used to enter hints about the currently
selected object. All the hints which are recorded at a datapoint at the time of event reception
can be displayed in event texts via the Hints variable (see 6.5.4.2 How to insert variables).
This function is primarily designed for documenting deactivations, but it can also be used in
other ways.

102
WinGuard User Manual WinGuard in use

7.3.4 Camera control panel

The Camera Control Panel enables the control of a connected video cross bar and, if a
video overlay card is installed, the overlay of a video image. The cameras and monitors that
should be used must be defined in the Objects/Datapoints file (see 6.3.3 Datapoints).
Using the View|Camera control panel command, you can display the Camera control
panel and hide it again. When the control panel is visible, the menu item will be shown with
a background colour. The appearance of the camera control panel depends on the settings
in the system control.

The three comboboxes at the upper edge of the control panel (if enabled) are used to define
the location areas from which the cameras should be listed in the combobox below. You
cannot only choose one special location but you can also choose “All”. If you select “All”, all
cameras will be made available.
If you select a location from one level the entries in the comboboxes of the subordinate
levels will be deleted. This is helpful when you want to change a location selection.
The combobox in the second line (if enabled) will list all cameras (incl. name and location)
that are positioned at the selected location. You can either select one of these cameras or
enter a camera number in the edit box. As soon as a camera is selected, its image will be
attached to the currently selected monitor. In addition, you can control the camera via the
buttons in the lower area of the control panel, provided that the used cameras support this
function.
It is also possible to select a camera by clicking its symbol in the graphic.
The button bar contains an appropriate button for any of the monitors projected at this
workstation. Any button shows, among others, the designation of the monitor. When you
click a monitor button, the image of the selected camera will be attached to this monitor. In
addition, the appropriate monitor will be selected as current monitor and the corresponding
button will be shown pressed. If you then choose another camera, the image of this newly
selected camera will be directly attached to the current monitor even if the camera control
panel is not being displayed at that moment.
The symbol on the button will indicate whether the respective monitor is a normal monitor or
whether the monitor signal is connected to the input of an optional video overlay card at the
workstation. Upon selection of such an overlay monitor, the control panel will be enlarged
automatically and the lower area will show the monitor image as video overlay.
The buttons in the control area enable the control of the selected camera. Please note that
not all camera models and video cross bars offer all functions like, for example, moving
speed, shutter control, focussing, zoom etc.
Correct function of the camera control panel can only be guaranteed if the used device has
been defined before in the Global folder under System|Settings (see 4.2 Settings) in the
video area.

103
WinGuard in use WinGuard User Manual

7.3.5 Intercom control panel

Using the Intercom Control Panel you can control a linked intercom system. The intercoms
that should be used must be defined in the Datapoints file (see 6.3.3 Datapoints).
Using the View|Intercom control panel command, or the Intercom button, you can display
the Intercom control panel and hide it again. When the control panel is visible, the menu
item or the button will be shown with a background colour.

The three comboboxes at the upper edge of the control panel (if enabled) are used to define
the location areas from which the intercoms should be listed in the combobox below. You
cannot only choose one special location but you can also choose “All”. If you select “All”, all
cameras will be made available.
If you select a location from one level the entries in the comboboxes of the subordinate
levels will be deleted. This is helpful when you want to change a location selection.
The combobox in the second line (if enabled) will list all intercoms (incl. name and location)
that are positioned at the selected location. You can either select one of these intercoms or
enter an intercom number in the edit box.
It is also possible to select an intercom by clicking its symbol in the graphic.
Using the button bar in the centre of the control panel, you can call up various functions like,
for example, Graphic display, Connect, Disconnect, Open etc. for the selected intercom.
The lower area of the control panel lists all active intercom connections. A symbol informs
about the state of the intercom connection:
Intercom is being called
Intercom is busy
Connected
Call from the intercom
Emergency call from the intercom
If you choose an entry from the list the appropriate intercom will be selected automatically
and you can execute the respective functions using the buttons like, for example, accept the
call or finish the connection, and so on.
Correct function of the Intercom control panel can only be guaranteed if the local intercom
has been defined before in the Global folder under System|Settings (see 4.2 Settings) in
the Intercom area.

104
WinGuard User Manual WinGuard in use

7.3.6 Control commands in the Datapoints explorer window

The Datapoints explorer window (see 6.3.3.3 Explorer window for datapoints) enables the
execution of the possible control commands for each datapoint or sensor – provided that you
have the appropriate rights (see 6.11 Rights). The right button in the title bar of the window
can be used to call up a context menu that contains all possible control commands for the
selected datapoint or sensor and enables their execution.

7.4 Documentation
In addition to event processing and device operation, another essential task of a system like
WinGuard is to document all activities in the system in a traceable way and to enable a
systematic investigation in the saved data files. Thus, weak points and possible sources of
error can be recognised quickly and be eliminated.
WinGuard saves this data in three different ways. All completely processed events and the
processing information related to them are saved in the Event archive (7.4.2 Event archive).
Access to the archive is possible via variable filters and the events can at any time be
displayed again for information purposes by selection in the event archive.
All user actions are saved in the System Log (7.4.3 System log) and can thus be retraced in
detail, if required.
The Device log (7.4.4 Device log) saves all the data that is received or sent via the devices.
The type and scope of the log for each interface depends on the used interface module.
Information from archive and logs can be collected and formatted into individual reports
(7.4.5 Reports) and be printed out.

7.4.1 Access to archive and logs

The archive and logs can be accessed in the same way. Selecting the corresponding entry in
the Functions main menu will open the window for accessing the desired log or the archive.
First, the selection view will be opened, enabling you to define filter criteria according to
which the entries in the archive or the logs will then be displayed in table view. The contents
of the local toolbar related to this window depends on the currently selected view.

7.4.1.1 Selection view

In selection view, the window shows an input mask which is used for entering criteria for the
selection of entries from the archive or logs. The selection criteria will be linked together by a
logical AND-linkage, i.e. only those entries will be displayed that meet all criteria
simultaneously. Blank fields will not be recognised. But please note that it is absolutely
necessary to make an entry in the Period range.

7.4.1.2 Table view

The table will list all entries of the archive or the logs that meet the selection criteria defined
in the selection view.
The appearance of the toolbar may partly differ between archive and logs. But there will
always be a button to get back to the Selection area.

105
WinGuard in use WinGuard User Manual

7.4.2 Event archive

All completely processed events (Complete) and all processing information related to them
will be saved in the Event archive. In order to determine which events should be archived,
select the Global folder in the Settings dialog (System|Settings) and make your definitions
in the Archive area under Event handling (see 4.2 Settings).
The event and the assigned text along with all entries from the user will be saved in the
interactive objects. Thus, entries in text fields, the state of checkboxes etc. are also saved in
the archive. Since archiving covers the complete text, modifications on text templates will not
affect the archived events. When selecting an event from the archive for display, the event
will have the same appearance as when it was saved in the archive. For reasons of memory
capacity (normally, graphic files are rather large) assigned graphics will only be saved with
their names. Therefore, a subsequent modification of the graphics will also affect the display
of archived events.
Calling up the Functions|Event archive command opens the Event archive window. This
is a window for accessing the archive or logs. Its basic functions are described in section
7.4.1 Access to archive and logs.

7.4.2.1 Selection view

In selection view, the window shows an input mask which is used for entering criteria for the
selection of entries from the archive or logs.

The various areas are used to define the appropriate filters for the selection of the data. The
date of event reception is decisive here; this date must be within the defined period. It is
absolutely necessary to state a period.
In the Editing range you can either state one of the defined workstations/users or select
“Current”. If you select “Current” all events that have been processed at the current
workstation or by the current user will be displayed. In this case, the “current” workstation is
the workstation from which you access the archive.
The Free search area is used to search for up to two values that the user entered into the
event text during event processing via comboboxes or checkboxes. Such entries are saved
in the archive along with datatype, value and event.

106
WinGuard User Manual WinGuard in use

7.4.2.2 Table view

The table lists all archived events that meet the selection criteria defined by you. The single
columns contain the following information:
• Symbol
As already known from the event list, this symbol informs about the datapoint type and
the event type.
• Begin
Date and time of event reception.
• Ack
Time at which the event was acknowledged.
• End
Date and time of end event.
• Archive
Date and time of archiving, i.e. the time at which the user deleted the event.
• State
State text of the event.
• Datapoint
Name of datapoint or sensor.
• Location
Location that is assigned to the datapoint or sensor.
• User
Identification of the user who processed the event.
When selecting an event for display, either with the Display button or with a double click on
the table entry, the event will have the same appearance as during event processing. The
display in the window will change from table view to event view.

7.4.2.3 Event view

In Event view, the selected event is displayed along with graphic and text, i.e. the event is
displayed in the same manner as in the Event display window. However, the toolbar of the
window does not contain buttons for processing the event but it offers the List button.
Clicking this button will lead you back to the table view of the window.
Modifications on the archived event in event view might be possible, depending on the
access rights of the user profile. During the projecting of a user profile, you can use the
assignment of rights (see 6.11.2 How to define rights) to define whether write access to the
archive is allowed. If write access has been granted, the events can be processed in the
same manner as in event display. This allows especially to make entries in interactive
objects of the text.

107
WinGuard in use WinGuard User Manual

7.4.3 System log

System activities and user actions are saved in the System Log and can thus be retraced in
detail, if required.
You can access the system log by calling up the Functions|System Log command which
opens the System log window. This is a window for accessing the archive or logs. Its basic
functions are described in section 7.4.1 Access to archive and logs.

7.4.3.1 Selection view

In selection view, the window shows an input mask which is used for entering criteria for the
selection of entries from the logs.

The various areas are used to define the appropriate filters for the selection of the data. The
date of event reception is decisive here; this date must be within the defined period. It is
absolutely necessary to state a period.
The Entry area is used to define which type should be displayed. The following types are
offered for selection: “System Access, “Group switching” and “Camera switching”.
If you select “Group switching” or “Camera switching” as event type further comboboxes will
be displayed like, for example, Device, Group and Command or Camera.

108
WinGuard User Manual WinGuard in use

7.4.3.2 Table view

The table shows all log entries that meet the selection criteria defined by you. The single
columns contain the following information:
• Date
Date of the log entry.
• Time
Time of the log entry.
• WS
Number of the workstation at which the event occurred.
• User
Identification of the user who executed an operating command.
• Event
Type of the recorded event.
• Details
Further information about the recorded event.

7.4.4 Device log

The Device log saves all the data that is received or sent via the devices. The type and
scope of the log for each device depends on the used interface module.
The Device log is called up with the Functions|Device log command which opens the
Device log window. This is a window for accessing the archive or logs. Its basic functions
are described in section 7.4.1 Access to archive and logs.

7.4.4.1 Selection view

In selection view, the window shows an input mask which is used for entering criteria for the
selection of entries from the logs.

109
WinGuard in use WinGuard User Manual

The various areas are used to define the appropriate filters for the selection of the data. The
date of event reception is decisive here; this date must be within the defined period. It is
absolutely necessary to state a period and a device.
The Entry area is used to define selection criteria for individual events that should be
displayed.

7.4.4.2 Table view

The table shows all log entries that meet the selection criteria defined by you. The single
columns contain the following information:
• Date
Date of the log entry.
• Time
Time of the log entry.
• Device
Number of the device.
• I/O
Transmission direction, “Rcv” for received data, “Snd” for sent data.
• Node
Node affected by the event. For example, this can be the number of a subcentre etc.
The meaning depends on the user interface module.
• Event
Information about the recorded event. Format and meaning of the information depend on
the used interface modul.

7.4.5 Reports
In WinGuard, abstracts from archive and logs can be compiled and completed with further
information in order to create freely designable reports. Reports are an essential element for

110
WinGuard User Manual WinGuard in use

documenting the work with the system. You can define a report, i.e. you determine its
appearance and contents, by creating a text file in the WinGuard Text (.wgt) format (see 6.5
Text) and save it in the Texts\Reports subdirectory. An important aspect in text creation is
the integration of lists (see 6.5.4.4 How to insert lists) which, during the creation of the report,
will be replaced with the corresponding data from archive or logs.
In order to create a report, first call up the Reports dialog window using the
Functions|Reports command.

The list field will show the names of all defined reports, i.e. the names of all files in
WinGuard Text (.wgt) format that are saved in the Texts\Reports subdirectory.
Clicking the Create report function will create the selected report, i.e. the appropriate report
text will be analysed and the result will be displayed in a newly opened window.
The report can then be printed out using the System|Print command.

7.5 Other functions

7.5.1 Scheduled commands

To relieve the operator, scheduled commands (see 6.2 Commands) can be defined which
will then be executed at a certain point in time once or in certain intervals. Thus, for example,
you can preprogram Arm/Disarmed actions or have reports created automatically at certain
times of day etc.
You can define for each scheduled command, whether a confirmation from the operator is
necessary prior to the execution of the command. In this case, the operator has the
possibility to postpone the execution or stop it completely.
Scheduled commands are therefore a universal tool for automatising actions in the system.

111
WinGuard in use WinGuard User Manual

Calling up the Functions|Scheduled commands command opens the Scheduled

commands window. The window is designed in the same manner as a window for editing
files. The basic functions of such a window are described in section 6.3.2 File access.

7.5.1.1 Table view

The table shows all Scheduled commands that are defined in the system along with the
following information:
• Symbol
The first column indicates the symbol for a one-time command that has already been
executed.
• Next execution
This and the next column show the date and time at which the command will be
executed next. If the command is a one-time command that has already been executed
this column will show the time of the last execution.
• Repeated
This column shows the intervals at which the command is executed, e.g. once, daily,
weekly, and so on. The next column shows the days on which the command will be
executed, e.g. on Sunday or on the 10th day of a month, and so on.
• WS
This column shows the number of the workstation at which the command will be
executed.
• Remark
This column shows the remark that you entered during the definition of the command.
The toolbar of the window offers functions for editing, navigation and execution.

112
WinGuard User Manual WinGuard in use

7.5.1.2 Form view

In form view, the window shows an input mask whose fields can be used to define or edit a
scheduled command. The form view is opened by clicking an entry in table view.

In the Scheduled execution area, you can define time and options for the execution of the
command. Depending on the selected interval (once, daily, weekly, monthly and yearly), the
next boxes to the right can be used to define details about the days on which the command
should be executed.
If you selected the Confirmation required option the execution of a command must be
confirmed via the Execution of Scheduled Commands dialog (see 7.5.1.3 Confirming the
execution of a command). Using this dialog, it is also possible to postpone the execution or
stop it completely.
For entering commands, you can use an edit box in the Script area; this edit box is quite
similar to the WinGuard text editor (see 6.5 Text) but it offers only limited functions. You can
enter conditional elements and commands. Moreover, you can enter a text in WinGuard
Text (.wgt) format which can be created with the text editor and which, in turn, may contain
conditional elements and commands. This proceeding is recommended when you want to
define complex command sequences.
The commands in the toolbar are used to insert conditional elements, commands and texts
and to edit their properties. For more information about conditional elements, please refer to
section 6.5.4.9 How to define conditional elements.
Clicking the If button displays the Condition Properties dialog window. An If element is
created by selecting the If checkbox in the Type area in this dialog window. Using the
comboboxes, you can define a condition and accept it with the <<and / <<or buttons. Should
there be several conditions, this button can also be used to define the logical link of the new
condition to the previous ones. With the >> button you can delete the marked conditions.
The commands behind an If element will be executed if the condition applies. An End
element is inserted at the end of the command block. Use the End button to insert such an
element.
You can also insert an action block that will be executed if the condition does not apply. The
Else element is used for this purpose. First, insert an If element. Then insert the commands

113
WinGuard in use WinGuard User Manual

that should be executed if the condition applies. These commands are followed by the Else
element which is inserted with the Else button. Then, insert the commands that should be
executed if the condition does not apply. The last part of the command block is the End
element.
Commands can be inserted using the commands button (Text|Insert|Command) which
opens the Command Properties dialog window. All supported commands are available in
the Command combobox in the Function area. The displayed windows for entering
command parameters may vary depending on the selected command. For more information
about commands, please refer to section 6.2 Commands.
Using the button with the text symbol (Text|Insert|Text command), you can also insert a text
in WinGuard Text (.wgt) format which in turn contains commands and conditional elements.
Such a text can be created with the text editor (see 6.5 Text).
Using the button for the properties (Text|Format|Properties command), you can call up the
properties of the corresponding objects. If, in the edit box, you position the cursor before an
object (conditional element, command or text) and click this button, the same dialog window
will be opened as during the creation of the respective element, enabling you to
subsequently change the properties of the object.
The toolbar of the window offers various functions for editing and navigation like, for
example, New, Copy, Delete, Forward, Back, Undo, and so on. Among them, there are
several functions that support an explicit or implicit saving of the current entries. Such a
saving is only possible if no time was entered for the execution of the command. In this case,
an event window will inform you about the problem. You have then the possibility to enter a
time, to press the button for undoing the changes or to remove the just edited Scheduled
command using the Delete button.
The dataset entered in the current form will be saved without prompt for confirmation and the
window changes to table view.

7.5.1.3 Confirming the execution of a command

If you have defined the Confirmation required option for a scheduled command, then the
command will not be executed directly but the Execution of Scheduled Commands dialog
will be displayed before.

The dialog contains details about the planned execution time and further information about
the upcoming execution of the command. In addition, it shows the Script text along with all
commands that you entered during the definition of the scheduled command.
If, during the insertion of a command in the Script text, you selected the Invisible display
option, the command will not be shown here but only the additionally entered explanatory
text will be visible.

114
WinGuard User Manual WinGuard in use

Upon display of the dialog, select the desired command (Execute, Move or Cancel).

7.5.2 Notification function

With the notification function, WinGuard offers the possibility to exchange text messages
between workstations within a network. This enables the permanent communication between
operators who work at distant workstations. The principle of this function is similar to those
for sending and receiving e-mails; you might know this from other applications.
The reception of a new notification at a workstation is indicated by an audible signal. Using
the Other|Horn off command, you can switch off this signal (in the same way as upon
reception of an event). A blinking yellow envelope in the symbol of the local workstation
indicates the presence of unread notifications.
In the Notification control panel, you can read received notifications or compose and send
your own notifications. The Notification control panel is opened or closed either by clicking
the symbol or one of the others workstation fields in the statusbar or by selecting the
View|Notification Control Panel command. For as long as the control panel is open, the
corresponding button or the menu item will be displayed with a different background colour.
The table lists all notifications that are saved on the workstation in a time order along with
the following information:
The symbol in the first column informs about the type of the notification (new, received, sent)
and the state of the notification (send, delivered, read, fault).
The table lists all notifications that are saved at the workstation in a time order along with the
following information:

• Symbol
Newly created notification that has not yet been sent.
Notification is being sent now.
Notification could not have been delivered.
Notification was delivered to the recipient.
Notification has already been read by the recipient.
Notification was sent as broadcast to all workstations.
Notification was received but is has not yet been read.
Notification was received and read.
Broadcast was received.
Broadcast notification was received and read.
Notifications to all workstations, the so-called broadcasts, will be marked “delivered”
immediately after sending since there is no status check query for such notifications.
• Time
Time at which the notification was received or sent.
• WS
Number of the workstation that is the recipient or sender of the notification; “All” for
broadcasts.
• Author
Author of the notification.
• Subject
Subject in the notification.

115
WinGuard in use WinGuard User Manual

The entry selected from the table will again be displayed in detail (incl. notification text) in the
lower area of the control panel. For newly created notifications, the fields can be used to
make the corresponding entries.

116