Q-WIN

Reference Manual
Vol 1 Basic
087.01E Q-MATIC AB i
Copyright notice
The information in this document is subject to change without prior notice and does not
represent a commitment on the part of Q-MATIC AB.
All efforts have been made to ensure the accuracy of this manual, but Q-MATIC can not assume
any responsibility for any errors and their consequences.
This manual is copyrighted and all rights are reserved.
Q-MATIC, Q-WIN, Q-MATIC Calendar, Q-MATIC Client Terminal, Q-MATIC Staff Basic
and Q-MATIC Staff Advanced are registered trademarks or trademarks of Q-MATIC AB.
Reproduction of any part of this Manual, in any form, is not allowed, unless written permission
is given by Q-MATIC AB.
COPYRIGHT 2005-2008 Q-MATIC AB
Q-WIN Reference Manual - Vol 1, Basic
ii Q-MATIC AB 087.01E
087.01E Q-MATIC AB iii
Contents
1. News in Q-WIN S ......................................................... 1
Web interface and web server ............................................................. 3
Management screens .......................................................................... 3
System Configuration .......................................................................... 4
New user interface .............................................................................. 5
New licence structure.......................................................................... 5
User group policies.............................................................................. 5
New script functions............................................................................ 6
Q-WIN CALENDAR............................................................................... 7
Sort the columns.................................................................................. 7
Deleted appointments ......................................................................... 8
Arrival notification............................................................................... 8
Book appointments in the Appointment List ....................................... 9
Row numbers in the Appointment List ................................................ 9
Use the ticket button to specify the ticket number sequence .............. 9
Undo arrived or call customer ............................................................. 9
All CUSTINFO fields can be shown in the Appointments List............. 10
Open with the current date ............................................................... 10
Better error message when the booking is incomplete...................... 10
Edit or delete appointments in the appointment list ......................... 11
Change the staff member when you edit an appointment ................ 11
Open a management screen when the customer arrives ................... 11
Search for a customer........................................................................ 12
Comments added to appointments ................................................... 13
Multi interface with radio and wireless terminal ............................... 13
New management screens ................................................................ 13
New statistics reports ........................................................................ 13
Password........................................................................................... 14
Logging into Q-WIN........................................................................... 16
Coded information in the network .................................................... 16
Maximum number of labels in scripts................................................ 16
Script program output size ................................................................ 16
New script functions.......................................................................... 16
Q-WIN Advanced scripts.................................................................... 17
Send parameters to a script program in the Q-WIN server ................ 17
New workstation command .............................................................. 18
New event ......................................................................................... 18
2. News in Q-WIN S SE................................................... 19
Support for TP3100 family of printers................................................ 20
Ticket Editor for TP3100 family of printers ........................................ 20
Q-WIN Reference Manual - Vol 1, Basic
iv Q-MATIC AB 087.01E
3. Q-WIN system.............................................................21
What is Q-WIN .................................................................................. 22
Terminology ...................................................................................... 22
Q-WIN Interface ................................................................................ 23
Q-WIN server..................................................................................... 24
Q-WIN Clients.................................................................................... 26
Data files ........................................................................................... 26
Options.............................................................................................. 27
Q-WIN Applications........................................................................... 28
4. Installation .................................................................31
Hardware and software requirements ............................................... 32
Licences............................................................................................. 32
Installing Q-WIN for the first time ..................................................... 33
Installing Q-WIN clients..................................................................... 34
Upgrade an existing licence .............................................................. 35
Upgrade Q-WIN to new version ........................................................ 36
Install a service pack (SP) .................................................................. 36
External Q-WIN applications ............................................................. 36
5. Start Q-WIN................................................................39
Logging into Q-WIN .......................................................................... 40
Start window..................................................................................... 41
6. Tickets ........................................................................43
Tickets are more than ticket numbers ............................................... 44
Ticket creator and editor - BP2800.................................................... 47
Editing plain text ............................................................................... 48
Editing a ticket layout program......................................................... 48
Adding a picture................................................................................ 50
Removing a picture ........................................................................... 51
Creating a new ticket ........................................................................ 51
Selecting ticket .................................................................................. 52
Example 1 - a simple ticket ............................................................... 53
Example 2 - Print two tickets at same time....................................... 54
Example 3 - Shift between two different tickets................................ 55
Example 4 - Stop printing tickets....................................................... 55
Example 5 - System without workstation terminals .......................... 56
Control codes .................................................................................... 57
Ticket creator and editor - TP3100 .................................................... 65
Editor commands .............................................................................. 66
Creating a new ticket ........................................................................ 68
Inserting and editing text .................................................................. 68
Inserting and editing system information.......................................... 70
Contents
087.01E Q-MATIC AB v
Inserting and editing scripts on a ticket............................................. 72
Inserting and editing barcodes on a ticket......................................... 72
Creating images for tickets................................................................ 74
Inserting and removing images ......................................................... 74
Assigning a ticket to a button ........................................................... 75
Examples ........................................................................................... 76
7. Quick texts................................................................. 77
Quick text .......................................................................................... 78
Editing a quick text............................................................................ 78
Adding a quick text ........................................................................... 79
Removing a quick text ....................................................................... 79
8. Customizing web pages............................................. 81
Q-WIN events and Javascript functions ............................................. 82
Load the Q-WIN event Javascript library............................................ 82
Set up which events to listen to ........................................................ 83
Handle Q-Win events......................................................................... 83
9. System configuration ................................................ 85
General information about settings................................................... 86
Number of units................................................................................. 86
Number and name............................................................................. 86
ID codes and Sub ID codes ................................................................ 87
The system configuration window..................................................... 88
Setting levels ..................................................................................... 89
Adding a new unit ............................................................................. 90
Removing units.................................................................................. 91
Move a unit to another group ........................................................... 91
Creating a new group........................................................................ 92
10. Alarm......................................................................... 93
Alarms in Q-WIN ............................................................................... 94
General alarm settings ...................................................................... 94
Messages from workstations............................................................. 96
Automatic alarms .............................................................................. 97
Alarms from workstations ................................................................. 98
Alarms to workstations ..................................................................... 98
11. Card readers ............................................................ 101
Card readers in Q-WIN systems ....................................................... 102
Card validation................................................................................ 102
General card validation settings...................................................... 102
Q-WIN Reference Manual - Vol 1, Basic
vi Q-MATIC AB 087.01E
Card settings ................................................................................... 103
Locking a card to a ticket button..................................................... 104
Changing the card data before validation....................................... 106
Additional settings in the ticket printer settings.............................. 106
Card reader units............................................................................. 107
General card reader settings ........................................................... 107
Card reader group settings.............................................................. 108
Card unit settings ............................................................................ 109
12. Category and ticket button......................................111
The difference between ticket buttons and categories .................... 112
Categories ....................................................................................... 113
General category settings................................................................ 113
Category settings ............................................................................ 114
Tickets per time period.................................................................... 115
Estimated waiting time in categories or ticket buttons ................... 116
Ticket buttons.................................................................................. 118
General ticket button settings ......................................................... 118
Button group settings...................................................................... 119
Ticket button settings...................................................................... 121
13. Database ..................................................................123
Database settings............................................................................ 124
Backup settings ............................................................................... 125
14. Displays ....................................................................127
Display types ................................................................................... 128
Main display.................................................................................... 128
General main display settings ......................................................... 129
Main display settings ...................................................................... 130
Programming main displays ............................................................ 133
Program example, two 1664 Displays as one main display............. 134
Information displays........................................................................ 138
General information display settings............................................... 138
Information display settings ............................................................ 139
Fonts ............................................................................................... 140
Designing a new font ...................................................................... 141
Different fonts to different displays................................................. 142
Introduction to programming.......................................................... 142
Simple display commands ............................................................... 145
Advanced programming.................................................................. 152
Advanced programming commands................................................ 159
911 and 917.................................................................................... 163
Complex languages......................................................................... 165
Contents
087.01E Q-MATIC AB vii
Troubleshooting .............................................................................. 167
Examples ......................................................................................... 167
General font settings ....................................................................... 170
Font settings.................................................................................... 171
15. Q-WIN Mail .............................................................. 173
Introduction..................................................................................... 174
General Email settings..................................................................... 174
Email message settings ................................................................... 175
Sending an email message .............................................................. 175
16. Host ......................................................................... 177
General connections settings........................................................... 178
Connection settings......................................................................... 178
Communication ............................................................................... 179
Event settings.................................................................................. 180
Run script ........................................................................................ 180
System script ................................................................................... 181
Date and time.................................................................................. 181
17. Licence..................................................................... 183
Locking an application to a Q-WIN client ........................................ 184
18. Matters .................................................................... 185
Matters give detailed information................................................... 186
Adding matters................................................................................ 186
Editing matters ................................................................................ 187
Remove matters .............................................................................. 187
Using matters at the workstation.................................................... 187
19. Multi interface......................................................... 189
Multi interfaces ............................................................................... 190
General multi interface settings ...................................................... 190
Interface group settings Internal programs ..................................... 191
Internal programs for the input pins................................................ 192
Internal program commands ........................................................... 193
Interface group settings Script programs......................................... 195
Input script programs ...................................................................... 196
Output programs ............................................................................. 197
Interface group settings RS232........................................................ 197
Radio Interface ................................................................................ 198
Q-WIN Reference Manual - Vol 1, Basic
viii Q-MATIC AB 087.01E
20. Q-MATIC Pager .........................................................199
Introduction..................................................................................... 200
General Pager settings .................................................................... 200
Pager unit settings .......................................................................... 201
Pager script ..................................................................................... 202
21. Priorities...................................................................203
Introduction..................................................................................... 204
Priority settings ............................................................................... 204
Editing priority settings ................................................................... 205
Using priorities ................................................................................ 206
Statements ...................................................................................... 207
Category greater than X.................................................................. 208
Category greater than X % of Category .......................................... 210
Category greater than X % of Ticket Button ................................... 212
Ticket Button greater than X ........................................................... 213
Ticket Button greater than X % of Category ................................... 214
Ticket Button greater than X % of Ticket button............................. 215
Customers waiting in Categories From - To..................................... 216
Test if a Person Choice Customer is waiting.................................... 217
Alternate true X times and false Y times ......................................... 218
Select a Customer from a Category ................................................. 219
Select a Customer from a Ticket Button .......................................... 220
Select a Person Choice Customer .................................................... 221
Select by level.................................................................................. 222
Select the highest value by level ..................................................... 225
Select the highest value .................................................................. 226
Select in priority sequence............................................................... 227
Test if selection can be made .......................................................... 228
Select by script program.................................................................. 229
Test if a Workstation Choice Customer is waiting........................... 230
Select a Workstation Choice Customer............................................ 231
Workstation open From - To............................................................ 232
Between Time of Day From - To ...................................................... 233
Jump to line by Script Program........................................................ 234
Web priority settings ....................................................................... 234
22. Security ....................................................................237
Password settings ........................................................................... 238
23. Scheduled activities .................................................241
Starting an action at a pre-set time................................................. 242
Adding a new scheduler setting...................................................... 242
Editing a scheduler setting .............................................................. 244
Contents
087.01E Q-MATIC AB ix
Delete a scheduler setting ............................................................... 244
Exclude days.................................................................................... 244
24. Ticket printer ........................................................... 245
Ticket printer together with Q-WIN................................................. 246
General ticket printer setting........................................................... 246
Ticket printer group settings............................................................ 247
Ticket printer settings...................................................................... 249
25. Transfer ................................................................... 251
Category transfer............................................................................. 252
Automatic transfer based on the waiting time ................................ 252
Category transfer based on a script program .................................. 253
Network transfer ............................................................................. 254
Adding a network category transfer ................................................ 255
Editing a network category transfer ................................................ 256
Delete a network category transfer ................................................. 256
26. Voice........................................................................ 257
Voice interface................................................................................. 258
Voice settings .................................................................................. 258
General voice settings ..................................................................... 258
Voice Script...................................................................................... 259
VU2187 ........................................................................................... 259
Q-WIN Voice.................................................................................... 261
To say a number .............................................................................. 262
Activate a Voice Unit ....................................................................... 263
Recording phrases ........................................................................... 264
English phrases in Q-WIN VOICE..................................................... 265
Example........................................................................................... 270
27. Wireless Terminal .................................................... 273
Introduction..................................................................................... 274
Wireless Terminal settings............................................................... 274
General Wireless Terminal settings ................................................. 274
Wireless Terminal group settings..................................................... 275
Learning a signature........................................................................ 276
Wireless Terminal unit settings........................................................ 276
Removing a Wireless Terminal ........................................................ 277
28. Workstations ........................................................... 279
General workstation settings........................................................... 280
Workstation settings ....................................................................... 281
Q-WIN Reference Manual - Vol 1, Basic
x Q-MATIC AB 087.01E
Workstation type settings................................................................ 282
Display info ..................................................................................... 286
Keys................................................................................................. 290
Single programs and sequence programs........................................ 291
System variables.............................................................................. 292
Registers.......................................................................................... 293
Entering numbers from the keyboard.............................................. 293
Scripts.............................................................................................. 294
Terminal group settings................................................................... 295
Park register .................................................................................... 297
29. Client settings ..........................................................299
Hot keys .......................................................................................... 300
Window options .............................................................................. 301
Client settings ................................................................................. 302
Branch register ................................................................................ 305
30. Staff management....................................................309
Staff members ................................................................................. 310
Staff groups..................................................................................... 314
User groups ..................................................................................... 316
31. Troubleshooting.......................................................321
Problems with Q-WIN...................................................................... 322
Reset system ................................................................................... 324
Preset category................................................................................ 325
Display test...................................................................................... 325
ID code test ..................................................................................... 326
Log files........................................................................................... 326
LOG_CENTRAL ................................................................................ 328
About Q-WIN................................................................................... 329
087.01E Q-MATIC AB 1
1. News in Q-WIN S
Topics in this chapter
Web interface and web server ......................................................... 3
Management screens....................................................................... 3
System Configuration ...................................................................... 4
New user interface........................................................................... 5
New licence structure ...................................................................... 5
User group policies .......................................................................... 5
New script functions........................................................................ 6
Web interface and web server ......................................................... 3
Q-WIN CALENDAR........................................................................... 7
Sort the columns.............................................................................. 7
Deleted appointments ..................................................................... 8
Arrival notification........................................................................... 8
Book appointments in the Appointment List ................................... 9
Row numbers in the Appointment List ............................................ 9
Use the ticket button to specify the ticket number sequence .......... 9
Undo arrived or call customer.......................................................... 9
All CUSTINFO fields can be shown in the Appointments List......... 10
Open with the current date............................................................ 10
Better error message when the booking is incomplete.................. 10
Edit or delete appointments in the appointment list...................... 11
Change the staff member when you edit an appointment............. 11
Open a management screen when the customer arrives ............... 11
Search for a customer .................................................................... 12
Comments added to appointments................................................ 13
Multi interface with radio and wireless terminal ........................... 13
New management screens............................................................. 13
New statistics reports .................................................................... 13
Password ....................................................................................... 14
Logging into Q-WIN....................................................................... 16
Q-WIN Reference Manual - Vol 1, Basic
2 Q-MATIC AB 087.01E
Coded information in the network .................................................16
Maximum number of labels in scripts.............................................16
Script program output size .............................................................16
New script functions.......................................................................16
Q-WIN Advanced scripts.................................................................17
Send parameters to a script program in the Q-WIN server .............17
New workstation command ...........................................................18
New event ......................................................................................18
087.01E Q-MATIC AB 3
Q-WIN S has a new Tomcat web server. The new web server has made it possible to use web
clients to reach some parts of Q-WIN. Here is a description of the features available from a web
browser.
Staff Member Registration
The staff member registration has been moved from the Q-WIN client to the web client. Here
you can perform all the tasks that were available in Q-WIN 2000 Q. New features are the user
group policies that specify user groups' access to Q-WIN.
Management Screens
A new type of management screens made with Velocity scripts. The old type of management
screens is still available in the Q-WIN client.
System Configuration
All settings for the system server are now moved from the Q-WIN client to the web client.
Statistical Reports
These are the web reports that have been available in previous versions of Q-WIN.
The new Tomcat web server has made it possible to use Velocity scripts to create management
screens. Three new default management screens are installed together with Q-WIN. It is easy to
design new and very flexible management screens.
Please read Q-WIN Reference Manual Volume 4 for more information.
Web interface and web server
Management screens
Q-WIN Reference Manual - Vol 1, Basic
4 Q-MATIC AB 087.01E
The new web based system configuration has a new and user-friendly user interface. Most
settings are the same as in previous versions of Q-WIN but the tree structure makes it much
easier to get an overview of the settings.
Help texts are integrated with the page which makes it easier to understand the settings; just
click the text in the settings form to display the help text.
System Configuration
087.01E Q-MATIC AB 5
The Q-WIN client has a new and more modern user interface.
The licence is no longer stored in the Q-WIN Interface. It is now stored in the Lic folder. The
licence still contains the interface number and can only be used together with the Q-WIN
Interface for which it was intended.
All users of Q-WIN must belong to a user group. The user group has a user group policy that
specifies the parts of Q-WIN that are available for the group members. This makes it possible to
give every user access to those parts of Q-WIN that he or she needs. Those parts that are not
included in the user group policy are not displayed on the screen.
New user interface
New licence structure
User group policies
Q-WIN Reference Manual - Vol 1, Basic
6 Q-MATIC AB 087.01E
GS(section key default)
Returns a setting from the qsys.ini file.
Parameters: Section is the section in the qsys.ini file.
Key is the setting in the selected section.
Default will be used if there is no value in the qsys.ini
file.
Return Values:The settings from the qsys.ini file as a string.
Example
GS(HOST MAX 1)
Get the number of hosts. It is the following setting from the qsys.ini file.
[HOST]
MAX = 2
The function will return 2.
CGS(section key default)
Returns a setting from the qwin.ini file on the Q-WIN server.
Parameters: Section is the section in the qwin.ini file.
Key is the setting in the selected section.
Default will be used if there is no value in the qwin.ini
file.
Return Values:The settings from the qwin.ini file as a string.
INI_GET_SECTION(section)
The function returns all settings for a section in the qsys.ini file. A wildcard can be used to
retrieve more than one section, for example BUTTON* will return both values from [BUTTON]
and [BUTTON_SETTING_1], etc.
Parameters: Section is the section in the qsys.ini file.
Return Values:A string with all settings.
LIC_SLOT_INFO(slot)
Return information from one slot in the licence.
Parameters: Slot is the slot number.
Return Values:The information in the slot as a string.
New script functions
087.01E Q-MATIC AB 7
Example of return string "slot=slot|users=number of total users|in_use=number of used
users|option1=options set on this slot|option2= options set on this slot|option3= options set on
this slot "
LIC_WRK_INFO
The total number of workstations that can be used and the number of workstations that are
currently used.
There are many improvements in Q-WIN CALENDAR. Most of these changes are made in the
Appointment List.
Here is an overview of the news in Q-WIN CALENDAR. Please read the Q-WIN CALENDAR
part of the Q-WIN Reference Manual for more information.
It is now possible to sort the Appointment List. The sort order can be based on three columns.
Right click a column title and choose if it should be primary, secondary or third sort criterion.
Parameters: None.
Return
Values:
Workstation information as a string.
Syntax: "max number of workstations|number
in use|workstation numbers".
Max number of workstations is the total
number of software workstations that can be
connected to the Q-WIN server.
Number in use is the number of software
workstations that is currently connected to
the Q-WIN server.
Workstation numbers is a list with the
workstation numbers for the software
workstations currently connected to the Q-
WIN server.
Q-WIN CALENDAR
Sort the columns
Q-WIN Reference Manual - Vol 1, Basic
8 Q-MATIC AB 087.01E
The ticket number is now removed from the queue when the appointment is deleted.
It is now possible to choose if the Notify dialogue should be displayed when a customer is
registered as arrived.
The Arrival notify dialog setting in the Calendar section of the User group policy (see User group
policies on page 5) controls the dialogue. There are two possibilities.
The Arrival notify dialog setting is not checked.
There are two ways for a user to specify that a customer has arrived: the Arrival button or to
right click an appointment in the Appointment list. There will be no Notify dialogue when the
Arrival button is used.
The user can choose to open the Notify dialogue if he or she right clicks on the appointment.
The Arrival notify dialog setting is checked.
The Notify dialogue is always opened when a customer is set to "arrived". Only the "Arrived &
Notify" option is available if the user right clicks on an appointment.
Deleted appointments
Arrival notification
087.01E Q-MATIC AB 9
The Schedule new appointment button that has only been available in the Appointment
Planner is now also available in the Appointment List. This makes it easier to book new
appointments from the Appointment List.
Row numbers are added to the Appointment List. The row number makes it easier to read the
list.
Increased possibility of specifying the ticket number sequence in the ticket button settings. In
earlier versions of Q-WIN this was only possible if you reserved ticket numbers for the
appointments, for example if the customer with the third appointment arrived he or she would
get ticket number 003. Ticket number 001 was reserved for the first appointment for the day
and ticket number 002 was reserved for the second appointment.
It is now possible to use a ticket number sequence specified in the ticket button settings even if
no numbers are reserved. You must set the USE_BTN_SEQ = 1 setting in the
[APPOINTMENT] section of the qsys.ini file. You must not set the "Assign numbers from
Ticket Button settings" check mark in the Q-WIN CALENDAR settings because it is still used
when you want to reserve ticket numbers.
It is now possible to undo that a customer has been set to arrived or has been called. The undo
of an arrived customer deletes the ticket number from the queue and the ticket number is not
included in the statistics. The undo of a called customer puts back the ticket number in the
original queue.
Book appointments in the Appointment List
Row numbers in the Appointment List
Use the ticket button to specify the ticket number sequence
Undo arrived or call customer
Q-WIN Reference Manual - Vol 1, Basic
10 Q-MATIC AB 087.01E
The following settings in the Calendar section of the User group policy (see User group policies
on page 5) will enable or disable the undo function:
Undo call
Undo arrival
All fields from the CUSTINFO table can be shown in the Appointment List. It is still possible
to hide those fields that you do not want to be visible.
Both the Appointment Planner and the Appointment List will open with the current date shown
on the screen.
There has always been an error message if you try to book an appointment but you forget to
select a customer. This error message was difficult to understand in previous versions of Q-WIN.
Now the error message explains that the user has forgotten to select a customer.
All CUSTINFO fields can be shown in the Appointments List
Open with the current date
Better error message when the booking is incomplete
087.01E Q-MATIC AB 11
It is now possible to edit or delete appointments in the Appointment List. In previous versions
of Q-WIN you could only do that in the Appointment Planner.
A new setting in the Calendar section of the User group policy (see User group policies on
page 5) will enable or disable the ability to edit an arrived appointment.
Edit arrived Check / Uncheck.
Two new settings in the Calendar section of the User group policy (see User group policies on
page 5) will enable or disable the ability to delete a called appointment and delete an arrived
appointment.
Delete called Check / Uncheck.
Delete arrived Check / Uncheck.
It is now possible move the appointment to another staff member when you edit the
appointment.
It is possible to open a management screen when a customer arrives for an appointment. If the
management screen returns TRUE then the status of the appointment is changed to customer
has arrived. If the management screen returns FALSE then a new management screen is opened.
This management screen can, for example, ask if the user wants to continue or if the
appointment should remain as not arrived.
The management screen can, for example, be used to check that a customer has all documents
required for the appointment. The management screen contains a list of documents and the user
can set a check mark for each document the customer shows. The management screen returns
TRUE if all check marks are marked otherwise it returns FALSE.
Edit or delete appointments in the appointment list
Change the staff member when you edit an appointment
Open a management screen when the customer arrives
Q-WIN Reference Manual - Vol 1, Basic
12 Q-MATIC AB 087.01E
A setting in the qwin.ini file will enable or disable the use of an extra arrival management screen.
[Q-CALENDAR]
FORCE_ARR_LAYOUT = 1/0 enable/disable
Following setting specifies the path to the layout file.
[Q-CALENDAR]
ARR_LAYOUT_FILE0 = layout_file.SUP
The Path always starts from the layout directory. Sub-directories may be used.
Following setting enables or disables the use of different layout files depending on the customer's
VIP level.
[Q-CALENDAR]
ARV_LAYOUT_BY_VIP = 0 1/0 enable/disable
If this setting is used, different files for all VIP levels must be specified like below.
[Q-CALENDAR]
ARR_LAYOUT_FILE0 = layout0_file.SUP ( VIP 0 )
ARR_LAYOUT_FILE1 = layout1_file.SUP ( VIP 1 )
ARR_LAYOUT_FILE2 = layout2_file.SUP ( VIP 2 )
ARR_LAYOUT_FILE3 = layout3_file.SUP ( VIP 3 )
You can search for a customer in the Appointment List.
Enter the name, personal identification number, account number or phone number of the
customer you want to search for. Click the Go Search button. The search is performed in two
steps. The first time you click the Go Search button Q-WIN is going to search for the selected
customer during the selected date.
The Go Search button is changed to the Search More button. Click the Search More button to
search for the customer within a specified date span.
The LST_SRCH_START and LST_SRCH_END settings in the [Q-CALENDAR] section of the
qwin.ini file specifies the number of days before and after the current day that should be
included in the search.
Search for a customer
087.01E Q-MATIC AB 13
You can select if you want to limit the search to the selected staff member or staff group or if
you want to include all staff members/staff groups in the search. Click the settings button and
select if you want search all staff members/groups or only the selected staff member/group.
Comments added to the customer during the registration of appointments can be transferred to
the waiting customer when he or she arrives. Use the "Copy notes when customer is inserted"
check mark in the category settings to enable this option.
Q-WIN has settings for the multi interface with radio and the wireless terminal.
New improved management screens replace the previously used management screens.
New improved statistics reports replace the previously used statistics reports.
Comments added to appointments
Multi interface with radio and wireless terminal
New management screens
New statistics reports
Q-WIN Reference Manual - Vol 1, Basic
14 Q-MATIC AB 087.01E
The passwords are coded and saved in the database. No passwords are stored on the client PC.
The password settings are completely new.
A complex password is required during the log-on process
You must use passwords that consist of small letters, capital letters and digits.
A password must be unique among the users
Each password must be unique.
A password can not have numerics at the beginning and at the end
The password cannot start or end with a number.
A password can not be the same as the user name
The password and the user name must be different.
A password can not have consecutive characters
The password must not have consecutive characters.
Password
087.01E Q-MATIC AB 15
A password can not be a dictionary word
It is possible to specify words that are not allowed as passwords. This word list is stored in the
database.
A dictionary word can not be part of a password
The password must not contain a part of a dictionary word.
A password can not be changed by a user after it has expired
The user cannot specify a new password when the old password expires.
All password sessions will be recorded in the password log
All activities where passwords are used are stored in the password.log file.
All password sessions with the server must use the same version of Q-WIN
All clients that use passwords must have the same Q-WIN version.
The maximum number of days a password is allowed to be in use
This setting makes it possible to specify a time limit for a password. The password is valid during
the specified number of days then it must be replaced with a new password.
Minimum length of characters in a password
This is the minimum length for a password.
Minimum number of new and different passwords before one is used again
This setting prevents the user from using the same password a second time. Q-WIN will
remember which passwords the user has used in the past. This setting specifies how many old
passwords Q-WIN compares with the new password. The new password is only accepted if Q-
WIN does not find it among the old passwords.
Maximum number of unsuccessful log-on attempts before a blocking occurs
The user can try invalid passwords the specified number of times, then the application is blocked.
It is not possible to login while the application is blocked, not even with a valid password. The
next setting specifies the duration of a block. Set to 0 to disable the block.
Blocking time in minutes due to a number of unsuccessful log-on attempts
This is the duration of the block if the previous setting is enabled. Set to 0 to disable the block.
A password can not contain this amount of characters from previous password
This setting prevents the user from specifying a new password that is too similar to the old one.
Q-WIN Reference Manual - Vol 1, Basic
16 Q-MATIC AB 087.01E
In a protected Q-WIN system the user must login before it is possible to use Q-WIN. The login
guarantees that the user gets their own access level to Q-WIN. This access level is specified in
the staff member management.
The communication between the Q-WIN server and the Q-WIN client is coded.
The maximum number of labels in scripts is increased from 50 to 100.
The maximum output size for script programs is increased from 15000 characters to 30000
characters.
New script functions that return the maximum value for some settings.
MAX_EMAIL Return maximum number of email settings.
MAX_MATTER Return maximum number of matter codes.
MAX_PRIORITY Return maximum number of priorities.
MAX_PAGER Return maximum number of pager settings.
WLTERMINAL This function returns the terminal number for the latest
used wireless terminal.
Logging into Q-WIN
Coded information in the network
Maximum number of labels in scripts
Script program output size
New script functions
087.01E Q-MATIC AB 17
It is possible to use SQL commands and API commands if you have a Q-WIN Advanced scripts
licence.
SQL_OPEN( [select] [dsn] ) -> 0=error/1-x=handle
SQL_FETCH( [handle] ) -> 1=Ok, 0=End of data
SQL_VALUE( [handle] [column] ) -> value
SQL_CLOSE( [handle] )
[select] = 'SELECT * FROM CUSTINFO'
[dsn] = empty string (""), use same ODBC source as Q-Win
[dsn] = 'name,user,psw,tmout,str'
name Data Source Name in ODBC control panel.
User User name of the data source.
Psw Password of the data source.
Tmout Time out for the connection phase.
Str Connection identifier at the SQL server side.
It is also possible to start applications from a Q-WIN script.
FUNC_RUN_PROGRAM( [path] [arguments] )
Path is the applications full path, for example C:\\WINDOWS\\NOTEPAD.EXE.
You must use double backslashes (\\).
Arguments is the application supplied commands, for example QSYS.INI.
Example
FUNC_RUN_PROGRAM( "C:\\WINDOWS\\NOTEPAD.EXE" "QSYS.INI" )
Q-Win is not waiting for the execution of the program to end before it continues with the rest
of the script.
It is possible to send parameters to a script program in the Q-WIN server.
Format:
Q-WIN Advanced scripts
Send parameters to a script program in the Q-WIN server
Q-WIN Reference Manual - Vol 1, Basic
18 Q-MATIC AB 087.01E
RUN [no] [var=value], [var=value],
no = Program number.
var = Variable A-Z
value = text or number.
If the first character in a value is a digit then the value must be an integer. If you want to include
a comma in a text string then you must enter two commas (,,).
New workstation command that makes it possible to call a specific track number.
FUNC_CALL_TRACK [track] [priority] [no disp] [no store next]
A new event, 18, is added to Q-WIN. This event occurs when the qsys.ini file has been saved
due to a change.
New workstation command
New event
087.01E Q-MATIC AB 19
2. News in Q-WIN S SE
Topics in this chapter
Support for TP3100 family of printers............................................ 20
Ticket Editor for TP3100 family of printers .................................... 20
Q-WIN Reference Manual - Vol 1, Basic
20 Q-MATIC AB 087.01E
Q-WIN S SE has full support for the TP3100 family of ticket printers. A new field has been
added to the Printers section of the System Configuration page. Each printer in the system has
a Ticket printer IP Address field. In this field the IP address of a ticket printer of the TP3100 family
must be entered. Leave this field empty when using ticket printers from the BP2800 family.
Q-WIN S SE has a new Ticker Editor for the TP3100 family of ticket printers. With this editor
it is very easy for the end user to make nice looking tickets. The end user can insert text, pictures
and some types of system information on tickets. It is also very easy to format the text, plain text
as well as system information, as to font, size, bold, rotation etc. All fonts available on the server
can be used.
Support for TP3100 family of printers
Ticket Editor for TP3100 family of printers
087.01E Q-MATIC AB 21
3. Q-WIN system
Topics in this chapter
What is Q-WIN............................................................................... 22
Terminology................................................................................... 22
Q-WIN Interface............................................................................. 23
Q-WIN server ................................................................................. 24
Q-WIN Clients................................................................................ 26
Data files ....................................................................................... 26
Options .......................................................................................... 27
Q-WIN Applications ....................................................................... 28
Q-WIN Reference Manual - Vol 1, Basic
22 Q-MATIC AB 087.01E
Q-WIN is the server in a system that handles the flow of products in processes. Traditionally the
products have been customers and the process has been waiting to be served. It does not have to
be like this, that is why we use the vague terms "products" and "processes". Q-WIN does not care
which type of flow it handles. It can be customers, patients, packages, documents, cars, etc. Q-
WIN identifies each product in the process, both their positions in the process and the time spent
at the different stages of the process. All this information is made available for applications in the
system and it is saved and can be used in reports and in planning.
The traditional markets for Q-WIN have been banks and post offices. Q-WIN was used to handle
the waiting customers; it was a queue system. It is of course still possible to use Q-WIN in this
way but the possibilities are almost endless and your imagination is the limit, not the Q-WIN
System.
Most parts of Q-WIN can be controlled by a script program, which makes it possible to tailor-
make the system for each customer's needs and requests.
Options and applications make it possible to give each customer exactly the system they want.
It is possible to add more options and applications when their needs change.
Using the correct words can be difficult because different organisations use different terms for
the same thing. Here are some terms used in the reference manuals.
Customer
Customers are the products or objects that are handled in a process. The word customer is used
because traditionally the Q-WIN system has been used to handle people in queue but it can be
packages, documents, cars, etc.
Staff member
Staff members are the resources used in the process. In the traditional queue system these are
the staff members serving the customers but it can be any other type of resources needed to serve
the customers. It can be rooms, equipment, etc.
Category
Categories are the different stages in the process. In the traditional queue system these are the
different types of services that are provided to the customers but they may be stages in a process.
Workstation
Workstations are the places that handle the customers. In the traditional queue system these are
the counters but it can be desks, equipment, etc.
What is Q-WIN
Terminology
Q-WIN system
087.01E Q-MATIC AB 23
The Q-WIN Interface is a small connection box that connects the Q-WIN software with the rest
of the Q-WIN system. There are two variants: one for RS-232 and one for USB connection. The
USB variant needs no external power, it gets power from the USB cord.
Q-WIN must be connected to a Q-WIN Interface to start.
There are two LEDs on the front of both Interfaces, one red and one green. When blinking, they
indicate that communication is going on between the Q-MATIC network and the Interface.
On the USB Interface there are also two LEDs on the back, one red and one blue. When on, the
red LED indicates that the connection with the Q-MATIC network is working and the blue that
the USB connection with the computer is working.
Q-WIN Interface
Q-WIN Interface RS-232 and USB
Width: 102 mm, depth: 101 mm, height: 52 mm
Power Consumption, stand by: 60 mA, maximum: 200 mA
When using the USB Interface and using other USB ports for other purposes, there is a risk that the
interface will not receive enough power. In that case use the RS-232 Interface or a USB hub with an external
power supply.
Operating Temperature: 10 - 32 C
Storage Temperature: -10 - 40 C
Operating Humidity: 15 - 85 % Rel. humidity
Storage Humidity: 10 - 90 % Rel. humidity
The Q-WIN Interface connects the Q-WIN server
to the rest of the system.
Q-WIN Reference Manual - Vol 1, Basic
24 Q-MATIC AB 087.01E
Q-WIN consists of two parts: the Q-WIN server and the Q-WIN clients. This duality is invisible
if Q-WIN is installed on only one PC but today most organisations have a local area network
(LAN) which may be connected to a wide area network (WAN).
The Q-WIN server handles all system related activities in the system. There can be only one Q-
WIN server in a system.
Most settings for the Q-WIN server are stored in the qsys.ini file. The rest of the settings are
stored in the database.
A network with one server and five clients.
Q-WIN server
Q-WIN Server
Q-WIN Client Q-WIN Client Q-WIN Client Q-WIN Client Q-WIN Client
Qsys.ini
Settings
Qwin.ini
Settings
Qwin.ini
Settings
Qwin.ini
Settings
Qwin.ini
Settings
Qwin.ini
Settings
Q-WIN system
087.01E Q-MATIC AB 25
Local area networks (LAN) and a wide area network (WAN). Each branch and the headquarters
(HQ) use LAN to locally distribute information. The WAN allows the HQ to collect information from
the branches.
HQ (LAN)
Branch (LAN) Branch (LAN) Branch (LAN)
Q-WIN
Customer database
WAN
Q-WIN Reference Manual - Vol 1, Basic
26 Q-MATIC AB 087.01E
There can be as many Q-WIN clients as there are network users in the licence. The Q-WIN client
gives the users access to the information on the Q-WIN server. The licence and the user group
policy specify which parts of the Q-WIN server that are accessible.
There are three types of clients:
Q-WIN clients
Web clients
Q-WIN Applications
Q-WIN clients are client PCs with Q-WIN installed. Q-WIN clients are used for some
applications, for example Q-MATIC Calendar and Q-MATIC Staff. Some Q-WIN features
require a Q-WIN client, for example to edit tickets. The settings for the Q-WIN client are stored
in the qwin.ini file.
Web clients are clients to the Q-WIN web server. Web clients are used for most of the server
settings, staff member registration, management screens and statistical reports.
Q-WIN Applications are applications that require a connection to the Q-WIN server. This
manual does not cover applications.
There is a lot of information in a running system. It is the waiting ticket numbers, arrival times,
selected priorities, etc. All this information is vital to the system and must be saved to prevent
chaos if Q-WIN stops. The information is saved in data files (.dat) in the Data folder. Q-WIN
automatically saves the information. The time between each backup is specified in the Host
Settings/Date & Time settings.
The Data folder also contains a temp.ini file that saves some temporary information, for example
positions and sizes for windows that have been open inside Q-WIN.
Q-WIN Clients
Data files
Q-WIN system
087.01E Q-MATIC AB 27
Options enhance Q-WIN and make it more useful. The user must have a licence to be able to
use an option.
Options are server based and not depending on the number of users.
Q-WIN Suite
With the Suite option for Q-WIN, the management of the number of workstations is handed
over to the Q-MATIC Suite application.
Q-WIN API
Q-WIN API releases the power of Q-WIN to other systems. With the Q-WIN API you can send
and receive commands and information from Q-WIN to and from just about any other Windows
program. The Q-WIN API is programmable from just about any Windows programming
language. There are two API options.
API Server makes it possible to use the Q-WIN API. This is a server-based option and it is not
based on the number of users.
API Clients are the clients using API to communicate with the Q-WIN server. The licence
specifies the number of users.
Q-WIN Advanced script
The advanced script option makes it possible to use SQL in Q-WIN scripts. Read or change in
existing databases or create new databases from Q-WIN scripts.
Q-WIN Custom Layouts
Customised layouts make it possible to create special management screens and statistics reports
for a customer.
Q-WIN Distributed Management
The Distributed Management option makes it possible to connect the Q-WIN client to remote
Q-WIN servers. This makes it, for example, possible for headquarters to collect statistics from
branches.
Q-WIN Ticketless
Use this option in Q-WIN system without ticket printers.
There must be at least one ticket printer in the system if it does not have the Q-WIN
Ticketless option.
Options
Q-WIN Reference Manual - Vol 1, Basic
28 Q-MATIC AB 087.01E
Q-WIN Database Statistics
Q-WIN Database Statistics makes it possible to store statistics in a database, for example in a
Microsoft Access database. This makes it possible for other applications than Q-WIN to read and
present the statistics, for example Microsoft Excel.
Q-WIN Mail
With Q-WIN Mail you can get email updates, keeping you informed regardless of your location.
Q-WIN Pager
Q-WIN Pager provides connectivity to real-time wireless messaging tools to help solve even the
toughest on-site communications problems. It is the ideal choice for people who need a cost-
effective, flexible and complete communications solution. Q-MATIC Pager can send numeric or
alphanumeric system information to almost any type of pager.
Q-WIN Voice
Q-WIN Voice can help people upon arrival as well as when they are being called out. Q-WIN
Voice is customisable, programmable and can announce in every spoken world language. Q-
WIN Voice can "speak" using a male or a female voice. It can also deliver information on two
separate channels.
The Q-WIN server itself is an invisible program running on a server. Only system administrators
and service technicians change in the server settings. The normal user uses one or more of the
applications in Q-WIN. There are two types of applications: internal applications and external
applications. Applications require a licence for each user of the application.
Internal applications are applications installed as a part of Q-WIN. Internal applications are
described in other chapters of this Q-WIN Reference Manual.
External applications are separate programs but they communicate with the Q-WIN server.
External applications have their own reference manuals and are not included in the Q-WIN
Reference Manual.
Q-MATIC Calendar
Keeping track of customer information is vital. With Q-MATIC Calendar you can keep things
running smoothly, with the ability to see all your office's appointments at a glance. Your
customers stay informed. You can inform them of appointment times, waiting times and even
integrate your call centre.
Q-MATIC Client Terminal
Q-MATIC Client Terminal allows you to serve, call and identify your customers in one easy-to-
use interface. With Q-MATIC Client Terminal you have all of the resources you need to provide
good customer service just one mouse click away.
Q-WIN Applications
Q-WIN system
087.01E Q-MATIC AB 29
Q-MATIC Staff Advanced
With Q-MATIC Staff Advanced you can choose the level of detail you work with. Whether you
are interested in minute-by-minute management or just the bottom line, Q-MATIC Staff
Advanced will help you save time and money.
Q-MATIC Staff Basic
With Q-MATIC Staff Basic you can simply and quickly compare staff allocations to service
targets to determine how many staff you should have up front, and when.
API Client
The API Client is not an application. The API Client makes it possible for custom made or third
party applications to use the API to communicate with Q-WIN.
The server must have the Q-WIN API option to be able to use API Clients.
Q-WIN Reference Manual - Vol 1, Basic
30 Q-MATIC AB 087.01E
087.01E Q-MATIC AB 31
4. Installation
Topics in this chapter
Hardware and software requirements ........................................... 32
Licences ......................................................................................... 32
Installing Q-WIN for the first time ................................................. 33
Installing Q-WIN clients ................................................................. 34
Upgrade an existing licence........................................................... 35
Upgrade Q-WIN to new version..................................................... 36
Install a service pack (SP) .............................................................. 36
External Q-WIN applications.......................................................... 36
Q-WIN Reference Manual - Vol 1, Basic
32 Q-MATIC AB 087.01E
Some applications have other requirements than those for Q-WIN. Please read the
documentation for the application for more information.
The licence is a file with information about the Q-WIN version, number of users, options and
applications. It is not possible to start Q-WIN without a valid licence. The licence is locked to
one Q-WIN Interface and cannot be used with any other Q-WIN Interface.
The licence is usually sent by email to the Q-MATIC representative. The file is copied to the
computer connected to the corresponding Q-WIN interface.
Save a backup of the licence file.
To install a licence:
1. From Q-MATIC you receive three files: the licence file (.qwl), and two files with information
about the licence, a text file and an HTML file.
Hardware and software requirements
Table 1: Requirements
Size of system
Small Medium Large
Operating system -
server
Windows NT4, 2000,
XP.
Windows NT4, 2000,
XP, Vista.
Windows NT4, 2000,
XP, Vista.
Processor
X86 500 MHz. X86 2 GHz. X86 3.4 GHz.
RAM
512 MB. 1 GB. 2 GB.
Hard Disk - server
200 MB. 500 MB. > 1 GB.
Serial Port
One COM or USB
port.
One COM or USB
port.
One COM or USB
port.
Sound Card
Yes with Q-WIN
Voice.
Yes with Q-WIN
Voice.
Yes with Q-WIN
Voice.
Network Card
10/100/1000 Mbps
Ethernet Controller.
100/1000 Mbps Ether-
net Controller.
100/1000 Mbps Ether-
net Controller.
Licences
Installation
087.01E Q-MATIC AB 33
2. Place the files in the licence directory, the default is the Lic directory, see below. Q-WIN
automatically uses the licence.
The licence only works when the corresponding Q-WIN Interface is connected to the
computer.
It is possible to have several licence files in the licence directory. Q-WIN searches the directory
and uses the first (in alphabetic order) valid licence found, for the connected Q-WIN interface.
In the [FILES] section in the qsys.ini file, there are two keys related to licences:
LIC_FILE = 36689-20000-101.qwl
stores the name of the licence file in use and
LIC_FILE_DIR = LIC
stores the name of the directory of the licence file. Default value is Lic. Change to any suitable
directory you want to use.
On a Windows Vista installation, all the Q-WIN directories (the Lic directory, for example)
are located in the directory called ProgramData. This directory is hidden as default. In the
Program Files directory (or the directory you specify) are only the exe and dll files.
There are three options for the installation.
Server installation
Client installation
Service installation
The Server installation installs a complete version of Q-WIN (both server and user interface) on
the computer.
This installation comes with a full Tomcat web server. It uses port 80 by default. Check that no
other application uses this port.
A Java Run-time application is also installed, if not already on the machine.
The Client installation is used to install Q-WIN clients.
The Service installation installs Q-WIN as a service on the computer. There will be no user
interface when Q-WIN is running as a service but it is possible to install a client on the same
computer to get a user interface.
To make a good installation of Q-WIN do the following:
1. Install the Q-WIN program.
2. Copy the licence file to the licence directory.
Installing Q-WIN for the first time
Q-WIN Reference Manual - Vol 1, Basic
34 Q-MATIC AB 087.01E
3. Start Q-WIN.
4. Make the necessary changes in the system settings.
5. Test the system.
Q-WIN Clients are installed in the same way as the Q-WIN server but the communication
between the server and the client must be specified before the client can start.
Server settings
The network communication must be enabled on the server before any client can be started. See
Connection settings on page 178 for more information.
1. Open the System Configuration window.
2. Select Host.
3. Select the Connection settings.
4. Make sure that there are at least two Host connections. Host connection 1 cannot be changed
or removed and is not displayed in the settings.
5. Specify the settings.
6. Click Save to save the settings.
Client settings
The client settings are usually entered during the Q-WIN installation.
To make changes to these settings at a later time you edit the qwin.ini file. Note: it is not possible
to open the Q-WIN client before it has established a connection with the server. Do the
following:
Installing Q-WIN clients
Installation
087.01E Q-MATIC AB 35
1. Open the qwin.ini file.
2. Change the CONNECTION setting for the the branch in question, for example:
[BRANCH_1].
3. Save the qwin.ini file.
4. Start the Q-WIN client.
Use the following syntax for the client settings:
TCP_IP, server_name, port_number, udp_event_port, not_used,
encryption, tcp_event_port
Example
TCP_IP, 192.168.1.10, 500, 501
The following settings are made: Q-win server port 500, Q-Win server UDP port 501. Note: It
is possible to leave out the remaining parameters; Q-Win default values will be used:
encryption=2, tcp_event_port=0.
Example
TCP_IP, 192.168.1.10, 500, 0, 0, 2, 5050
The following settings are made: Q-win server port 500, udp event disabled, q-win encryption,
Q-Win server TCP event port 5050.
The users must upgrade the licence if they want to add options or applications or if they want to
upgrade to a new Q-WIN version.
1. Order the licence.
server_name tcp/ip address or host name of Q-Win server
port_number Q-Win server port
udp_event_port Q-Win server UDP port, set to 0 if TCP is used
not_used 0
encryption 2 = Q-Win encryption
1 = Distributor encryption
0 = no encryption
Note. Q-Win clients must use 2, Q-Win encryption
tcp_event_port Q-Win server TCP port, set to 0 if UDP is used
Upgrade an existing licence
Q-WIN Reference Manual - Vol 1, Basic
36 Q-MATIC AB 087.01E
2. From Q-MATIC you receive three files: the licence file (.qwl), and two files with information
about the licence, a text file and an HTML file.
3. Replace the files in the licence directory with the new files. The new options are immediately
available.
When upgrading to version S, there are two things to consider: previous use of TCP/IP
connection and migration of an existing Q-WIN database.
The upgrade to a new Q-WIN version is performed in two steps.
1. Install the new version of Q-WIN.
2. Copy the licence files to the licence directory.
The new version of Q-WIN must be installed before the licence is copied.
If you have not used a TCP/IP-connection in your previous version of Q-WIN, you must insert
these lines in the qsys.ini file:
[HOST]
MAX = 2
HOST1 = DIRECT
HOST2 = TCP_IP,500,501,30
To move the contents of your existing Q-WIN (Access) database over to the new version of
Q-WIN you must run the X41 program. You must have run the new Q-WIN at least once so
that it has created the default database. An InstallAdmin user group is created with one
InstallAdmin user. All user group policies will have to be recreated; all users have full rights to
everything. All staff members will be able to choose user name and logon without password.
Service packs are corrections of errors in existing versions of Q-WIN. You do not need any new
licence for a service pack.
External Q-WIN applications are separate programs that need the Q-WIN server to run. Most
settings are performed within the application and described in the application's manual but there
are two things that are general.
Upgrade Q-WIN to new version
Install a service pack (SP)
External Q-WIN applications
Installation
087.01E Q-MATIC AB 37
Licences
Make sure that the Q-WIN Interface contains a licence for the application.
Enable network communication
Most applications use a network to communicate with the Q-WIN server. Make sure that the
network communication for the server is enabled. Open the system server settings and select the
Connection tab. Enable the type of connection used between the application and the Q-WIN
server. See Installing Q-WIN clients on page 34, for more information.
Q-WIN Reference Manual - Vol 1, Basic
38 Q-MATIC AB 087.01E
087.01E Q-MATIC AB 39
5. Start Q-WIN
Topics in this chapter
Logging into Q-WIN....................................................................... 40
Start window................................................................................. 41
Q-WIN Reference Manual - Vol 1, Basic
40 Q-MATIC AB 087.01E
The user must always log-in before using Q-WIN. The log-in gives the user the access rights that
are specified in the user group policy. The user name and password are specified in the staff
member registration in the database.
There are password settings that specify the protection level.
There are three ways to perform a login.
Use the Windows user name.
Enter a user name.
Enter a password.
Use the windows user name
The user does not have to enter any name or password to access Q-WIN. Q-WIN uses the
Windows login name to identify the user. The Widows login name must be specified in the staff
member database.
Enter a user name
A user name is specified in the staff member database. The user must enter a user name to get
access to Q-WIN. The user name can be any name.
Enter a password
A password is specified in the staff member database. The user must enter a password to get
access to Q-WIN. The password can be used together with the user name.
Logging into Q-WIN
Start Q-WIN
087.01E Q-MATIC AB 41
Use the Q-WIN Workspace in the start window to start Q-WIN applications. The available
applications on the Workspace depends on the user's access right. The Workspace is not opened
if the user has access to only one application.
Start window
Q-WIN Reference Manual - Vol 1, Basic
42 Q-MATIC AB 087.01E
087.01E Q-MATIC AB 43
6. Tickets
Topics in this chapter
Tickets are more than ticket numbers............................ 44
Ticket creator and editor - BP2800 ................................ 47
Editing plain text ........................................................... 48
Editing a ticket layout program ..................................... 48
Adding a picture ............................................................ 50
Removing a picture........................................................ 51
Creating a new ticket .................................................... 51
Selecting ticket .............................................................. 52
Example 1 - a simple ticket............................................ 53
Example 2 - Print two tickets at same time ................... 54
Example 3 - Shift between two different tickets ............ 55
Example 4 - Stop printing tickets................................... 55
Example 5 - System without workstation terminals....... 56
Control codes................................................................. 57
Ticket creator and editor - TP3100................................. 65
Editor commands........................................................... 66
Creating a new ticket .................................................... 68
Inserting and editing text .............................................. 68
Inserting and editing system information ...................... 70
Inserting and editing scripts on a ticket......................... 72
Inserting and editing barcodes on a ticket..................... 72
Creating images for tickets............................................ 74
Inserting and removing images ..................................... 74
Assigning a ticket to a button........................................ 75
Examples ....................................................................... 76
Q-WIN Reference Manual - Vol 1, Basic
44 Q-MATIC AB 087.01E
Q-MATIC Ticket Editors are programs to design tickets that are printed on Q-MATIC ticket
printers. With the programs, all features of a ticket can be changed easily. You can keep ticket
designs for use on special occasions, and also easily create new ones.
Q-MATIC has two families of ticket printers:
The BP2800 series (BP2882 and BP2884).
The TP3100 series.
These ticket printers are designed differently, therefore there is a Ticket Editor for each type of
printer.
Q-WIN needs to be set-up so that the correct Ticket Editor is on the Utilities menu for the end
user. Also, the Edit Script function of the TP Editor should normally be disabled for end users.
This is done on the User Group Policies page on the Staff Member Registration pages.
All systems except Q-MATIC Ticketless Systems must use tickets. For most customers the ticket
is the most concrete part of the system. The size of a ticket is 60 X 60 mm.
The traditional ticket has a large ticket number in the middle. The ticket number is the most
important information on the ticket and is printed in a bigger text style. Above the ticket there
is usually a logotype or a short text message. Below the ticket number there are some information
texts such as the estimated waiting time and the date and time the ticket was printed.
This is a good ticket design, but the tickets can have other designs as well.
Tickets are more than ticket numbers
This is a typical ticket with
a picture, a line of plain text
and 4 lines of system infor-
mation.
This is an Information tick-
et. It has only plain text and
it will look the same every
time it is printed.
There are three types of items
that can be printed on a ticket:
Plain text.
Images.
Items of these two types are
exactly the same on all
tickets.
System information.
This is information from the
queue system, for example
ticket number, time and date.
The system automatically
updates this information
before it is printed on the
ticket.
Tickets
087.01E Q-MATIC AB 45
Use the ticket Editor to design a ticket that serves the customers' needs in the best way. For
example, print advertisements on the ticket. It is even possible to print different advertisements
at different days or at different hours during the day.
Print barcodes and use the ticket with barcode readers.
Print information about the selected service or perhaps the name of the person that will handle
the service.
It is even possible to completely remove the ticket number. Perhaps the user only wants an
information text on the ticket, for example "We open at 8:00am, please come back later" or
"Invalid card, please go to the information desk".
The customer name can replace the ticket number in a system where the customer is identified
on arrival.
It is possible to print more than one ticket at a time. Perhaps the customer should keep one ticket
and attach the other to documents.
It is the ticket layout that makes this flexibility possible. The ticket layout is a mixture of text,
formatting code and script program code.
Here is a short functional comparison of the two ticket Editors, for a BP2800 and a TP3100
printer respectively.
BP2800 TP3100
The view of the complete ticket layout in the Editor:
There is also a preview available of the ticket
in this Editor, but this is the design window
for scripts and text.
In the TP3100 Editor, the scripts can be
written as small snippets that are positioned
on the ticket by dragging with the mouse.
Q-WIN Reference Manual - Vol 1, Basic
46 Q-MATIC AB 087.01E
System information
System information is information from the Q-WIN server. This information is dynamic and
makes it possible to print ticket number, selected service, time, date, etc. on the ticket. Use
script program in the ticket layout to print system information.
BP2800
It is usually not possible for end users to
change system information items because you
need good knowledge in script programming.
Script programming and ticket layout are not
described in the Q-WIN User's Guide for
these printers.
TP3100
Some system information items (see below)
can be managed separately and thereby end
users can handle them on a ticket.
Many format properties of an information
item can easily be changed: font, size, bold,
alignment, rotation, etc.
Plain text
Plain text is always the same on all tickets that use the same ticket layout.
BP2800
The end user can change the text and change
the size of the text.
TP3100
The end user can easily change the text and
many format properties of the text: font, size,
bold, alignment, rotation, etc.
Pictures
Pictures are usually logotypes. Can be any type of picture, an advert, for example.
BP2800
The picture format used with these printers is
not a standard format. Use the bmpcnvt.exe
program or the Q-Master Support program to
convert bitmap (bmp) pictures into the pic
format. Both programs are available free of
charge from the Q-MATIC Support Site.
The picture must be available both as a
bitmap file and a hpic file.
End users can easily insert images on tickets,
but not add images to the image library.
TP3100
The picture format used with these printers is
a standard format: Windows bmp, mono-
chrome.
End users can easily both add images to the
image library and insert images on tickets.
Tickets
087.01E Q-MATIC AB 47
The Ticket Editor is used to edit tickets or to create new tickets. Select "Ticket Editor..." from
the Utilities menu.
No. Name
This is a list with all saved tickets.
Functions codes
Function codes are used in script programs. Select a function code and click "Insert Code" to
insert it into the ticket script.
Pictures
Use this list to place an image on the ticket. The image file must be available in two formats: the
Q-WIN pic-format to be able to print on a ticket and the bitmap (bmp) format to be able to
preview on the screen. Click "Insert Picture" to place the selected image on the ticket.
Ticket script/text
This is the script and/or text for the information displayed on the ticket.
Increase Width, Decrease Width, Increase Height, Decrease Height
Use these button to change the size of the ticket text. The buttons affect the part of the ticket
text that is currently displayed in the Ticket script box.
Ticket creator and editor - BP2800
Q-WIN Reference Manual - Vol 1, Basic
48 Q-MATIC AB 087.01E
View Script
Display the complete ticket script in the Ticket script box.
Next Section
Display the next section of the ticket script in the Ticket script box.
Preview ticket
Click Test to preview the ticket.
Open the Ticket editor by selecting Ticket Editor... in the Utilities menu.
Select a ticket from the No. Name list. This list contains all available ticket texts.
Click Next Section until the text that should be edited is shown in the ticket text box.
Edit the displayed text or use Increase Width, Decrease Width, Increase Height and
Decrease Height to change the size of the text.
Click the Preview ticket to see the result of the changes.
Click OK to save the changes or click Cancel to exit without changes.
A ticket layout program is a mixture of control code, script program and plain text.
Example of a ticket and the corresponding ticket layout program.
Editing plain text
Editing a ticket layout program
PICTURE qmatic.pic
AT 146 322
\eB4\eH4Welcome
"\eb4\eh5\eS"
GROUP_NUMBER LEN(3)
"\n\eb3\eh3"
BUTTON_NAME
"\n\eb1\eh3" TIME DATE" "
PRINTER_TICKETS_LEFT
LEN(4 ) "\n\f"
Tickets
087.01E Q-MATIC AB 49
Control codes specifie the layout of the ticket, for example text size, the position of text, font,
etc.
The script program puts system information on the ticket and makes it possible to start complex
activities in the system.
Plain text is printed on the ticket exactly as it is written in the ticket layout program.
A ticket layout program can contain other scripts than those that are needed to print the
ticket. It is for example possible to add the FUNC_CAMERA_SNAPSHOT script command to
take picture of the customer.
Copy the ticket layout program to the clipboard before it is saved. The program may be
erased if it contains errors.
Select a ticket from the No. Name list. This list contains all available ticket layouts.
Click the Preview ticket to show the current ticket.
Click View Script to show the ticket layout program in the Ticket script box.
Edit the ticket layout program.
Click Preview ticket to check the result of the changes.
Click OK to save the changes or click Cancel to exit without changes.
Click Preview ticket after all changes that affects the layout of the ticket. Then you know
that the result of the changes was what you expected.
You can use the Functions Codes list box to search for a script command. Click the Insert
button to insert the selected script command into the ticket layout program.
Sometimes you do not want to print the same ticket every time the users press a ticket
button. For example, you want one information text printed if the customer arrives before 8:00
am and an ordinary ticket printed if the customer arrives after that time. You can create a ticket
layout program that does not print any ticket at all. The ticket layout program uses
FUNC_RUN_TEXT to select which of the two tickets, information ticket or ordinary ticket, that
will be printed.
Q-WIN Reference Manual - Vol 1, Basic
50 Q-MATIC AB 087.01E
An image, usually a logotype, can be placed on the ticket. The image must be monochrome and
small enough to fit into the ticket.
Make a monochrome bitmap picture.
You can use Microsoft Paint to convert a picture into monochrome bitmap format.
Open the picture and select Save As from the File menu. Select Monochrome Bitmap as the
file type when you save the picture.
Convert the bitmap picture into the Q-MATIC pic format.
The pic format used in Q-WIN is not a standard format. You must use the bmpcnvt.exe
program or the Q-master Support program to convert bitmap (bmp) pictures into the pic
format. Both programs are available free of charge from the Q-MATIC Support Site.
Place both the bitmap and the pic file in the Q-WIN folder. Q-WIN must find the bitmap
file to be able to show the picture in the preview box.
Select Ticket Editor on the Utilities Menu.
Select a ticket from the "No. Name" list box.
Click Preview ticket to show the current ticket.
Use the Pictures list box to select a picture.
Click Insert Picture to insert the picture into the ticket.
Adding a picture
Pictures on tickets
Format: monochrome bitmap and pic format.
Maximum width: 448 pixels
Maximum height: Ticket height
Tickets
087.01E Q-MATIC AB 51
Place the mouse pointer on the picture and press the left mouse button. Drag the picture to
a new position.
Click OK to save the changes or click Cancel to exit without changes.
Select a ticket from the "No. Name" list and click the preview button to show the ticket.
Place the mouse pointer on the picture.
Press the left mouse button and drag the picture out from the ticket.
Click OK to save the changes or click Cancel to exit without changes.
The designing of a new ticket layout never starts from scratch. It always starts with an existing
ticket layout.
Select "Ticket Editor..." from the Utilities menu.
Click New Ticket.
Click Edit name and enter a name for the ticket.
Removing a picture
Creating a new ticket
Q-WIN Reference Manual - Vol 1, Basic
52 Q-MATIC AB 087.01E
Continue in the same way as when editing an existing ticket layout program.
Design a set of useful tickets for your customer. It is much easier for your customer to just
select a ticket from a set than to edit an existing ticket layout program. For example, your
customer uses an ordinary "Welcome" ticket but wants to use a "Merry Christmas" ticket in
December. It is of course possible to edit the "Welcome" ticket each December but it is much
better to have two tickets and to just assign one of them to the button.
It is very easy for the customer to select the ticket that should be used (see below). It is even
possible to automatically change the ticket at December 1st. You make a ticket text that checks
which ticket to use. Use a script program to check the date. If it is between 1 of December and
31 of December then you use the "Merry Christmas" ticket else you use the "Welcome" ticket.
There is usually a ticket assigned to each ticket button in the system. Many ticket buttons can
share the same ticket if they are going to show the same type of information, for example ticket
number, date and time.
Select "Ticket Selector" from the Utilities menu or click Ticket Selector on the Workspace.
Select a ticket button from the list.
Select a ticket from the "No. Name" list box.
Selecting ticket
Tickets
087.01E Q-MATIC AB 53
Click Preview ticket to show the selected ticket.
Continue with the next ticket button.
Click OK to save the changes or on Cancel to exit without changes.
This is an example of a very simple ticket. It is perhaps not very useful but is a good start if you
are unfamiliar with ticket layout programs.
The ticket shows the text Welcome to Q-WIN and a ticket number.
"\eB3\eH3Welcome to\n\eB4\eH4
Q-WIN\n\eB2\eH3\eS" GROUP_NUMBER
LEN(3) "\n\eZ150\n\f"
Explanation
\eB3
Set the width of the text to size 3.
\eH3
Set the height of the ticket to size 3.
Welcome to
This is plain text. This text is printed on the ticket.
\n
New line, the next character will be placed on the next line.
\eB4\eH4
Specify the size of text line two.
Q-WIN
Another piece of plain text.
Example 1 - a simple ticket
Q-WIN Reference Manual - Vol 1, Basic
54 Q-MATIC AB 087.01E
\n\eB2\eH3
Add a new line and specify the text size on line three.
\eS
Print the ticket number with enlarged digits.
GROUP_NUMBER
Insert the ticket number.
LEN(3)
Specify that the ticket number always uses three digits.
\n
Add anew line.
\eZ150
This command specifies the placement of the text on the ticket. We want to print the text
in the middle of the ticket.
\n\f
New line and form feed. All tickets that should be printed must end with a line feed and a
form feed otherwise it is not printed.
In this example we write a ticket layout program that prints two tickets. This can be very useful
if the customers are supposed to hand in something, for example documents. The customer can
attach one of the tickets to the documents.
"\eB3\eH3Ticket No: 1\nWelcome to\n\eB4\eH4
Q-WIN\n\eB2\eH3\es" GROUP_NUMBER LEN(3)
"\n\eZ150\n\f""\eB3\eH3Ticket No: 2\nWelcome
to\n\eB4\eH4Q-WIN\n\eB2\eH3\es" GROUP_NUMBER LEN(3)"\n\eZ150\n\f"
The \n\f in the middle of the ticket layout program is the form feed that ends the first ticket. You
can add \n\f to print many tickets at the same time.
The example above is one way to print multiple tickets. This is useful if you print tickets
that are not advanced. If you want to print multiple tickets and they are advanced with long
ticket layout programs then you can use FUNC_RUN_TEXT. Write a ticket layout program that
uses FUNC_RUN_TEXT to call the different tickets that you want to print. This is a very
flexible solution.
Example 2 - Print two tickets at same time
Tickets
087.01E Q-MATIC AB 55
We want to print two tickets. Between 8:00 am and 5:00 pm we want to print the ordinary
ticket. Before and after that time we want to print a ticket that informs the customers that it is
closed.
The two tickets are very simple but the point of the example is the ticket layout program that
selects which ticket to print. The ticket button is assigned a ticket that does not print any ticket
by itself; it calls one of two other ticket layout programs.
IF((TIME_NO GT 8*1800) AND (TIME_NO LT 17*1800))
FUNC_RUN_TEXT(2) ELSE FUNC_RUN_TEXT(3)
IF((TIME_NO GT 8*1800) AND (TIME_NO LT 17*1800))
Check if the time is between 8:00 am and 5:00 pm (17:00).
FUNC_RUN_TEXT(2)
Run ticket layout program 2 if the time is between 8:00 am and 5:00 pm.
FUNC_RUN_TEXT(3)
Run ticket layout program 3 if the time is not between 8:00 am and 5:00 pm.
In this example we want to stop printing tickets at 4:00 pm Monday to Friday and at 1:00 pm
on Saturdays.
IF (DAY_IN_WEEK LE 5 AND HOUR LT 16 OR DAY_IN_WEEK EQ 6 AND HOUR LT 13)
BEGIN
... the ticket layout program...
END
DAY_IN_WEEK LE 5
Check if it is Monday to Friday.
HOUR LT 16
Check that the time is before 4:00 pm (16:00).
DAY_IN_WEEK EQ 6
Check if it is Saturday.
Example 3 - Shift between two different tickets
Example 4 - Stop printing tickets
Q-WIN Reference Manual - Vol 1, Basic
56 Q-MATIC AB 087.01E
HOUR LT 13
Check that the time is before 1:00 pm (13:00).
This system does not use workstation terminals. The customer is called at the same moment as
the ticket is printed. This example shows that a ticket layout program can contain script
commands that have nothing to do with the information printed on the ticket.
"\eB6\eH8Welcome\n\eB3\eH3\n\eB3\eH3"
"\eb4\eh5\eS" GROUP_NUMBER LEN(3)
"\n\eb3\eh3" BUTTON_NAME "\n\eb1\eh3"
TIME DATE" " PRINTER_TICKETS_LEFT
LEN(4 ) "\n\f" FUNC_CALL (3
GROUP_NUMBER BUTTON 0 0)
FUNC_CALL
This script command calls a ticket number. The command has five arguments.
3 This is the workstation number used to call the ticket number.
GROUP_NUMBERThis is the ticket number.
BUTTON This is the priority number. In this case the ticket button number selects
the priority number. Priority 1 serves customers from ticket button 1,
priority 2 serves customers from ticket button 2, etc.
0 The first 0 specifies that the called ticket number should be showed on the
displays.
0 The last 0 specifies that the call for a customer should be stored if there are
no waiting customers. This argument has no function in this example
because there is always a waiting customer when the FUNC_CALL
command is executed.
Example 5 - System without workstation terminals
Tickets
087.01E Q-MATIC AB 57
Here is an alphabetic list of all control codes used in ticket layout programs. See the Reference
Manual Vol. II, Scripts for more information about script commands.
\n
Line feed.
\f
Form feed. Each ticket must end with a line feed and a form feed, "\n\f". Place a form feed inside
the ticket layout program to continue with the text on the next ticket.
\eA
Paper cut. The paper cut is always placed after the form feed. Can only be used if the ticket
printer is equipped with a cutter unit.
Control codes
Control codes and tickets
Always strings (placed within quotation marks "").
Ticket Width: 448 pixels
One step of the step motor: 0.109 mm
Q-WIN Reference Manual - Vol 1, Basic
58 Q-MATIC AB 087.01E
\eBx
Specify the width of the subsequent characters. The code only applies to one line.
Arguments
x Character width. Valid values are 0-9.
\eCx
Print the a number as a barcode. Put \eCx before the number.
Arguments
x Type of barcode
Table 2: Barcodes
x Barcode
0 2/5
1 EAN 13 (European Article Numbering). This is the code used on the products in the
supermarket. Use this code carefully. It is no problem as long as it is used internally in
an organisation but never use it so that it can be mistaken for an official EAN code.
2 Interleaved 2/5. Older code type. Can only print digits, not letters. Must have an even
number of characters.
Tickets
087.01E Q-MATIC AB 59
\eD
Kanji off. This is used if you have used Kanji characters (\eK) and want to print European
characters.
\eE
Add an end mark to barcode 2/5, Interleaved 2/5 and Code 39.
An end code must be added to the barcode otherwise it will not work.
\eFx
Select a character set.
Arguments
x The code page number.
3 Code 39. Commonly used code. Can print digits, letters and some other characters.
Table 3: Code pages
x Code page
1 IBM standard (OEM 437 US except positions
9B/9D that are the Latin small and capital
letters and ).
2 Q-MATIC SD Set (Japanese 932 and some extra
characters in the lead byte positions).
3 ANSI (ISO 8859)
4 IBM Danish
5 IBM Icelandic
6 IBM Turkish
7 IBM Greek
8 IBM Polish
9 IBM Arabic
1250 1250 ANSI, Central Europe
1252 1252 ANSI Latin 1 (US, Western Europe)
1253 1253 ANSI Greece
1254 1254 ANSI Turkey
Table 2: Barcodes (Continued)
x Barcode
Q-WIN Reference Manual - Vol 1, Basic
60 Q-MATIC AB 087.01E
You should usually not use \eFx if there are new printers in the system. Use CODE_PAGE in
the [PRINTER] section of the qsys.ini file to specify the code page. Set CODE_PAGE=0 to use
the code page used by Windows.
You cannot use ANSI code pages on older ticket printers.
Set CODE_PAGE to one of the ANSI code pages (except 3) if you want to manually specify the
code page
\eGx
Select Font. The code applies to one line.
Arguments
x The font number.
\eHx
Character Height. The code applies to one line.
Arguments
x The character height. Valid values are 0 - 9.
1257 1257 ANSI Baltic
Table 4: Fonts
x Font
1 Q-MATIC Standard
2 IBM 1 6x10
3 IBM 2 8x14
4 Arial 16x21
5 Times New Roman 16x28
Table 3: Code pages (Continued)
x Code page
Tickets
087.01E Q-MATIC AB 61
\eI
Inverted text. The code applies to one line.
\eKx
Print Kanji characters. The Kanji alphabet must be loaded into the ticket printer.
Arguments
x Character set
Table 5: Character set
x Character set
0 Sub set of Japanese Kanji 300 pc.
1 Full range Kanji. You use .yyyy to specify the
characters. For example. enter
"\eKx.yyyy.yyyy.yyyy normal text.yyyy".
2 and 3 Full range Korean language.
4 Full range Kanji for Windows
Q-WIN Reference Manual - Vol 1, Basic
62 Q-MATIC AB 087.01E
\eL
Align text to the left. The code applies to one line.
\eMx
Change the centre position line. The centre position line specifies the centre of the ticket. The
text is usually centred relative to the centre position line. The code applies to the current line
and all previous lines.
Arguments
x The position of the centre line. Valid values: 0-448. Default value: 224.
\eR
Align text to the right. The code applies to one line.
All lines are centred to the
The centre position for the two
Tickets
087.01E Q-MATIC AB 63
\eS
Print number with enlarged digits. This control code can only be used on numbers. It is usually
used to show the ticket number with large digits. \eS must be used together with the default font.
\eTx
Specify the blackness of the text.
Arguments
x Blackness of the text. Valid values: 0-9. 0=light, 9=dark. Default value: 5.
You reduce the lifetime of the print head if you select blackness 7-9.
\eU
Print the text upside-down. The code applies to one line.
\eXx
Specify the printing speed.
Arguments
x The speed of the ticket. Valid values: 0-9. Default value: 5
\eYx
Change line spacing. The code affects the line space between the line with the code and the
previous and the following lines.
Q-WIN Reference Manual - Vol 1, Basic
64 Q-MATIC AB 087.01E
Ticket without changed line spacing. The line spacing before and after the ticket
number is changed to 30 steps. Place
\eY30 at the same line as GROUP_NUMBER.
Arguments
x Line space in number of dots. Valid values: 01-63 dots.
\eZx
Line feed. All previous text lines are moved x steps.
Ticket without \eZ. Ticket with \eZ220 added to the line for the ticket
number.
Arguments
x Line feed in steps. One step is 0.1089 mm. Valid values are 0-65535 steps.
Tickets
087.01E Q-MATIC AB 65
Select Ticket Editor TP on the Utilities menu to open the Editor. The Editor is opened as a
window covering the whole of the Q-WIN window. Close the Editor by clicking the small Close
cross in the upper right corner (the large, red cross closes Q-WIN).
The printable area on a ticket is 432 X 440 and 432 X 920 pixels, for a single-ticket and double-
ticket respectively.
Ticket creator and editor - TP3100
The window has two main areas:
The area to the left for Tickets. There is a
list of available tickets and command icons
for them.
The area to the right is the workspace for
the Selected Ticket. There are icons for
items on the ticket. Note the centre line.
The program has five menus:
File
Edit
Format
Insert
Help
Right area
Left area
Q-WIN Reference Manual - Vol 1, Basic
66 Q-MATIC AB 087.01E
File menu
The following commands are on the File menu and apply to the ticket as a whole:
New
Open a new empty ticket.
Save
Save the open ticket.
Save As
Save the open ticket with a new name. Use this command to create a copy of an existing
ticket.
Delete
Delete the selected ticket.
Set ticket length
Use this command to set the length of the ticket to a single-ticket or a double-ticket. A single-
ticket is one piece of paper and a double-ticket is two. Use this for example when customers
need to keep one ticket and need a second ticket to accompany a document etc. Another use
could be for advertising.
Save As Bitmap
The open ticket is saved as a Windows bitmap file. This file can be printed on an ordinary
printer, attached to an e-mail etc.
Upload image
Upload an image to the server. The image will be copied to the server. If there already is an
image with that name on the server, the user will be asked about what to do; over write,
rename or cancel. The image will then show up on the insert image list for inserting on a
ticket.
Button-Ticket Linker
Connect a ticket to a button.
To rename an existing ticket, double-click the name in the list and enter the new name.
Edit menu
On the Edit menu are commands for managing items on a ticket: Cut, Copy, Paste and Delete.
Format menu
On the Format menu are Font, Alignment (left, centre and right) and Rotation (0, 90, 180 and
270) commands.
Editor commands
Tickets
087.01E Q-MATIC AB 67
Insert menu
The commands on the Insert menu insert items on a ticket. There are several types of item that
can be inserted:
Icons and other features
The icons are short-cuts to Editor commands.
Text
Image
System Information:
Date, Time, Ticket Number, Category
Letter, Button Letter and Button Name.
Script
Barcode
The icons for the Ticket commands are, from left to right:
New , Save , Save As and Delete .
Below the icons is the Ticket list.
The icons for the Edit commands are,
from left to right:
Cut , Copy , Paste , Delete
and Edit .
The drop down lists and icons for the Text Format
commands are, from left to right:
Font and Size.
Bold, Italics and Underlined.
Alignment: left, centre and right.
Rotate: 0, 90, 180 and 270.
Q-WIN Reference Manual - Vol 1, Basic
68 Q-MATIC AB 087.01E
To create a new ticket:
1. Do one of the following:
Select New from the File menu or click the New icon to open a blank ticket.
Use an existing ticket as a template: Click a ticket in the Ticket list and select Save As on
the File menu to create a copy of an existing ticket.
2. Edit the ticket as required.
Plain text can be inserted and positioned anywhere on a ticket. Any available TrueType font can
be used.
The fonts to be used on a ticket must be installed on the Q-WIN server.
To insert text on a ticket:
1. Do either of the following:
On the Insert menu, select Text.
The icons for the Insert commands are placed in
the top left corner of the Selected Ticket area.
They are, from the top down:
Insert Text.
Insert System Information.
Insert Image.
Insert Script.
Insert Barcode.
The Image list
In the figure, the user has clicked the Insert Image
icon and thereby opened the Image List. This is the
list of images that are available on the system
server.
Creating a new ticket
Inserting and editing text
Tickets
087.01E Q-MATIC AB 69
Click the Insert Text icon .
A text item is inserted on the ticket.
2. Select the text by clicking it.
3. Drag the text with the mouse to the approximate position and double click it.
The Edit Text window opens.
4. Enter (change) the text and click the OK button.
5. With the text selected on the ticket, set text formats: font, size, bold, etc. Align the text
within the box (see step 2), and rotate the text as required.
6. If necessary, adjust the position of the text more exactly with the mouse.
To edit the content of text, open the Edit Text window by either:
Note the fixed selection box around the text and the small red triangle
at the edge of the box. The red triangle is the alignment indicator, left,
centre or right. The alignment of text is accomplished within this box,
not on the ticket. When there are several lines of text in the box, these
lines can be aligned, left centre or right. To position the text on the
ticket, move the box to the correct position; see the following steps.
Tip for centring text on a ticket: first align the text in the centre of the
box and then use the red dot and the centre line to position the box
exactly in the middle of the ticket.
Q-WIN Reference Manual - Vol 1, Basic
70 Q-MATIC AB 087.01E
Clicking the text on the ticket to select it and clicking the Edit Icon .
Double-clicking the text.
To change the format of text:
Click the text on the ticket to select it and use the icons or the Format menu commands
to make changes to font, size, bold, etc., as required.
To remove text, do either of the following:
Click the text on the ticket to select it and select Delete on the Edit menu.
Click the text on the ticket to select it and click the Delete icon .
Click the text on the ticket to select it and press the Delete key on the keyboard.
There are six basic system information items that can be inserted on a ticket. These items are
information from the queue system. The system automatically updates this information before
it is printed on the ticket.
It is possible to print barcodes on tickets, see below.
A ticket number must always be inserted on a ticket, otherwise the queue information will
be lost.
These information items are handled in the same way by the Ticket Editor.
Date
Time
Ticket Number
This is the current number in the numbering sequence for the specific ticket button the
customer pressed.
Category Letter
This is the letter of the category that this ticket button is assigned to; can be used to identify
the selected service.
Button Letter
This is the letter of the ticket button that the customer pressed; can be used to identify the
selected service.
Button Name
This is the name of the ticket button; can be used to identify the selected service. For
example, the bank service Foreign Exchange.
The way these information items work on a particular installation, depend on system settings.
Inserting and editing system information
Tickets
087.01E Q-MATIC AB 71
To insert system information on a ticket:
1. Do either of the following (this example concerns Ticket Number, the other types are
handled in the same way):
On the Insert menu, on the System Information sub menu, select Ticket Number.
Click the Insert System Information icon and select Ticket Number in the list.
A ticket number is inserted on the ticket.
2. Select the number by clicking it.
3. Drag the number with the mouse to the approximate position.
4. Set the format (font, size, bold etc.) of the number as required, using the icons or the Format
menu commands.
5. If necessary, adjust the position of the item more exactly with the mouse.
Tip for centring an item on a ticket: first align the item in the centre of the box and then use
the red dot and the centre line to to position the box exactly in the middle of the ticket.
To change the format of a system information item:
Click the item on the ticket to select it and use the format icons or the Format menu
commands to change font, size, bold etc. as required.
To delete system information, do either of the following:
Click the item on the ticket to select it and select Delete on the Edit menu.
Click the item on the ticket to select it and click the Delete icon .
Click the item on the ticket to select it and press the Delete key on the keyboard.
Note the fixed selection box around the number and the small red triangle at the
edge of the box. The red triangle is the alignment indicator, left, centre or right.
The alignment of the number is accomplished within this box, not on the ticket.
To position the text on the ticket, move the box to the correct position; see the
following steps.
Q-WIN Reference Manual - Vol 1, Basic
72 Q-MATIC AB 087.01E
Inserting Scripts on a ticket is done by using the appropriate insert icon or option on the
Insert menu. Position the script on the ticket in the same way as with System information, see
above.
To edit the script on the ticket, do either of the following:
Double click the script item
Select it and click the Edit icon,
Select it and select Edit on the Edit menu.
The Script Editor is started:
Select a Script command from the list and click the Insert button to insert it in the Editor. Edit
the command(s) as required.
Click Compile to make the Editor do a syntax check of the script.
Click OK to finish editing the script.
Inserting barcodes on a ticket is done by using the appropriate insert icon or option on the
Insert menu. Position the barcode on the ticket in the same way as with System information, see
above.
Because of printing considerations, we recommend to use the barcodes only horizontally aligned.
To edit the barcode on the ticket, do either of the following:
Inserting and editing scripts on a ticket
Inserting and editing barcodes on a ticket
Tickets
087.01E Q-MATIC AB 73
Double click the barcode item
Select it and click the Edit icon,
Select it and select Edit on the Edit menu.
The Barcode Editor is started:
There are three types of Barcodes available:
Interleaved 2/5
Encodes: Numeric Only.
Length: Variable, but must have an even number of digits. A 0 (zero) is automatically
added to the beginning of the number to make an odd number of digits even.
Checksum: Optional. Use the check box to select it or leave unchecked.
EAN 13
Encodes: Numeric Only.
Length: Fixed Length, 13 digits. Twelve digits of data and one checksum digit, which is
automatically added.
Checksum: Required.
Code 39
Encodes: Only 43 characters: 0-9, A-Z, and space $%+-./
Length: Variable. The the start and stop character, the asterisk (*), is automatically added.
Checksum: Optional. Use the check box to select it or leave unchecked.
By using script commands, any number from the system can be generated and thus converted to
a barcode. Select a script command from the list and click the Insert button to insert it in the
Editor. Edit the command(s) as required.
Click Compile to make the Editor do a syntax check of the script in the Editor.
Click OK to finish editing the barcode.
Q-WIN Reference Manual - Vol 1, Basic
74 Q-MATIC AB 087.01E
Images for tickets can be created from ordinary pictures, for example a logotype. The format
must be monochrome and Windows bitmap, bmp. The width of the printable area on a ticket is
432 pixels, and the printable height is 440 pixels for a single-ticket and 920 for a double-ticket.
Remember to leave room for other information on the ticket.
All images used on tickets must reside on the Q-WIN server, in the images directory. Use the
Upload Image command on the File menu to upload singel images. All images in the images
directory show up on the Image List. It is not possible to remove images from the server by using
the Ticket Editor.
Before inserting an image on a ticket, it must be up-loaded to the server. This is done with the
Upload image command on the File menu.
To insert an image on a ticket:
1. Do either of the following:
On the Insert menu, select Image.
Click the Insert Image icon .
The Image list is opened.
Creating images for tickets
Images on tickets
Format: monochrome Windows bitmap.
Maximum width: 432 pixels
Maximum height = ticket height: 440 and 920 for a single-ticket and a double-ticket, respectively.
Inserting and removing images
Tickets
087.01E Q-MATIC AB 75
2. Click the image to be inserted.
The image is inserted on the ticket.
3. Drag the image with the mouse to the intended position.
To remove an image from a ticket, do either of the following:
Click the image on the ticket to select it and select Delete on the Edit menu.
Click the image on the ticket to select it and click the Delete icon .
Click the image on the ticket to select it and press the Delete key on the keyboard.
One ticket is assigned to each ticket button. Many, or perhaps all, buttons can be assigned the
same ticket. Q-WIN automatically puts the correct system information related to the pressed
button on the printed ticket.
Assigning a ticket to a button
Q-WIN Reference Manual - Vol 1, Basic
76 Q-MATIC AB 087.01E
To select a ticket for a button:
1. Select Button-Ticket Linker on the File menu.
The Link a Ticket to a Button window is opened.
2. Click the cell in the Assign Ticket column for the button to link, and select a ticket from the
drop-down list that appears.
3. Click OK to save the selection or Cancle to abort.
To add a script for printing the expected waiting time on the ticket, use the Insert script
command and enter the following script:
"Waiting time " PRINT_TIME(BUTTON_ESTW) " min."
Format the layout of the script on the ticket as required.
To add a script for printing the number of remaining tickets on the ticket, use the Insert script
command and enter the following script:
TIME " " DATE " " PRINTER_TICKETS_LEFT LEN(4)
With this script, the time and date are also printed, for good measure.
Format the layout of the script on the ticket as required.
Examples
087.01E Q-MATIC AB 77
7. Quick texts
Topics in this chapter
Quick text ...................................................................... 78
Editing a quick text........................................................ 78
Adding a quick text ....................................................... 79
Removing a quick text ................................................... 79
Q-WIN Reference Manual - Vol 1, Basic
78 Q-MATIC AB 087.01E
Quick texts are predefined texts that can be used on tickets, displays, etc. The quick text is stored
at one site and when it is changed the new text will be shown everywhere where the quick text
is used.
Each quick text is assigned a number. Use the TEXT() script command and the quick text
number to print a quick text.
You can use quick texts to support multiple languages. For example, you use ten phrases in
a system. You use quick texts 1 to 10 for English phrases, quick texts 11 to 20 for French phrases,
etc. Script Number 11 is the French translation of the English phrase in quick text 1. In the script
program you add an offset to the quick text number depending on which language the customer
selected.
Select "Quick Text Editor" from the Utilities menu or click "Quick Text Editor" in the start
window.
Select a quick text in the "No. Name" list.
Edit the quick text.
Click OK to save the new text or click Cancel to exit without changes.
The edited text is immediately shown at all places where it is used.
Quick text
Quick text
Maximum number of quick texts: 250
Script Command to print a quick text: TEXT(Quick_Text_Number)
Editing a quick text
Quick texts
087.01E Q-MATIC AB 79
Select "Quick Text Editor" from the Utilities menu or click "Quick Text Editor" in the start
window.
.
Increase the Number of Quick Texts by one.
Select the new quick text in the "No. Name" list.
Click Edit name and enter a name. The name is not used to identify the quick text. It only
makes it easier to read the quick text list. Click OK to save the name.
Click in the Edit Quick Text box and enter the new quick text.
Click OK to save the quick text.
Write at least one script program that uses the new quick text.
Open the script program that uses the quick text.
Remove TEXT(Quick_Text_Number) from the script program or change the quick text
number.
Never decrease the number of texts (Number of Texts). There will be an error if you
decrease the number of quick texts but forget to remove it from all script programs where it is
used. It is much better to only remove it from all scripts. It does not matter that there are unused
quick texts in the settings.
Adding a quick text
Removing a quick text
Q-WIN Reference Manual - Vol 1, Basic
80 Q-MATIC AB 087.01E
087.01E Q-MATIC AB 81
8. Customizing web pages
Topics in this chapter
Q-WIN events and Javascript functions ....................................... 82
Load the Q-WIN event Javascript library ...................................... 82
Set up which events to listen to ................................................... 83
Handle Q-Win events ................................................................... 83
Q-WIN Reference Manual - Vol 1, Basic
82 Q-MATIC AB 087.01E
It is possible to customize the web pages in a Q-WIN system. This is a basic requirement for web
pages displayed on printers with touch screens, for example Q-Matic Vision kiosks and Q-Matic
TP3115 printers. Other web pages, for example Management screens and HTML-based
workstations, will also benefit from the following ways of customization.
The web pages in a Q-WIN system can be of several types:
Ordinary web pages.
QSP pages with Q-WIN scripts.
HTML/QSP pages with Javascript functions handling events from Q-WIN.
For information about using Q-WIN scripts in QSP pages, see the Q-WIN Reference Manual vol
2 - Scripts. In this chapter the use of Javascript for Q-WIN event handling will be described.
Example HTML / QSP pages and JavaScript files can be downloaded from the Q-Matic Partner
Portal. It is recommended that these example pages are used as a starting point when customized
pages are created.
The directory for web pages for printers with touch screens on the Q-WIN web server is:
[qwin-install]\Tomcat\webapps\QWIN\touchscreens\
In this directory, create a suitable directory structure for the pages of the printers of the site.
The browser on the printers uses Java and JavaScript for communication with the Q-WIN server.
To modify the content on the web pages based on events from Q-WIN, a set of Javascript
functions is available. All Javascript functions needed are included in the examples, located in
the directory:
[qwin-install]\Tomcat\webapps\QWIN\touchscreens\
There is one example for Vision, and one example for the TP3115. Both examples are basic, but
they include all functionality needed to create more advanced pages. Check for more and
updated example files on the Partner Portal.
The HTML page must load the Q-WIN Event Javascript library to be able to communicate with
Q-WIN.
The following code on an HTML page loads the library:
<script type='text/javascript' src='/js/qevent.js'> </script>
This code should be in the <head> section of the HTML page, before any other Javascript is
loaded.
Q-WIN events and Javascript functions
Load the Q-WIN event Javascript library
087.01E Q-MATIC AB 83
Many different events are sent from Q-WIN. Most of them are not needed by the touch screen
pages. Therefore we list the events we want to listen to. This is done with the function:
qwin_event.waitForEventTrig().
In the supplied example we want to listen to events 5, 6, 8 and 16, and this is set up like this:
qwin_event.waitForEventTrig("5.6.8.16");
This function must be called after the Javascript library has been loaded (in the example this is
done at the end of the file main.js).
The information above explains how to set up the event listening on our page.
Now we also need some functions to be called when an event is received. There is a set of
predefined functions which are called depending on what is happening on the Q-WIN server:
When a regular Q-WIN event is received, the following function is called:
qwin_event.trig = function(eventType, unit, payload) {
// this function is run when an event is received
}
The parameters are:
eventType: This is the event id, (1-21)
unit: This is the unit number, for example the workstation number when calling a customer
payload: This is the result from the event script
The Server Down function is called when the Q-WIN server stops for any reason:
qwin_event.watchdogServerDown = function() {
// this function is run once when the server is down
}
The Server Up function is called when the Q-WIN server starts:
qwin_event.watchdogServerUp = function() {
// this function is run once when the server is up
Set up which events to listen to
Handle Q-Win events
Q-WIN Reference Manual - Vol 1, Basic
84 Q-MATIC AB 087.01E
}
The Server Up/Down functions are controlled by a watchdog. The server is sending a watchdog
signal every 60 seconds. If this watchdog signal is not received within 65 seconds, the
watchdogServerDown function is called; then a check is made every 10 seconds if the server is
up and running, and as soon as the server is up, the function watchdogServerUp is called.
The last predefined function is the watchdog function, which is called every time the server sends
the watchdog signal. In the examples this function is not used, but it is available if someone wants
to use it:
qwin_event.watchdogTrig = function() {
// this function is run for every watchdog trig
}
087.01E Q-MATIC AB 85
9. System configuration
Topics in this chapter
General information about settings............................................... 86
Number of units............................................................................. 86
Number and name......................................................................... 86
ID codes and Sub ID codes............................................................. 87
The system configuration window................................................. 88
Setting levels ................................................................................. 89
Adding a new unit ......................................................................... 90
Removing units.............................................................................. 91
Move a unit to another group ....................................................... 91
Creating a new group.................................................................... 92
Q-WIN Reference Manual - Vol 1, Basic
86 Q-MATIC AB 087.01E
There are default settings for most parts of Q-WIN when Q-WIN is started for the first time but
the system is usually customised.
Here are some general rules about settings.
Many settings have a default number that specify the number of units or settings. Be very careful
before this number is decreased, see Removing units on page 91.
This is an example of a typical setting (in this case the Main display settings). The setting specifies the
number of units and the starting Id code.
All settings have a number and a name. The system uses the unit number to identify the unit,
for example in Q-WIN scripts. Q-WIN automatically assigns the unit numbers and they cannot
be changed.
The unit name is only used to make it easier for a user to identify the unit. The name is assigned
to the unit during the set up but it can be changed in a running system.
This is the unit number and name list from the Main display settings.
The use of good naming principles is important, it is a prerequisite for correct statistics from the
system.
General information about settings
Number of units
Number and name
System configuration
087.01E Q-MATIC AB 87
Naming in a single system
All unit names (Ticket Buttons, Categories, Workstations and the like) must be unique.
Since there is only one set of Ticket Buttons in a Q-WIN system regardless of the number of
printers, all printers use these Ticket Buttons. Each Ticket Button has a unique ID and is treated
as a separate unit from all other Ticket Buttons. Two Ticket Buttons with the same name are not
treated as one and the same Ticket Button.
It is possible to change the assignment of Ticket Buttons to physical buttons with scripts.
Example
You have a service called Information which should be available on both Printer 1 and Printer 2.
If you use Ticket Button 1 in the Q-WIN System for Information for Printer 1, then you also have
to use that Ticket Button for Printer 2 for that service. In this case there is only one Ticket Button
in the Q-WIN System called Information.
Problems will show up with statistics if you use Ticket Button 1 for Information for Printer 1,
and Ticket Button 2 for Information for Printer 2. In this case you have two separate Ticket But-
tons with exactly the same name.
Naming in a multi branch system
If the same unit name is to be used in several branches, then they must be connected to the same
unit id.
Example
You have a service called Information which should be available in both Branch 1 and Branch 2.
If you use Ticket Button 1 as Information in Branch 1, then you also have to use Ticket Button 1
in Branch 2 for the same service.
If you for any reason cannot use the same Ticket Button in both systems, then you should make
the names unique, one method is to add the button number to the name:
If you use Ticket Button 1 for Information in Branch 1, and Ticket Button 3 for Information in
Branch 2, then you could name the Ticket Buttons like this:
Ticket Button 1 in Branch 1: 1. Information
Ticket Button 3 in Branch 2: 3. Information
When using the Management Portal, it is possible to map these two Ticket Buttons to one and
the same service, and thus getting correct statistics.
All hardware units have ID codes. The ID code is the unit's address in the system. It is not
possible to specify the ID code for each unit of the same type. The ID code is specified for the
first unit in the system. Additional units of the same type must have ID codes in sequence with
the first unit or the same ID code but different Sub ID codes. For example, if there are three
ID codes and Sub ID codes
Q-WIN Reference Manual - Vol 1, Basic
88 Q-MATIC AB 087.01E
main displays and the first main display has ID code 81, the two other main displays must have
ID code 82 and 83.
The available ID codes are 1 - 128.
Some units use an additional address, the Sub ID code. The Sub ID code is used together with
the ID code and makes it possible to have more than 128 units in a Q-WIN system.
Each unit type has a default start ID code. This ID code can usually be changed; please refer to
the unit's reference documentation or settings chapter in this manual for more information.
Only change the default ID codes if it is absolutely necessary. Using the default ID codes
makes it much easier to support the system and reduces the risk for problems.
Always have the workstations in the beginning of the ID codes sequence (1-).
Two units of different types must never share the same ID code. There is one exception, the
workstation terminals and the workstation displays share the same ID codes but they have
different Sub ID codes.
Two units of the same type that send information to the server, for example workstation
terminals, must never have the same ID code. It would be impossible for the server to
identify the unit that sent the information.
Two units that only receive information, for example displays, can share the same ID code.
These units will work in exactly the same way. The system does not recognise them as
separate units.
These are the default ID codes:
1-64 Work Stations
65-90 Information Displays
81-88 Main Displays
89-96 Ticket Printers
120 Supervisor Terminal, Card Reader
121 Video Interface, Multi Interface
124 Alarm Display
125 Voice Unit
The system configuration window is used to edit all server settings in the Q-WIN system. The
system configuration window consists of a list of settable items, for example Displays and
Printers. The settings for an item are usually divided into several levels and units.
The system configuration window
System configuration
087.01E Q-MATIC AB 89
Selecting an item in the list, opens a tree of levels for the item and selecting a level opens a
settings form for the units of that item at that level.
Click an item, for example Displays, in the list to open the levels tree for the item. Use the levels
tree to select setting level. For some level trees, there are buttons below the tree. These buttons
are used to add, remove or move units in the levels tree.
Use the settings form to make changes to selected settings. Click Save to save any changes. Q-
WIN gives a warning if you try to close the form or open another form without saving the
changes.
Click a setting's name in the form to display the corresponding help text.
There are usually several levels in the levels tree. A setting at one level affects all its sub-levels.
Three levels of settings are found in many items:
General settings
Setting levels
Q-WIN Reference Manual - Vol 1, Basic
90 Q-MATIC AB 087.01E
Group settings
Unit settings
General settings
General settings are settings that apply to all units of the same type. General settings are, for
example, the number of units and the starting ID code.
Group settings
These are the settings for the units. Some units share the same settings, for example when all
workstation terminals in the system are supposed to work in the same way. These units are
placed in the same settings group. All units in a settings group are going to work in the same way
but they still have their unique identity.
Unit settings
These are the settings for each unit. Units that are included in a settings group (see above) do
not have many unit related settings, usually only the name.
There are two ways to add units: increase the number of units and the Add button.
The number of units is always in the general settings. New units are always placed in the first
group if there is a group level in the settings tree and the new unit is added from the general level.
1. Select the general settings.
2. Increase the number of units or click Add.
New units are added to the settings tree.
3. Select the new unit.
4. Type the name of the unit.
5. Click Save.
It is also possible to first select a group and then add a new unit to that group.
1. Select a group in the settings tree.
2. Click Add. A new unit is added to the group.
Adding a new unit
System configuration
087.01E Q-MATIC AB 91
3. Open the settings for the new unit and type a name.
4. Click Save.
There are two ways to remove units: decrease the number of units in the general settings or use
the Remove button.
1. Select the group setting in the settings tree.
2. Click Remove or decrease the number of units in the group settings.
3. The latest added units are removed from the settings.
4. Click Save.
It is always the latest added unit that is deleted. It is not possible to select a unit and then
use Remove to remove that particular unit.
Make sure that removed unit numbers are not used in other system settings or in script
programs.
We strongly recommend against removing unused units (Buttons, Categories, Workstations and
the like) from the default Q-WIN System setup. Having units in the system that are not used
does not degrade performance in any practical way.
Example 1, Buttons and Categories
Buttons are connected to Categories, and both Buttons and Categories are connected to
Priorities. If you remove a Category, then you must remove all Buttons connected to this
Category, and also remove all Priorities using these Categories and/or Buttons.
Example 2, Main Display
In the standard setup, all Categories are represented on a Main Display. If a Main Display is
removed from the system, this may have the effect that one or more Categories are no longer
represented on a Main Display. The result will be that some customers will not be callable.
The solution is to make sure that all Categories are represented on one or more Main Displays.
A display can be internal to Q-WIN, not connected to a physical display.
To move a unit:
1. Select a unit from the tree.
2. Select a group from the drop-down list.
Removing units
Move a unit to another group
Q-WIN Reference Manual - Vol 1, Basic
92 Q-MATIC AB 087.01E
3. Click Move.
The unit is moved to the selected group.
To create a new group:
1. Select a unit.
2. Select New from the drop-down list.
3. Click Move to. The selected unit is moved to the new group.
4. Select the new group.
5. Edit the group settings.
Creating a new group
087.01E Q-MATIC AB 93
10. Alarm
Topics in this chapter
Alarms in Q-WIN............................................................................ 94
General alarm settings................................................................... 94
Messages from workstations......................................................... 96
Automatic alarms .......................................................................... 97
Alarms from workstations ............................................................. 98
Alarms to workstations.................................................................. 98
Q-WIN Reference Manual - Vol 1, Basic
94 Q-MATIC AB 087.01E
Alarms in Q-WIN are used to inform staff or management when something important happens
in the system.
There are two types of alarms: automatically generated and manually generated. The manually
generated alarms are alarms from workstations and alarms to workstations.
At least one alarm must be specified in the alarm settings to be able to generate any of the
alarm types.
Never use Q-WIN or any part of the Q-WIN system for alarms that are vital for people's
health. Q-WIN alarms are supposed to inform staff members when something important
happens in the system, such as too many customers are waiting and new workstations must be
opened.
Automatically generated alarms and alarms from workstations are always displayed on all Q-
WIN clients. Alarms from workstations are displayed on all KT2595 and KT2695 terminals.
Alarms sent to workstations are shown on the KT2595 or KT2695 terminal display.
An alarm window is opened on the Q-WIN clients. The alarm window shows the alarm number
and the alarm text. Click OK to close the alarm widow.
There are two script functions associated with the alarms. ALARM_NUMBER returns the alarm
number and ALARM_TEXT returns the alarm text.
The general alarm settings are usually used when alarms are displayed on displays. The settings
specify how the alarm number and the alarm text are made available for the ALARM_NUMBER
and ALARM_TEXT script functions.
Alarms in Q-WIN
General alarm settings
Alarm
087.01E Q-MATIC AB 95
Select "Alarms" in the System configuration window.
Number of Alarm types
This setting specifies the number of different automatic alarms.
Update of Alarm
This is the time, in seconds, between each update of the information sent to the alarm script
functions. This setting is usually not used. The alarm information is always updated when there
is a new alarm.
Max: 1000 seconds
Min: 0 (only update information when there is a new alarm)
New alarms
These settings specify the way new alarms are handled.
Min. time, new alarm is active
This is the shortest time new alarms are available for ALARM_NUMBER and ALARM_TEXT.
The setting is used when alarms are displayed, for example, on displays. The setting makes it
possible for the readers to see every alarm when many alarms occur at the same time. Each new
alarm is displayed this time before the next new alarm is displayed.
Max: 60 seconds
Min: 0 seconds
Max time, new alarm is active
ALARM_NUMBER and ALARM_TEXT cycles through the old alarms when there are no new
alarms. This setting specifies the time an alarm is considered as a new alarm.
Max: 1000 seconds
Min: 0 seconds
Q-WIN Reference Manual - Vol 1, Basic
96 Q-MATIC AB 087.01E
Maximum number of queued alarms
This is the maximum number of new alarms that can be queued.
Max: 100
Min: 0
Alternating old Alarms as Alarm Info
These settings handle the old alarms. The "Max Time, new alarm is active as alarm Info" setting
(see above) specifies the time an alarm is considered as a new alarm. The ALARM_NUMBER
and ALARM_TEXT functions start to cycle through the old alarms when there are new alarms.
These settings specify the way Q-WIN handles the old alarms.
Number of old alarms alternating
This setting specifies the number of old alarms that can be stored. The oldest alarm will be
deleted when the limit is reached.
Max: 100
Min: 0
Alternating time between old alarms
This is the time, in seconds, an old alarm is available for the ALARM_NUMBER and
ALARM_TEXT functions.
Max: 1000 seconds
Min: 0 seconds
Maximum Time an old Alarm can be alternating
This is the maximum time, in minutes, an old alarm is included in the cycling of old alarms.
Max: 1000 minutes
Min: 0 minutes
Messages are sent with FUNC_MESSAGE. They are used to send a message from one
workstation to another. The message must be a number. The "Message alarms" settings specify
the valid message values.
Messages are used together with the KT2595 workstation terminal.
Messages from workstations
Alarm
087.01E Q-MATIC AB 97
Minimum Message No.
This is the minimum value allowed for a message from a workstation.
Max: 1000
Min: 0
Maximum message No.
This is the maximum value allowed for a message from a workstation (FUNC_MESSAGE).
Max: 1000
Min: 0
Automatic alarms are automatically sent from the Q-WIN server to all Q-WIN clients. The
result of a script program and the alarm type settings specify when an alarm is sent.
General settings - Number of alarm types
This setting specifies the number of different automatic alarms.
Edit Alarm Settings
These are the settings for the alarm type. The settings specify when an alarm is sent.
Name
This is the name of the alarm setting.
Alarm number
This is the value assigned to ALARM_NUMBER.
Voice Unit
It is possible to play a voice message when an alarm occurs. The setting must be a valid Voice
Interface setting.
Automatic alarms
Q-WIN Reference Manual - Vol 1, Basic
98 Q-MATIC AB 087.01E
Trigging
These settings specify when the Q-WIN server sends an alarm. The alarm is based on the result
returned by the script program (Criteria for alarm).
The result of the script program is compared with Min. value and Max. value. There are two
ways to compare the values.
Trigg this alarm when the result value is less or equal to Min
The result of the script program is compared with Min. value. An alarm is issued if the result
of the script is equal to or less than Min. value. The result of the script must rise to a value
above Max. value before the server can issue this alarm again.
Trigg this alarm when the result value is greater or equal to Max
The result of the script program is compared with Max. value. An alarm is issued if the result
of the script is equal to or grater than Max. value. The result of the script must drop to a value
below Min. value before the server can issue this alarm again.
Alarms are sent with FUNC_ALARM and they are shown on all Q-WIN clients and on the
display of the KT2595/KT2695 workstation terminals. They are used when a workstation wants
attention, for example there are too many customers or a technical problem.
Never use Q-WIN or any part of the Q-WIN system for alarms that are vital for people's
health. Q-WIN alarms are supposed to inform staff members when something important
happens in the system, such as too many customers are waiting and new workstations must be
opened.
These alarms are sent from a Q-WIN client to a KT2595/KT2695 workstation terminal. The
alarm is a number that will be displayed on the workstation terminal display. The alarm also
activates the buzzer in the workstation terminal.
The alarms to workstations are only available from the Q-WIN client.
Alarms from workstations
Alarms to workstations
Alarm
087.01E Q-MATIC AB 99
Sending an alarm
Select "Alarm to Workstation" from the Utilities menu.
Enter at "Alarm No. to show at Workstation terminal display" the number that will be
displayed on the workstation terminal display. The number is always shown as a four-digit
number.
Select a workstation terminal from the "Workstation" list.
Click Send Alarm.
Q-WIN Reference Manual - Vol 1, Basic
100 Q-MATIC AB 087.01E
087.01E Q-MATIC AB 101
11. Card readers
Topics in this chapter
Card readers in Q-WIN systems ................................................... 102
Card validation ............................................................................ 102
General card validation settings .................................................. 102
Card settings................................................................................ 103
Locking a card to a ticket button................................................. 104
Changing the card data before validation against database ....... 106
Additional settings in the ticket printer settings .......................... 106
Card reader units ......................................................................... 107
General card reader settings........................................................ 108
Card reader group settings .......................................................... 108
Card unit settings ........................................................................ 109
Q-WIN Reference Manual - Vol 1, Basic
102 Q-MATIC AB 087.01E
A card reader used together with a customer database makes it possible to identify the customer.
This makes it possible to give the customer a personal service. The staff member can have the
correct information available when the customer arrives. Identifying the customer makes it also
possible to check the customer's identity.
Q-WIN handles all types of cards in the same way, no matter if it is bar code, magnetic or smart
card.
An organisation that issues customer cards does not usually accept cards issued by other
organisations. These settings are used to validate the card type. This makes it possible for the
system to reject invalid card types before a search is started for the customer in the database.
Select "Card validation" in the System configuration window.
Number of card types
The number of valid card types.
Debug
Set the Debug check mark to open a window with the card data when a card is used. The card
data can be used to check that the system reads correct information from the card.
Card readers in Q-WIN systems
Card validation
Card validation
Number of card types. Minimum value: 0, Maximum value: 255.
Start validation: Minimum value: 0, Maximum value: 255.
Stop validation: Minimum value: 0, Maximum value: 255.
General card validation settings
Card readers
087.01E Q-MATIC AB 103
The debug window is opened on the Q-WIN server. A Q-WIN client or a web browser
cannot display this information.
Name
This is the name of the setting.
Start validation
The first digit that should be used for card validation.
Stop validation
The last digit that should be used to validate the card.
Example: Digit #2 is specified as start digit and #5 as stop digit. A card with the following card
number is used: 12345678. Digits 2345 are used to validate the card.
All cards will be of valid type if both the start and the stop values are 0.
Validation data
The number that identifies a valid card.
Card settings
Q-WIN Reference Manual - Vol 1, Basic
104 Q-MATIC AB 087.01E
Example
If the card we used above was a valid card then "2345" must be specified in Validation data.
Track to use for validation
The track used for validation.
Bankcards usually use track 2.
Locked to ticket button
Lock the card reader to a ticket button to automatically print tickets when cards are used.
Card data program
Script executed before the data is validated against the database.
Search the Customer Register for info.
Set this check mark to search for customer information in the database. The information from
the database is assigned to the ITEM_CUSTINFO_ item types. These can be used in
CUSTOMER_ITEM_STR script functions.
Card's data must be valid
The card is only valid if Q-WIN finds the card number in the database.
Lock the card reader to a ticket button to automatically print tickets when cards are used. The
card is validated before any ticket is printed.
This is only possible when the card reader is connected to a ticket printer.
There are two possibilities; both are described here.
Card Validation
Use the card validation settings to specify the ticket button.
Open the card validation.
Select Card Validation and a card type.
Select a ticket button from the "Locked to ticket button" list.
Locking a card to a ticket button
Card readers
087.01E Q-MATIC AB 105
Click Save.
Ticket printer settings
Use the ticket printer settings to specify the ticket button.
Select "Printers".
Select the ticket printer group to which the ticket printer belongs.
A ticket printer must be selected in the Card reader settings when a Card Reader
Interface is used.
Go to the Card reader section of the setting.
Enter a script program at "Approved card". The result of the script is used as the ticket button
number. This script program overrides the ticket button selection made in the Card
validation settings. The result of the script must be a valid ticket button number.
Ticket printer settings
You must change one setting in the Ticket printer settings to automatically print tickets when
cards are used.
Select "Ticket Printer".
Select the ticket printer group to which the ticket printer belongs.
Set "Button available time" to 0.
Q-WIN Reference Manual - Vol 1, Basic
106 Q-MATIC AB 087.01E
Click Save.
It is possible to change in the card data before it is validated against the database.
Enter a script program at "Card data program. Select the same track that is used for the
validation.
The script is executed before the validation. The result of the script is used as validation data
against the database.
Some of the settings related to cards are available in the ticket printer settings. Select "Printer".
Select the ticket printer group to which the ticket printer belongs.
Card reader LED
This setting specifies the time the LEDs on the card reader are lit when a card is inserted.
Maximum value: 1000.
Minimum value: 1.
Changing the card data before validation against database
Additional settings in the ticket printer settings
Card readers
087.01E Q-MATIC AB 107
Track
The track used at the card. This selection overrides the selection made in the Card validation
settings.
Button available time
The customer must select a ticket button within this time after a card has been used. Set this
value to 0 to automatically print a ticket when a card is used.
Card reset
Mark the check box to remove the card data after the ticket has been printed. If the data is not
removed then it will be available until the next card is inserted.
This can be necessary if the card data is used in a script program. Use
FUNC_PRINTER_RESET_CARD() in the script program to remove the card data.
Approved card
This script program specifies the ticket button number when a valid card is used. The result of
the script must be a valid ticket button number.
Unauthorized card
The script program is executed when an invalid card is used. The result of the script program
specifies a ticket text and prints a ticket. This ticket text should be an information ticket that
informs the customer that an invalid card has been used.
The card reader unit is an interface between the card reader and the Q-WIN system. Please read
the documentation for the card reader interface for more information.
Card reader units
Card reader interface
Maximum number of card reader interfaces: 15
Default ID code: 120
Default Sub ID code: 1, maximum value: 15
Q-WIN Reference Manual - Vol 1, Basic
108 Q-MATIC AB 087.01E
Select "Card readers" in the System configuration window.
Number of card readers
The number of card reader interfaces in the system.
ID code
The ID code for the card reader interfaces. All card reader interfaces uses the same ID code. The
Sub ID code identifies each card reader interface.
Starting sub ID
The starting Sub ID code. This is the Sub ID code for the first card reader interface in the system.
This is usually 1.
Connected to printer
There are two ways to use card readers. They can be used as independent units or connected to
ticket printers. The card reader interface must be connected to a ticket printer to automatically
print tickets when cards are used.
Use the drop-down list to select a ticket printer. Select "None" when the card reader is not
connected to any ticket printer.
General card reader settings
Card reader group settings
Card readers
087.01E Q-MATIC AB 109
LED time
The time the LEDs should be lit on the card reader when a card is inserted.
Card reader scripts
The scripts in the card reader settings are executed when the card reader is not connected to any
ticket printer.
Card accepted script
This script is executed when a valid card is used. The result of the script can result in three
different actions.
The result is a valid ticket button number
A ticket number is added to the ticket button queue but no ticket is printed.
The script program does not return any value or there is no script program
Use the ticket button specified in the card validation settings and add a ticket number to the
ticket button queue.
The script returns 0
No action, no new ticket number.
Card rejected script
This script program is executed when the card is invalid. The action must be specified in the
script program. The result of the script is not used.
Name
This is the name of the card unit.
Card unit settings
Q-WIN Reference Manual - Vol 1, Basic
110 Q-MATIC AB 087.01E
087.01E Q-MATIC AB 111
12. Category and ticket button
Topics in this chapter
The difference between ticket buttons and categories ......112
Categories .........................................................................113
General category settings ..................................................113
Category settings...............................................................114
Tickets per time period ......................................................115
Estimated waiting time in categories or ticket buttons......116
Ticket buttons....................................................................118
General ticket button settings ...........................................118
Button group settings ........................................................119
Ticket button settings ........................................................121
Q-WIN Reference Manual - Vol 1, Basic
112 Q-MATIC AB 087.01E
It can be difficult to know the difference between ticket buttons and categories. They are
sometimes used in a very similar way. It is very important to know the difference if you want to
design an efficient system.
Ticket buttons are the different services that the customer can choose. They are usually physical
buttons on the ticket printer but they can be on a management screen or software buttons used
in script programs.
Categories are the different ticket number series in the system. A category can contain more than
one ticket button. All ticket buttons within a category share the same ticket number sequence.
A ticket button can never belong to more than one category.
The difference is not important if the system has one ticket button in each category and ticket
button 1 belongs to category 1, ticket button 2 to category 2, etc.
Let us take a closer look at what happens when a customer arrives and selects a service.
The customer arrives and presses one of the ticket buttons to select a service.
The system uses the ticket button settings to place the ticket button into one of the
categories.
The category specifies the ticket number.
The ticket button is connected to a ticket text.
The ticket text gets the ticket number from the category and prints the ticket.
The difference between ticket buttons and categories
Ticket button 2
Ticket button 1 Category 1
Ticket button 2 Category 1
Ticket button 3 Category 2
Ticket button settings
Category 1
Category 2
Ticket number
1-199
Ticket number
200-299
Customer presses ticket
button 2
Category 1
Category settings
Ticket button 1 Ticket text 1
Ticket button 2 Ticket text 1
Ticket button 3 Ticket text 2
Ticket button settings
126
Button 2
Ticket text 1
Category and ticket button
087.01E Q-MATIC AB 113
Select "Categories" in the System configuration window.
Number of categories
The number of categories.
Do not decrease the number of categories even if not all are used. There is a risk that the
categories are used somewhere within Q-WIN and that there is an error if they are removed.
There are no problems to have unused categories.
Category letters
Category letters can be used to indicate that a ticket number belongs to a certain category. The
category letter can be printed on the ticket and shown on the displays. You do not have to enter
anything if you want to use the English alphabet as category letters. If you do not want to use
the default letters then you must enter the letters you want to use. Enter the letters without any
separation, for example EKLFB. The first of the letters will be assigned to category 1, the second
to category 2, etc.
Categories
Categories
Maximum number of categories: 255
Default number of categories: 8
Minimum value for ticket number: 0
Maximum value for ticket number: 9999
General category settings
Q-WIN Reference Manual - Vol 1, Basic
114 Q-MATIC AB 087.01E
Name
The name of the category.
Start number
The first ticket number in the ticket number sequence. Each category has its own ticket number
sequence. It is possible for two ticket number sequences to use the same ticket numbers but we
recommend that each category use unique ticket numbers. The category letter makes it possible
to identify a ticket number when many categories have the same ticket number sequences.
The ticket number will restart with the first number in the sequence when it has reached the last
ticket number.
End number
The last ticket number in the ticket number sequence.
Category settings
Category and ticket button
087.01E Q-MATIC AB 115
Max waiting customers
The maximum number of customers that are allowed to wait. Additional customers get an
information ticket instead of an ordinary ticket. The ticket text number for the information
ticket is specified in the ticket button settings.
Default value: 300
Maximum value: 9999
Max tickets per time period
This is the maximum number of tickets that can be assigned to a period, see the next section.
Period length
The length of one time period, see the next section.
Do not allow the same ticket number twice
The number of ticket numbers in a sequence depends on the settings. It is possible that the same
ticket number appears twice if there are few numbers in the ticket number sequence and if there
are long waiting times. The system can identify them as two different customers but it can be
very confusing when one of the numbers is called to a workstation.
You avoid this confusion if you set this check mark. The same ticket number is not allowed.
Copy notes
It is possible to add a note to a customer (for example in the Q-MATIC Client Terminal). This
note is normally deleted when a customer is transferred to another category. Set this setting to
keep the note even when the customer is transferred.
It is possible to specify a maximum number of tickets per period. The period length is also
specified in the category settings.
Max tickets per time period
This is the maximum number of tickets that can be assigned to a period. This setting is used
together with FUNC_TICKET_MAKE_APPOINT and makes it possible to book a visit time for
a ticket number. The ticket number cannot be called before the correct time period.
Max: 1000
Min: 0
Period length
The length of one time period.
Max: 12:00:00
Min: 00:01:00
Tickets per time period
Q-WIN Reference Manual - Vol 1, Basic
116 Q-MATIC AB 087.01E
Example
A doctor needs ten minutes for each patient. The day is divided into ten-minutes time periods.
One patient can be served in each time period. A ticket number is reserved for each time period.
When a patient phones the reception, he or she is assigned a specific time on the day. When the
patient arrives at the reception the receptionist enters the time that was assigned for the patient
at the workstation terminal. The ticket printer prints a ticket with the ticket number reserved
for that time period. The patient cannot be called before the time assigned to the ticket number.
In this example "Max number of Tickets per Time Period" is 1 (one patient per time period) and
"Length of Time Period" 00:10:00 (ten minutes are reserved for each patient).
These settings specify the estimated waiting time. The same calculation is used for both
categories and buttons.
The estimated waiting time is the calculated waiting time for a new customer. It is, for example,
printed on the ticket to help the customer to plan the waiting time. This makes it possible for
the customers to do other errands while they are waiting.
The real waiting time is the waiting time for the next customer to be called.
A calculated waiting time can never be completely accurate. The best result is when there is a
constant customer flow and unchanged number of open workstations. For example, to open or
close workstations at the same time as there are waiting customers result in real waiting times
that are different from the estimated waiting times.
Q-WIN uses the average time between the latest calls within the category to calculate the
estimated waiting time. The ESTW_LEN setting in the qsys.ini file specifies the maximum
number of calls that are stored for the calculations. The ESTW_BUNCH setting specifies the
maximum number of calls per workstation that are used.
The estimated waiting time settings make it possible to include a constant time and the real
waiting time in the calculation of the estimated waiting time.
The storage of times is reset if there are no waiting customers. This will prevent old information
from being included in the calculations. The real waiting time is included in the calculation of
the estimated waiting time when there are less than five stored waiting times (that is when the
number of served customers is less than seven, the first time is saved when the second customer
is called). The table below shows the percentage of the estimated waiting time (ESTW) and the
Estimated waiting time in categories or ticket buttons
Category and ticket button
087.01E Q-MATIC AB 117
real waiting time (RWT) used as the estimated waiting time when the first eight customers are
called. Note! This will restart each time the waiting time is 0:00.
*There is no waiting time when the first customer is called. There is no ESTW until the second
customer is called.
This is the calculation for the estimated waiting time when customer 3 has been called.
(((T2-T1) + ( T3-T2))*0.2/2) + (RWT*0.8)
The real waiting time is the waiting time for the customer that has been waiting the longest time
in the category.
The waiting time printed on the ticket is the estimated waiting time multiplied by the number
of waiting customers.
Use weighted average
Weighted estimated waiting time makes the latest time the most important one. Trends will
affect the weighted estimated waiting time more than the ordinary estimated waiting time.
Percentage of estimated waiting time, Percentage of real waiting Time, Percentage of fixed value
Three values can be used to calculate the estimated waiting time used for the tickets. They are
the estimated waiting time (as described above), the real waiting time and a fixed time. Specify
the percentage of each value that should be included in the estimated waiting time used on the
ticket. Enter 100 at "Percentage of ESTW to be included" and 0 at the others if only the
estimated waiting time should be used.
The fixed time is specified below.
Example. We want to use 50% of the estimated waiting time (ESTW), 30% of the real waiting
time (RWT) and 20% of the Fixed Value (FV). Enter 50, 30 and 20. The Estimated Waiting time
used for the tickets will be (0.5*ESWT*number of waiting customers)+(0.3*RWT)+(0.2*FV).
Fixed Value
The fixed value used in the calculation above.
Cus-
tomer
#
ESTW
(%)
RWT
(%)
Time when
customer
was called
Time
stored
1* 0 0 T1 -
2* 0 0 T2 T2-T1
3 0 100 T3 T3-T2
4 20 80 T4 T4-T3
5 40 60 T5 T5-T4
6 60 40 T6 T6-T5
7 80 20 T7 T7-T6
8 100 0 T8 T8-T7
Q-WIN Reference Manual - Vol 1, Basic
118 Q-MATIC AB 087.01E
Exclude long waiting times
Exclude waiting times that are longer than the specified value. This makes it possible to exclude
faulty waiting times. You can, for example, get a faulty waiting time if you take a test ticket in
the morning to check the system. This ticket is not called until you open the office, which results
in an extremely long waiting time. Use this option to exclude the waiting time from the
calculation of the estimated waiting time.
Number of ticket buttons
The number of ticket buttons.
Be careful if you decrease the number of ticket buttons. Make sure that the ticket buttons
you are going to remove are not used in any other settings or script programs. We recommend
that you do not remove unused ticket buttons.
A ticket button is not necessarily a physical ticket button on a ticket printer. It is possible
to specify ticket buttons that are used in management screens, script programs or internally in
Q-WIN.
Button letters
Ticket button letters can be used to indicate that a ticket number belongs to a certain ticket
button. The ticket button letter can be displayed on tickets and displays. You do not have to
enter anything to use the letters in alphabetic order (button 1 = A, button 2 = B, etc.). Enter the
letters without any space to specify ticket button letters, for example EKLBF. The first of the
letters will be assigned to ticket button 1, the second to ticket button 2, etc.
Ticket buttons
Ticket button
Maximum number of ticket buttons: 255
General ticket button settings
Category and ticket button
087.01E Q-MATIC AB 119
Walk time
This setting is used if the ticket printer is not placed in the waiting area. The entered time
prevents workstations from calling a customer before the customer has arrived to the waiting
area. The entered time must elapse before a workstation can call the customer.
Max: 17 hours.
Min: 0
Time for transfer
This setting is used together with the category transfer. The ticket numbers are automatically
transferred when the waiting time reaches this level. See Transfer, page 251.
Button locked to Work Station
Lock the Ticket Button to a Workstation. A customer that uses a locked Ticket Button can only
be served at that particular Workstation. The Select a Person Choice Customer Priority statement
must be used to be able to lock a Ticket Button to the Workstation.
Button group settings
Q-WIN Reference Manual - Vol 1, Basic
120 Q-MATIC AB 087.01E
Transfer to this button
This setting is used together with the category transfer. The ticket numbers are transferred to
this ticket button queue. See Transfer on page 251.
Start ticket number
This setting is used together with Q-MATIC Calendar. This setting specifies the first number in
the ticket number sequence.
End ticket number
This setting is used together with Q-MATIC Calendar. This setting specifies the last number in
the ticket number sequence.
Error ticket
In the category settings it is possible to specify the maximum number of waiting customers.
Additional customers that arrive get an information ticket. This setting specifies the ticket text
number for the Information ticket. Default value is 99. The entered value must be a valid ticket
text number.
Voice played when button is pressed
This message is sent when a customer presses the ticket button. For example, here you call the
voice setting that plays "Your ticket number is xxx.".
Voice played when too many waiting
In the category settings it is possible to specify the maximum number of waiting customers. This
message is sent when more customers arrive.
Optional button program
The result of the script is used as category number. The result of the script overrides the category
selected in the ticket button settings.
Optional customer ID program
This script program assigns a text to ITEM_ID. Use a CUSTOMER_ITEM_STR( x ITEM_ID)
script command to retrieve the text.
Estimated waiting time
The calculation of the estimated waiting time for buttons is the same as for categories, see
Estimated waiting time in categories or ticket buttons, page 116.
Category and ticket button
087.01E Q-MATIC AB 121
Button name
This is the name of the ticket button.
Ticket text
Choose a ticket text for the ticket button. The different Ticket Printers (BP2800 and TP3100
families respectively) have different example tickets. They are labelled (BP) and (TP)
respectively.
Category
Place the ticket button in a category. The category specifies the ticket number sequence. All
ticket buttons in the same category will share the same ticket number sequence. Select a category
number.
Ticket button settings
Q-WIN Reference Manual - Vol 1, Basic
122 Q-MATIC AB 087.01E
087.01E Q-MATIC AB 123
13. Database
Topics in this chapter
Database settings ........................................................................ 124
Backup settings ........................................................................... 125
Q-WIN Reference Manual - Vol 1, Basic
124 Q-MATIC AB 087.01E
Select "Database" in the System configuration window.
DSN
This is the data source name in the ODBC settings.
User name
Some databases require a user name.
Password
Some databases require a password.
Timeout
This is the time, in seconds, Q-WIN tries to connect to the database.
Query timeout
This is the maximum number of times Q-WIN will try to get in contact with a database.
Max rows
This is the maximum number of entries Q-WIN will read from the database when a drop down
list is used. This will prevent extremely long waiting times for large databases.
Compact time
Deleted records may result in empty entries in the Microsoft Access database. These empty lines
make the file much larger than necessary. These empty entries are removed when the file is
compacted. The compact time setting specifies the time for the compact action. Use Q-WIN
two-second units to specify the time. The compact action will be performed once within thirty
minutes from the specified time.
Database settings
Database
087.01E Q-MATIC AB 125
Keep picture
This is the maximum time customer pictures are stored in the database. Pictures older than this
date are automatically deleted. Set to 0 to disable the setting.
Q-WIN can automatically make a backup of the database. All new records are copied to the
backup. It is also possible to delete old information from the backup. The backup database is
compacted when the backup is finished. The backup section of the database settings contains all
settings for the backup.
Backup time
Backup time specifies the time, in two-second units, for the backup. The backup will be
performed once within thirty minutes from the start time. Set to 0 to disable the automatic
backup.
Backup User
Some databases require a user name.
Password
Some databases require a password.
DSN
DSN is the database name in the ODBC settings.
Automatic deletion
Automatic deletion is the time a record should be stored in the database. Set to 0 to disable the
automatic deletion of old records.
Backup settings
Q-WIN Reference Manual - Vol 1, Basic
126 Q-MATIC AB 087.01E
087.01E Q-MATIC AB 127
14. Displays
Topics in this chapter
Display types................................................................................ 128
Main display ................................................................................ 128
General main display settings...................................................... 129
Main display settings................................................................... 130
Programming main displays ........................................................ 133
Program example, two 1664 Displays as one main display ......... 134
Information displays .................................................................... 138
General information display settings ........................................... 138
Information display settings ........................................................ 139
Fonts............................................................................................ 140
Designing a new font................................................................... 141
Different fonts to different displays ............................................. 142
Introduction to programming ...................................................... 142
Simple display commands............................................................ 145
Advanced programming .............................................................. 152
Advanced programming commands ............................................ 159
911 and 917 ................................................................................ 163
Complex languages ..................................................................... 165
Troubleshooting........................................................................... 167
Examples ..................................................................................... 167
General font settings ................................................................... 170
Font settings................................................................................ 171
Q-WIN Reference Manual - Vol 1, Basic
128 Q-MATIC AB 087.01E
Displays are an important part of the Q-WIN system. They present information for both
customers and staff members. Displays can be used in all Q-WIN systems.
A system can contain many different displays. In Q-WIN there are three types of displays.
Information display
This is a display that can show any type of information. It is continually updated. The
information can be anything from the number of waiting customers to advertisements.
Main display
The main display informs the customers when a new ticket number is called. Usually it also
guides the customer to the workstation. The information is updated when a workstation calls a
customer.
Workstation display
The workstation display is always placed at the workstation. It helps the customer to find the
workstation. It usually shows the latest called ticket number. The information is updated when
the workstation calls a customer. Workstation displays are parts of the workstation settings and
are described in the workstation chapter.
The main display informs the customers when a new ticket number is called. They should be
placed so that they are clearly visible for all waiting customers. The main display usually shows
the ticket number, the workstation number and the direction to the workstation.
Q-WIN contains script templates for the most common types of main displays.
Display types
Main display
Main display
Default ID Code: 81
Maximum number of main display settings: 99
Default number of main display settings: 8
Minimum value of ticket numbers handled simultaneously by the display: 2
Maximum value of ticket numbers handled simultaneously by the display: 255
Displays
087.01E Q-MATIC AB 129
Select "Displays" in the System configuration window and then Main displays general in the
tree.
Number of settings
The number of main display settings. This is not the same as the number of main displays. A
system can contain many main displays with the same ID code showing the same information.
These displays are counted as one main display setting.
It is not necessary to have a physical main display for each setting. It can be very useful with
a main display setting that is used internally by Q-WIN. For example, use it to show the same
type of information on a management screen. Use the main display setting to get information to
the script program used by the management screen.
We recommend that you do not decrease the number of displays even if you do not have
eight types of main displays. Unused main display settings do not cause any problems.
A category must be included in a main display setting to work properly.
Starting ID code
The ID code for main display number 1.
Queued calls
This setting specifies the number of ticket numbers that are stored in the main display if they are
called at the same time. This setting is usually not changed.
General main display settings
Q-WIN Reference Manual - Vol 1, Basic
130 Q-MATIC AB 087.01E
Voice
The voice message played when a customer is called. The entered value must be a valid voice
interface setting.
Auto turn off
The system turns off the display if it is inactive longer than the specified time in minutes.
Max: 1400 minutes
Min: 0 minutes
Update (sec.)
This is the time, in seconds, between each update of the display if no customers are called. The
displays are always updated when customers are called.
Max: 1000 seconds
Min: 0 seconds
Main display settings
Displays
087.01E Q-MATIC AB 131
Minimum time for ticket number
It is very important that the customers always have time to read their ticket numbers even if
many workstations call customers at the same time. This is the minimum time in seconds a ticket
number is shown on the main display. Other ticket numbers that arrive during this time are
stored and displayed after the current ticket number.
Max: 60 seconds
Min: 0 seconds
You can reduce this time if the main display setting is only used internally by Q-WIN.
Time before alternating
This setting is used if a main display shows ticket numbers from many categories. It specifies the
number of seconds that the latest ticket number is shown. After that time the display starts to
cycle the latest ticket number in all categories specified for the display. This makes it possible for
the customers to see the currently served ticket numbers for all categories.
Max: 1000 seconds
Min: 0 seconds
Display time
This setting specifies the time in seconds that each ticket number is shown when the display
cycles through the latest called ticket numbers (see previous setting). This setting is ignored if
the display shows ticket numbers from only one category.
Max: 1000 seconds
Min: 0 seconds
Time number is displayed
This setting specifies the maximum time in minutes a ticket number stays in the cycle described
above (Time delay before alternating between Categories).
Max: 1000 minutes
Min: 0 minutes
Time for arrow
This setting specifies the time the arrow is displayed. Most main displays have an arrow that
guides the customers to the workstations. Use the DISPLAY_ARROW_FLASH script function
to control the arrow in the scripts.
Max: 1000 seconds
Min: 0 seconds
Flash time
It is possible to flash all information on the main display. This makes it easier for the customers
to observe that the information has been changed. Use DISPLAY_FLASH in scripts to check if
the display should flash.
Max: 1000 seconds
Q-WIN Reference Manual - Vol 1, Basic
132 Q-MATIC AB 087.01E
Min: 0 seconds (no flash)
Use button letters
Ticket button letter and category letter are letters placed in front of the ticket number to indicate
the ticket button or the category. Set this check mark to use ticket button letters instead of
category letters.
Use enter button
The ticket button letter or category letter is usually changed when a ticket number is transferred
from one ticket button queue into another one. This setting makes it possible to prevent the
change and keep the original ticket button letter or category letter.
Included categories
The categories that are going to be shown on the display. A main display can show ticket
numbers from many categories. The number of categories that you can show on the same main
display depends on the number of customers. It must be possible to show every called ticket
number on the main display long enough for the customers to read it.
Enter a single category (for example 2), multiple categories separated by commas (2,5,7), a
sequence of categories (2-5) or a mix (2,5-7,9).
Included workstations
The workstations that should use the main display. In very large system it may be necessary to
limit the number of workstations that use the same main display otherwise simultaneous calls
will be delayed too long before they can be showed.
Enter a single workstation number (for example 2), multiple workstation numbers separated by
commas (2,5,7), a sequence of workstation numbers (2-5) or a mix (2,5-7,9).
Workstations to the left
The workstations that are placed to the left of the main display. This setting affects the direction
of the arrow (DISPLAY_COUNTER_IS_LEFT and DISPLAY_COUNTER_IS_RIGHT).
Click with the right mouse button in the text box to open the Edit dialogue. Enter a single
workstation number (for example 2), multiple workstation numbers separated by commas
(2,5,7), a sequence of workstation numbers (2-5) or a mix (2,5-7,9).
Use internal buzzer
Set this check mark to use the internal buzzer in the display.
8/9/16-Series displays have no internal buzzer.
Optional program, Secondary program
These scripts specify the displayed information. The 8, 9 and 16-series displays require script
programs; the 7-series displays cannot use a script program.
Displays
087.01E Q-MATIC AB 133
You will find detailed information about display programming later in this chapter. Here is some
information that is important when you work with main displays.
The main display settings dialogue has two text boxes for script programs: "Optional
programming" and "Secondary rows programming". Optional programming is always used for 8,
9 and 16-series displays. Secondary rows programming is used when the main display consists of
stacked displays.
Optional Programming
Here is a typical script program used in Optional Programming (this is the template for 1664
main display).
N= DISPLAY_NUMBER
C= DISPLAY_COUNTER
IF( DISPLAY_ARROW_FLASH AND DISPLAY_COUNTER_IS_LEFT )
A= "\ef+<\ef-"
ELSE IF( DISPLAY_ARROW_FLASH AND DISPLAY_COUNTER_IS_RIGHT )
A= "\ef+>\ef-"
ELSE
A= " "
IF( DISPLAY_UPDATE )
"BR B "
IF( DISPLAY_FLASH )
"F+ "
ELSE
"F- "
"FS D PL I [" DISPLAY_LETTER N LEN(3) A C LEN(2) "] "
The display is going to show the ticket number, the workstation number and a flashing arrow.
The script starts to check which arrow the display should show (left "<" or right ">") or if there
should not be any arrow at all. The result is stored in the variable A.
IF( DISPLAY_ARROW_FLASH AND DISPLAY_COUNTER_IS_LEFT )
A= "\ef+<\ef-"
ELSE IF( DISPLAY_ARROW_FLASH AND DISPLAY_COUNTER_IS_RIGHT )
A= "\ef+>\ef-"
If the display is updated then the display should send a signal to the bell output.
Programming main displays
Q-WIN Reference Manual - Vol 1, Basic
134 Q-MATIC AB 087.01E
IF( DISPLAY_UPDATE )
"BR B "
Check if the setting specifies that the display should flash.
IF( DISPLAY_FLASH )
"F+ "
ELSE
"F- "
Finally send the information that should be shown on the display.
"FS D PL I [" DISPLAY_LETTER N LEN(3) A C LEN(2) "] "
Secondary Rows Programming
Secondary rows are the additional displays in stacked main displays. This makes it possible to
create large main displays with many rows. Q-WIN can automatically handle these additional
displays.
First, specify the number of additional displays. These displays must have the same ID code as
the top display. The top display must have Sub ID code 1,the second display must have Sub ID
code 2, etc.
Enter the script program for the additional displays (see the example below). The program uses
the information in the display cache (DISPLAY_CACHE) for the secondary rows. The display
cache contains all information about the latest served customers.

A main display with two rows. Optional Programming controls the first row. Secondary row
programming controls the second row. Number of additional rows: 1.
This script is used on a main display that consists of two 1664 displays. Both displays must have
the same ID code. The upper display must have Sub ID code 1 and the lower display must have
Sub ID code 2.
Enter the following script program in the Optional Programming box.
N= DISPLAY_CACHE_NUMBER
C= DISPLAY_CACHE_COUNTER
Program example, two 1664 Displays as one main display
Displays
087.01E Q-MATIC AB 135
IF( DISPLAY_ARROW_FLASH AND DISPLAY_COUNTER_IS_LEFT )
A= "\ef+<\ef-"
ELSE IF( DISPLAY_ARROW_FLASH AND DISPLAY_COUNTER_IS_RIGHT )
A= "\ef+>\ef-"
ELSE
A= " "

IF( DISPLAY_UPDATE )
"BR CSY B S SMS 2 PMDL "
ELSE
"PL "
IF( DISPLAY_FLASH )
"F+ "
ELSE
"F- "
"FS D I ["DISPLAY_CACHE_LETTER N LEN(3) A C LEN(2) "] "
Explanation
N= DISPLAY_CACHE_NUMBER
C= DISPLAY_CACHE_COUNTER
N is the ticket number and C is the workstation number.
Do not use DISPLAY_COUNTER and DISPLAY_NUMBER on a display with more than
one row. After some seconds these functions start to cycle through the latest called ticket
numbers in each category. A main display that shows more than one called ticket number must
never use this cycling.
IF( DISPLAY_ARROW_FLASH AND DISPLAY_COUNTER_IS_LEFT )
A= "\ef+<\ef-"
ELSE IF( DISPLAY_ARROW_FLASH AND DISPLAY_COUNTER_IS_RIGHT )
A= "\ef+>\ef-"
ELSE
A= " "
This section checks if an arrow should be shown and if the workstation is to the left or to the
right. The "<" character and the ">" character are used as arrows. The \ef+ command specifies
that the following characters should flash on the display. The \ef- command specifies that the
following characters should not flash.
IF( DISPLAY_UPDATE )
"BR CSY B SMS 2 PMDL "
Break the current program in the display (BR) if the information on the display should be
updated. The next command (CSY) synchronises the flashing on the display with the flashing on
Q-WIN Reference Manual - Vol 1, Basic
136 Q-MATIC AB 087.01E
the additional display (row 2). Activate the external bell (B). Set the scroll speed to two (SMS
2) and scroll down the new information (PMDL). The text is aligned to the left.
ELSE
"PL "
If the information on the display should be unchanged then show the text on the display (PL).
The text is aligned to the left.
IF( DISPLAY_FLASH )
"F+ "
ELSE
"F- "
This section checks if all information on the display should flash (F+) or not (F-).
"FS D I ["DISPLAY_CACHE_LETTER N LEN(3) A C LEN(2) "] "
Select font D (FS D) and send the text (I). Send the category letter or the ticket button letter
(DISPLAY_CACHE_LETTER). The settings specifies which letter that should be displayed.
Send the ticket number as three digits (N LEN(3)), the arrow (A) and the workstation number
as two digits (C LEN(2)).
Set the number of additional displays to 1 and enter the following script program in the
Secondary Rows Programming box.
S= DISPLAY_SECONDARY
IF( S LT DISPLAY_CACHE_DEPTH )
BEGIN
N= DISPLAY_CACHE_NUMBER
C= DISPLAY_CACHE_COUNTER
A= " " { No arrow }
IF( DISPLAY_UPDATE )
"BR CSY B S SMS 2 PMDL "
ELSE
"PL "
IF( DISPLAY_FLASH )
"F+ "
ELSE
"F- "
"FS D I ["DISPLAY_CACHE_LETTER N LEN(3) A C LEN(2) "] "
END
ELSE
"PL I [] "{ No cache -> nothing to display }
Displays
087.01E Q-MATIC AB 137
Explanation
S= DISPLAY_SECONDARY
S is the current additionally display. The script is executed one time for each additional display.
DISPLAY_SECONDARY is increased by 1 each time the script is executed. In this example we
have one additional display so S will always be 1.
IF( S LT DISPLAY_CACHE_DEPTH )
Check that there are customers in the display cache. The second row of the main display should
be empty when the first customer is called. The display cache stores the latest customers shown
on the main display. Cache position 0 is the latest called customer, cache position 1 is the second
latest called customer, etc. Information from cache position 1 should be placed on the first
additional display. The script handles this automatically.
N= DISPLAY_CACHE_NUMBER
C= DISPLAY_CACHE_COUNTER
A= " " { No arrow }'
N is the ticket number and C is the workstation number. In this example we do not have any
arrows on the second row so A is just a space.
IF( DISPLAY_UPDATE )
"BR CSY B S SMS 2 PMDL "
Break the current program in the display (BR) if the information on the display should be
updated. The next command (CSY) synchronises the flashing on the display with the flashing on
the additional display (row 2). Activate the external bell (B). Set the scroll speed to two (SMS
2) and scroll down the new information (PMDL). The text is aligned to the left.
ELSE
"PL "
If the information on the display should be unchanged then show the text on the display (PL).
The text is aligned to the left.
IF( DISPLAY_FLASH )
"F+ "
ELSE
"F- "
This section checks if all information on the display should flash (F+) or not (F-).
"FS D I ["DISPLAY_CACHE_LETTER N LEN(3) A C LEN(2) "] "
Select font D (FS D) and send the text (I). Send the category letter or the ticket button letter
(DISPLAY_CACHE_LETTER). The setting specifies which letter that should be displayed.
Send the ticket number as three digits (N LEN(3)), the arrow (A) and the workstation number
as two digits (C LEN(2)).
Q-WIN Reference Manual - Vol 1, Basic
138 Q-MATIC AB 087.01E
"PL I [] "
The last line is executed if there were no customers in the display cache. This line sends an empty
string to the display. The display does not show any information.
The same script program can be used if the main display has more than two rows. The script
automatically puts the correct information on the additional displays. The only thing that must
be specified is the number of additional displays (secondary rows).
Information displays can show any kind of information. It can be everything from a small display
showing the number of waiting customers to a big display showing a long advertisement.
Select "Displays" in the System configuration window and then Information displays general in
the tree.
Number of settings
This is the number of settings. Displays with the same ID code are counted as one setting.
Information displays
Information displays
Default ID code: 65
Maximum number of settings: 99
General information display settings
Displays
087.01E Q-MATIC AB 139
Starting ID code
ID code for information display number 1.
Update interval
This is the time between each update of the information to the display when the information is
not changed. This setting is used if the connection to the display is broken. The display does not
show any information after a broken connection until it is updated. There are two actions that
update the display. The information is always updated when the result of the script changes. The
information is also updated according to this setting. If you set the time to 0 then the display is
only updated when the result of the script changes.
Name
The name of the information display setting.
Output format
Specify if it is text (8, 9 and 16-series displays) or numerical (7-series displays) displays.
Flash above this value
The display starts to flash when the result of the script program is equal to or greater than this
value. 8, 9 and 16-series displays do not use this setting (set the value to 0).
Bell above this value
A bell must be connected to the display to use this setting. The bell sounds once when the result
of the script program is equal to the setting. 8, 9 and 16-series displays do not use this setting
(set the value to 0).
Internal buzzer
The currently produced displays do not have any built in buzzer and they are going to ignore this
setting.
Information display settings
Q-WIN Reference Manual - Vol 1, Basic
140 Q-MATIC AB 087.01E
Script program
Script program for the information display.
The 8/9/16-series displays can show different fonts. The font must be according to the following
rules.
It must be possible to show the font with the numbers of pixels available on the display.
It cannot be italic.
It must be a simple and clean font without decorative windings. For example, the following
font cannot be shown: "ABCDEF".
The font is stored in a special fnt-format. The font files must be stored in the Tgen directory. Use
the Font Generator (QFont.exe) to generate fnt-format from Windows Fonts.
A font ID identifies the font. The font ID can be any character but we recommend that A to Z
and a to z are used. Font 0 is always the system font.
The font is loaded into the display at start-up of Q-WIN.
When you use the font on a main display you can reduce the number of characters in the font.
You will save memory in the display and reduce the time to load the font. We recommend that
you use characters 32-72.
The fonts are proportional and do not have a fixed width. The letter "i" is for example narrower
than the letter "w".
Fonts
Displays
087.01E Q-MATIC AB 141
Start the QFont program .
Open the Windows font you want to convert into a Q-WIN font.
Edit the font. Use the on-line help for more information.
Save the font.
Start Q-WIN.
Select "Font" from the Settings menu.
Specify the number of fonts you want to use on the displays. The number of fonts that you
can use depends on the size of the font.
A font must be loaded into a display before it can be used. This happens every time you start
Q-WIN. Usually that is enough but if the connection to the display is broken then the display
will lose the font and it is not loaded back into the display until the next time you start Q-
WIN.
The refresh time regularly loads the fonts to the display. The problem is that it takes time to
load the font and the system stops during that time.
Only use this refresh time if you have problems with broken connections to displays.
Designing a new font
Q-WIN Reference Manual - Vol 1, Basic
142 Q-MATIC AB 087.01E
Select a setting in the "No. Name" list and click the Edit Name button. Enter a name for the
font.
Select a setting in the "No. Name" list and click the Edit Settings button to edit the settings.
Enable the font.
Enter a font ID. The display command FS uses the font ID to select the font. The font ID
must be one character, usually a letter.
Do not change the BSID No. This is the Broadcast ID Number and it is used instead of
the ordinary ID Code to send information to many units at the same time. If you change the
BSID then you must also change it on those displays that are going to use the font.
Enter the path to the font file or click the Browse button to search for the file.
Click the OK button to save the settings.
On the Utilities page in System configuration there is an Upload fonts button. Use this button
to immediately load the fonts to the displays; otherwise they are loaded the next time you
start Q-WIN.
Do not click the Upload button if the system is running and serving customers. The
system stops during the time the fonts are loaded into the displays.
In the example above all displays are loaded with the same fonts. This may be a problem if the
system contains displays with different size. It is possible to load different fonts to different
displays. Perhaps you have both 16 and 8 series displays or you want to show a European
alphabet on some displays and a local alphabet on other displays.
You use the Broadcast ID code (BSID) to select the displays that should receive the font.
Displays with the same BSID get the same fonts. Please read the Display Manual for information
about changing the BSID code on the displays.
The 8/9/16-series displays can show everything from a single number in one colour to a scrolling
text in three colours and multiple languages. Usually you should try to keep the information as
simple as possible. Much scrolling and different colours tend to confuse the customers.
Different fonts to different displays
Introduction to programming
Displays
087.01E Q-MATIC AB 143
The 8/9/16-series displays must have a script program otherwise they will not work.
The programming is divided into two parts simple display commands and advanced display
commands. You do not need to know how the displays work internally to use the simple display
commands but that is very important if you want to use the advanced display commands.
The displays use their own display commands. These display commands are added to a script
program in the settings for the display. The script program specifies the commands that should
be sent to the display. The commands are sent to a buffer in the display and they are loaded into
the display memory when the execution of the current commands has finished.
The commands will continue to run in the display until the last command is executed, there is a
break (BR) or the display is restarted. Note! It is not the script program that is executed in the
display; it is the display commands sent from the script program. Some commands result in an
endless loop. To stop the execution of these commands you must send a break (BR).
You can do almost everything with the simple commands; the advanced commands are only used
when you want very special solutions. The simple commands are (of course) easy to use. The
following line shows Hello World on the display.
"PC I [ Hello World ] "
The line is even better if we add a couple of commands to select font and colour. We select green
colour (CS G) and font B (FS B).
"CS G FS B PC I [ Hello World ] "
Finally we can scroll the text into the display. We scroll the text down and place it in the centre
of the display (PMDC).
"CS G FS B PC PMDC I [ Hello World ] "
Q-WIN Reference Manual - Vol 1, Basic
144 Q-MATIC AB 087.01E
The same script program is only loaded once into the display. The display will ignore the script
program if it is exactly the same as it already has in the memory.
All display commands are texts and must be inside quotation marks "". All display commands
must be separated by at least one space, for example "F+ PC I [Welcome]".
Do not forget to place a space after the last character in a command string that will be
concatenated with another string. For example, the strings:
"FS B CS R"
"F+ PC I [Welcome]"
When concatenated, the display gets the following command string:
Execute the Script Program
Send the Display Commands to
the display buffer
Is the Script Program
new or changed?
Ignore the Script Program No
Is the display
memory free or a
break?
Check if the execution of the
current Commands has
finished or if the Commands
contain a break (BR).
Yes
Yes
Load the Commands into the
memory
Execute the commands
Wait No
START
END
Displays
087.01E Q-MATIC AB 145
"FS B CS RF+ PC I [Welcome]"
The "R" at the end of the upper string is added to the "F+" in the beginning of the second string
to the non-existing command "RF+".
The correct strings are
"FS B CS R "
"F+ PC I [Welcome]"
These commands do not use the mask or the display area. The text will automatically be placed
at the correct position on the display. These commands can be used to show any text on the
display and to scroll in one direction.
\ec colour
Change the colour of the following characters. Set colour to R for red, G for green or A for
Amber. This command makes it easy to change colour between words or even within words.
This command is used locally in the string when a string or characters within a string should
have a different colour than the rest of the display. Use CS to select colour for the display.
\ef+
Flash all characters after \ef+.
Use F+ if you want to flash all information on the display.
Example
"PL I [\ef+ Hello \ef- Word] "
Hello World is placed on the display and Hello flashes.
\ef-
Do not flash the characters after \ef-.
\eg font
Select a font for the characters that follows the command.
This command is used locally in the string when you want to use a different font than the
one selected for the display. Use FS to specify the font for the display.
Simple display commands
Q-WIN Reference Manual - Vol 1, Basic
146 Q-MATIC AB 087.01E
AB
The Abort command makes it possible to abort the command string at specific positions. The
command is used when the program is endless and you want to be able to stop the execution at
specific positions. Note! You should not use Break (BR) together with Abort (AB). Break
immediately breaks the running program even if it is in the middle of a scrolling text. Abort
makes sure that the program is broken after the text has scrolled out from the display.
Example
"PMH I [Hello1] W AB I [Hello2] W AB I [Hello3] W AB I [Hello4] W AB RPT "
The program can be broken between each of the texts. Remove all Aborts (AB) except the last
one if you want to be sure that all four texts are shown before the break.
AX
Always execute. Always execute the script sent to the display even if it is exactly the same as the
one currently loaded in the display.
B
Activate the bell output.
BR
Break he execution of the program in the display. The program executed in the display will be
immediately stopped and replaced with the new information from the script program.
CS colour
Specify the display colour. Three colours are available: red (CS R), green (CS G) and amber (CS
A). The displays are available in three versions, red, green and three-colour. The three-colour
displays have both red and green LEDs. Amber is when both colours are used at the same time.
CSY
The Clock Sync command synchronises the flashing of the displays. This command is used on
main displays with more than one row. The displays flash with 1 Hz but the internal clocks are
not synchronised so they do not flash at the same time. This command restarts the internal clock.
D-
Turn off the display.
F+
Flash all information shown on the display. The flash will continue until It is stopped by an F-
command.
F-
Stop flashing all information shown on the display. The command will be ignored if the display
is not flashing.
Displays
087.01E Q-MATIC AB 147
FS font_id
Select a font. Font_id is a character that identifies the font. The system font is 0 (FS 0). Use the
font editor to generate new fonts.
The fonts are loaded to the display when Q-WIN starts.
Example
Select font B and print the text Fonts.
"CS R WS 48 0 96 16 WC "
"FS B PP 10 0 I [Fonts]"
"MC MA 48 0 0 MR "
I [text]
Show the text between the square brackets on the display. "Text" can be any string or
information from the system.
A script command must be placed outside the quotation marks but inside the square
brackets.
Example
"PM I [There are "GROUP_QUEUE(1)" customers waiting]"
PC
Place the text centred on the display.
Example
"PC I [Welcome]"
PL
Place the text to the left on the display.
Example
"PL I [Welcome]"
PM
Scroll the text from the right to the left.
Q-WIN Reference Manual - Vol 1, Basic
148 Q-MATIC AB 087.01E
Example
"PM I [Welcome]"
PMDC
Scroll down the new text into the display at the same time as the old text scrolls out from the
display. The new text is placed centred on the display.
PMDL
Scroll down the new text into the display at the same time as the old text scrolls out from the
display. The new text is placed aligned to the left.
PMDR
Scroll down the new text into the display at the same time as the old text scrolls out from the
display. The new text is placed aligned to the right.
PMH
Scroll the text one time from the right to the left.
Scroll text
Displays
087.01E Q-MATIC AB 149
Example
"PMH I [Welcome]"
PMLC
Scroll the new text into the display from the right to the left at the same time as the old text
scrolls out from the display. The new text is placed centred on the display.
PMLL
Scroll the new text into the display from the right to the left at the same time as the old text
scrolls out from the display. The new text is placed aligned to the left.
PMLR
Scroll the new text into the display from the right to the left at the same time as the old text
scrolls out from the display. The new text is placed aligned to the right.
PMRC
Scroll the new text into the display from the left to the right at the same time as the old text
scrolls out from the display. The new text is placed centred on the display.
PMRL
Scroll the new text into the display from the left to the right at the same time as the old text
scrolls out from the display. The new text is placed aligned to the left.
PMRR
Scroll the new text into the display from the left to the right at the same time as the old text
scrolls out from the display. The new text is placed aligned to the right.
PMUC
Scroll up the new text into the display at the same time as the old text scrolls out from the
display. The new text is placed centred on the display.
PMUL
Scroll up the new text into the display at the same time as the old text scrolls out from the
display. The new text is placed aligned to the left.
Scroll text one time
Q-WIN Reference Manual - Vol 1, Basic
150 Q-MATIC AB 087.01E
PMUR
Scroll up the new text into the display at the same time as the old text scrolls out from the
display. The new text is placed aligned to the right.
PMV
Scroll the text upwards one time.
Example
"PMV I [Welcome]"
PR
Place the text to the right on the display.
Example
"PR I [Welcome]"
RPT
Repeat the program in the memory of the display.
This command results in an endless loop and should be used very carefully.
RW
The Repeat Wait command (RW) is used in endless movements to make sure that the scrolling
of the text is not aborted until if is finished. The current movement will finish before the text
can be interrupted.
The movement of a text on the display takes longer time than the execution of the script. If you
do not use Repeat Wait then the display may start to execute a new set of commands while there
is text scrolling on the display. The new set of commands may abort the scrolling text before its
movements is finished. The RW command makes sure that all movements are finished before
anything new is shown on the display.
The Break command (BR) overrides the RW command and breaks the movement
immediately.
Example
"PM I [ Hello World ] RW "
Displays
087.01E Q-MATIC AB 151
Any command following RW will be executed before a new set of commands are loaded
into the display.
S
Activate the speaker output.
SM margin
Set Margin. This command is used together with the movement commands (PMxx). The margin
specifies the space in pixels between the old text shown on the display and the new text scrolled
into the display.
There are no limitations for the vertical margin. The horizontal margin has the following
limitation:
Maximum margin = 256 - 2 x width
Width is the display width. Here are some examples.
Display Maximum margin
16128, 8128 0
996 64
1664, 864 128
SMS speed
Set the scroll speed of the text. This command must be used together with PM, PMH or PMV.
Speed 1 (SMS 1) is the fastest speed. Example: Reduce the scroll speed of the text.
"SMS 5 PM I [Welcome]"
W
Wait for the movements to finish before the next text is shown.
WP time
Make a pause in the execution of the script program. "Time" is the length of the pause in seconds.
It is possible to add one decimal, for example WP 1.2 (Wait 1.2 seconds).
Margin
Q-WIN Reference Manual - Vol 1, Basic
152 Q-MATIC AB 087.01E
With advanced programming it is possible to scroll in more than one direction. In advanced
programming it is important to know the difference between memory area, mask and display
area.
Always try to use the simple commands if that is possible.
Memory area
All characters are placed in the memory area. The memory area is the physical memory available
in the display and it is larger than the area shown on the display. This makes it possible to change
one text while another text is displayed.
The size of the memory area is 256 x 64 pixels. The upper left corner has the co-ordinates (0,0)
and the bottom right corner has the co-ordinates (255,63).
Mask
The mask is the part of the memory area where the text is changed. Usually you place the mask
on a part of the memory area that is not shown on the display. The following commands use the
mask: Place Text (PP), Line commands (LS and LD) and Window Clear (WC). These
commands use co-ordinates relative to the upper left corner of the mask.
Window Full (WF) will disable the mask, i.e. setting the mask to the same size as the memory
area.
Display area
The display area is the part of the memory area that is shown on the display. The display area is
like a window where you can see a part of the memory area. You can only see the part of the
memory area that is beneath the display area. If you want to see another part of the memory area
you must change the position of the display area.
There are two ways to change the position of the display area. If you move the display area over
the memory area the text will scroll on the display.
The text scrolls in the opposite direction of the movement of the display area. For example,
if you move the display area from the left to the right the text will scroll from the right to the left.
Open the display area on a new position to replace the text on the display without scrolling.
The display area is not connected to the mask. Usually the mask and the display area are
placed on different positions in the memory area.
Advanced programming
Displays
087.01E Q-MATIC AB 153
The memory area, the mask and the display area.
Move Text
To scroll the text you must move the display area over the memory area.
Place the mask on the position in the memory area where you want to enter the text.
Enter the text that should scroll on the display.
Place the display area at a suitable start position. If you want to start with a blank display and
scroll the text into the display you must place the display area so the text is not visible. In this
case we place the display area before the text.
256.00
6
4
.
0
0
Memory area
Change the
text inside
the mask.
The display shows
the characters in the
display area.
The display area.
924
Place the Mask
Enter the text.
Q-WIN Reference Manual - Vol 1, Basic
154 Q-MATIC AB 087.01E
Move the display area to the right. The text will scroll from the right to the left on the display.
A movement list makes it possible to create a complex movement that scrolls the text in more
than one direction.
Movement list
The movement list is a list of commands that specifies the movement of the display area over the
memory area. This movement makes it possible to scroll text in all directions an also to change
the direction of the scrolling.
Another way to use the movement list is to shift between different texts, perhaps in different
languages. The texts are placed in the memory area. Then the display area is placed above each
text for a short while.
Example
We want to show three texts "Start", "Wait" and "End" on a 1664 display. These texts can of
course be replaced with any kind of text or system information. We want the display to scroll
the texts according to the description below.
Start to show "Start" on the display.
Place the Display Area.
The 972 Display
Move the Display
Area to the left.
The 972 Display The text scrolls from
right to left.
Start
Displays
087.01E Q-MATIC AB 155
Move "Start" to the left out from the display. Move at the same time "Wait" into the display from
the right.
Show "Wait" for about one second.
Move "Wait" upwards until it disappears from the display. Move at the same time "End" into the
display. "End" never stops. When it reaches the middle of the display it should start to move to
the right.
Finally we want to scroll "Start" back into the display. We add a downward movement to the
current movement to the right when "End" has almost disappeared from the display. Now we
have two movements at the same time: one to the right and one down. The result is that the texts
are moved diagonally over the display, from the top left corner to the bottom right corner.
The sequence restarts when "Start" is shown on the display.
Use the following script program.
"CS R WF WC WR PP 20 2 I [Start] "
"WS 64 0 124 16 PP 20 2 I [Wait] "
"WS 64 16 124 32 PP 20 2 I [End] "
"MC MA 0 0 0 MA 64 0 7 MP 10 MA 64 16 4 MA 27 16 5 MA 0 0 2 MR R "
The script contains two parts. The first three lines use the mask to place the text in the memory
area. The last line is the movement list that specifies the movement of the display area.
"CS R WF WC WR PP 20 2 I [Start] "
Wait Start
Wait
End
Wait
art
End
Start
Q-WIN Reference Manual - Vol 1, Basic
156 Q-MATIC AB 087.01E
CS R: Select red as the colour.
WF WC: Delete all information in the memory area. Set the mask to the same size as the
memory area (WF) and delete all information in the mask (WC).
WR: Set the size of the mask to the same size as the display and place it in the top left corner of
the memory area.
PP 20 2 I [Start]: Print "Start" in the memory area. The co-ordinates (20 2) specify the position
of the text in the mask. Place the text at the specified position (I).
"WS 64 0 124 16 PP 20 2 I [Wait] "
WS 64 0 124 16: Specify a new mask. The top left corner is at position 64 0 in the memory area
and the bottom right corner is at position 124 16.
PP 20 2 I [Wait]: Print "Wait" in the memory area.
"WS 64 16 124 32 PP 20 2 I [End] "
WS 64 16 124 32: Specify a new mask. The top left corner is at position 64 16 in the memory
area and the bottom right corner is at position 124 32.
PP 20 2 I [Wait]: Print "End" in the memory area.
Start
The position
of the Mask
The Memory
Area
Start
The position
of the Mask
The Memory
Area
64 0 124 16
Wait
Start
The position
of the Mask
The Memory
Area
64 16 124 32
Wait
End
Displays
087.01E Q-MATIC AB 157
All texts are placed in the memory area. Next step is to create a movement list for the display
area.
"MC MA 0 0 0 MA 64 0 7 MP 10 MA 64 16 4 MA 27 16 5 MA 0 0 2 MR R "
MC: Clear the movement list. Delete any existing movement list.
MA 0 0 0: Immediately move the display area to the text "Start". The first two numbers are the
co-ordinates for the top left corner of the display area. The size of the display area is always the
same as the size of the display, in this case 64 x 16. The last number is the speed of the
movement. In this case we want the display area to immediately move to the specified position
(speed=0).
MA 64 0 7: Move the display area to the text "Wait". The display area is moved from the current
position (in this case the text "Start") to the co-ordinates specified by the two first numbers (in
this case the text "Wait"). The last number specifies the speed of the movement (7).
MP 10: Pause the movement in one second. The time is in tenths of a second.
The Display Area The Memory Area 0 0
Wait
End
1664
Start
Start
The Display Area The Memory Area 64 0
End
1664
Start
Start
Wait
Speed=7
Wait
Q-WIN Reference Manual - Vol 1, Basic
158 Q-MATIC AB 087.01E
MA 64 16 4: Move the display area to the text "End".
MA 27 16 5: Move the display area to a position to the left of the text "End". "End" is moved to
the right.
MA 0 0 2: Move the display area back to the text "Start".
MR R: Run the movement list. This will start the movement of the display area. The movement
will be repeated until a Break command is sent to the display or it is disconnected from the
power.
The Display Area The Memory Area 64 16
Start Wait
S
p
e
e
d
=
4
Wait
End
End
1664
The Display Area The Memory Area 27 16
Start Wait
Speed=5
End
End
1664
The Display Area The Memory Area 0 0
Start
Wait
S
p
e
e
d
=
2
End
End
1664
Start
Displays
087.01E Q-MATIC AB 159
The commands must be separated by a space and placed inside quotation marks "". There must
be a space after the last command. All commands and their arguments must be separated by at
least one space.
It is possible to use a variable or a script function as an argument to a command. They must be
placed outside the quotation marks, for example "MA "DISPLAY_COUNTER(1)+16 " 0 " V "
MP 20 ". The display commands (MA and MP) and the constant values (0 and 20) are inside the
quotation marks. The script function (DISPLAY_COUNTER(1)+16) and the variable (V) are
placed outside the quotation marks.
Do not forget that all commands and arguments must be separated by at least one space. It
is very easy to miss a space when you mix commands, variables and script functions. It is better
to add an extra space than to forget a space.
LD x y
Draw a line from the start co-ordinates (LS x y) to the end co-ordinates (LD x y).
Example
We want to show a text with one line above the text and one line below the text.
"WF WC WS 0 16 64 32 "
"LS 0 1 LD 63 1 "
"LS 0 13 LD 63 13 "
"PP 12 3 I [Time " GROUP_RWT(1)/30 "] "
"MC MA 0 16 0 MR S "
WF WC: Clear the memory area.
WS 0 16 64 32: Specify the mask. In this case we use a 1664 display.
LS 0 1: Specify the start position for the top line.
LD 63 1: Specify the end position of the line and draw the line. 63 is the last column of LEDs
because we start to count at 0.
Advanced programming commands
The Memory Area
The Mask
LS x1 y1 LD x2 y2
Q-WIN Reference Manual - Vol 1, Basic
160 Q-MATIC AB 087.01E
LS 0 13: Specify the start position for the bottom line. We use a font that is nine pixels high. The
display is 16 pixels high. We cannot place the text exactly at the middle of the display but we
want it to be exactly in the middle between the lines. To achieve this we must place the bottom
line two lines from the bottom of the display.
LD 63 13: Specify the end position of the line and draw the line.
PP 12 3: Place the text at position 12 3 in the mask.
I [Time GROUP_RWT(1)/30 ] : Print the text in the mask.
MC MA 0 16 0: A very simple movement list. We want to place the display area at the position
of the text. We want it to be placed there immediately (speed=0).
MR S: Run the movement list. The display area is now placed on top of the text and the text will
be visible in the display. We run the movement list one time. The script program will be
executed by the display each time the information is updated. This will happen at least once
every minute.
LS x y
Specify the start position for the line in the mask.
MA x y speed
Add a new position to the movement list. The movement list specifies the movement of the
display area. The list contains of a number of positions and the speed of the movement. The
position specifies the position of the display area in the memory area. The display area will be
moved from the current position to the specified position. Speed is the speed of the movement.
Speed=1 is the fastest speed and speed=100 is the slowest speed. Speed=0 will immediately
move the display area to the specified position. Use speed 1 to 100 to scroll the text and speed
0 to shift between texts. See A movement list makes it possible to create a complex movement
that scrolls the text in more than one direction. on page 154.
It is possible to have more than one movement list in the same script. In such cases it is very
important that only one movement list at the time is executed. Always start with a MC
command to remove the current list before the new one is executed.
It is not necessary to have all the parts of the movement list at the same place in the script
program. All Movement Add (MA) and Movement Pause (MP) commands will be stored until
they are executed by a Movement Run (MR) command or deleted by a Movement Clear (MC)
command.
The current
position of the
Display area. The Memory Area
The new
position of the
Display Area.
speed
y
x
Displays
087.01E Q-MATIC AB 161
MC
Clear the movement list. The movement list is stored in the memory of the display. This
command deletes the current movement list. We recommend that this command always is used
before a new movement list to make sure that it will work properly.
MP time
Make a pause in a movement list. This command is adde to the movement list. The time is
specified in one-tenths of a second. Set time to 10 to get a pause for 1 second.
MR type
Run the movement list. Use "type" to specify if the list should be executed once (MR S) or
repeatedly (MR R). This command executes the commands that specify the movement of the
display area. Note! Repeatedly (R) movement will continue to run the movement list until it is
interrupted by a break (BR) command. No other parts of the script program will be executed.
PP x y
Place the text at the specified position in the mask. Position 0,0 is the top left corner of the mask.
Use WR, WF or WS to specify a mask. Use WC to remove old text from the memory area
specified by the mask.
Example:
CS R WR WC PP 7 11 I Test
Place the text Test at position 7,11 in the mask.
SCR pixels
Specify the number of pixels between each line of text. Default is 1.
WC
Turn off all LEDs of the selected colour in the mask. Use CS to specify the colour. WC only
affects the memory area specified by the mask.
WF
Set the size of the mask to the same size as the memory area. Use WF WC to delete everything
in the memory area.
The Mask The Memory Area
Start
x
y
Q-WIN Reference Manual - Vol 1, Basic
162 Q-MATIC AB 087.01E
WR
Set the size of the mask to the display default size. The display default size is specified with the
button at the back of the display. The mask will be placed at the upper left corner of the memory
area.
WS left top right bottom
Set the size and the position of the mask. WS specifies a rectangle. The first co-ordinates (left
top) are for the top left corner of the mask and the last co-ordinates (right bottom) are for the
bottom right corner of the mask. Co-ordinates 0 0 are for the upper left corner of the memory
area. WS 0 0 256 64 sets the mask to the same size as the memory area (same as WF).
The bottom right corner is placed one pixel outside the available area. The co-ordinates for
the bottom right corner of the memory area are 255 63. This is because you start to count at 0;
the first pixel is 0 0.
Example: You want a mask placed at position 0 16 in the memory area. The size of the mask
should be 96 x 16 pixels (a 1696). Enter WS 0 16 96 32 to specify the mask.
The Mask The Memory Area
The Mask
The Memory Area left
right
t
o
p
b
o
t
t
o
m
Displays
087.01E Q-MATIC AB 163
The co-ordinates shown on the display are from 0 16 to 95 31; the last co-ordinates in the
specification are always one pixel outside the visible area.
The 911 and 917 are different from the other displays in the 9-series. They are a smaller version
of the 9-series displays intended as workstation displays or information displays. They can show
two (911) or three (917) characters (letters and digits).
The 911 and 917 displays must have a script program to work but they can only use a reduced
set of display commands. They cannot scroll text or show more than one colour.
They can use the following display commands.
\ef+
Flash all characters after \ef+.
Use F+ if you want to flash all information on the display.
Example
"PL I [\ef+ A \ef- BC] "
ABC is placed on the display and A flashes.
\ef-
Do not flash the characters after \ef-.
\eg font
Select a font for the characters that follows the command.
This command is used locally in the string when you want to use a different font than the
one selected for the display. Use FS to specify the font for the display.
911 and 917
The Mask
The Memory Area
0 16
96 32
Q-WIN Reference Manual - Vol 1, Basic
164 Q-MATIC AB 087.01E
AB
The Abort command makes it possible to abort the command string at specific positions. The
command is used when the program is endless and you want to be able to stop the execution at
specific positions. Note! You should not use Break (BR) together with Abort (AB). Break
immediately breaks the running program even if it is in the middle of a text sequence. Abort
makes sure that the program is interrupted after all the texts have been shown on the display.
Example
"PR I [GROUP_QUEUE(1)] WP 4 I [GROUP_RWT(1)/30] WP 4 AB RPT "
The display shows the number of waiting customers in category 1 for four seconds then the
waiting time for category 1 for four seconds. The AB command makes sure that the sequence
cannot be interrupted until both the number of customers and the waiting time have been
shown.
AX
Always execute. Always execute the script sent to the display even if it is exactly the same as the
one currently loaded in the display.
B
Activate the bell output.
BR
Break he execution of the program in the display. The program executed in the display will be
immediately stopped and replaced with the new information from the script program.
CSY
The Clock Sync command synchronises the flashing of the displays. The displays use an internal
clock to flash the information. Each display has its own internal clock with the same frequency
(1 Hz) but they are not synchronised because they were not started at the same time. The CSY
command restarts the internal clock to synchronise the displays.
This can be useful when there are many information displays placed close to each other and they
use flash (F+).
D-
Turn off the display.
F+
Flash all information shown on the display. The flash will continue until It is stopped by an F-
command.
F-
Stop flashing all information shown on the display. The command will be ignored if the display
is not flashing.
Displays
087.01E Q-MATIC AB 165
FS font_id
Select a font. Font_id is a character that identifies the font. The system font is 0 (FS 0). Use the
font editor to generate new fonts. Note! The fonts are loaded to the display when Q-WIN starts.
Example
Select font B and print the text FNT.
"FS B PL I [FNT]"
I [text]
Show the text between the square brackets on the display. "Text" can be any string or
information from the system.
A script command must be placed outside the quotation marks but inside the square
brackets.
Example
"PM I ["GROUP_QUEUE(1)" ] "
PL
Place the text to the left on the display.
PR
Place the text to the right on the display.
RPT
Repeat the program in the memory of the display.
This command results in an endless loop and should be used very carefully.
WP time
Make a pause in the execution of the script program. "Time" is the length of the pause in seconds.
It is possible to add decimals, for example WP 1.2 (Wait 1.2 seconds).
The 16-series displays can show the characters used in complex languages, for example Chinese
or Japanese.
Settings
There are special settings for the complex languages that must be correct before you can show
the text. You can find the settings in the [FONT] section of the qsys.ini file.
Complex languages
Q-WIN Reference Manual - Vol 1, Basic
166 Q-MATIC AB 087.01E
REDUCED_LANG
This setting specifies the language. The following values are available.
1 = Japanese
2 = Chinese (simplified)
3 = Chinese (traditional)
4 = Korean
REDUCED_FNT_ID
This setting specifies the font ID letter used in the Font Settings. Note! You cannot use the letter
"L".
REDUCED_FNT
This is the path to the series of font files. The font files must be in the fnt format. Use the QFont
program to convert Windows fonts to the fnt format. The path must be in the same format as
the following example:
C:\Program\QWin\TGen\Subfolder Name\932_%03d.fnt
REDUCED_DEFAULT
This is an additional set of commonly used characters that are always kept in the memory. You
can for example use the following characters as default: "123456789ABCD".
Tips to QFont
Here are some useful tips that can help you when you use QFont to design your Q-WIN fonts.
Use the localised version of Windows with the language you want. In other words, if you want
to display Chinese characters, begin working with a Chinese version of Windows.
If you want a codepage reference, check the entry given in Help/About.
If you start up QFont on a CJK (Chinese, Japanese or Korean) Windows machine, you will have
an option under the Tools menu called CJK Tools. Use these tools to create and save your font
files.
If you are only using Katakana characters, you do not need any special tools at all! Everything
will fit in only one byte.
Kanji characters must be 16x16 pixels, meaning that on a 1632 display, you can only show two
characters.
Create zenkaku files, then hankaku files. Normally, the same file you used for zenkaku is also
good for hankaku.
When saving your hankaku files, save it with the 000 leadbyte.
QFont and Arabic fonts
Here are some tips for those of you who use QFont to create Arabic fonts.
Displays
087.01E Q-MATIC AB 167
When creating Arabic fonts, always save character range 0-255, because Windows codepages has
actual characters in the control code area.
If using traditional Arabic digits, you must create a separate font for them.
In some versions of Windows, you will not get some characters to come through in QFont's font
converter.
Here are some of the most common errors or problems and their solutions.
The script is not working at all
Check that you use capital i (I) for text output, not the vertical bar (|).
Check that you use a space between all commands and after the last command.
The script itself and all results from the script are sent as one string to the display. If you have a
loop that is executed many times and each time it generates a result you will get a string that is
too long. Rewrite the script so the results are not sent at the same time. You may for example
send only a part of the result each time the script is executed. Use a counter (I=I+1) to check
how many times you have executed the script. Reset the counter when all information has been
sent to the display.
The information is not updated
You must remember that the script generates the list of commands that is executed by the
display. A repeated movement list (MR R) or a PM command result in an endless loop. Use a
single movement such as MR S, PMH or PMV or add a break (BR) to break the movement.
The display ignores the script if it is exactly the same script and the same result of the script as
it already has in the memory. Use a break command (BR) to restart the script.
The font is not changed
The fonts are loaded to the display when you start Q-WIN. Restart Q-WIN to add the new fonts.
The movements are not according to the movement list
You must be very careful if you have a complex script program with more than one movement
list. Make sure that the script executes only one movement list at the time. If it starts to execute
one movement list and later in the script it starts another movement, the first one will be
interrupted.
These examples will show you how to use both the simple and the advanced commands.
Troubleshooting
Examples
Q-WIN Reference Manual - Vol 1, Basic
168 Q-MATIC AB 087.01E
It is very important that the script program is entered into Q-WIN exactly as it is printed
in the manual. The most common errors are that you have missed a space or that you have used
a vertical bar (|) instead of a capital i (I).
It is also very important that you place the scripts in the correct settings. If you, for example,
make a script for a main display you must enter the script in the main display settings.
Special effect 1
This simple program shows a W that scrolls to the right to and returns with the word Welcome.
"WR WC "
"WS 64 0 128 16 PP 0 4 I [ W ] "
"WS 64 16 128 32 PP 0 4 I [ Welcome ] "
"MC MA 64 0 0 MA 0 0 2 MA 0 16 0 MA 60 16 2 MP 5 MR R "
Special effect 2
This program creates a bouncing text.
"WR WC "
"WS 64 0 128 16 PP 0 4 I [ Welcome ] "
"MC MA 0 0 0 MA 64 0 2 MA 48 0 2 MA 32 0 3 MA 48 0 3 MA 64 0 2 MA 56 0 2 MA
48 0 3 "
"MA 56 0 3 MA 64 0 2 MP 5 MR R "
Special effect 3
Print the word Welcome letter by letter on the display.
"WR WC "
"WS 0 0 64 16 PP 0 4 I [ W ] "
"WS 64 0 128 16 PP 0 4 I [ We ] "
"WS 128 0 192 16 PP 0 4 I [ Wel ] "
"WS 0 16 64 32 PP 0 4 I [ Welc ] "
"WS 64 16 128 32 PP 0 4 I [ Welco ] "
"WS 128 16 192 32 PP 0 4 I [ Welcom ] "
"WS 0 32 64 48 PP 0 4 I [ Welcome ] "
"MC MA 0 0 0 MP 5 MA 64 0 0 MP 5 MA 128 0 0 MP 5 "
"MA 0 16 0 MP 5 MA 64 16 0 MP 5 MA 128 16 0 MP 5 MA 0 32 0 MP 5 MR R "
Information display
The information display should show the time in hours and minutes. The colon between hour
and minutes should flash once every second.
"FS D CS R PC I [" HOUR LEN(2) "\ef+:\ef-" MINUTE LEN(2) "] "
Note! The script uses font D.
The "\ef+:\ef-" part of the script specifies that the colon should flash. The flash frequency in the
8/9/16-series Displays is 1 Hz so the colon will flash once every second.
Displays
087.01E Q-MATIC AB 169
Main display 948
The main display uses the system font (Font 0).
N= DISPLAY_NUMBER
C= DISPLAY_COUNTER
IF( DISPLAY_ARROW_FLASH AND DISPLAY_COUNTER_IS_LEFT )
L= "\ef+<\ef-"
ELSE
L= " "
IF( DISPLAY_ARROW_FLASH AND DISPLAY_COUNTER_IS_RIGHT )
R= "\ef+>\ef-"
ELSE
R= " "
IF( DISPLAY_UPDATE )
"B S "
"FS 0 PC I [" DISPLAY_LETTER N LEN(3) L C LEN(2) R "] "
IF( DISPLAY_FLASH )
"F+ "
ELSE
"F- "
Explanation
N= DISPLAY_NUMBER
C= DISPLAY_COUNTER
Set N to the ticket number and C to the workstation number.
IF( DISPLAY_ARROW_FLASH AND DISPLAY_COUNTER_IS_LEFT )
L= "\ef+<\ef-"
ELSE
L= " "
If the arrow should flash and the workstation is to the left then set L to a flashing "<" character
otherwise L is just a space.
IF( DISPLAY_ARROW_FLASH AND DISPLAY_COUNTER_IS_RIGHT )
R= "\ef+>\ef-"
ELSE
R= " "
If the arrow should flash and the workstation is to the right then set R to a flashing ">" character
otherwise R is just a space.
IF( DISPLAY_UPDATE )
"B "
Q-WIN Reference Manual - Vol 1, Basic
170 Q-MATIC AB 087.01E
Give a signal on the bell when the display is updated.
"FS 0 PC I [" DISPLAY_LETTER N LEN(3) L C LEN(2) R "] "
Select the system font (FS 0) and place the text on the centre of the display (PC). Put a category
letter or a ticket button letter in front of the number. The main display settings specifies which
type of letter that should be used.
Use three digits to show the ticket number (N LEN(3)). "L" is a left arrow if the workstation is
to the left otherwise it is a space. Use two digits to show the workstation number (C LEN(2)).
"R" is a right arrow if the workstation is to the right otherwise it is a space.
IF( DISPLAY_FLASH )
"F+ "
ELSE
"F- "
Check if the display should flash (F+) or not (F-).
Number of Fonts
This is the total number of fonts that are used on the displays.
Max: 100
Min: 0
Refresh Time
The refresh time, in minutes, specifies the time between each update of the fonts in the displays.
A font must be loaded into a display before it can be used. This is performed when Q-WIN starts.
If something happens to the display that makes it lose the fonts it will not get back the fonts until
next time Q-WIN is started. This can be prevented if Q-WIN regularly updates the fonts. Specify
the time between the updates of the font. Set the time to 0 to turn of the automatic update.
Max: 1440 minutes
Min: 0 minutes (disabled)
Select language
This setting specifies the language (only used with double byte languages). The following values
are available. 1 = Japanese 2 = Chinese (simplified) 3 = Chinese (traditional) 4 = Korean.
General font settings
Displays
087.01E Q-MATIC AB 171
To Upload the fonts
On the Utilities page of the System Configuration pages there is a button to Upload fonts. This
is usually performed at start-up of Q-WIN.
You must perform a font upload if you have changed a font or added a font otherwise the
changes are not loaded into the displays until the next time you start Q-WIN.
Do not upload a font in a running system. It can take some minutes to load the fonts and
Q-WIN is stopped during that time.
Name
The name of the font.
Font enabled
Set the check mark if the font should be loaded into the displays.
BSID
This is the Broadcast Sub ID code for the displays. The same fonts will be loaded to all displays
with the same Sub ID Code. This makes it possible to load different fonts into different types of
displays. All displays with the same Broadcast Sub ID code will use the same fonts.
Font ID
The font ID is the character that identifies the font. The font ID is used by the FS display
command to select the font. You can choose any characters but letters are usually used. Upper
case and lower case characters are identified as separate font ID characters.
You cannot use 0 because that is the system font.
Never use the same character as font ID for more than one font.
Font settings
Q-WIN Reference Manual - Vol 1, Basic
172 Q-MATIC AB 087.01E
Font file
This is the path to the file with the Q-WIN font (fnt). Click the Browse button to select a file.
The file must be Q-WIN (fnt) font. Use the QFont program to change a Windows font to
a Q-WIN font.
087.01E Q-MATIC AB 173
15. Q-WIN Mail
Topics in this chapter
Introduction................................................................................. 174
General Email settings................................................................. 174
Email message settings ............................................................... 175
Sending an email message .......................................................... 175
Q-WIN Reference Manual - Vol 1, Basic
174 Q-MATIC AB 087.01E
Q-WIN Mail is an option to Q-WIN. Q-WIN Mail makes it possible to automatically send e-mail
messages from script programs in Q-WIN. The FUNC_EMAIL script command sends a
predefined email message.
Q-WIN Mail makes it possible to send email messages based on system information, for example
when the waiting is too long. It is also possible to send emails at a specific time, for example once
every day.
These settings connect Q-WIN to the mail server. Q-WIN must be connected to an SMTP server
that handles the outgoing e-mail messages.
Select "E-Mail" in the System configuration window.
Number of email setups
The number of email messages.
From e-mail address
This e-mail address is used as the sender signature of the e-mail message.
From e-mail name
This name informs the recipient about the identity of the sender.
Reply to
This is the email address that will receive the replies on the emails. This can be another address
than the from address.
SMTP Server
This is the address to the SMTP server.
Introduction
General Email settings
Q-WIN Mail
TM
087.01E Q-MATIC AB 175
SMTP Server Login name
This is the user's account name on the SMTP server. Not all servers need this.
Email queue
Q-WIN may send many email messages at almost the same time. These email messages must be
placed in a queue and wait for the server to handle previous messages. This setting specifies the
maximum number of messages that can be placed in the queue.
The email messages in Q-MATIC Mail are predefined. A setting number identifies each email
message. This setting number is used in the FUNC_EMAIL script command.
Name
The name of the email message.
To e-mail address
The recipient's email address.
To e-mail name
The recipient's name.
Script program
This is the script program that specifies the email message. The result of the script is the email
message.
Q-WIN MAIL messages can only be sent from script programs. The message is always sent to
the same email address specifies in the email message settings (see above).
Enter a script program that specifies when the email message should be sent.
Add FUNC_EMAIL(message number) to the script. The message number is the number that
identifies the email message.
Email message settings
Sending an email message
Q-WIN Reference Manual - Vol 1, Basic
176 Q-MATIC AB 087.01E
Make sure that the message is sent only once. Most scripts are regularly executed and it will
cause a lot of annoyance if an email message is sent every time. Use a variable or an array position
as a flag to indicate that the massage has been sent. The flag prevents the script from sending
more email messages. Reset the flag when it is acceptable to send a new message.
Example
We want to send an email message at 5:00 pm every day. The email informs about the number
of customers that were served during the day.
Use HOUR to check if the hour is 17 (5:00 pm in the 24-hours format).
The problem is that HOUR will be 17 during one hour and the script will continue to send email
if we do not use a flag to guarantee that it is only sent once. Use an array position as a flag and
check if HOUR is 17 and the flag is not set.
Use FUNC_EMAIL to send the email message and set the flag to prevent more messages.
IF ((HOUR EQ 17) AND ( ARRAY(25) EQ 0))
BEGIN
SETARRAY(25 1)
FUNC_MAIL(1)
END
Enter a script in the system server settings that resets the flag (array) in the middle of the night.
IF (HOUR EQ 1) SETARRAY(25 0)
087.01E Q-MATIC AB 177
16. Host
Topics in this chapter
General connections settings....................................................... 178
Connection settings ..................................................................... 178
Communication ........................................................................... 179
Event settings .............................................................................. 180
Run script..................................................................................... 180
System script................................................................................ 181
Date and time.............................................................................. 181
Q-WIN Reference Manual - Vol 1, Basic
178 Q-MATIC AB 087.01E
Select Host in the System configuration window, and then Connections:
Connections specifies the way clients, applications, etc. can be connected to the server.
Host connections
Specify the number of connection settings. The first connection is always DIRECT (the client at
the same PC as the server). This connection cannot be changed and it is not displayed in the
settings tree.
Name
This is the name of the setting.
Port
This port receives information from the outside. Default port is 500.
UDP Event Port
This port is used to send events from the server with the UDP protocol. Default port is 501. The
event data is broadcasted and do not reach outside the subnet.
General connections settings
Connection settings
Host
087.01E Q-MATIC AB 179
TCP Event Port
This port is used to send events from the server with the TCP protocol. This is the standard TCP
protocol and it reaches outside the subnet.
Max Clients
This is the number of clients that can be connected to the server at the same time.
Type of encryption
The communication between the clients and the server is encrypted. There are three levels of
encryption.
Q-WIN encryption.
All Q-WIN clients and all applications from Q-MATIC use this type of encryption.
Distributor encryption.
Distributor developed applications use this type of encryption.
No encryption.
Some applications cannot handle encrypted communication.
The Communication settings specify the communication with the hardware units that are
connected to the system (displays, terminals, printers, etc.). If the system is slow it may be
necessary to change these settings to avoid unnecessary time out errors in the Error log.
Send commands
This is the maximum number of times that Q-WIN tries to send a command to a unit. Default
value: 5, minimum value: 1, maximum value: 100.
Connection time out
The maximum time that Q-WIN waits for an answer when it tries to connect to a unit. The value
is in 0.01 seconds. Default value: 100, minimum value: 10, maximum value: 30000.
Answer time out
The maximum time that Q-WIN waits for an answer when a command is sent to a unit. The
value is in 0.01 seconds. Default value: 1000, minimum value: 10, maximum value: 30000.
Communication
Q-WIN Reference Manual - Vol 1, Basic
180 Q-MATIC AB 087.01E
Send data
This is the maximum number of times that Q-WIN tries to send data to a unit. Default value: 5,
minimum value: 1, maximum value: 100.
These settings are used to enable the events that Q-WIN use in the communication with other
applications.
Event Scripts
This script is executed when the corresponding event occurs. Q-WIN returns the result of the
script and the event number.
Run Scripts are executed with the API command RUN. A number that identifies the scripts is
used as an argument to RUN.
Event settings
Run script
Host
087.01E Q-MATIC AB 181
Run scripts
The number of scripts. Increase the number of programs by 1 to add a script.
Script
The corresponding script program.
System script
This script program is executed once in the second while Q-WIN is running. This is the only
script program that is always executed. Script programs connected to units are only executed
when the units are active.
Use this script program for scripts that must be executed even if the rest of the system is
not active. Example of use:
Reset the Array.
Send automatic email messages (Q-MATIC Mail).
System script
Date and time
Q-WIN Reference Manual - Vol 1, Basic
182 Q-MATIC AB 087.01E
am/pm
Set the check mark to use Am/Pm time format otherwise Q-WIN will use the 24-hour format.
Date format
Select one of the date formats.
Turning off displays
This is the time that the displays stay lit when the system is inactive. Then the system
automatically turns off all displays.
Max: 1400 minutes
Min: 1 minute
Backup
In the Data folder there are data files (.dat) that store information from the system. This
information makes it possible to continue after a break. For example, the data files save the ticket
numbers. The waiting customers are still in the queue when Q-WIN restarts after a break.
This setting specifies the time in seconds between each backup.
Max: 1000 seconds
Min: 1 second
Daily reset
The daily reset removes all remaining waiting customers and the ticket numbers and the track
number restart from the start value.
The track number is a unique number for each customer. This is necessary because it is possible
for two customers in the same category to get the same ticket number. The ticket number
restarts when it has reached the last number in the sequence. This makes it possible for the same
ticket number to appear twice.
The setting specifies the hour for the reset. Default is at 1:00 am. Set the setting to 0 to disable
the daily reset.
The Test daily reset button simulates a daily reset with one exception, the track number does
not restart. This button is used to test the system.
087.01E Q-MATIC AB 183
17. Licence
Topics in this chapter
Locking an application to a Q-WIN client .................................... 184
Q-WIN Reference Manual - Vol 1, Basic
184 Q-MATIC AB 087.01E
The licence settings make it possible to dedicate an application to a specific client. Normally the
user group policy specifies the users with access to an application. The user can open the
application from any Q-WIN client. No more users can open the application when all licences
for the application are locked. This can result in problems if there are more users with access to
an application than there are licences.
Use these settings to be sure than an application is always accessible from a specific client. The
user cannot open the application from any other Q-WIN clients than those specified in these
settings.
Select "Licens" in the System configuration window.
Select an application in the tree.
Click Add client.
Enter the client ID of the Q-WIN client as specified in the qwin.ini file.
Click Save.
Locking an application to a Q-WIN client
087.01E Q-MATIC AB 185
18. Matters
Topics in this chapter
Matters give detailed information ............................................... 186
Adding matters............................................................................ 186
Editing matters ............................................................................ 187
Remove matters........................................................................... 187
Using matters at the workstation ................................................ 187
Q-WIN Reference Manual - Vol 1, Basic
186 Q-MATIC AB 087.01E
Ticket buttons are the types of services that the customers can choose. This is usually not very
detailed information. You know that you had a private customer that wanted counter service but
what kind of counter service? This is when you use matters.
Matters split the selected service into detailed information. You get exact information about the
service given to the customers.
Select Matter codes in the System configuration window.
Click Matter Codes in the levels tree.
Click Add Matter code.
Enter the matter name. This name will be used in, for example, statistics reports.
Enter an id for the matter. This id is used at the KT2595 workstation to identify the matter.
Software terminals use the matter name.
Matters give detailed information
Matters
Maximum number of matters: 10000
Maximum matter code: 9999
Adding matters
Matters
087.01E Q-MATIC AB 187
Enter a transaction time for the matter. This time is used in Q-MATIC Calendar and Q-
MATIC Client Terminal.
It can be difficult to know the transaction time for a matter. You can use Q-WIN to improve
this setting. Enter a time that you think is a correct time. Use Q-WIN for some weeks then print
a Statistics Report that shows the transaction times for the matters. Now you have exact
information about the average transaction time for all matters.
Click Save to save the settings.
Select Matter codes.
Click Matter Codes in the settings tree.
Click the matter name for the matter that you want to edit.
Enter the new information.
Click Save to save the settings.
Select Matter codes.
Click Matter Codes in the settings tree.
Click "Delete" to the right of the matter you want to delete. The matter is immediately
deleted.
Be careful if you delete mattes in a system that is used. The matter is still stored in the
statistics and you will get faulty statistics reports. We recommend that you only delete matters
during the installation and set-up of the system. In running systems you should not delete any
matter. You can instead change the matter code to a value that is not used. The matter is
deactivated but can still be included in statistics reports with old statistics.
It is at the workstation that you specify the matter. The way to select a matter depends on the
type of workstation terminal.
Editing matters
Remove matters
Using matters at the workstation
Q-WIN Reference Manual - Vol 1, Basic
188 Q-MATIC AB 087.01E
There are two workstation functions for matters:
FUNC_MATTER and FUNC_MATTER_PRESET.
FUNC_MATTER is the default function for KT2595. The matter code is entered after the
matter has been served.
The matter code must be entered before the matter is served if FUNC_MATTER_PRESET is
used.
087.01E Q-MATIC AB 189
19. Multi interface
Topics in this chapter
Multi interfaces............................................................................ 190
General multi interface settings................................................... 190
Interface group settings Internal programs.................................. 191
Internal programs for the input pins............................................ 192
Internal program commands ....................................................... 193
Interface group settings Script programs..................................... 195
Input script programs .................................................................. 196
Output programs ......................................................................... 197
Interface group settings RS232.................................................... 197
Radio Interface ............................................................................ 198
Q-WIN Reference Manual - Vol 1, Basic
190 Q-MATIC AB 087.01E
Use multi interfaces to connect devices that do not use Q-MATIC communication to the system.
There are two types of Multi interfaces and three types of settings.
MI2280 is a multi interface with eight inputs and eight outputs. Both the inputs and the outputs
have two levels: on or off. There are two types of settings for the MI2280: internal program or
script program.
Internal programs are executed in the Multi interface. This is very quick but there are only a few
commands that can be used in internal programs.
Script programs are slower but much more flexible. The signal from the Multi interface input is
sent to the Q-WIN server. The Q-WIN server executes the script program.
SI2477 is a serial interface for RS232 communication.
Select "Multi interfaces" in the System configuration window.
Number of interfaces
The number of interfaces.
ID code
All multi interfaces have the same ID code, use the Sub ID code to identify the multi interface.
Sub ID code
This is the sub ID code for the first multi interface.
Multi interfaces
Multi interface
Maximum number of Interfaces: 99
Minimum Sub ID Code: 0
Maximum Sub ID Code: 1000
Default ID Code: 121
General multi interface settings
Multi interface
087.01E Q-MATIC AB 191
Multi interfaces using internal programs are faster but less flexible than interfaces using script
programs. The MI2280 can use both internal programs and script programs.
The interface group has three sublevels in the settings tree: interfaces, inputs and outputs.
Interfaces are the single interfaces in the system. The number of interfaces is specified in the
general multi interface settings.
The number of inputs and outputs is specified in the interface group settings.
Interface type
The interface type. There are three possibilities.
Internal programs
Script programs
RS232 (SI2477)
Number of inputs
This setting specifies the number of inputs that are used. For each input an entry is added to the
interface group.
Interface group settings Internal programs
Q-WIN Reference Manual - Vol 1, Basic
192 Q-MATIC AB 087.01E
Number or outputs
This is the number of outputs that are used. For each output an entry is added to the interface
group.
Disable Radio Receiver
Set the check mark to disable the radio interface. The radio receiver setting is usually enabled
(no check mark) because multi interfaces without radio receivers ignore the setting. Set the
check mark if the system has radio interfaces that should not receive signals from wireless
terminals.
Internal programs are executed in the multi interface, which makes them faster than script
programs. Internal programs can be used together with MI2166 or MI2280. Internal programs
can only be used at the inputs.
The script field is used together with the SCRIPT command.
Select an interface group using internal programs.
Specify the number of input pins or click Add inputs.
Write the program for the input pins. Use the internal program commands that are described
below. Select an input from the tree and enter the program.
You cannot use the Test button on internal programs for multi interfaces. The test will
always return an error because it can only test Q-WIN scripts.
Click Save to save the settings.
Internal programs for the input pins
Multi interface
087.01E Q-MATIC AB 193
These commands can only be used in internal programs for the input pins on the multi interface.
They cannot be used in script programs. The internal program is always one line with one
program command.
CLEAR_GROUP,a,b,c
Remove all ticket numbers in a category.
Arguments
a The time, in 0.01 second units, that the button must be pressed before it is detected.
Recommended value, 50 ( second).
b The time, in 0.01 second units, that the button must be released before a new signal
can be detected. Recommended value, 50 ( second).
c The category number.
CLOSE,a,b,c
Close a workstation.
Arguments
a The time, in 0.01 second units, that the button must be pressed before it is detected.
Recommended value, 50 ( second).
b The time, in 0.01 second units, that the button must be released before a new signal
can be detected. Recommended value, 50 ( second).
c The workstation number.
MAKE_TICKET,a,b,c
Create a new ticket number without printing a ticket.
Arguments
a The time, in 0.01 second units, that the button must be pressed before it is detected.
Recommended value, 0.
b The time, in 0.01 second units, that the button must be released before a new signal
can be detected. Recommended value, 0.
c The ticket button number.
NEXT,a,b,c,d
Call a customer to a workstation.
Arguments
a The time, in 0.01 second units, that the button must be pressed before it is detected.
Recommended value, 50 ( second).
Internal program commands
Q-WIN Reference Manual - Vol 1, Basic
194 Q-MATIC AB 087.01E
b The time, in 0.01 second units, that the button must be released before a new signal
can be detected. Recommended value, 50 ( second).
c The workstation number.
d The priority number.
PRINT_TICKET,a,b,c,d
Print a ticket on a ticket printer.
Arguments
a The time, in 0.01 second units, that the button must be pressed before it is detected.
Recommended value, 0.
b The time, in 0.01 second units, that the button must be released before a new signal
can be detected. Recommended value, 0.
c The ticket printer number.
d The ticket button number.
SCRIPT,a,b,c
Start a script program. Use the Input Script Program field for the script program.
Arguments
a The time, in 0.01 second units, that the button must be pressed before it is detected.
Recommended value, 50 ( second).
b The time, in 0.01 second units, that the button must be released before a new signal
can be detected. Recommended value, 50 ( second).
c The script program number in the "No. Script Program" list.
SENSOR,a,b,c,d,e
The multi interface is connected to a sensor that checks if there are any customers in front
of the workstations. The workstation will automatically call a customer if there is no
one in front of the workstation.
Arguments
a The time, in 0.01 second units, a customer has to stand in front of the sensor until it
indicates the presence of the customer. Recommended value, 500 (5 seconds).
b The time, in 0.01 second units, there must be no customer in front of the
workstation before the multi interface calls the next customer. Recommended value,
500 (5 seconds).
c The workstation number.
Multi interface
087.01E Q-MATIC AB 195
d The delay, in 0.01 second units, before the system tries to call a new customer if it
fails to call a customer. Recommended value, 20 (0,2 seconds).
e The ticket button from which ticket numbers are taken for customers who walk
directly to the workstation without taking any tickets. This makes it possible to
include these customers in the statistics. This function only works if there are no
other waiting customers. If e=0 this function is off, e=1 function is on.
SEQUENCE,a,b,c
Two light beam sensors are connected to the multi interface. They are located at the
entrance of a waiting line in a system without tickets. The customer is registered
when he/she passes the two light beams in the right direction.
Arguments
a The minimum time, in 0.01 second units, between each phase when a customer
passes through the two sensors. Recommended value, 0.
b The time, in 0.01 second units, both sensors must be on. Recommended value, 0.
c The ticket button number for which the customers are recorded. Sensor two must
be connected to an input specified as NEXT.
The script programs type of multi interfaces are very flexible but they are not as fast as the multi
interfaces that use internal programs.
Interface group settings Script programs
Q-WIN Reference Manual - Vol 1, Basic
196 Q-MATIC AB 087.01E
The interface group has three sublevels in the settings tree: interfaces, inputs and outputs.
These script programs are executed when there is a signal at an input pin. It is a normal script
program executed in the Q-WIN server.
Adding programs
Select an interface group.
Specify the number of inputs or click the Add inputs button.
Select an input pin from the settings tree. There are two entries for each input pin. The first
entry is executed if the input signal is very short, a click. The second entry is executed if the
input signal lasts for two seconds or more.
Enter the script program.
Input script programs
Multi interface
087.01E Q-MATIC AB 197
Click Save to save the settings.
The output programs are the same for interfaces that use internal programs and interfaces that
use script programs. The output program is always a script program executed in the Q-WIN
server. The output pin is off when the result of the script program is 0, otherwise the output pin
is on.
These are the settings for the SI2477 serial interface when it is used as a general RS232 interface.
The SI2477 serial interface can also be used as a card reader interface.
Interface type
The interface type. There are three possibilities.
Internal programs
Script programs
RS232 (SI2477)
Input script
The input script program. Use the INTERFACE_RS232_INPUT script function to read the
information at the input. The result is a string that can be saved in a variable
(A= INTERFACE_RS232_INPUT) or in the Array
(SETARRAY (12 INTERFACE_RS232_INPUT)).
Output script
The output script program. The result of the program is sent as a string to the device connected
to the RS232 interface. It is also possible to send some commands to the Interface.
Output programs
Interface group settings RS232
Q-WIN Reference Manual - Vol 1, Basic
198 Q-MATIC AB 087.01E
Interface commands
I End of commands. The next characters are the output string and they should be sent to
the device connected to the interface.
LO Turn off the LEDs and the relay.
SBE Beep the buzzer.
SGL Turn on the green LED.
SRE Turn on the relay.
SRL Turn on the red LED.
Example
"SGL I 12345"
Turn on the green LED on the Interface. Send the string "12345" to the device connected to the
RS232 interface.
The radio interface is a MI2280 multi interface with a radio receiver. The radio interface is used
together with the wireless terminals. There is only one setting in the multi interface settings. All
other settings are in the wireless terminal settings.
Disable Radio Receiver
Set the check mark to disable the radio interface. The radio receiver setting is usually enabled
(no check mark) because multi interfaces without radio receivers ignore the setting. Set the
check mark if the system has radio interfaces that should not receive signals from wireless
terminals.
Radio Interface
087.01E Q-MATIC AB 199
20. Q-MATIC Pager
Topics in this chapter
Introduction................................................................................. 200
General Pager settings................................................................. 200
Pager unit settings....................................................................... 201
Pager script.................................................................................. 202
Q-WIN Reference Manual - Vol 1, Basic
200 Q-MATIC AB 087.01E
An indoor pager system can be connected to a Q-WIN system with Q-WIN Pager licence. Q-
WIN can send several types of information to the pager. It might be when there is an alarm, when
a customer arrives for an appointment or any other type of information. The pagers are standard
models, for example Motorola. Q-WIN supports the JTech Communication, INC. radio
transmitter.
A serial cable connects the radio transmitter to one of the COM ports on the PC.
The FUNC_PAGER script command uses the information in the pager settings. The command
needs two arguments, a script program and a pager unit. The script program specifies the
information sent to the pager and the pager unit specifies the pager that will receive the
information.
Select "Pager Interfaces" in the System configuration window to open the settings.
Number of pagers
This is the number of pagers in the system.
Number of Script Programs
The umber of pager scripts.
Communication
This is the setting for the COM port. The format is port,speed,bits,parity,stop bits.
Example: 2,1200,8,N,1.
Introduction
General Pager settings
Q-MATIC Pager
TM
087.01E Q-MATIC AB 201
There must be one pager unit setting for each pager connected to the system.
Name
The pager's name.
Cap code
This is the pager's address.
7 bytes cap code
Set the check mark if the pager uses a cap code address with seven bytes. Remove the check mark
if the pager uses a cap code with three bytes.
Inverted signal
Set the check mark if the signal between the transmitter and the pager should be inverted.
Alphanumerical pager
Set the check mark if the pager can show text.
Priority type
The following four check marks handles the priority signal that can be attached to the message.
The first two settings are for numerical pagers and the last two are for alphanumerical pagers.
Baud rate
This is the baud rate of the radio transmission.
Pager unit settings
Q-WIN Reference Manual - Vol 1, Basic
202 Q-MATIC AB 087.01E
The script programs specify the message sent to the pagers. A number identifies the script. This
script number is one of the parameters used by the FUNC_PAGER script command. The other
parameter is the pager unit number.
Pager script
087.01E Q-MATIC AB 203
21. Priorities
Topics in this chapter
Introduction................................................................................. 204
Priority settings............................................................................ 204
Editing priority settings................................................................ 205
Using priorities ............................................................................ 206
Statements................................................................................... 207
Category greater than X .............................................................. 208
Category greater than X % of Category....................................... 210
Category greater than X % of Ticket Button................................ 212
Ticket Button greater than X........................................................ 213
Ticket Button greater than X % of Category................................ 214
Ticket Button greater than X % of Ticket button ......................... 215
Customers waiting in Categories From - To................................. 216
Test if a Person Choice Customer is waiting................................ 217
Alternate true X times and false Y times ..................................... 218
Select a Customer from a Category ............................................. 219
Select a Customer from a Ticket Button....................................... 220
Select a Person Choice Customer................................................. 221
Select by level .............................................................................. 222
Select the highest value by level.................................................. 225
Select the highest value............................................................... 226
Select in priority sequence........................................................... 227
Test if selection can be made....................................................... 228
Select by script program.............................................................. 229
Test if a Workstation Choice Customer is waiting ....................... 230
Select a Workstation Choice Customer ........................................ 231
Workstation open From - To........................................................ 232
Between Time of Day From - To................................................... 233
Jump to line by Script Program.................................................... 234
Web priority settings ................................................................... 234
Q-WIN Reference Manual - Vol 1, Basic
204 Q-MATIC AB 087.01E
Priorities specify which customers a workstation should serve. The priorities can be used to
create a very flexible and efficient system. Use priorities to make sure that all customers are
served within the shortest possible time.
A workstation can serve many categories. The priority can automatically select customers from
the category with the longest waiting time. It can also select customers from another category if
there are no customers waiting in the category normally served by the workstation.
The priority number identifies the priority. This number is used to select a workstation's priority.
Select "Priority Settings" from the Utilities menu to open the priority settings.
Number of priorities
This is the number of priority settings.
Max: 255
Min: 1
No. Name
This is a list with all priority settings.
Select a setting and click Edit Name to change the name of the setting.
Select a setting and click Edit Settings to edit the setting.
Introduction
Priority settings
Priorities
087.01E Q-MATIC AB 205
A priority setting consists of priority statements, one statement on each line in the settings. The
editor is line based. You can add or remove lines.
The top of the dialogue shows the lines. Each line has a line number. The bottom of the dialogue
shows the currently selected statement and its parameters. The contents depend on the selected
statement.
All statements and arguments are selected from drop down lists.
The execution of the statements always starts with the statement on the first line. The statements
are executed every time they are used at a workstation terminal. The result of the executions is
that a customer is called.
Click Add to add more lines to the priority settings. The new line is added under the selected
line. Click the line. It is now possible to change the settings for the line.
Select a line and click Remove to delete it from the settings.
It is very complicated to create priorities with more than about five lines, especially if they
contain jumps. Use script programs instead of priority statements for complicated priorities.
Jumps
Some statements result in FALSE or TRUE. These statements are used for jumps. Jumps are
based on the line number. You must specify a line number that will be executed when the result
of the statement is TRUE and another line number when the result is FALSE.
Editing priority settings
Q-WIN Reference Manual - Vol 1, Basic
206 Q-MATIC AB 087.01E
Priorities are always used when ticket numbers are called.
It is very important that a workstation use correct priority. Make sure that it is easy for the
user to use correct priority. The best solution might be to automatically assign a priority to a
workstation or staff member (see below).
Be careful when ticket numbers are transferred. The original ticket button number is not
changed. Make sure that the priority can call the ticket numbers after they have been transferred.
Workstation terminal
It is usually possible to select priority from the workstation terminal. This makes the system very
flexible but it is very important that the staff members can handle the selection.
Workstation settings
In the workstation settings it is possible to lock a workstation to a priority. A locked priority
cannot be changed from the workstation terminal.
Using priorities
Priorities
087.01E Q-MATIC AB 207
Staff member
It is possible to select priorities for the staff members in the staff member registration. The staff
member will automatically get this priority at login. The priority is not locked and it is still
possible to select the priority from the workstation terminal.
This selection is disabled if the workstation is locked to a priority.
The rest of the chapter describes the different priority statements.
Some settings are used by many of the priority statements. They are listed here.
"Based on" specifies a system value used for comparison in the statement. The following values
are available.
Customers Waiting The number of waiting customers for the selected category or
ticket button.
Estimated Waiting Time The estimated waiting time for the selected category or ticket
button.
Actual Waiting Time The real waiting time for the selected category or ticket button.
Open Workstations The number of open workstations serving the selected category
or ticket button.
Statements
Q-WIN Reference Manual - Vol 1, Basic
208 Q-MATIC AB 087.01E
Waiting/Workstation The number of customers waiting per open workstation serving
the selected category or ticket button.
Customers waiting can be called The number of waiting customers, blocked customers are
ignored.
Actual waiting time can be calledThe real waiting time, blocked customers are ignored.
Compare a value from the selected category (Based on) with a specified value (Grater than). The
statement returns TRUE if the value from the category is greater than the specified value
(Greater than). Use Based on to specify the value from the category. The value from the
category is compared with the constant value entered in the Greater than field.
Example
The priority order in the example is the following.
It there are more than five customers waiting in category 1 the next customer will be called from
category 1. The next customer will be from category 2 if there are five customers or less waiting
in category 1 and there are customers in category 2.
Click Add until there are five lines in the settings.
Click the first line.
Choose the "Category greater than X" statement.
Choose "Customer Waiting" in the Based on field.
Category greater than X
Priorities
087.01E Q-MATIC AB 209
Choose category 1.
Enter 5 in the Greater than field.
Enter 2 in the "Go to line when statement is true" field. Line 2 will be executed when there
are more than five waiting customers in category 1.
Enter 3 in the "Go to line when statement is false" field. Line 3 will be executed when there
are five or less waiting customers in category 1.
Click line two. Choose the statement that will be executed when there are more than five
waiting customers in category 1. We want to call customers from category 1. These are the
settings for the statement.
Click line three. Choose the statement that will be executed if there are five or less waiting
customers in category 1. Check first that there are waiting customers in category 2. These are
the settings for line three.
Click line four. Line four will call customers from category 2. These are the settings for line
four.
Q-WIN Reference Manual - Vol 1, Basic
210 Q-MATIC AB 087.01E
Click line five. Line five should call customers from category 1. This line is executed when
there are no customers in category 2. These are the settings for line five.
Compare a value from one category with a part of a value from another category.
Use the "Based on" field to specify the value that will be used in the comparison. The same type
of value will be used from both categories.
Enter at "Compared to X percent of" the percentage of the value from the second category that
will be used in the comparison.
Example
We want the waiting time in category 1 to be of the waiting time in category 2.
Category greater than X % of Category
Priorities
087.01E Q-MATIC AB 211
Enter the following settings for line 1.
Enter the following settings for line 2.
Enter the following settings for line 3.
Q-WIN Reference Manual - Vol 1, Basic
212 Q-MATIC AB 087.01E
Compare a value from one category with a part of a value from one ticket button.
Use the "Based on" field to specify the value that will be used in the comparison. The same type
of value will be used from both the category and the ticket button.
Enter at "Compared to X percent of" the percentage of the value from the ticket button that will
be used in the comparison.
Category greater than X % of Ticket Button
Priorities
087.01E Q-MATIC AB 213
Compare a value from one ticket button with a fixed value.
Use the "Based on" field to specify the value that will be used in the comparison.
Enter at "Greater than" the fixed value that will be compared with the value from the ticket
button.
Ticket Button greater than X
Q-WIN Reference Manual - Vol 1, Basic
214 Q-MATIC AB 087.01E
Compare a value from one ticket button with a part of a value from one category.
Use the "Based on" field to specify the value that will be used in the comparison. The same type
of value will be used from both the ticket button and the category.
Enter at "Compared to X percent of" the percentage of the value from the category that will be
used in the comparison.
Ticket Button greater than X % of Category
Priorities
087.01E Q-MATIC AB 215
Compare a value from one ticket button with a part of a value from another ticket button.
Use the "Based on" field to specify the value that will be used in the comparison. The same type
of value will be used from both ticket buttons.
Enter at "Compared to X percent of" the percentage of the value from the second ticket button
that will be used in the comparison.
Ticket Button greater than X % of Ticket button
Q-WIN Reference Manual - Vol 1, Basic
216 Q-MATIC AB 087.01E
Test if there are any waiting customers in the selected categories.
The specified span of categories is based on the category number, not the category name.
Example
We want to call customers from category 2 or category 3 if there are any waiting customers in
these categories otherwise we want to call customers from category 1.
The first line checks if there are any customers waiting in category 2 or 3.
Customers waiting in Categories From - To
Priorities
087.01E Q-MATIC AB 217
The second line will call customers from category 2 and category 3. It uses the "Select by level"
statement which is explained later in this chapter.
Line three is executed if there are no customers in category 2 or 3. This line calls a customer from
category 1.
The line is TRUE if there is a person choice customer waiting.
Test if a Person Choice Customer is waiting
Q-WIN Reference Manual - Vol 1, Basic
218 Q-MATIC AB 087.01E
Alternate between two lines.
The settings specify the number of times the statement will return TRUE and FALSE. The
statement returns TRUE the number of time specified in the settings then it starts to return
FALSE. The statement restarts to return TRUE when it has returned FALSE the specified
number of times.
Alternate true X times and false Y times
Priorities
087.01E Q-MATIC AB 219
Call a ticket number from the specified category. Choose the ticket buttons that should be
included in the priority.
The selected ticket buttons must be in the selected category otherwise it will be impossible
to call any ticket numbers.
Select a Customer from a Category
Q-WIN Reference Manual - Vol 1, Basic
220 Q-MATIC AB 087.01E
Call a ticket number from the selected ticket button.
Select a Customer from a Ticket Button
Priorities
087.01E Q-MATIC AB 221
Call a person choice customer.
Select a Person Choice Customer
Q-WIN Reference Manual - Vol 1, Basic
222 Q-MATIC AB 087.01E
This statement creates a list that specifies the priority for the included ticket buttons. The list
contains the ticket buttons and their priority levels. All ticket numbers from priority level 1 will
be served before any ticket numbers are called from level 2, all from level 2 before level 3, etc.
The calls will be evenly distributed among ticket buttons with the same priority level.
"Based on" is only used to check if there are any waiting customers for the ticket button. We
recommend that you use "Actual Waiting Time can be called". Ticket numbers from ticket
buttons with the same priority level are always evenly called no matter the value returned by
"Based on".
Use "Actual Waiting Time can be called" instead of "Actual Waiting Time". There is a risk
that customers with the same waiting time are called in reverse order if "Actual Waiting Time"
is used.
Priority level settings
Click Settings to open the priority level settings.
Select by level
Priorities
087.01E Q-MATIC AB 223
The priority level settings specify the ticket buttons included in the priority and their priority
levels.
Level, Ticket Button
This is the priority list. Ticket buttons with level 1 will be served first, then level 2, etc.
Click Add to add a ticket button to the priority list.
Click Remove to remove the selected ticket button from the priority list.
Level
This is the priority level for the selected ticket button.
Ticket Button
Select a line in the priority list, then choose a ticket button. The ticket button is inserted into the
list at the selected position.
Example
We have three ticket buttons: 1, 2 and 3. Customers from ticket button 2 and 3 should always
be served before customers from ticket button 1.
Choose "Select by level" for the first line in the priority settings.
Click Settings.
Q-WIN Reference Manual - Vol 1, Basic
224 Q-MATIC AB 087.01E
Click Add three times to add three ticket buttons to the priority list.
Select the first line.
Select ticket button 2 from the Ticket Button list.
Check that the priority level for ticket button 2 is 1.
Select line two in the priority list.
Select ticket button 3 from the Ticket Button list.
Check that the priority level for ticket button 3 is 1.
Select the last line in the priority list.
Select ticket button 1 from the Ticket Button list.
Change the priority level to 2 for ticket button 1.
Click OK.
Priorities
087.01E Q-MATIC AB 225
"Select the highest value by level" is almost the same as the "Select by level" statements (see the
previous statement). The "Based on" values are used in a different way. Create a priority list as
described for "Priority by level". If two or more ticket buttons have the same priority level, the
one with the highest "Based on" value will be served. The selection of the ticket buttons is first
based on the priority level than on the "Based on" value.
Select the highest value by level
Q-WIN Reference Manual - Vol 1, Basic
226 Q-MATIC AB 087.01E
Create a list with ticket buttons. The ticket buttons are compared with each other and a ticket
number is called from the ticket button with the highest "Based on" value.
Click Settings to create the priority list. It is not possible to specify any priority level in the
priority list. The priority is only based on the "Based on" value.
Select the highest value
Priorities
087.01E Q-MATIC AB 227
Specify a priority list. The first ticket button in the list will be served until there are no more
customers then the second ticket button in the priority list will be served, etc. "Based on" is only
used to check if there are any waiting customers for a ticket button.
Click Settings to edit the priority list.
Select in priority sequence
Q-WIN Reference Manual - Vol 1, Basic
228 Q-MATIC AB 087.01E
Test if there are any customers that can be called. The statement does not call any customers. It
must be combined with other statements that call ticket numbers.
Choose a category and the ticket buttons that will be tested. Choose the lines that will be
executed when the statement returns TRUE or FALSE.
The selected ticket buttons must be included in the selected category.
Test if selection can be made
Priorities
087.01E Q-MATIC AB 229
Use a script program to specify the ticket button.
Click Script to edit the script.
Select ticket button by Script Program's result
The value returned by the script program is used as the ticket button number from which the
next customer will be called. The returned value must be a valid ticket button number.
Goto Line by script program's result
The script program specifies the next line to be executed in the priority settings. The returned
value must be a line number in the priority settings.
Select by script program
Q-WIN Reference Manual - Vol 1, Basic
230 Q-MATIC AB 087.01E
Program value
The script program must return an integer. The value is assigned to the PRIORITY_VALUE
script function. Use PRIORITY_VALUE in other script programs, for example to get the sum of
all waiting customers for all categories in a priority.
This statement tests if there are any workstation choice customers. The statement does not call
any customers. It must be combined with other statements that call ticket numbers.
Test if a Workstation Choice Customer is waiting
Priorities
087.01E Q-MATIC AB 231
Call workstation choice customers.
Select a Workstation Choice Customer
Q-WIN Reference Manual - Vol 1, Basic
232 Q-MATIC AB 087.01E
Test if the selected workstations are open. The statement does not call any customers. It must
be combined with other statements that call ticket numbers.
Workstation open From - To
Priorities
087.01E Q-MATIC AB 233
The statement returns TRUE if the clock is between the specified hours. The statement does not
call any customers. It must be combined with other statements that call ticket numbers.
Between Time of Day From - To
Q-WIN Reference Manual - Vol 1, Basic
234 Q-MATIC AB 087.01E
The result of the script program is the next line that will be executed.
Click Edit Script and enter the script program. The script program must be entered in the "Goto
line by Script Program's result" textbox. The result must be a valid line number.
Some types of priority settings can be made in the System configuration window:
Select a customer from a category
Select by level
Select the highest value by level
Select a button by script
Jump to line by Script Program
Web priority settings
Priorities
087.01E Q-MATIC AB 235
The settings are made in the same way as the settings above, with the Priority Settings in the
Utilities menu.
Q-WIN Reference Manual - Vol 1, Basic
236 Q-MATIC AB 087.01E
087.01E Q-MATIC AB 237
22. Security
Topics in this chapter
Password settings........................................................................ 238
Q-WIN Reference Manual - Vol 1, Basic
238 Q-MATIC AB 087.01E
The password settings specify the security level for the login. They also specify the rules for new
passwords. The passwords are encrypted and stored in the database.
Select "Security" in the System configuration window.
Do not activate the login function before user names and passwords are specified in the staff
member database otherwise it will be impossible to login to Q-WIN.
Select "Security" in the Server tree.
Policy
The policy settings specify the rules for new passwords. The restrictions can be combined with
each other.
Passwords are only checked when they are entered as new passwords. Already specified
passwords are not checked if the policy is changed.
Complex password
The passwords must consist of small letters, capital letters and digits.
Example
AB12cd
Password settings
Security
087.01E Q-MATIC AB 239
Unique password
Two staff members cannot use the same password.
Not numerics at start or end
The passwords cannot start or end with a digit.
Example
Valid: abcd, ab123cd, A2b3cD
Invalid: 1abc, 1234, abcd3
Not username
The user name and the password must be different.
No consecutive characters
The same character cannot be placed together in the passwords.
Example
Valid: 1234, ulan, AbcD1, abab
Invalid: aabcde, password, 123321
Not a dictionary word
It is possible to specify a dictionary with reserved words in the database. These words cannot be
used as passwords if this setting is enabled.
The dictionary is stored in the PSWDICT table in the Q-WIN database. Use for example
Microsoft Access to edit the dictionary.
No part of a dictionary word
The passwords cannot contain a dictionary word.
Example
Dictionary words: ulan
Valid passwords: lan, ulab. Nalu
Invalid passwords: ulan, abculan, ulanic, 123ulan567
Not possible to changed after it has expired
It is possible to specify a time limit for passwords (see below). The user cannot change the
password when it has expired.
Log passwords
All logins will be saved in the password.log file in the Log folder.
Time limit
It is possible to specify a time limit for all passwords. The "A password cannot be changed by a
user after it has expired" setting above specify what will happen when the password is older than
the limit.
Q-WIN Reference Manual - Vol 1, Basic
240 Q-MATIC AB 087.01E
The password must be changed before it is older than the time limit if the "A password cannot
be changed by a user after it has expired" setting is enabled otherwise it will be impossible for
the user to login. This is a guarantee that all passwords are regularly reviewed.
The user is asked to enter a new password if the "A password cannot be changed by a user after
it has expired" setting is disabled and the password is too old.
Max: 365 days
Min: 0 (no limit)
Minimum length
This is the minimum length of the password.
Max: 50 characters
Min: 0 characters
Used passwords
This setting prevents the user from using the same password a second time. Q-WIN will
remember which passwords the user has used in the past. This setting specifies how many old
passwords Q-WIN compares with the new password. The new password is only accepted if Q-
WIN does not find it among the old passwords.
Max: 50
Min: 0 (disabled)
Maximum number of log-on attempts
The user can try invalid passwords the specified number of times, then the application is blocked.
It is not possible to login while the application is blocked, not even with a valid password. The
next setting specifies the duration of a block. Set to 0 to disable the block.
Max: 50
Min: 0 (disabled)
Blocking time
This is the duration of the block if the previous setting is enabled. Set to 0 to disable the block.
Max: 50 minutes
Min: 0 (disabled)
The new password must differ from the old one
A password cannot contain this amount or more characters from the previous password. This
setting prevents the user from specifying a new password that is too similar to the old one.
Max: 50
Min: 0 (disabled)
Expired warning
Warn the user before the password has expired.
087.01E Q-MATIC AB 241
23. Scheduled activities
Topics in this chapter
Starting an action at a pre-set time ............................................. 242
Adding a new scheduler setting .................................................. 242
Editing a scheduler setting .......................................................... 244
Delete a scheduler setting ........................................................... 244
Exclude days................................................................................ 244
Q-WIN Reference Manual - Vol 1, Basic
242 Q-MATIC AB 087.01E
The scheduler makes it possible to perform an action at a specific time. The scheduler is used
together with the SCHEDULE(n) script function. The scheduler specifies when
SCHEDULE(n) will return TRUE or FALSE. SCHEDULE(n) will return TRUE on all time
periods specified in the scheduler.
Select "Scheduled Activities" in the System configuration window.
Click Scheduled activities in the levels tree.
Click Add new activity.
Select the new scheduler setting in the Settings tree.
Enter the name of the scheduler setting.
Click Add new item to change the settings.
Starting an action at a pre-set time
Scheduler
Maximum number of schedule settings: 999
Script function used with scheduler: SCHEDULE (schedule_number)
Adding a new scheduler setting
Scheduled activities
087.01E Q-MATIC AB 243
Select the new setting from the Settings tree. The scheduler setting will return TRUE when
one or more of the sub levels in the settings tree are true.
Specify the date when the scheduler setting should be true. The following options are
available.
Specify the time span when the scheduler setting should be true. The time is used together
with the date setting above.
Click Save to save the setting.
The setting is added to the scheduler. You can continue to add more sub settings to the
settings tree. The scheduler setting will return TRUE when any of the settings is true.
Add the SCHEDULE(n) function to a script program. SCHEDULE(n) returns TRUE when
the scheduler setting is true. The scheduler setting number is used as argument to
SHEDULE(n).
Every Day The scheduler will be true every day.
Date The scheduler will be true only on the specified date.
Day in Month The scheduler will be true at the specified days in the month.
Day in Week The scheduler will be true on the selected weekday.
First Day in Month The scheduler will be true the first day in every month.
Q-WIN Reference Manual - Vol 1, Basic
244 Q-MATIC AB 087.01E
Select "Scheduled Activities" from the Server tree.
Select the scheduler setting in the Settings tree.
Click the settings you want to change.
Edit the settings.
Click Save to save the settings.
You cannot delete a specific setting. It is possible to decrease the number of settings but you
cannot choose which setting you want to remove. Usually you do not have to remove a setting.
Instead you edit the script program where it is used.
Be careful if you decrease the number of scheduler settings. It is always the last setting in
the list that is removed. Make sure that the scheduler setting is not used in any script program
otherwise you will get an error.
The scheduler makes it possible to exclude moths or weeks from the schedule. The scheduler
will never return TRUE during excluded moths or weeks. This can, for example, be used during
the summer holiday.
The scheduler makes it only possible to exclude whole months or one span of weeks. Use
the script program to exclude other combinations of dates.
Editing a scheduler setting
Delete a scheduler setting
Exclude days
087.01E Q-MATIC AB 245
24. Ticket printer
Topics in this chapter
Ticket printer together with Q-WIN ............................................. 246
General ticket printer setting....................................................... 246
Ticket printer group settings........................................................ 247
Ticket printer settings .................................................................. 249
Q-WIN Reference Manual - Vol 1, Basic
246 Q-MATIC AB 087.01E
All Q-WIN systems except Q-MATIC Ticketless must contain at least one ticket printer. Q-
MATIC Ticketless is a Q-WIN system that you can run without a ticket printer.
Each ticket printer must have a unique ID code.
Select "Printers" in the System configuration window.
Number of printers
The number of ticket printers in the system.
It is important that this is the exact number of ticket printers in the system.
Starting ID code
The ID code for the first ticket printer. The default ID code is 89.
Codepage
Enter the codepage the printer is going to use. The Default to windows code page can be used
for most Western European languages.
Ticket printer together with Q-WIN
Ticket printer
Maximum number of ticket printers: 99
Minimum number of ticket printers: 1
Minimum number of ticket printers for Q-MATIC Ticketless: 0
Default ID code: 89
General ticket printer setting
Ticket printer
087.01E Q-MATIC AB 247
Paper jam detection
The TP3100 family of ticket printers have a paper jam detection and prevention system. To
enable this system, set this check mark; it is set by default.
Q-WIN Ticketless
Set this check mark if there is no ticket printer in the system.
The system requires a Q-WIN Ticketless licence to be able to work without a ticket printer.
Tickets per roll
This is the number of tickets per ticket roll. The ticket counter uses this setting as a start value.
The ticket counter restarts at this value when the paper feed button on the ticket printer is
pressed.
Low tickets alarm
Q-WIN sends alarm 201 when the number of tickets in a ticket printer is less than this value.
The alarm is displayed on all Q-WIN clients.
Be careful to use this alarm. The ticket counter restarts every time the paper feed button is
pressed.
Ticket printer group settings
Q-WIN Reference Manual - Vol 1, Basic
248 Q-MATIC AB 087.01E
Button delay
This is the minimum time that must elapse after a customer has pressed the button and until the
next customer can get a ticket. Never use a delay under three seconds. A shorter delay can result
in the following error in the error log "Error Io, Command Answer, target response NAK due to
over run at input buffer". This message does not cause any malfunction of the system.
Max: 60 seconds
Min: 0 seconds
Access to button number
This is the time that the printer button number is available for the PRINTER_BUTTON and
PRINTER_BUTTON_PUSHED script functions. These functions return 0 after that this time
has elapsed. Set this setting to 0 to keep the ticket button number until the next ticket button is
pressed.
Report unconnected printers
Set the check box to report unconnected ticket printers to the error log. Use this option during
installation but not in a running system.
Auto stop tickets
The ticket counter is described above (number of tickets / ticket roll). Set this check mark to
stop issuing tickets when it is 0.
Button program
This script program is executed when a ticket button is pressed. The result of the script program
is used as the ticket number.
End the script with PRINTER_BUTTON to execute a script but not change the ticket
button number.
Example
We want to identify the VIP customers and separate them from the rest of the customers. This
script checks if a customer is a VIP customer and then adds four to the ticket button number.
The ticket button number is unchanged for the rest of the customers.
This example requires a card reader and a database.
IF(PRINTER_CUSTOMER_ITEM(1 ITEM_VIP) EQ 1)
PRINTER_BUTTON+4
ELSE
PRINTER_BUTTON
Card reader
The card reader settings are described in the card reader chapter. See Additional settings in the
ticket printer settings on page 106.
Ticket printer
087.01E Q-MATIC AB 249
Appointments
The appointment settings are described in the Q-MATIC Calendar Reference manual.
Settings for individual printers are as follows.
Ticket printer name
It is a good idea to give each printer an informative name.
Ticket printer IP Address
Each printer of the TP3100 family must have a unique IP address, it is entered here. Leave this
field empty when using printers of the BP2800 family.
Ticket printer settings
Q-WIN Reference Manual - Vol 1, Basic
250 Q-MATIC AB 087.01E
087.01E Q-MATIC AB 251
25. Transfer
Topics in this chapter
Category transfer...............................................................252
Automatic transfer based on the waiting time ..................252
Category transfer based on a script program.....................253
Network transfer ...............................................................254
Adding a network category transfer ..................................255
Editing a network category transfer ..................................256
Delete a network category transfer ...................................256
Q-WIN Reference Manual - Vol 1, Basic
252 Q-MATIC AB 087.01E
Category transfer automatically transfers waiting customers. For example, if the customer can
choose an adviser then there is a risk that some queues are much longer than the others. The
waiting time soon rises to unacceptable levels. To ignore this is not good customer service. You
want to make it possible for these customers to book appointments with the adviser.
Category transfer is the solution. You specify a transfer based on the number of waiting
customers. When more customers arrive than the adviser can handle are new customers
automatically transferred to a new category that handles the booking of appointments. The
booking category serves customers much faster than the advisers. The customers are informed
that the adviser cannot meet them today but they can book an appointment (with Q-WIN
CALENDAR of course).
The customers do not have to wait for hours to find out that they cannot be served. They are
quickly informed about the situation and get help to book an appointment with their favourite
adviser.
The customers are always placed last in the queue to which they are transferred.
This transfer is based on the waiting time. It transfers customers from one ticket button to
another one.
Select "Transfers" in the System configuration window.
Select General settings in the levels tree.
Set the "Waiting time" check mark.
Set the "Statistics" check mark if you want the transfer to be stored in the statistics. The
customer gets a new waiting time after the transfer. The transfer cannot be traced in the
statistics if this setting is omitted.
Click Save to store the settings.
Select "Buttons" in the System configuration window.
Select the button group settings for the ticket button from which you want to transfer
customers.
Category transfer
Automatic transfer based on the waiting time
Transfer
087.01E Q-MATIC AB 253
Enter at "Time for transfer" the waiting time, in minutes, at which customers should be
automatically transferred. Valid values: 0-1440 minutes.
Enter at "Transfer to this button" the ticket button to which the customers should be
transferred. The entered value must be a valid ticket button number.
Click Save to save the settings.
Script Program, the result indicates new Ticket Button
This script program must be used if the ticket button settings do not specify the destination for
the transfer. The result of the script program is used as the new ticket button number for the
customer.
This transfer is based on the result from a script program.
Select "Transfers" in the System configuration window.
Select General settings from the levels tree.
Click Add transfer.
Select the new transfer from the levels tree.
Write the name of the transfer type.
Specify from which category the ticket number will be transferred (From category).
Specify to which ticket button the ticket number will be transferred (To button).
Specify the information that will be shown on the main display. The ticket number is shown
on the main display when the customer is transferred. The main display will also show
another number at the position for the workstation number. At the "Area number" it is
possible to specify this number. This number can be used to guide the customer to a new
Category transfer based on a script program
Q-WIN Reference Manual - Vol 1, Basic
254 Q-MATIC AB 087.01E
waiting area (sub waiting area). The main display will show the category from which the
customer is transferred if this setting is 0.
Set the "Save in statistics" check mark to save the transfer in the statistics.
The "To button" setting usually specifies to which ticket button the ticket number is going
to be transferred. Set this check mark to override the "To button" setting and instead use the
result of the script program to specify the destination of the transfer. The result of the script
program must be a ticket button number.
Enter the script program. The transfer is performed if the result of the script is greater than 0.
Use network category transfer to transfer customers from one Q-WIN system to another.
Network category transfer can be used in large organisation with more than one Q-WIN system,
for example hospitals. Network category transfer makes it possible for the customers to use the
same tickets when they are transferred to different parts of the hospital with different Q-WIN
systems.
Network category transfer is also used in very large systems with more than 100 workstations.
Q-WIN cannot handle more than about 100 hardware workstation terminals (KT2595/KT2695)
because there are only 128 ID codes. The solution is to divide a very large system into two or
more smaller systems, for example, one system per floor. Network category transfer is used to
transfer ticket numbers between the systems.
Because of the repeated connection - disconnection, the network must be fast. Use TCP/IP and
not NetBIOS.
Network category transfer transfers all ticket numbers from the selected category to the selected
ticket button in the other system. Specify a category that is only used for network category
transfer. Q-WIN automatically transfers all ticket numbers in the specified category. The time
between each transfer is specified in the settings.
Network category transfer is only available in the Q-WIN Client, not in the web based server
settings.
Network transfer
Transfer
087.01E Q-MATIC AB 255
Select "Transfer Settings" from the Utilities menu.
Set the Always connected setting if the two systems should be constantly connected with
each other.
Specify the time between each transfer. Max: 3600 seconds, min: 5 seconds.
Click Add.
Click in the Name field and enter the name of the transfer.
Choose the branch and the category from which the ticket numbers will be transferred.
Chose the branch and the ticket button to which the ticket numbers are transferred.
Adding a network category transfer
Q-WIN Reference Manual - Vol 1, Basic
256 Q-MATIC AB 087.01E
Click OK to save the settings.
Click OK to save and exit the settings.
Select "Transfer Settings" from the Utilities menu.
Choose a setting from the list.
Click Edit.
Edit the settings.
Click OK to save the settings.
Select "Transfer Settings" from the Utilities menu.
Choose a setting from the list.
Click Remove. The transfer is immediately deleted.
Click OK to save the settings.
Editing a network category transfer
Delete a network category transfer
087.01E Q-MATIC AB 257
26. Voice
Topics in this chapter
Voice interface............................................................................. 258
Voice settings .............................................................................. 258
General voice settings ................................................................. 258
Voice Script.................................................................................. 259
VU2187........................................................................................ 259
Q-WIN Voice................................................................................ 261
To say a number .......................................................................... 262
Activate a Voice Unit ................................................................... 263
Recording phrases ....................................................................... 264
English phrases in Q-WIN VOICE ................................................. 265
Example....................................................................................... 270
Q-WIN Reference Manual - Vol 1, Basic
258 Q-MATIC AB 087.01E
There are two ways to get sound messages from a Q-WIN system: Voice Unit or Q-WIN Voice.
The Voice Unit is a unit connected to the system in the same way as any other Q-MATIC unit.
Q-WIN Voice is a Q-WIN option and it uses the internal sound card of the PC.
The sound messages usually inform the customers about their ticket numbers when they take
tickets and the ticket numbers and workstation numbers when they are called but it can be any
type of messages.
Select Voice in the System configuration window. The voice settings is a collection of scripts
used to play messages on a Voice Unit or Q-MATIC Voice.
Select "Voice" in the System configuration window.
Voice units
This is the number of scripts.
The setting is not automatically connected to a specific Voice Unit. The Voice Unit is
specified in the script program.
Starting ID code
The ID Code for the Voice Units. This value is not used by Q-WIN Voice. All Voice Units must
have the same ID code. Use the Sub ID code to identify the units.
Voice interface
Voice settings
Voice Unit
Maximum number of scripts: 99
Default ID code: 125
General voice settings
Voice
087.01E Q-MATIC AB 259
Name
The name of the setting.
Use sound card
Set the check mark if an internal sound card is used (Q-WIN Voice).
Q-WIN must have a Q-WIN Voice licence to be able to use the internal sound card.
Wav file
The Wav file option must be set if an internal sound card is used (Q-WIN Voice) but it must not
be set if a Voice Unit is used.
Voic script
This is the script program that specifies the voice message.
The VU2187 is a two-channels Voice Unit. The two channels work completely independent of
each other.
Do not set the Internal Sound Card and the Wave File check marks in the settings.
The Voice Unit has a set of commands that are executed in the unit. The result of the script will
be the command string sent to the Voice Unit. Place all commands inside quotation marks "".
\eD dir_name
Select Directory. Multiple directories are usually used when the system supports multiple
languages. The phrases for the different languages are placed in different directories. The
directories are usually named 1, 2, 3 and 4. Directory 0 is the root directory and it is
automatically used if no directory is specified.
Voice Script
VU2187
Q-WIN Reference Manual - Vol 1, Basic
260 Q-MATIC AB 087.01E
This voice command can be separately specified for each channel.
\eFn
Play Phrase. Play the selected phrase. The Voice Unit can store 2048 phrases (0-2047) in each
directory. This command is used to play phrases such as "Welcome", "Your Ticket Number is...",
etc.
\eLn
Set Volume. Specify the output volume. The volume can be a number from 0 to 7.
\eL0 is not silence, it is the lowest volume.
This Voice Command can be separately specified for each channel.
\eNn
Play Number. The Voice Unit plays a number. The number (n) must be an integer. It can be a
script program function, for example GROUP_NUMBER. The Play Number command uses the
number table to play a number. The entered value is replaced with the files specified at the
corresponding line in the number table. For example 256 is replaced with the files specified at
line 257 in the number table.
Max: 999
Min: 0
\ePn
Pause. Make a pause for the specified number of milliseconds.
Max: 8191
Min: 0
\eUn
SUB ID code. Select the SUB ID code. Each Voice Unit has a SUB ID code. The SUB ID code
specifies which of the Voice Units in the system that will play the phrases.
Max: 63
Min: 0
This command must be placed first in he output string when it is used.
\eVn
Select Channel. The Voice Unit has two independent channels that can play different phrases at
the same time. Set n=0 to play on the left channel, n=1 to play on the right channel or n=2 to
play the same thing at both channels. The Voice Unit plays the same phrases at both channels
(n=2) if no channel is selected.
All voice commands except \eU only affects the selected channel. The two channels may
for example play phrases from different directories and with different volume.
Voice
087.01E Q-MATIC AB 261
Set the "Internal Sound Card" checkbox and the "Wave File" checkbox in the settings to use the
sound card instead of the external Voice Unit. Below is a description of the set-up of the files
and the voice commands used with the internal sound card.
Q-WIN Voice can use two channels. The two channels cannot play phrases at the same time.
Files and Directory
The files with the phrases must be stored in the Voice directory. The Voice directory must be
stored in the working directory of Q-WIN. The Voice directory contains one subdirectory for
each language. The Voice directory must contain the 1.wav file. This files specifies the format of
all files that will be played. All files in all subdirectories must have the same format as the 1.wav
file. Each subdirectory must contain a number table (number.tab and number.ini).
Minimum format: 8000 kHz, 8-bit mono. Maximum format: 44100 kHz, 16-bit stereo. Default
format: 8000 kHz, 8-bit mono.
Text
Click with the right mouse button in the Text box to open the Edit Program dialogue box and
enter the Script Program.
Voice Commands
Q-WIN Voice can use the following voice commands.
\eV0 Use the left channel.
\eV1 Use the right channel.
\eD Select Directory. Multiple directories are usually used when the system supports multiple
languages. The phrases for the different languages are placed in different directories.
\eF Play Phrase. Play the selected phrase.
\eN Play Number. Q-WIN Voice plays a number. The number (n) must be an integer. It can
be a script program function, for example GROUP_NUMBER. The Play Number
command uses the number table to play a number. The entered value (n) is replaced with
the files specified at the corresponding line in the number table. For example 256 is
replaced with the files specified at line 257 in the number table.
Max: 999
Min: 0
\r End of phrase.
All commands must be inside quotation marks "".
Q-WIN Voice
Q-WIN Reference Manual - Vol 1, Basic
262 Q-MATIC AB 087.01E
Example
The following script is placed in the ticket button settings and it is played when customers take
tckets. The script uses files from the "English" directory. Play the phrases on the left channel
(\eV0). Play the phrase "Your Ticket Number is" (file 201.wav). Use the number table (\eN) to
say the ticket number (GROUP_NUMBER).
"\eD"English"\eV0 \eF 200 \eN" GROUP_NUMBER "\r"
The following script is placed in the main display settings and it is used when the customers are
called. The phrases are played on the right channel.
"\eD"English"\eV1 \eF 201 \eN" DISPLAY_NUMBER "\r"
It would be very complicated if you had to record every number from 1 to 999 as separate
phrases then use \eF to play them. The solution is the number table. Numbers are composed of
some basic components. Many numbers use the same components; you can for example use the
same "twenty" in 25 and 427. The number table specifies the basic components for each number.
The number.ini file is the text file that specifies the number table. The number.ini file must be
in the VOICE directory. The number table is recreated if it is older than the number.ini file.
The following figure shows the steps from a ticket number to a spoken word.
1
The System returns a Ticket Number, for example 324.
To say a number
324
Ticket number
-1 103 21 321
103 20 1 322
103 20 2 323
103 20 3 324
103 20 4 325
103 20 5 326
103 20 6 327
Number Table
Line Phrases
Three hundred and...
Twenty...
four
103.wav
20.wav
4.wav
File Phrase
103 20 4
103 20 4
Three hundred and twenty-four
1
2
3
4
5
Voice
087.01E Q-MATIC AB 263
2
The \eN command specifies that the number table should be used. The ticket number specifies
a line (325) in the number table (line 1 is number 0, line 2 is number 1, etc.).
3
Each line in the number table consists of three numbers. These numbers specify the components
of the ticket number. Some lines contain one or two positions with -1. These lines specify
numbers that do not consist of three components, for example 56 (two components) or 4 (one
component). Our example (324) has three components: 103, 20 and 4.
4
Each component represents a file. The files contain the recorded phrases. The file names are the
same as the numbers in the number table. Ticket number 324 uses the following files: 103.wav
(three hundred and...), 20.wav (twenty...) and 4.wav (four).
5
The files are played in the same order as they are placed in the number table.
Voice settings used when a ticket is taken
The ticket button setting contains the script that is played when the customers take tickets.
Activate a Voice Unit
Q-WIN Reference Manual - Vol 1, Basic
264 Q-MATIC AB 087.01E
Voice settings used when a customer is called
The main display settings contain the script that is played when the customers are called.
The "Minimum time for ticket number" setting in the main display settings specifies the
minimum time a ticket number is displayed. There is a great risk for problems if the voice
message is longer than this time. The result is that the information on the display is changed
while the message is played. The message for the new number is not played until the current
message has finished. This will be extremely confusing for the customers.
Make sure that the minimum time a ticket number is displayed is longer than the played
message.
You can use any software that generates wav files to record the phrases.
The Voice Unit does not use wav files. It uses files in u-law 12 bit 8 kHz mono format.
Please refer to the Voice Unit VU2187 manual for more information.
A phrase must start and end at zero level otherwise there will be an unwanted noise
between the phrases.
A pause must never be absolutely silent. There is always a background noise, even when
there is a gap between phrases. The background noise should be very low. You can record the
noise in a silent room.
Recording phrases
Voice
087.01E Q-MATIC AB 265
The following table describes the English default phrases.
English phrases in Q-WIN VOICE
Table 6: Phrases
File
(.wav)
Phrase
1 ...one
2 ...two
3 ...three
4 ...four
5 ...five
6 ...six
7 ...seven
8 ...eight
9 ...nine
10 ten
11 eleven
12 twelve
13 thirteen
14 fourteen
15 fifteen
16 sixteen
17 seventeen
18 eighteen
19 nineteen
20 twenty...
21 twenty
22 one
23 two
24 three
Q-WIN Reference Manual - Vol 1, Basic
266 Q-MATIC AB 087.01E
25 four
26 five
27 six
28 seven
29 eight
30 thirty...
31 thirty
32 nine
40 forty...
41 forty
50 fifty...
51 fifty
60 sixty...
61 sixty
70 seventy...
71 seventy
80 eighty...
81 eighty
82 one hundred
83 two hundred
84 three hundred
85 four hundred
86 five hundred
87 six hundred
88 seven hundred
89 eight hundred
90 ninety...
91 ninety
92 nine hundred
Table 6: Phrases (Continued)
File
(.wav)
Phrase
Voice
087.01E Q-MATIC AB 267
101 one hundred and
102 two hundred and
103 three hundred and
104 four hundred and
105 five hundred and
106 six hundred and
107 seven hundred and
108 eight hundred and
109 nine hundred and
111 one thousand
112 two thousand
113 three thousand
114 four thousand
115 five thousand
116 six thousand
117 seven thousand
118 eight thousand
119 nine thousand
132 passport office
133 the post office
134 Q-MATIC
141 ticket
142 office
143 information
144 service
151 welcome to
152 information desk
153 position
154 desk
Table 6: Phrases (Continued)
File
(.wav)
Phrase
Q-WIN Reference Manual - Vol 1, Basic
268 Q-MATIC AB 087.01E
155 counter
156 teller
157 room
158 interview room
159 number
161 your
162 your number
163 is
164 please
166 go to
167 the waiting area
168 the main reception
172 button
173 the button
175 now serving
176 category
177 ticket number
178 take a seat
179 the initial reception
180 and
181 and wait for your number to be called
182 at
183 in
184 on
185 the
186 on the
187 requested
189 waiting time
191 estimated
Table 6: Phrases (Continued)
File
(.wav)
Phrase
Voice
087.01E Q-MATIC AB 269
192 minute
193 minutes
194 hour
195 hours
196 there are
197 customers
198 before you
199 people
200 waiting
201 Merry Christmas
202 floor
203 ground
204 first
205 second
206 third
207 fourth
208 fifth
209 sixth
210 seventh
211 eighth
212 ninth
213 tenth
214 A
215 B
216 C
217 D
218 E
219 F
220 G
Table 6: Phrases (Continued)
File
(.wav)
Phrase
Q-WIN Reference Manual - Vol 1, Basic
270 Q-MATIC AB 087.01E
This example describes how Q-WIN VOICE can be used to help customers that speak different
languages. Assume that we want to support three languages, English, German and French. We
want to use three ticket buttons, one for each language, but they belong to the same category.
The customer should be called in the correct language.
Make language directories
Make three subdirectories in the "Voice" directory. Name them for example "Eng", "Ger" and
"Fre".
Copy wav-files
Copy all wav-files and the number.tab files to the respective language directory.
1.wav and number.tab
Copy the English file "1.wav" and "number.tab" to the "Voice" directory (not any subdirectory).
These files must be present in the "Voice" directory but the Voice Interface will use the files in
the language directories.
Voice Interface Settings
Start Q-WIN and set the "Number of Voice Units" to 2.
Script for Voice Unit 1
Enter the following Script. Note that the phrase number (200) depends on the phrases in the
wav-files.
B=BUTTON
N=GROUP_NUMBER
IF(B EQ 1)
BEGIN
"\eD"Eng"\eF 200 \eN" N "\r"
END
IF(B EQ 2)
BEGIN
"\eD"Ger"\eF 200 \eN" N "\r"
END
IF(B EQ 3)
BEGIN
"\eD"Fre"\eF 200 \eN" N "\r"
END
Script for Voice Unit 2
Enter the following Script. Note that the phrase number (201) depends on the phrases in the
wav-files.
Example
Voice
087.01E Q-MATIC AB 271
B=DISPLAY_BUTTON
N=DISPLAY_NUMBER
IF(B EQ 1)
BEGIN
"\eD"Eng"\eF 201 \eN" N "\r"
END
IF(B EQ 2)
BEGIN
"\eD"Ger"\eF 201 \eN" N "\r"
END
IF(B EQ 3)
BEGIN
"\eD"Fre"\eF 201 \eN" N "\r"
END
Ticket button settings
Open the ticket button settings and set the "Voice Unit No when Button is pressed" to 1.
Main display settings
Open the main display settings and set the "Voice Unit No when a Customer is called" to 2.
Q-WIN Reference Manual - Vol 1, Basic
272 Q-MATIC AB 087.01E
087.01E Q-MATIC AB 273
27. Wireless Terminal
Topics in this chapter
Introduction................................................................................. 274
Wireless Terminal settings ........................................................... 274
Wireless Terminal group settings................................................. 275
Wireless Terminal unit settings.................................................... 276
Learning a signature.................................................................... 276
Removing a Wireless Terminal..................................................... 277
Q-WIN Reference Manual - Vol 1, Basic
274 Q-MATIC AB 087.01E
Wireless Terminals are used together with the radio multi interface in wireless systems. They use
radio signals to communicate with the interface.
The Wireless Terminal has three buttons. Scripts in the settings specify the function of the
buttons. The default function is as a workstation terminal with NEXT, CLOSE and ALARM.
Each Wireless Terminal has a unique signature. This signature together with the order in which
they were assigned to the system is used as the workstation number. The system must learn the
signatures of all Wireless terminals before they can be used.
Please refer to the Wireless Solutions manual for more information about Wireless terminals and
radio interfaces.
Enter all settings for the radio multi interface before you open the settings for the Wireless
terminals.
Select Wireless Terminal in the System configuration window.
Number of terminals
This is the number of wireless terminals.
Debug
Use this setting to display the signature from the Wireless terminal on the system server screen.
This setting is only used during test of the system.
Introduction
Wireless Terminal settings
Wireless Terminals
Maximum number of terminals: 99
General Wireless Terminal settings
Wireless Terminal
087.01E Q-MATIC AB 275
Time delay
This time is used to prevent that a script is executed twice by mistake. This time must elapse
after a button has been pressed and before a script can be executed again.
Max: 1000 seconds
Min: 0 seconds
The maximum and minimum values are extreme values that are never used. A very short
time makes it easy for the user to start a script by mistake. A very long time is irritating because
nothing happens when the user presses a button. The default time (five seconds) can usually be
used.
Script
There are three script programs for each Wireless Terminal, one for each button. The script is
executed when the corresponding button is pressed.
Wireless Terminal group settings
Q-WIN Reference Manual - Vol 1, Basic
276 Q-MATIC AB 087.01E
Name
The name of the Wireless Terminal.
Signature
The signature of the Wireless Terminal.
A Wireless Terminal unit can only be assigned to one setting. The terminal's signature is
assigned to the latest learned setting.
Open the Wireless Terminal unit settings.
Expand the units branch in the settings tree and select Learn.
Click Learn.
Wireless Terminal unit settings
Learning a signature
Wireless Terminal
087.01E Q-MATIC AB 277
Press any button on the Wireless Terminal.
Click Save to save the signature.
It may be necessary to disable a Wireless Terminal, for example when it is lost. It is only possible
to remove the last terminal in the settings but it is possible to disable any terminal.
Always disable lost Wireless Terminals to prevent unauthorised people from using them.
Select the Wireless Terminal unit in the settings tree.
Select to move the terminal to a new Wireless Terminal group.
Make sure that the new terminal group does not have scripts for any buttons.
The Wireless Terminal is now disabled. A Wireless Terminal without any scripts cannot start
any action in Q-WIN.
Removing a Wireless Terminal
Q-WIN Reference Manual - Vol 1, Basic
278 Q-MATIC AB 087.01E
087.01E Q-MATIC AB 279
28. Workstations
Topics in this chapter
General workstation settings....................................................... 280
Workstation settings.................................................................... 281
Workstation type settings............................................................ 282
Display info.................................................................................. 286
Keys ............................................................................................. 290
Single programs and sequence programs .................................... 291
System variables.......................................................................... 292
Registers...................................................................................... 293
Entering numbers from the keyboard .......................................... 293
Scripts.......................................................................................... 294
Terminal group settings............................................................... 295
Park register ................................................................................ 297
Q-WIN Reference Manual - Vol 1, Basic
280 Q-MATIC AB 087.01E
Select "Terminals" in the System configuration window.
Number of terminals
This is the highest workstation number in the system. This is usually the same as the number of
workstations.
Max: 255
Min: 0
It is not possible to have 255 hardware terminals because there are only 128 ID codes. It is
possible to connect about 100 hardware terminals to the system. Displays, ticket printers and
other hardware units need the remaining ID codes.
Starting ID code
This is the ID code for the first workstation terminal.
Terminals handled simultaneously
This is the number of workstation terminals that the server handles at the same time. The server
must call all hardware units one by one. Each unit must be called within a reasonable time. This
may cause a problem if there are many workstation terminals because the server must call every
terminal before it can continue with the other units.
This setting specifies the number of workstation units that should be handled each time the
server calls workstation terminals. The server handles the next bunch of terminals in the next
cycle.
Max: 64
Min: 1
Unconnected terminals
These are the terminals that are not connected to the system. This setting is used when the
number of terminals is less than the highest workstation number (see above). We recommend
that you always use this setting if there are unused workstation numbers. The system will be
faster because the server ignores these numbers.
Enter single workstation numbers separated by comma (1,5,12), sequences of numbers (3-7,11-
13) or a mix of both (1-4,7,10-13).
General workstation settings
Workstations
087.01E Q-MATIC AB 281
Name
The name of the workstation
Lock to priority
Lock the workstation to a priority. This setting disables the possibility of using the workstation
terminal, or the login, to choose a priority.
Alt. workstation number
This setting is used when the workstation does not use its own workstation number. Choose a
workstation, then enter the workstation number that should be used. Enter 0 to turn off this
function.
Workstation settings
Q-WIN Reference Manual - Vol 1, Basic
282 Q-MATIC AB 087.01E
The workstation settings specify the keys on the workstation terminal and the information
displayed on the workstation displays.
The terminal type settings are complex settings with the following sub levels in the settings tree.
Keys
These are the keys on the workstation terminals. There is one entry for each key.
Single programs
These programs specify some of the functions of the workstation terminal keys. There is one
entry for each single program.
Sequence programs
These programs specify most functions of the workstation terminal keys. There is one entry for
each program.
Scripts
These are script programs that are started from sequence programs. Sequence programs are
simple and cannot perform complex actions. When a complex function is needed, the sequence
program calls a script program. There is one entry for each script program.
Workstations
These are the workstations that are using these terminal type settings.
Workstation type settings
Workstations
087.01E Q-MATIC AB 283
Update
The time between refreshes of the information on the workstation terminal and the workstation
display.
Max: 1000 seconds
Min: 1 second
Time between keystrokes
The longest time, in seconds, allowed between two keystrokes on the workstation terminal. After
this time the entered information is cleared.
Max: 1000 seconds
Min: 0 seconds
Number of digits
This is the number of digits for the ticket number when it is displayed on the workstation
terminal display.
Disconnect displays
Disable the hardware workstation displays. This setting is used when there are no workstations
displays in the system.
Disconnect terminals
Disable the hardware workstation terminals. This setting is used when software applications are
used instead of hardware terminals.
Protocol
Set the protocol type. All new Q-MATIC terminals use protocol B.
Display buzzer
Current displays do not have any internal buzzer.
Display, Serving Cust
This script program specifies the information on the workstation display when the workstation
is open and serving customers.
Example
Display the ticket number and flash it a short time when a new number is called.
IF( COUNTER_DISPLAY_FLASH )
"F+ "
ELSE
"F- "
"FS 0 CS R PC I [" COUNTER_DISPLAY_NO LEN(3) "] "
Q-WIN Reference Manual - Vol 1, Basic
284 Q-MATIC AB 087.01E
Display, No customers
This script program specifies the information on the workstation display when the workstation
is open but not serving any customers.
Display, Closed
This script program specifies the information on the workstation display when the workstation
is closed.
Terminal display
This script program specifies the information on the hardware workstation terminal display.
Terminal buzzer
This script program activates the buzzer in the hardware workstation terminal. The buzzer is
activated when the result of the script changes from 0 to 1.
Terminal INFO1
The result of the script program is displayed on the hardware workstation terminal display. It is
displayed at the same position as the clock.
Terminal INFO2
The result of the script program is displayed on the hardware workstation terminal display. It is
displayed at the same position as the clock.
Terminal LED1
The result of the script controls LED 1 on the workstation terminals. The LED is lit when the
script returns a value greater than 0.
Terminal LED2
The result of the script controls LED 2 on the workstation terminals. The LED is lit when the
script returns a value greater than 0.
End customer
The script is executed when a transaction ends.
Number of terminal keys
This is the number of keys on the terminal.
Workstations
087.01E Q-MATIC AB 285
Name of key
This is the specification of the workstation terminal key names.
Number of single programs
This is the number of single programs.
Single programs
These programs specify the functions of the workstation terminal keys.
Number of sequence programs
This is the number of sequence programs.
Sequence programs
These programs specify the functions of the workstation terminal keys.
Script programs
These are script programs that can be started from a sequence program.
Q-WIN Reference Manual - Vol 1, Basic
286 Q-MATIC AB 087.01E
The TP: Display info script program can be used to change the information on the hardware
workstation terminals' displays. A string specifies the information on the display. The string
contains 26 characters.
The string must always start with " |". These two characters are used as control code and they are
not displayed on the display. They must always be the two first characters.
The next four characters are the big numbers on the display.
The next four characters are usually used to display the time.
The next four characters are usually used for alarms and the ticket counter.
The next seven characters usually show the number of waiting customers and the real waiting
time. The fourth character in the string is usually not shown.
This was the end of the characters that are displayed as they are. The last five characters are used
to control the different signs on the display. The characters are used binary with one bit per sign.
Use BIT() in a script to turn on (1) or off (0) bits.
Here are the five characters.
Bit 0: am
Bit 1: pm
Bit 2: colon
Bit 3: green LED
Bit 4: red LED
Display info
Workstations
087.01E Q-MATIC AB 287
Bit 0: ticket
Bit 1: clock
Bit 2: bell
Bit 3: i
Bit 4: on/off
Bit 0: left person
Bit 1: right person
Bit 2: left ALT
Bit 3: right ALT
Bit 4: (not used)
Bit 0: top symbol
Bit 1: thin line
Bit 2: bottom symbol left
Bit 3: bottom symbol middle
Bit 4: bottom symbol right
Bit 0: p1
Bit 1: p2
Bit 2: p3
Bit 3: p4
Bit 4: p5
The following string: " | 00209522999007 002%3!#0" result in the following display.
Q-WIN Reference Manual - Vol 1, Basic
288 Q-MATIC AB 087.01E
Editing the string
It is possible to edit the string. The COUNTER_SIGNS() script function returns the default
string from the system. Use this string for those parts of the display that should show the default
information.
The first part of the string that shows digits on the display is easy to edit. Replace the default
value with other digits, for example from a script function.
It is important that the string contains the correct number of characters.
Use BIT() for the bits (the last five characters). Enter for example BIT(0 0 0 0 0 1 0 0) to turn
on bit 2.
Use an empty string (space on the keyboard) to turn off all bits in a character. Do not use
BIT(0 0 0 0 0 0 0 0).
This is the default string as a script program.
{control codes (2) do not change}
COUNTER_SIGNS LEN(2)
{ticket number}
COUNTER_SIGNS SKIP(2) LEN(4)
{time}
COUNTER_SIGNS SKIP(6) LEN(4)
{number of tickets and alarm}
COUNTER_SIGNS SKIP(10) LEN(4)
{waiting customers}
COUNTER_SIGNS SKIP(14) LEN(3)
{extra digit between customers waiting and waiting time}
COUNTER_SIGNS SKIP(17) LEN(1)
{waiting time}
COUNTER_SIGNS SKIP(18) LEN(3)
{colon am-pm and LEDs}
COUNTER_SIGNS SKIP(21) LEN(1)
{bell ticket clock}
COUNTER_SIGNS SKIP(22) LEN(1)
{ALT signs and figures}
COUNTER_SIGNS SKIP(23) LEN(1)
{external connector signs}
COUNTER_SIGNS SKIP(24) LEN(1)
{priority selection signs}
Workstations
087.01E Q-MATIC AB 289
COUNTER_SIGNS SKIP(25) LEN(1)
The script will result in the default information. COUNTER_SIGNS returns the system string
for the terminal display. SKIP removes the specified number of characters from the beginning of
the string. LEN specifies the length of the string. Remove COUNTER_SINGNS and SKIP and
enter a new string or script function to change the information on the display.
Example
We want to remove some of the signs from the display. We want to show the ticket number and
the time as in the default string. We want to show the current priority at the position for the
alarm and the number of tickets left.
We want to use one if the signs, , to indicate that there are more than ten waiting
customers.
We use the following script.
{control codes (2) do not change}
COUNTER_SIGNS LEN(2)
{ticket number}
COUNTER_SIGNS SKIP(2) LEN(4)
{time}
COUNTER_SIGNS SKIP(6) LEN(4)
{current priority}
COUNTER_PRIORITY_NUMBER LEN(4)
{waiting customers}
COUNTER_SIGNS SKIP(14) LEN(3)
{extra digit between customers waiting and waiting time}
COUNTER_SIGNS SKIP(17) LEN(1)
{waiting time}
COUNTER_SIGNS SKIP(18) LEN(3)
{colon am-pm and LEDs}
COUNTER_SIGNS SKIP(21) LEN(1)
{indicate more than ten customers}
A=COUNTER_GROUP
IF (GROUP_QUEUE(A) GT 10) BIT(0 0 0 1 0 0 0 0)
ELSE " "
{remove signs}
" "
{ remove signs }
" "
Q-WIN Reference Manual - Vol 1, Basic
290 Q-MATIC AB 087.01E
{priority selection signs}
COUNTER_SIGNS SKIP(25) LEN(1)
The following information will be displayed on the display.
The default script is unchanged at those positions where we want to use the default information.
At one position is the COUNTER_SIGNS and SKIP functions replaced with the
COUNTER_PRIORITY_NUMBER. We keep the LEN command to make sure that the inserted
string is four characters.
We use BIT to turn on the sign on the display when there are more than ten customers in the
category that the workstation serves. The sign is bit 4 in the character.
We use an empty string (" ") to remove the unwanted signs from the display.
These settings specify the name of the terminal keys. These names are used in the single
programs and the sequence programs. It is also possible to assign a value to a key, for example
the numerical keys have values.
The terminal type settings specify the number of keys on the terminal.
The Keys list contains all keys. The key number identifies the key on the keyboard. Key one is
the top left key. The CLOSE and NEXT keys are double keys, number 31-32 and 34-35
respectively.
Keys
P1 P2 P3 P4 P5
CLOSE
D
C
B
A
ALT NEXT
0
9 8 7
6 5 4
3 2 1
CLR ENT
125
02:30pm
2991
000000
Key 1
Key 35
Workstations
087.01E Q-MATIC AB 291
Name
The key name. The name must be unique. Use capital letters.
Value assigned to a key
Some keys have a value assigned to the key name, for example the numerical key. Use the KEY
system variable to read the value.
Example
The name for key 14 is: NUMERIC,8
Eight is assigned to the key name.
Single programs and sequence programs specify the function of the keys on the hardware
workstation terminals. Single programs use only one key while sequence programs use key
sequences.
It is possible to use only one key in sequence programs too. Use only the sequence programs
to add or change programs.
Single programs and sequence programs must use the workstation functions. Please refer to the
Script Manual for more information.
It is not possible to use calculations in single or sequence programs.
Number of single programs
This is the number of single programs.
Number of sequense programs
This is the number of sequense programs.
Syntax
Workstation function parameters keys
The programs always start with a workstation function and there is always at least one key name
but the parameters can be omitted for some functions (please read the script manual for
information about the workstation functions). There must be a space between each item in the
program. There is usually extra space between the workstation function and the parameters and
between the parameters and the key sequence. These extra spaces make it easier to read the
program.
Example
FUNC_INSERT_LAST MOVE NUM B2 OPT NUMERIC INSERT_LAST
Single programs and sequence programs
Q-WIN Reference Manual - Vol 1, Basic
292 Q-MATIC AB 087.01E
FUNC_INSERT_LAST is the workstation function.
MOVE, NUM and B2 are the parameters.
OPT NUMERIC INSERT_LAST specifies the keystroke.
Single programs and sequence programs can only contain one workstation function. Use
scripts to get more complex programs.
Neither single programs nor sequence programs can contain script commands or functions.
Use FUNC_SCRIPT to execute a script program.
FUNC_INSERT_LAST is a workstation function that moves a called ticket number to the last
position in a queue (see the Script Manual for more information). It uses three parameters: type,
ticket number and ticket button. Type specifies the type of insertion of the ticket. NUM is a
system variable (see below). It is the number on the workstation terminal display, usually the
ticket number.
B2 is a workstation register; in this case it is used to specify the ticket button number. B2 must
have a valid value before FUNC_INSERT_LAST is used. The registers are explained below.
OPT NUMERIC specifies that it is possible to use the numerical keys to enter a number and
INSERT_LAST is a key name from the key name specification (see above).
Key names are specified in the same order as they should be entered from the keyboard. A key
that should be entered twice is specified twice, for example ALT ALT. There is one exception;
the numerical keys are only specified once (NUMERIC).
The keystroke sequence must be unique. Use a script program if a key sequence should
result in more than one function.
System variables are predefined variables that represent a value returned by the system. They are
used in single programs and sequence programs. All system variables are integers.
These system variables cannot be used in script programs.
CGR
This is the category for the current customer at the workstation.
CON
This is the workstation number.
System variables
Workstations
087.01E Q-MATIC AB 293
GRP
This is the category selected at the workstation. Usually not used with the current workstation
terminals.
KEY
This is the value assigned to a key (see above).
LNUM
A number entered at the workstation terminal. This number is usually used together with login
and it is not limited to the four digits that can be displayed on the workstation terminal display.
NUM
This is the number shown on the workstation terminal display.
PRI
This is the priority number used at the workstation.
QNUM
This is the ticket number for the customer served at the workstation.
The registers are used to store settings made at the workstation terminals. Each workstation
terminal has its own set of registers. The values are not deleted when the workstation is closed
or Q-WIN is closed because they are stored in the data files in the Data folder. Use
FUNC_VALUE to enter a value into the register.
Ax
There are 29 A registers for each workstation terminal. They are numbered A1, A2, , A29.
Bx
There are 9 B registers for each workstation terminal and selected priority. They are numbered
B1, B2, , B9.
The difference between the A registers and the B registers. Both registers are unique for
each workstation terminal but the B registers are also unique for each priority.
Some workstation terminals have a keyboard with numerical keys. These can be used to enter
numbers, for example a matter code or a login code.
Registers
Entering numbers from the keyboard
Q-WIN Reference Manual - Vol 1, Basic
294 Q-MATIC AB 087.01E
The sequence program must specify that a value will be entered from the keyboard. Here are
two examples.
FUNC_LOGON NUM NUMERIC LOGON
FUNC_REMOVE NUM B6 OPT NUMERIC REMOVE
The first example is the function used when a user enters a login code. The user must enter a
number. NUMERIC specifies that numerical keys must be used before the LOGON key is
pressed.
The second example removes a ticket number from a category. The user can choose between
entering a ticket number or to remove the ticket number already displayed on the workstation
terminal display. OPT specifies that the numerical keys are optional.
The NUM or LNUM parameters must be used to read the number in the workstation terminal
display.
Script must be used for complex actions that cannot be performed with a single workstation
function. The FUNC_SCRIPT function executes a script program. The Script Programs list
contains the script programs. Numbers identify the programs. This number is used as a
parameter to the FUNC_SCRIPT function.
To create a new script, increase the number in the Number of script programs field:
To edit a script program, select a script from the list and click in the Program field. The script
editor is started.
Scripts
Workstations
087.01E Q-MATIC AB 295
These are a second set of workstation settings. They can be the same for all workstations even if
they are not of the same type.
Auto close display (sec)
The workstation display will be turned off if the workstation is closed.
Max: 1000 minutes
Min: 0 minutes
Display flash time (sec)
This is the time the display flashes when a ticket number is called.
Max: 1000 seconds
Min: 0 seconds
Auto close workstation (min)
The workstation is automatically closed if no ticket numbers are called.
Max: 1400 minutes
Min: 0 minutes
Min time between calls (sec)
This time must elapse after a customer is called and until the next customer can be called.
Max: 1000 seconds
Min: 0 seconds
Terminal group settings
Q-WIN Reference Manual - Vol 1, Basic
296 Q-MATIC AB 087.01E
Park register size
This is the maximum number of ticket numbers that can be stored in the park register.
Max: 1000
Min: 0
Show next number
Show the ticket button and ticket number for the next customer to be called, on the workstation
terminal display.
Max: 9999 seconds
Min: 0 seconds (disabled)
Trash category
Save the served ticket number in a trash category. The entered value must be a valid category
number or 0 (off).
Report unconnected terminals
Unconnected workstation terminals are reported to the error log.
Store next
Store the call of a customer if there are no waiting customers. The terminal will automatically
call the next customer.
Previous number
This setting affects the value returned by COUNTER_DISPLAY_BUFFERD_NO and
COUNTER_DISPLAY_NO. COUNTER_DISPLAY_BUFFERD_NO will return the ticket
number currently called to the workstation. COUNTER_DISPLAY_NO will show the ticket
number previously called to the workstation.
Force login
The user must login to be able to use the workstation terminal.
Force matter
The user must enter at least one matter code per called ticket number.
Automatically logoff
The user is logged out when the workstation is closed.
Log errors
Some of the errors caused by the workstation are saved in the error log.
Workstations
087.01E Q-MATIC AB 297
The park register is a register that the workstation can use to temporarily store ticket numbers.
Each workstation has its own park register.
The "Number of ticket nos. which can be stored in the park area of the terminal" setting specifies
the number of ticket numbers that can be stored in the park register.
There are four workstation functions for the park register.
FUNC_PARK
Place a ticket number in the park register.
FUNC_PARK_CALL
Call a ticket number stored in the park register. The ticket number is removed from the park
register.
FUNC_PARK_REMOVE
Remove a ticket number from the park register.
FUNC_PARK_SCROLL
Scroll through the stored ticket numbers. The ticket numbers are displayed on the workstation
terminal's display.
Park register
Q-WIN Reference Manual - Vol 1, Basic
298 Q-MATIC AB 087.01E
087.01E Q-MATIC AB 299
29. Client settings
Topics in this chapter
Hot keys....................................................................................... 300
Window options .......................................................................... 301
Client settings.............................................................................. 302
Branch register ............................................................................ 305
Q-WIN Reference Manual - Vol 1, Basic
300 Q-MATIC AB 087.01E
Hot keys (keyboard shortcuts) make it possible for the user to use the keyboard instead of the
computer mouse.
Select "Define Hot Keys" from the Utilities menu.
Select one of the four functions.
Enter the key combination that should be used as hot keys.
Click OK to save the settings.
Hot keys
Client settings
087.01E Q-MATIC AB 301
Select "Window Options" from the File menu.
Click the Toolbox tab. Set a checkmark for those toolboxes that should be visible.
The General Options tab has three settings.
Show tab window
Window options
Q-WIN Reference Manual - Vol 1, Basic
302 Q-MATIC AB 087.01E
Set the check mark to use tabs when more than one window is open at the same time. Use
the tabs to select which window that should be active.
User can move Toolbars
Set the check mark if it should be possible to move the toolbars.
User can dock windows
Set the check mark if it should be possible to dock management screens. Please read the
statistics and managements manual for more information about management screens.
The client settings are stored on the client in the qwin.ini file. Here is a short description of the
content of the file.
[BRANCH]
These are the settings from the branch register.
[CAT_REPLICATION]
These are the settings from the network category transfer.
Client settings
Client settings
087.01E Q-MATIC AB 303
[CUSTMAG]
These are the settings for the Q-WIN CLIENT TERMINAL.
[CUSTOMER_REGDLG]
These settings specify the contents of the customer registration dialogue.
[CUSTOMER]
These are the settings for the terminal in the Q-WIN client.
Q-WIN Reference Manual - Vol 1, Basic
304 Q-MATIC AB 087.01E
[DB_IMPORT]
These are the settings for the database import.
[HOT_KEY]
These are the hot key settings.
[LOG_CENTRAL]
These settings are used to get a very detailed log. See Q-WIN Reference Manual Volume I for
more information.
[PROPERTIES]
This is information from the properties dialogue.
[PROTOCOL]
These are settings for the communication between the Q-WIN client and the Q-WIN server.
Client settings
087.01E Q-MATIC AB 305
ANSI_OEM
This setting converts ANSI characters on the Q-WIN client to OEM characters. The default
value is 0 and it is normally not changed. Some old printers require that the character set is
converted to OEM.
[SYSTEM]
These are database settings. See Q-WIN Reference Manual Volume III for more information.
[VIEW_TICKET]
This setting is used when a ticket is previewed on the screen.
[WINDOWS_PRINTER]
These are the printer margins.
[Q-CALENDAR]
These settings make it possible to disable or enable some functions in Q-WIN CALENDAR.
The branch register specifies the connection between the client and the server. It can also be used
to import statistics from other Q-WIN or Q-MASTER systems and to synchronies databases.
Opening the branch register
Adding a branch
Right click "Q-WIN NET".
Select "New Branch" from the menu.
Branch register
Click Branch Selector in the start window or select "Branch
Selector" from the Utilities menu.
Q-WIN Reference Manual - Vol 1, Basic
306 Q-MATIC AB 087.01E
Enter the branch number. Make sure that this is the same number as in the system server
settings for the branch.
Enter the name of the branch.
Enter the branch address.
Specify the type of the connection.
Enter the path to the statistics directory for the branch. This path is used to store statistics
after a transfer.
Enter the path to the qsys.ini file. This path is used if "Catch Setup" has been selected. A
copy of the qsys.ini file will be saved on the Q-WIN client.
Click Save to save the new branch.
Editing a branch
Select the branch in the branch register.
Edit the information.
Click Save to save the settings.
Removing a branch
Right click the branch in the branch list.
Select delete from the menu.
Click Save to confirm the deletion.
Connecting to a branch
The Q-WIN client is connected to the server at the selected branch. This makes it possible to
transfer statistics, edit ticket texts or change the system settings.
Client settings
087.01E Q-MATIC AB 307
Click the branch name in the branch list.
Click Connect.
It is also possible to right click the branch name and select "Connect to Branch".
Additional settings
Catch Setup
Catch Setup saves a copy of the qsys.ini file on the Q-WIN client. This copy is used to print
statistics reports. Specify where the file should be save and set the Catch setup check mark to
enable the function.
Use the Database located on the server
Always set this check mark. The Q-WIN client should always use the database on the Q-WIN
server.
Q-WIN Reference Manual - Vol 1, Basic
308 Q-MATIC AB 087.01E
087.01E Q-MATIC AB 309
30. Staff management
Topics in this chapter
Staff members ............................................................................. 310
Staff groups ................................................................................. 314
User groups ................................................................................. 316
Q-WIN Reference Manual - Vol 1, Basic
310 Q-MATIC AB 087.01E
The staff member registration pages are used to read, add or change information in the
STAFINFO table in the database.
Click "Staff Member Registration" in the start window.
The staff member management has three sections: Staff Members, Staff Groups and User Groups.
These sections all work in the same way. Click the appropriate Type to display the list of its
members.
The staff member information is grouped on three tabs.
General tab - All the specific settings of a staff member are collected on this tab.
User Groups tab - The User Groups to which the staff member belongs. User groups specify
staff members access to Q-WIN.
Staff Groups tab - The Staff Groups to which the staff member belongs. Staff groups usually
describe the service provided by the staff members. The staff groups are used to make it
easier to read the Q-MATIC Calendar.
Do not forget to click Save after making changes.
Staff members
Staff Members contains information about the staff members.
Staff Groups are used in Q-MATIC Calendar to group staff
members performing the same type of tasks.
User Groups specify the access level to Q-WIN. A user must
be included in a user group to be able to login to Q-WIN.
To add a member (or group), click the Add button.
Search for a member of a group by entering the beginning of its
name in the search field and click the Search button.
Staff Management
087.01E Q-MATIC AB 311
The General tab
Part 1 of Personal settings.
Part 2 of Personal settings.
Q-WIN Reference Manual - Vol 1, Basic
312 Q-MATIC AB 087.01E
Part 3 of Personal settings.
Email. The email address is used in Q-MATIC Calendar to notify the staff member about new
appointments and customers that have arrived.
Pager name. The pager can be used together with Q-MATIC Calendar to notify the staff
member about new appointments and customers that have arrived. The pager must be specified
in the pager settings.
Office Printer. This printer can be used together with Q-MATIC Calendar to write an arrival slip
when a customer arrives for an appointment.
Button name. A staff member must be assigned to a ticket button to be able to use Q-MATIC
Calendar to book customer appointments.
Login Id. This is the staff identification number used to identify the staff member in the database.
It is not possible to change this number.
Work Start, Work End, Salary, Working limit, During weeks and "Use present month instead of
weeks". These settings are used in Q-MATIC Staff Advanced
Login code. Login code is used to identify the staff members. There are two ways to assign a login
code to a staff member. Used to login on workstation terminals like the KT2595 and the Web
Terminal.
Manually enter a login code.
Click Create to create a unique random login code.
Two staff member cannot have the same login code.
Button name. Lock the staff member to a specific ticket button. The staff member will be able
to call ticket numbers from this ticket button only.
Priority. Lock the login code to a priority.
Staff Management
087.01E Q-MATIC AB 313
Password. Click Password to change the staff member's password.
Enter the password and click Save.
The User Groups tab
Adding the staff member to a User Group
A staff member can be included in more than one staff group.
Click a Group name in the Not members of these groups list.
Removing the staff member from a User Group
Click a Group name in the Already member of these groups list.
Q-WIN Reference Manual - Vol 1, Basic
314 Q-MATIC AB 087.01E
The Staff Groups tab
Adding the staff member to a Staff Group
A staff member can be included in more than one Staff Group.
Click a Group name in the Not members of these groups list.
Removing the staff member from a Staff Group
Click a Group name in the Already member of these groups list.
Staff groups usually describe the service provided by the staff members. The staff groups are used
to make it easier to read the Q-MATIC Calendar. There are three tabs here:
General tab
Membership tab
Access Control tab
Staff groups
Staff Management
087.01E Q-MATIC AB 315
The General tab
Set the "Can book appointments" to make the staff group available in Q-MATIC Calendar.
The Membership tab
Adding a staff member to the staff group
A staff member can be included in more than one staff group.
Click a staff member name in the Non members of this group list.
Q-WIN Reference Manual - Vol 1, Basic
316 Q-MATIC AB 087.01E
Removing a staff member from the staff group
Click a staff member name in the Already members of this group list.
Access Control tab
User groups specify staff members access to Q-WIN. All staff members in a user group can access
the same parts of Q-WIN. There are three tabs here:
General tab
Membership tab
Access Control tab
User groups
Staff Management
087.01E Q-MATIC AB 317
The General tab
The user group policy specifies the user group's access to Q-WIN.
Q-WIN CALENDAR Access
These settings specify a user group's access to Q-WIN CALENDAR. A staff member must be
included in a user group that have access to Q-WIN CALENDAR to be able to open it.
Accessible Staff Groups
These are the staff groups that the user group has access to in Q-WIN CALENDAR. The user
group cannot read information about staff groups not included in the list.
Access rights to the selected staff group and its member
The settings specify the user group's access to each of the staff groups in the list. Select a staff
group and select one of the access levels.
Read. The user group can only read the information about the staff group in Q-WIN
CALENDAR.
Set Appointments status to "arrived". The user group can inform staff members in the staff
group when a customer has arrived for an appointment.
Write. The user group has full access to Q-WIN CALENDAR. They can read the
information, inform that a customer has arrived, book new appointments and change existing
appointments for the staff group.
WEB Reports
This setting specifies the web reports that are accessible for the user group. Each staff member
must also have a user name and a password to be able to read the reports.
Q-WIN Reference Manual - Vol 1, Basic
318 Q-MATIC AB 087.01E
Branch Access
This setting specifies the branches that are accessible for the user group.
Menu Access
This setting specifies the parts of Q-WIN that will be available for the user groups. Parts that are
not available are not displayed on the screen when the user logs in to Q-WIN.
The Membership tab
Staff Management
087.01E Q-MATIC AB 319
The Access Control tab
Adding a user group
A staff member should be included in only one user group otherwise it is impossible for Q-
WIN to assign the correct access level.
1. Click User Groups to show the user group view.
2. Click Add.
3. Enter the name of the user group and click Save.
4. Select the new user group in the User Groups list.
5. Specify the policy for the user group.
6. Click Save.
7. Add staff members to the user group. Click the Membership tab. Click staff member names
in the top list to add them to the user group. Click a name in the "Already members of this
group" list to remove the staff member from the user group.
Editing a user group
To edit a user group:
1. Click User Groups.
2. Select the user group.
3. Edit the settings for the user group.
Q-WIN Reference Manual - Vol 1, Basic
320 Q-MATIC AB 087.01E
4. Click Save to save the changes.
Adding a staff member to the user group
From the user group view
A staff member must be included in only one user group otherwise it is impossible for
Q-WIN to assign the correct access level.
1. Click User Groups.
2. Select a user group.
3. Click the Membership tab.
4. Click a staff member name in the Non members of this group list.
From the staff member view:
1. Click "Staff Members".
2. Select a staff member.
3. Click the User Groups tab.
4. Click a user group in the "Not member of these groups" list to add the staff member to the
user group.
Removing a staff member from a user group
From the user group view:
1. Click User Groups.
2. Select a user group.
3. Click the Membership tab.
4. Click a staff member name in the Already members of this group list.
From the staff member view:
1. Click "Staff Members".
2. Select a staff member.
3. Click the User Groups tab.
4. Click a user group in the "Already member of these groups" list to add the staff member to
the user group.
087.01E Q-MATIC AB 321
31. Troubleshooting
Topics in this chapter
Problems with Q-WIN.................................................................. 322
Reset system................................................................................ 324
Preset category............................................................................ 325
Display test .................................................................................. 325
ID code test.................................................................................. 326
Log files ....................................................................................... 326
LOG_CENTRAL............................................................................. 328
About Q-WIN............................................................................... 329
Q-WIN Reference Manual - Vol 1, Basic
322 Q-MATIC AB 087.01E
Q-WIN is a very complex and flexible program. This is of course an advantage but it may cause
problems. Sooner or later you will have a system that does not work properly.
Q-WIN has some tools that can help you to find errors in the system.
What do I do when the system does not work? Here are some guidelines that will help you to
find the type of the problem and some suggestions of solutions.
Q-WIN does not start
Do you get the Security failed error message?
Yes!
This error message indicates that Q-WIN cannot read the licence from the interface. Check
that:
the interface is connected to a COM port on the PC.
the interface is connected to the rest of the system.
the interface is powered.
correct COM port is specified in the qsys.ini file. Check the PORT setting in the [IO] section
of the file.
you have a valid licence in the Lic folder.
the client has contact with the server and that the server is running.
No!
Is it the first time you try to start Q-WIN in this system?
Yes!
If you have changed anything in the settings then use the qsys_org.ini file. Do not forget to
first rename the ini-file with your settings. If Q-WIN starts then you should check your
settings.
Uninstall Q-WIN and reinstall it.
Check that everything is OK with the computer.
Close all other programs.
No, this system has been running without problems.
If you have changed anything in the settings then use an ini-file that you know works. You
can also use the qsys-org.ini file. Do not forget to first rename the ini-file with your settings.
If Q-WIN starts then you should check your settings.
Problems with Q-WIN
Troubleshooting
087.01E Q-MATIC AB 323
Delete all data files (.dat) in the Data folder. Corrupt data files can cause many problems.
You do not lose any important information when they are deleted. They will be recreated the
next time you run Q-WIN.
Check that no software installed after Q-WIN can cause this problem.
Check that there are no problems with the hard disc or any other part of the PC.
You get errors in the night
You probably get this error at the daily reset. Use the test button in the Time/Date settings to
test if the daily reset causes the error. If this is the problem then start to check your script
programs. Perhaps there is a value that must be reset.
If the system serves customers in the night then check that there are no scripts that can cause
problems when the date changes.
You get an error when you start to serve the customers but not later
You have probably forgotten to reset a value in a script program. Check that old values in the
Array cannot cause this problem. Remember that the Array keeps the information even if you
turn off Q-WIN.
Problems to transfer files from a Q-MASTER
There are two time settings for the communication. The Q-MASTER is slow which can cause
problems. Use the following settings in the [PROTOCOL] part of the qsys.ini file.
CONNECT_TIME_OUT= 5000
ANSWER_TIME_OUT = 5000
Wrong characters on the tickets and in reports
Disable the ANSI to OEM setting in the [PROTOCOL] section of the qwin.ini file,
ANSI_OEM=0. Note that this is only possible if you have a new printer. Older printers cannot
use ANSI characters.
Check the fonts used in the reports. Perhaps the font does not contain the characters.
Other hints
Check the error log; perhaps it contains some useful information.
Always try with a qsys.ini file that you know work. You can always use the qsys_org.ini file. If
this helps then you must carefully check your ini-file. Check that you have not removed anything
from a setting that is used in another setting.
Try Q-WIN on another PC.
Read the manual. Please take a second look in the manual.
Contact the support department
It is now time to contact the support. Please always give us the information listed below. This
information can save us very much time and makes it possible for us to give you a quicker answer.
Q-WIN Reference Manual - Vol 1, Basic
324 Q-MATIC AB 087.01E
Settings. Please send us the qsys.ini file. We want to test with the same settings that were
used when the error occurred. Please give us a short description of the system if the settings
are different from the original ones. It takes very long time for us if we must read through all
settings to understand the system.
Error log. Please send us the error log if it contains any error messages from the time of the
error.
Q-WIN version. It is almost impossible for us to help you if we do not know the version that
you use. Do not forget to inform us if you use a service pack.
Background. When does the error occur? Is it a system that has been working? In such case
for how long time and is there anything that you know happened when the system stopped?
How was the system used when the error occurred?
Description of script programs. Please describe all scripts that you have added. We want to
know where you have added scripts and what they are supposed to do.
Layouts. Please send us the layout files if you have problems with non-standard management
screens or a statistics reports.
Statistics files. If you have problems with a statistics report then please send us the same
statistics files that you use. This makes it possible for us to recreate the error here.
Information about the PC running Q-WIN. We want to know the operating system, type of
processor, etc.
Any other information that can help us. We must try to recreate the error here otherwise it
is difficult for us to find it. All information that can give us a clue is important.
Can we always help you? There are situations when it is impossible or almost impossible for us
to help you.
The problem is outside Q-WIN. We do not support products from other manufacturers
(graphic cards, sound cards, Microsoft Windows, Microsoft Office programs, etc.).
Sometimes we can give you some help but we recommend that you contact the support for
the product. Usually you can fin help on the manufacturers home page on the internet.
We cannot recreate the problem and is unique. This is the worst kind of problems. Of course
we will try to help you but sometimes (they are extremely rare) it is impossible.
Bugs. The support cannot solve bugs. They can help you if there is a workaround. Bugs are
registered in a database that the programmers read when they make service packs.
The function does not exist. Sometimes you want to do something that is not possible in the
current version of Q-WIN. The support cannot help you; they cannot add new functions to
the program. Your request is registered and will be taken into consideration when we make
a new version of Q-WIN.
This function rests all ticket numbers and they restart from the first number in the sequence. The
reset is used during test of the system. Select "Utilities" and "Reset system".
Reset system
Troubleshooting
087.01E Q-MATIC AB 325
Click Save to reset the system .
Never use Reset in a running system with waiting customers.
Preset categoryr is used when you test the system and you want ticket numbers in a queue but
you do not want to spend time pressing the ticket buttons. The specified number of ticket
numbers are placed in the selected queue and they replace any existing ticket numbers. Select
Utilities and "Preset Category".
Start
You can specify the first ticket number that will be used. Q-WIN will use the start ticket number
from the category settings if Start is 0.
Tickets
This is the number of ticket numbers. All existing ticket numbers are erased.
Ticket button
Select in which ticket button queue you want to place the new ticket numbers.
Never use Set new ticket number in a running system with waiting customers.
The display test turns on all LEDs on all displays in the system (including the display on the
workstation terminals). Select "Utilities" and "Display test".
Seconds
Enter the length of the test in seconds and click Save.
Preset category
Display test
Q-WIN Reference Manual - Vol 1, Basic
326 Q-MATIC AB 087.01E
Show the ID code on the displays. Select Utilities and "ID codes test".
Seconds
Enter the length of the test in seconds and click Save.
The log files are very useful when you want to trace an error in Q-WIN. All log files are stored
in the Log folder.
Autorep.log
This log file stores information when Auto Reports are printed.
Example
18/12/01 Tuesday 13:00:06 , Category Daily : Printed Ok!
Err_msg.log
Some errors are stored in this log file.
Example
< 2001-12-18 15:56:01.038 55.01q Build: Dec 14 2001 Message > "CPP Error, Thread 210, File
_qwin_01.src\_supsrv.07\SMTP.CPP:265, 2048:Windows Socket error 'No listed error':
Couldn't get hostname or host address 'mail.emailhost.com'."
ID code test
Log files
Troubleshooting
087.01E Q-MATIC AB 327
Error.log
This is the most used of the log files. It stores messages and errors from the Q-WIN server. Select
Utilities and "Server log" from the web page or View Error Log from the Utilities menu in
the Q-WIN client.
There are some settings for the error log in the qsys.ini file the [ERROR] section.
FILE_MAX is the maximum size in bytes for the error log. The error file is renamed and stored
as a separate file when it reaches this size.
MAX_ERR_FILES is the maximum number of old error log files that are stored. The oldest file
is deleted if Q-WIN reaches this level.
Update
Click the Update button once to hide all old messages. Only messages stored after you clicked
on the button are shown. Click a second time to show all messages again.
Always check this file if you have a problem in Q-WIN. We usually want you to attach it to your
support questions.
Example
< 2002-12-18 14:22:36.056 55.01r(beta) Build: Nov 8 2002 >
271:0000000000(0000) <_qwin_01.src\_supsrv.07\qwsthred.cpp:195> Message:
Log on
-----
< 2002-12-18 14:23:01.043 55.01r(beta) Build: Nov 8 2002 >
272:0000000000(0062) <_qwin_01.src\_supsrv.07\qwsthred.cpp:287> Message:
Log off
Host.log
The file name of the host log also contains the date and the time when the file was saved, for
example Host200212181422.log. This file stores all communication with the Q-WIN server. It
is by default disabled. You must set HOST_LOG=1 in the [HOST] section of the qsys.ini file.
Only enable the host log on request from Q-MATIC and only for a very short time. The log
stores all communication and grows very fast.
Q-WIN Reference Manual - Vol 1, Basic
328 Q-MATIC AB 087.01E
You cannot read the information in the host log because it is a binary file. It is rarely used and
only on request from Q-MATIC Sweden.
Qwin.log
This is the log file for the Q-WIN client. It stores messages and errors from the client.
Example
2002-12-17 13:49:38.097 Log On
2002-12-18 10:29:06.014 Log On
2002-12-18 14:22:36.025 Log On
2002-12-18 14:25:30.037 Log On
Test.log
The test log file is only used when you test a system or try to find an error. It is disabled by
default. You use the [LOG_CENTRAL] in the qwin.ini file to turn on this log and to specify the
information that should be stored.
You only use the test log when the support team at Q-MATIC want this kind of information
from the system. They will inform you about the settings when they ask you to enable the log.
Never enable this log during normal use of the system. The log stores much information and
can be extremely large.
Example
2002-11-22 13:49:01.051 15454.864, Layout, Basic, Read Layout, path:
LAYOUT\099TEST.SRP
2002-11-22 13:49:01.051 32.154, StatMtx, Basic, Rebuild due to QWIN.INI
changed
2002-11-22 13:49:01.051 15.110, StatMtx, Basic, Matrix write to file due
to 'check_rebuild' found changes
2002-11-22 13:49:01.051 49.499, Action_cache, Basic, Cache miss!
2002-11-22 13:49:01.051 0.053, Action_cache, Basic, Time: 29.570ms
It is possible to save the test log as a binary file: testbin.log.
These settings are used together with the test log file. These setting make it possible to get a very
detailed log of the activities in Q-WIN. The settings for the log file may be changed and they are
not listed in this manual. The test log file is only used when Q-MATIC Sweden want detailed
information about the system.
ACTIVE
Set ACTIVE=1 to activate the test log.
LOG_CENTRAL
Troubleshooting
087.01E Q-MATIC AB 329
BIN_LOG
Set BIN_LOG=1 to save the test log file as a binary file.
The About Q-WIN window shows some information about the Q-WIN System. Select About
QWin... from the Help menu and click the More info button.

Connected Work Stations in use
This is the workstation numbers for all software workstations that are active. Hardware
workstation terminals (KT2143/KT2243) are not included.
Server system performance
Loops
This the number of loops to contact connected units that were performed during one minute.
Time (min., avg., max.)
The minimum time, average time and maximum time for these loops.
Script avg.
The average time it took to run a script.
Server network performance
Requests
This is the number of times that Q-WIN has received a request through the network.
About Q-WIN
Q-WIN Reference Manual - Vol 1, Basic
330 Q-MATIC AB 087.01E
Wait for system
The time until Q-WIN has received the request.
Execute command
The time it took to execute the command.
Send answer back
The time until the answer is returned.
Manager request performance
Requests
This is the number of times that the Q-WIN client has requested something from the system
server.
Command
Times until these requests were handled.
087.01E Q-MATIC AB 331
Index
A
About Q-WIN 329
adding a branch 305
advanced display programming 152
advanced programming commands 159
alarm settings 94
Arabic fonts 166
assign ticket to button 75
Autorep.log 326
B
backup 26
barcode 58, 72
branch access 318
branch register 305
Broadcast ID code 142
Broadcast Sub ID Code 171
BSID 142
C
card reader 102
card reader interface 107
card validation 102
Catch Setup 307
Category 22
category transfer 252
CLEAR_GROUP 193
client 24
client settings 34, 302
CLOSE 193
code page 59
connecting to a branch 306
Customer 22
D
daily reset 182
display area 152
display commands 145
displays 128
E
editing a branch 306
Err_msg.log 326
Error.log 327
estimated waiting time 116
events 180
F
Font Id 171
Q-WIN Reference Manual - Vol 1, Basic
332 Q-MATIC AB 087.01E
fonts 140
FUNC_EMAIL 175
H
Host.log 327
I
ID code 87
ID code test 326
image (ticket) 74
information display 138
installation 33
L
log files 326
login 16
login codes 312
M
main display 128
MAKE_TICKET 193
mask 152
memory area 152
menu access 318
movement list 154
multi interface program commands 193
N
new ticket 51
NEXT 193
NT service 33
P
pager 200
park register 297
password 40
password settings 238
phrases 265
picture (ticket) 50
PRINT_TICKET 194
PRINTER_BUTTON 248
PRINTER_BUTTON_PUSHED 248
priority statements 207
Q
QFont 141, 166
quick texts 78
Q-WIN API 27
Q-WIN CALENDAR 27, 28, 317
Q-WIN client 24
Q-WIN CLIENT TERMINAL 27
Q-WIN CUSTOM LAYOUTS 27
Q-WIN DATABASE STATISTICS 28
Q-WIN Interface 23
Q-WIN MAIL 28
Index
087.01E Q-MATIC AB 333
Q-WIN PAGER 28
Q-WIN server 24
Q-WIN STAFF ADVANCED 29
Q-WIN STAFF BASIC 29
Q-WIN TICKETLESS 246
Q-WIN VOICE 28
Qwin.log 328
R
Refresh Time 170
registers 293
removing a branch 306
Requirements 32
S
scheduler 242
SCRIPT 194
SENSOR 194
SEQUENCE 195
sequence programs 291
server 24
server installation 33
Service packs 36
single programs 291
Staff Member 22
staff member registration 310
sub ID code 87
T
Test.log 328
ticket printer 246
ticket text program 48
tickets 44
toolboxes 301
U
upgrade the licence 35
upgrade to a new Q-WIN version 36
user groups 316
V
voice 95, 102, 107, 113, 124, 129, 138, 174, 178, 184, 186, 190, 238, 246, 258, 274, 280
Voice Unit 259
VU2187 259
W
WEB Reports 317
windows user name 40
Workstation 22
workstation display 286
workstation keys 290
Q-WIN Reference Manual - Vol 1, Basic
334 Q-MATIC AB 087.01E
Q-MATIC AB, Neongatan 8, SE-431 53 Mlndal, Sweden. Tel +46 31 756 46 00. Fax +46 31 756 46 99.
[email protected] www.q-matic.com