Top Banner

of 348

Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
  • Q-WIN

    Reference ManualVol 1 Basic

    TorbjornRectangle

  • Copyright notice

    The information in this document is subject to change without prior notice and does notrepresent 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 assumeany 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 Basicand 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 permissionis given by Q-MATIC AB.

    COPYRIGHT 2005-2008 Q-MATIC AB087.01E Q-MATIC AB i

  • Q-WIN Reference Manual - Vol 1, Basicii Q-MATIC AB 087.01E

  • Contents

    1. News in Q-WIN S ......................................................... 1Web interface and web server ............................................................. 3Management screens .......................................................................... 3System Configuration .......................................................................... 4New user interface .............................................................................. 5New licence structure .......................................................................... 5User group policies .............................................................................. 5New script functions............................................................................ 6Q-WIN CALENDAR............................................................................... 7Sort the columns.................................................................................. 7Deleted appointments ......................................................................... 8Arrival notification............................................................................... 8Book appointments in the Appointment List ....................................... 9Row numbers in the Appointment List ................................................ 9Use the ticket button to specify the ticket number sequence .............. 9Undo arrived or call customer ............................................................. 9All CUSTINFO fields can be shown in the Appointments List............. 10Open with the current date ............................................................... 10Better error message when the booking is incomplete...................... 10Edit or delete appointments in the appointment list ......................... 11Change the staff member when you edit an appointment ................ 11Open a management screen when the customer arrives ................... 11Search for a customer........................................................................ 12Comments added to appointments ................................................... 13Multi interface with radio and wireless terminal ............................... 13New management screens ................................................................ 13New statistics reports ........................................................................ 13Password ........................................................................................... 14Logging into Q-WIN........................................................................... 16Coded information in the network .................................................... 16Maximum number of labels in scripts................................................ 16Script program output size ................................................................ 16New script functions.......................................................................... 16Q-WIN Advanced scripts.................................................................... 17Send parameters to a script program in the Q-WIN server ................ 17087.01E Q-MATIC AB iii

    New workstation command .............................................................. 18New event ......................................................................................... 18

    2. News in Q-WIN S SE................................................... 19Support for TP3100 family of printers................................................ 20Ticket Editor for TP3100 family of printers ........................................ 20

  • Q-WIN Reference Manual - Vol 1, Basic

    3. Q-WIN system.............................................................21What is Q-WIN .................................................................................. 22Terminology ...................................................................................... 22Q-WIN Interface ................................................................................ 23Q-WIN server..................................................................................... 24Q-WIN Clients.................................................................................... 26Data files ........................................................................................... 26Options.............................................................................................. 27Q-WIN Applications........................................................................... 28

    4. Installation .................................................................31Hardware and software requirements ............................................... 32Licences............................................................................................. 32Installing Q-WIN for the first time ..................................................... 33Installing Q-WIN clients..................................................................... 34Upgrade an existing licence .............................................................. 35Upgrade Q-WIN to new version ........................................................ 36Install a service pack (SP) .................................................................. 36External Q-WIN applications ............................................................. 36

    5. Start Q-WIN ................................................................39Logging into Q-WIN .......................................................................... 40Start window..................................................................................... 41

    6. Tickets ........................................................................43Tickets are more than ticket numbers ............................................... 44Ticket creator and editor - BP2800.................................................... 47Editing plain text ............................................................................... 48Editing a ticket layout program ......................................................... 48Adding a picture................................................................................ 50Removing a picture ........................................................................... 51Creating a new ticket ........................................................................ 51Selecting ticket .................................................................................. 52Example 1 - a simple ticket ............................................................... 53Example 2 - Print two tickets at same time ....................................... 54Example 3 - Shift between two different tickets................................ 55Example 4 - Stop printing tickets....................................................... 55Example 5 - System without workstation terminals .......................... 56Control codes .................................................................................... 57Ticket creator and editor - TP3100 .................................................... 65Editor commands .............................................................................. 66Creating a new ticket ........................................................................ 68iv Q-MATIC AB 087.01E

    Inserting and editing text .................................................................. 68Inserting and editing system information.......................................... 70

  • Contents

    Inserting and editing scripts on a ticket............................................. 72Inserting and editing barcodes on a ticket......................................... 72Creating images for tickets................................................................ 74Inserting and removing images ......................................................... 74Assigning a ticket to a button ........................................................... 75Examples ........................................................................................... 76

    7. Quick texts................................................................. 77Quick text .......................................................................................... 78Editing a quick text............................................................................ 78Adding a quick text ........................................................................... 79Removing a quick text ....................................................................... 79

    8. Customizing web pages............................................. 81Q-WIN events and Javascript functions ............................................. 82Load the Q-WIN event Javascript library............................................ 82Set up which events to listen to ........................................................ 83Handle Q-Win events......................................................................... 83

    9. System configuration ................................................ 85General information about settings................................................... 86Number of units................................................................................. 86Number and name............................................................................. 86ID codes and Sub ID codes ................................................................ 87The system configuration window..................................................... 88Setting levels ..................................................................................... 89Adding a new unit ............................................................................. 90Removing units.................................................................................. 91Move a unit to another group ........................................................... 91Creating a new group........................................................................ 92

    10.Alarm ......................................................................... 93Alarms in Q-WIN ............................................................................... 94General alarm settings ...................................................................... 94Messages from workstations............................................................. 96Automatic alarms .............................................................................. 97Alarms from workstations ................................................................. 98Alarms to workstations ..................................................................... 98

    11.Card readers ............................................................ 101Card readers in Q-WIN systems ....................................................... 102087.01E Q-MATIC AB v

    Card validation ................................................................................ 102General card validation settings ...................................................... 102

  • Q-WIN Reference Manual - Vol 1, Basic

    Card settings ................................................................................... 103Locking a card to a ticket button..................................................... 104Changing the card data before validation ....................................... 106Additional settings in the ticket printer settings.............................. 106Card reader units............................................................................. 107General card reader settings ........................................................... 107Card reader group settings.............................................................. 108Card unit settings ............................................................................ 109

    12.Category and ticket button......................................111The difference between ticket buttons and categories .................... 112Categories ....................................................................................... 113General category settings................................................................ 113Category settings ............................................................................ 114Tickets per time period.................................................................... 115Estimated waiting time in categories or ticket buttons ................... 116Ticket buttons.................................................................................. 118General ticket button settings ......................................................... 118Button group settings...................................................................... 119Ticket button settings...................................................................... 121

    13.Database ..................................................................123Database settings............................................................................ 124Backup settings ............................................................................... 125

    14.Displays ....................................................................127Display types ................................................................................... 128Main display.................................................................................... 128General main display settings ......................................................... 129Main display settings ...................................................................... 130Programming main displays ............................................................ 133Program example, two 1664 Displays as one main display............. 134Information displays........................................................................ 138General information display settings............................................... 138Information display settings ............................................................ 139Fonts ............................................................................................... 140Designing a new font ...................................................................... 141Different fonts to different displays ................................................. 142Introduction to programming .......................................................... 142Simple display commands ............................................................... 145Advanced programming .................................................................. 152Advanced programming commands................................................ 159vi Q-MATIC AB 087.01E

    911 and 917 .................................................................................... 163Complex languages......................................................................... 165

  • Contents

    Troubleshooting .............................................................................. 167Examples ......................................................................................... 167General font settings ....................................................................... 170Font settings.................................................................................... 171

    15.Q-WIN Mail .............................................................. 173Introduction..................................................................................... 174General Email settings..................................................................... 174Email message settings ................................................................... 175Sending an email message .............................................................. 175

    16.Host ......................................................................... 177General connections settings........................................................... 178Connection settings......................................................................... 178Communication ............................................................................... 179Event settings .................................................................................. 180Run script ........................................................................................ 180System script ................................................................................... 181Date and time.................................................................................. 181

    17.Licence..................................................................... 183Locking an application to a Q-WIN client ........................................ 184

    18.Matters .................................................................... 185Matters give detailed information ................................................... 186Adding matters................................................................................ 186Editing matters ................................................................................ 187Remove matters .............................................................................. 187Using matters at the workstation .................................................... 187

    19.Multi interface......................................................... 189Multi interfaces ............................................................................... 190General multi interface settings ...................................................... 190Interface group settings Internal programs ..................................... 191Internal programs for the input pins................................................ 192Internal program commands ........................................................... 193Interface group settings Script programs......................................... 195Input script programs ...................................................................... 196Output programs ............................................................................. 197Interface group settings RS232........................................................ 197Radio Interface ................................................................................ 198087.01E Q-MATIC AB vii

  • Q-WIN Reference Manual - Vol 1, Basic

    20.Q-MATIC Pager .........................................................199Introduction..................................................................................... 200General Pager settings .................................................................... 200Pager unit settings .......................................................................... 201Pager script ..................................................................................... 202

    21.Priorities...................................................................203Introduction..................................................................................... 204Priority settings ............................................................................... 204Editing priority settings ................................................................... 205Using priorities ................................................................................ 206Statements ...................................................................................... 207Category greater than X .................................................................. 208Category greater than X % of Category .......................................... 210Category greater than X % of Ticket Button ................................... 212Ticket Button greater than X ........................................................... 213Ticket Button greater than X % of Category ................................... 214Ticket Button greater than X % of Ticket button............................. 215Customers waiting in Categories From - To..................................... 216Test if a Person Choice Customer is waiting.................................... 217Alternate true X times and false Y times ......................................... 218Select a Customer from a Category ................................................. 219Select a Customer from a Ticket Button .......................................... 220Select a Person Choice Customer .................................................... 221Select by level.................................................................................. 222Select the highest value by level ..................................................... 225Select the highest value .................................................................. 226Select in priority sequence............................................................... 227Test if selection can be made .......................................................... 228Select by script program.................................................................. 229Test if a Workstation Choice Customer is waiting ........................... 230Select a Workstation Choice Customer............................................ 231Workstation open From - To............................................................ 232Between Time of Day From - To ...................................................... 233Jump to line by Script Program........................................................ 234Web priority settings ....................................................................... 234

    22.Security ....................................................................237Password settings ........................................................................... 238

    23.Scheduled activities .................................................241Starting an action at a pre-set time................................................. 242viii Q-MATIC AB 087.01E

    Adding a new scheduler setting ...................................................... 242Editing a scheduler setting .............................................................. 244

  • Contents

    Delete a scheduler setting ............................................................... 244Exclude days.................................................................................... 244

    24.Ticket printer ........................................................... 245Ticket printer together with Q-WIN ................................................. 246General ticket printer setting........................................................... 246Ticket printer group settings............................................................ 247Ticket printer settings ...................................................................... 249

    25.Transfer ................................................................... 251Category transfer............................................................................. 252Automatic transfer based on the waiting time ................................ 252Category transfer based on a script program .................................. 253Network transfer ............................................................................. 254Adding a network category transfer ................................................ 255Editing a network category transfer ................................................ 256Delete a network category transfer ................................................. 256

    26.Voice........................................................................ 257Voice interface................................................................................. 258Voice settings .................................................................................. 258General voice settings ..................................................................... 258Voice Script...................................................................................... 259VU2187 ........................................................................................... 259Q-WIN Voice.................................................................................... 261To say a number .............................................................................. 262Activate a Voice Unit ....................................................................... 263Recording phrases ........................................................................... 264English phrases in Q-WIN VOICE ..................................................... 265Example........................................................................................... 270

    27.Wireless Terminal .................................................... 273Introduction..................................................................................... 274Wireless Terminal settings............................................................... 274General Wireless Terminal settings ................................................. 274Wireless Terminal group settings..................................................... 275Learning a signature........................................................................ 276Wireless Terminal unit settings........................................................ 276Removing a Wireless Terminal ........................................................ 277

    28.Workstations ........................................................... 279087.01E Q-MATIC AB ix

    General workstation settings........................................................... 280Workstation settings ....................................................................... 281

  • Q-WIN Reference Manual - Vol 1, Basic

    Workstation type settings................................................................ 282Display info ..................................................................................... 286Keys................................................................................................. 290Single programs and sequence programs........................................ 291System variables.............................................................................. 292Registers.......................................................................................... 293Entering numbers from the keyboard .............................................. 293Scripts.............................................................................................. 294Terminal group settings................................................................... 295Park register .................................................................................... 297

    29.Client settings ..........................................................299Hot keys .......................................................................................... 300Window options .............................................................................. 301Client settings ................................................................................. 302Branch register ................................................................................ 305

    30.Staff management....................................................309Staff members ................................................................................. 310Staff groups..................................................................................... 314User groups ..................................................................................... 316

    31.Troubleshooting .......................................................321Problems with Q-WIN...................................................................... 322Reset system ................................................................................... 324Preset category................................................................................ 325Display test...................................................................................... 325ID code test ..................................................................................... 326Log files........................................................................................... 326LOG_CENTRAL ................................................................................ 328About Q-WIN................................................................................... 329x Q-MATIC AB 087.01E

  • 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 .................................................................... 13087.01E Q-MATIC AB 1

    Password ....................................................................................... 14

    Logging into Q-WIN....................................................................... 16

  • Q-WIN Reference Manual - Vol 1, Basic

    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 ......................................................................................182 Q-MATIC AB 087.01E

  • Q-WIN S has a new Tomcat web server. The new web server has made it possible to use webclients to reach some parts of Q-WIN. Here is a description of the features available from a webbrowser.

    Staff Member Registration

    The staff member registration has been moved from the Q-WIN client to the web client. Hereyou can perform all the tasks that were available in Q-WIN 2000 Q. New features are the usergroup 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 managementscreens 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 managementscreens. Three new default management screens are installed together with Q-WIN. It is easy todesign new and very flexible management screens.

    Web interface and web server

    Management screens087.01E Q-MATIC AB 3

    Please read Q-WIN Reference Manual Volume 4 for more information.

  • Q-WIN Reference Manual - Vol 1, Basic

    The new web based system configuration has a new and user-friendly user interface. Mostsettings are the same as in previous versions of Q-WIN but the tree structure makes it mucheasier to get an overview of the settings.

    Help texts are integrated with the page which makes it easier to understand the settings; justclick the text in the settings form to display the help text.

    System Configuration4 Q-MATIC AB 087.01E

  • 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. Thelicence still contains the interface number and can only be used together with the Q-WINInterface for which it was intended.

    All users of Q-WIN must belong to a user group. The user group has a user group policy thatspecifies the parts of Q-WIN that are available for the group members. This makes it possible togive every user access to those parts of Q-WIN that he or she needs. Those parts that are notincluded in the user group policy are not displayed on the screen.

    New user interface

    New licence structure

    User group policies087.01E Q-MATIC AB 5

  • Q-WIN Reference Manual - Vol 1, Basic

    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 = 2The 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 toretrieve 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.

    New script functions6 Q-MATIC AB 087.01E

    Return Values:The information in the slot as a string.

  • Example of return string "slot=slot|users=number of total users|in_use=number of usedusers|option1=options set on this slot|option2= options set on this slot|option3= options set onthis slot "

    LIC_WRK_INFO

    The total number of workstations that can be used and the number of workstations that arecurrently used.

    There are many improvements in Q-WIN CALENDAR. Most of these changes are made in theAppointment List.

    Here is an overview of the news in Q-WIN CALENDAR. Please read the Q-WIN CALENDARpart 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 columns087.01E Q-MATIC AB 7

  • Q-WIN Reference Manual - Vol 1, Basic

    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 isregistered as arrived.

    The Arrival notify dialog setting in the Calendar section of the User group policy (see User grouppolicies 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 toright click an appointment in the Appointment list. There will be no Notify dialogue when theArrival 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 notification8 Q-MATIC AB 087.01E

  • The Schedule new appointment button that has only been available in the AppointmentPlanner is now also available in the Appointment List. This makes it easier to book newappointments from the Appointment List.

    Row numbers are added to the Appointment List. The row number makes it easier to read thelist.

    Increased possibility of specifying the ticket number sequence in the ticket button settings. Inearlier versions of Q-WIN this was only possible if you reserved ticket numbers for theappointments, for example if the customer with the third appointment arrived he or she wouldget ticket number 003. Ticket number 001 was reserved for the first appointment for the dayand 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 ifno 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 fromTicket Button settings" check mark in the Q-WIN CALENDAR settings because it is still usedwhen 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 undoof an arrived customer deletes the ticket number from the queue and the ticket number is notincluded in the statistics. The undo of a called customer puts back the ticket number in the

    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 customer087.01E Q-MATIC AB 9

    original queue.

  • Q-WIN Reference Manual - Vol 1, Basic

    The following settings in the Calendar section of the User group policy (see User group policieson 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 possibleto 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 shownon the screen.

    There has always been an error message if you try to book an appointment but you forget toselect 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 incomplete10 Q-MATIC AB 087.01E

  • It is now possible to edit or delete appointments in the Appointment List. In previous versionsof 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 onpage 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 onpage 5) will enable or disable the ability to delete a called appointment and delete an arrivedappointment.

    Delete called Check / Uncheck.

    Delete arrived Check / Uncheck.

    It is now possible move the appointment to another staff member when you edit theappointment.

    It is possible to open a management screen when a customer arrives for an appointment. If themanagement screen returns TRUE then the status of the appointment is changed to customerhas 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 theappointment should remain as not arrived.

    The management screen can, for example, be used to check that a customer has all documents

    Edit or delete appointments in the appointment list

    Change the staff member when you edit an appointment

    Open a management screen when the customer arrives087.01E Q-MATIC AB 11

    required for the appointment. The management screen contains a list of documents and the usercan set a check mark for each document the customer shows. The management screen returnsTRUE if all check marks are marked otherwise it returns FALSE.

  • Q-WIN Reference Manual - Vol 1, Basic

    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/disableFollowing 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'sVIP level.

    [Q-CALENDAR]ARV_LAYOUT_BY_VIP = 0 1/0 enable/disableIf 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 thecustomer you want to search for. Click the Go Search button. The search is performed in twosteps. The first time you click the Go Search button Q-WIN is going to search for the selectedcustomer during the selected date.

    The Go Search button is changed to the Search More button. Click the Search More button tosearch for the customer within a specified date span.

    The LST_SRCH_START and LST_SRCH_END settings in the [Q-CALENDAR] section of theqwin.ini file specifies the number of days before and after the current day that should beincluded in the search.

    Search for a customer12 Q-MATIC AB 087.01E

  • You can select if you want to limit the search to the selected staff member or staff group or ifyou want to include all staff members/staff groups in the search. Click the settings button andselect 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 tothe 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.

    Comments added to appointments

    Multi interface with radio and wireless terminal

    New management screens

    New statistics reports087.01E Q-MATIC AB 13

    New improved statistics reports replace the previously used statistics reports.

  • Q-WIN Reference Manual - Vol 1, Basic

    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.

    Password14 Q-MATIC AB 087.01E

    A password can not have consecutive characters

    The password must not have consecutive characters.

  • 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 thedatabase.

    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 duringthe 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 willremember which passwords the user has used in the past. This setting specifies how many oldpasswords 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. Thenext 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.087.01E Q-MATIC AB 15

  • Q-WIN Reference Manual - Vol 1, Basic

    In a protected Q-WIN system the user must login before it is possible to use Q-WIN. The loginguarantees that the user gets their own access level to Q-WIN. This access level is specified inthe 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 30000characters.

    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 functions16 Q-MATIC AB 087.01E

  • It is possible to use SQL commands and API commands if you have a Q-WIN Advanced scriptslicence.

    SQL_OPEN( [select] [dsn] ) -> 0=error/1-x=handleSQL_FETCH( [handle] ) -> 1=Ok, 0=End of dataSQL_VALUE( [handle] [column] ) -> valueSQL_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 restof the script.

    It is possible to send parameters to a script program in the Q-WIN server.

    Q-WIN Advanced scripts

    Send parameters to a script program in the Q-WIN server087.01E Q-MATIC AB 17

    Format:

  • Q-WIN Reference Manual - Vol 1, Basic

    RUN [no] [var=value], [var=value],no = Program number.var = Variable A-Zvalue = text or number. If the first character in a value is a digit then the value must be an integer. If you want to includea 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 saveddue to a change.

    New workstation command

    New event18 Q-MATIC AB 087.01E

  • 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 .................................... 20087.01E Q-MATIC AB 19

  • Q-WIN Reference Manual - Vol 1, Basic

    Q-WIN S SE has full support for the TP3100 family of ticket printers. A new field has beenadded to the Printers section of the System Configuration page. Each printer in the system hasa Ticket printer IP Address field. In this field the IP address of a ticket printer of the TP3100 familymust 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 editorit is very easy for the end user to make nice looking tickets. The end user can insert text, picturesand some types of system information on tickets. It is also very easy to format the text, plain textas well as system information, as to font, size, bold, rotation etc. All fonts available on the servercan be used.

    Support for TP3100 family of printers

    Ticket Editor for TP3100 family of printers20 Q-MATIC AB 087.01E

  • 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 ....................................................................... 28087.01E Q-MATIC AB 21

  • Q-WIN Reference Manual - Vol 1, Basic

    Q-WIN is the server in a system that handles the flow of products in processes. Traditionally theproducts have been customers and the process has been waiting to be served. It does not have tobe like this, that is why we use the vague terms "products" and "processes". Q-WIN does not carewhich 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 spentat the different stages of the process. All this information is made available for applications in thesystem 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 handlethe waiting customers; it was a queue system. It is of course still possible to use Q-WIN in thisway but the possibilities are almost endless and your imagination is the limit, not the Q-WINSystem.

    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 forthe 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 usedbecause traditionally the Q-WIN system has been used to handle people in queue but it can bepackages, documents, cars, etc.

    Staff member

    Staff members are the resources used in the process. In the traditional queue system these arethe staff members serving the customers but it can be any other type of resources needed to servethe customers. It can be rooms, equipment, etc.

    Category

    Categories are the different stages in the process. In the traditional queue system these are thedifferent types of services that are provided to the customers but they may be stages in a process.

    Workstation

    What is Q-WIN

    Terminology22 Q-MATIC AB 087.01E

    Workstations are the places that handle the customers. In the traditional queue system these arethe counters but it can be desks, equipment, etc.

  • Q-WIN system

    The Q-WIN Interface is a small connection box that connects the Q-WIN software with the restof the Q-WIN system. There are two variants: one for RS-232 and one for USB connection. TheUSB 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, theyindicate 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, thered LED indicates that the connection with the Q-MATIC network is working and the blue thatthe 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 serverto the rest of the system.087.01E Q-MATIC AB 23

  • Q-WIN Reference Manual - Vol 1, Basic

    Q-WIN consists of two parts: the Q-WIN server and the Q-WIN clients. This duality is invisibleif 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 arestored 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

    Settings24 Q-MATIC AB 087.01E

  • Q-WIN system

    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 fromthe branches.

    HQ (LAN)

    Branch (LAN) Branch (LAN) Branch (LAN)

    Q-WIN

    Customer database

    WAN087.01E Q-MATIC AB 25

  • Q-WIN Reference Manual - Vol 1, Basic

    There can be as many Q-WIN clients as there are network users in the licence. The Q-WIN clientgives the users access to the information on the Q-WIN server. The licence and the user grouppolicy 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 someapplications, for example Q-MATIC Calendar and Q-MATIC Staff. Some Q-WIN featuresrequire a Q-WIN client, for example to edit tickets. The settings for the Q-WIN client are storedin the qwin.ini file.

    Web clients are clients to the Q-WIN web server. Web clients are used for most of the serversettings, staff member registration, management screens and statistical reports.

    Q-WIN Applications are applications that require a connection to the Q-WIN server. Thismanual 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 preventchaos if Q-WIN stops. The information is saved in data files (.dat) in the Data folder. Q-WINautomatically saves the information. The time between each backup is specified in the HostSettings/Date & Time settings.

    The Data folder also contains a temp.ini file that saves some temporary information, for examplepositions and sizes for windows that have been open inside Q-WIN.

    Q-WIN Clients

    Data files26 Q-MATIC AB 087.01E

  • Q-WIN system

    Options enhance Q-WIN and make it more useful. The user must have a licence to be able touse 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 handedover 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 sendand receive commands and information from Q-WIN to and from just about any other Windowsprogram. The Q-WIN API is programmable from just about any Windows programminglanguage. 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 notbased on the number of users.

    API Clients are the clients using API to communicate with the Q-WIN server. The licencespecifies 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 inexisting 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 reportsfor a customer.

    Q-WIN Distributed Management

    The Distributed Management option makes it possible to connect the Q-WIN client to remoteQ-WIN servers. This makes it, for example, possible for headquarters to collect statistics frombranches.

    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-WINTicketless option.

    Options087.01E Q-MATIC AB 27

  • Q-WIN Reference Manual - Vol 1, Basic

    Q-WIN Database Statistics

    Q-WIN Database Statistics makes it possible to store statistics in a database, for example in aMicrosoft Access database. This makes it possible for other applications than Q-WIN to read andpresent 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 thetoughest 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 oralphanumeric 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-WINVoice 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 twoseparate channels.

    The Q-WIN server itself is an invisible program running on a server. Only system administratorsand service technicians change in the server settings. The normal user uses one or more of theapplications in Q-WIN. There are two types of applications: internal applications and externalapplications. Applications require a licence for each user of the application.

    Internal applications are applications installed as a part of Q-WIN. Internal applications aredescribed 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-WINReference Manual.

    Q-MATIC Calendar

    Keeping track of customer information is vital. With Q-MATIC Calendar you can keep thingsrunning smoothly, with the ability to see all your office's appointments at a glance. Yourcustomers stay informed. You can inform them of appointment times, waiting times and evenintegrate your call centre.

    Q-MATIC Client Terminal

    Q-MATIC Client Terminal allows you to serve, call and identify your customers in one easy-to-

    Q-WIN Applications28 Q-MATIC AB 087.01E

    use interface. With Q-MATIC Client Terminal you have all of the resources you need to providegood customer service just one mouse click away.

  • Q-WIN system

    Q-MATIC Staff Advanced

    With Q-MATIC Staff Advanced you can choose the level of detail you work with. Whether youare interested in minute-by-minute management or just the bottom line, Q-MATIC StaffAdvanced 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 servicetargets 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 thirdparty 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.087.01E Q-MATIC AB 29

  • Q-WIN Reference Manual - Vol 1, Basic30 Q-MATIC AB 087.01E

  • 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.......................................................... 36087.01E Q-MATIC AB 31

  • Q-WIN Reference Manual - Vol 1, Basic

    Some applications have other requirements than those for Q-WIN. Please read thedocumentation for the application for more information.

    The licence is a file with information about the Q-WIN version, number of users, options andapplications. It is not possible to start Q-WIN without a valid licence. The licence is locked toone 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 thecomputer connected to the corresponding Q-WIN interface.

    Save a backup of the licence file.

    To install a licence:

    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.

    Licences32 Q-MATIC AB 087.01E

    1. From Q-MATIC you receive three files: the licence file (.qwl), and two files with informationabout the licence, a text file and an HTML file.

  • Installation

    2. Place the files in the licence directory, the default is the Lic directory, see below. Q-WINautomatically uses the licence.

    The licence only works when the corresponding Q-WIN Interface is connected to thecomputer.

    It is possible to have several licence files in the licence directory. Q-WIN searches the directoryand 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.qwlstores the name of the licence file in use and

    LIC_FILE_DIR = LICstores the name of the directory of the licence file. Default value is Lic. Change to any suitabledirectory 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 theProgram 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) onthe computer.

    This installation comes with a full Tomcat web server. It uses port 80 by default. Check that noother 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 userinterface when Q-WIN is running as a service but it is possible to install a client on the samecomputer to get a user interface.

    To make a good installation of Q-WIN do the following:

    1. Install the Q-WIN program.

    Installing Q-WIN for the first time087.01E Q-MATIC AB 33

    2. Copy the licence file to the licence directory.

  • Q-WIN Reference Manual - Vol 1, Basic

    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 communicationbetween 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. SeeConnection 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 changedor 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

    Installing Q-WIN clients34 Q-MATIC AB 087.01E

    to open the Q-WIN client before it has established a connection with the server. Do thefollowing:

  • Installation

    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, 501The following settings are made: Q-win server port 500, Q-Win server UDP port 501. Note: Itis 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, 5050The 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 toupgrade to a new Q-WIN version.

    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 licence087.01E Q-MATIC AB 35

    1. Order the licence.

  • Q-WIN Reference Manual - Vol 1, Basic

    2. From Q-MATIC you receive three files: the licence file (.qwl), and two files with informationabout 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 immediatelyavailable.

    When upgrading to version S, there are two things to consider: previous use of TCP/IPconnection 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 insertthese lines in the qsys.ini file:

    [HOST]MAX = 2HOST1 = DIRECTHOST2 = TCP_IP,500,501,30To move the contents of your existing Q-WIN (Access) database over to the new version ofQ-WIN you must run the X41 program. You must have run the new Q-WIN at least once sothat it has created the default database. An InstallAdmin user group is created with oneInstallAdmin user. All user group policies will have to be recreated; all users have full rights toeverything. 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 newlicence for a service pack.

    External Q-WIN applications are separate programs that need the Q-WIN server to run. Mostsettings are performed within the application and described in the application's manual but there

    Upgrade Q-WIN to new version

    Install a service pack (SP)

    External Q-WIN applications36 Q-MATIC AB 087.01E

    are two things that are general.

  • Installation

    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 thenetwork communication for the server is enabled. Open the system server settings and select theConnection tab. Enable the type of connection used between the application and the Q-WINserver. See Installing Q-WIN clients on page 34, for more information.087.01E Q-MATIC AB 37

  • Q-WIN Reference Manual - Vol 1, Basic38 Q-MATIC AB 087.01E

  • 5. Start Q-WIN

    Topics in this chapter

    Logging into Q-WIN....................................................................... 40

    Start window ................................................................................. 41087.01E Q-MATIC AB 39

  • Q-WIN Reference Manual - Vol 1, Basic

    The user must always log-in before using Q-WIN. The log-in gives the user the access rights thatare specified in the user group policy. The user name and password are specified in the staffmember 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 theWindows login name to identify the user. The Widows login name must be specified in the staffmember database.

    Enter a user name

    A user name is specified in the staff member database. The user must enter a user name to getaccess 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 getaccess to Q-WIN. The password can be used together with the user name.

    Logging into Q-WIN40 Q-MATIC AB 087.01E

  • Start Q-WIN

    Use the Q-WIN Workspace in the start window to start Q-WIN applications. The availableapplications on the Workspace depends on the user's access right. The Workspace is not openedif the user has access to only one application.

    Start window087.01E Q-MATIC AB 41

  • Q-WIN Reference Manual - Vol 1, Basic42 Q-MATIC AB 087.01E

  • 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 ....................................................................... 76087.01E Q-MATIC AB 43

  • Q-WIN Reference Manual - Vol 1, Basic

    Q-MATIC Ticket Editors are programs to design tickets that are printed on Q-MATIC ticketprinters. With the programs, all features of a ticket can be changed easily. You can keep ticketdesigns 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 ofprinter.

    Q-WIN needs to be set-up so that the correct Ticket Editor is on the Utilities menu for the enduser. 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 ticketis 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 mostimportant information on the ticket and is printed in a bigger text style. Above the ticket thereis usually a logotype or a short text message. Below the ticket number there are some informationtexts such as the estimated waiting time and the date and time the ticket was printed.

    Tickets are more than ticket numbers

    This is a typical ticket witha picture, a line of plain textand 4 lines of system infor-mation.

    This is an Information tick-et. It has only plain text andit will look the same everytime it is printed.

    There are three types of items that can be printed on a ticket:

    Plain text.

    Images.

    Items of these two types areexactly the same on alltickets.

    System information.

    This is information from thequeue system, for exampleticket number, time and date.The system automaticallyupdates this informationbefore it is printed on theticket.44 Q-MATIC AB 087.01E

    This is a good ticket design, but the tickets can have other designs as well.

  • Tickets

    Use the ticket Editor to design a ticket that serves the customers' needs in the best way. Forexample, print advertisements on the ticket. It is even possible to print different advertisementsat 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 handlethe service.

    It is even possible to completely remove the ticket number. Perhaps the user only wants aninformation 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 identifiedon arrival.

    It is possible to print more than one ticket at a time. Perhaps the customer should keep one ticketand 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 TP3100printer respectively.

    BP2800 TP3100

    The view of the complete ticket layout in the Editor:

    There is also a preview available of the ticketin this Editor, but this is the design windowfor scripts and text.

    In the TP3100 Editor, the scripts can bewritten as small snippets that are positionedon the ticket by dragging with the mouse. 087.01E Q-MATIC AB 45

  • Q-WIN Reference Manual - Vol 1, Basic

    System informationSystem information is information from the Q-WIN server. This information is dynamic andmakes it possible to print ticket number, selected service, time, date, etc. on the ticket. Usescript program in the ticket layout to print system information.

    BP2800It is usually not possible for end users tochange system information items because youneed good knowledge in script programming.Script programming and ticket layout are notdescribed in the Q-WIN User's Guide forthese printers.

    TP3100Some system information items (see below)can be managed separately and thereby endusers can handle them on a ticket.

    Many format properties of an informationitem can easily be changed: font, size, bold,alignment, rotation, etc.

    Plain textPlain text is always the same on all tickets that use the same ticket layout.

    BP2800The end user can change the text and changethe size of the text.

    TP3100The end user can easily change the text andmany format properties of the text: font, size,bold, alignment, rotation, etc.

    PicturesPictures are usually logotypes. Can be any type of picture, an advert, for example.

    BP2800The picture format used with these printers isnot a standard format. Use the bmpcnvt.exeprogram or the Q-Master Support program toconvert bitmap (bmp) pictures into the picformat. Both programs are available free ofcharge from the Q-MATIC Support Site.

    The picture must be available both as abitmap file and a hpic file.

    End users can easily insert images on tickets,but not add images to the image library.

    TP3100The picture format used with these printers isa standard format: Windows bmp, mono-chrome.

    End users can easily both add images to theimage library and insert images on tickets.46 Q-MATIC AB 087.01E

  • Tickets

    The Ticket Editor is used to edit tickets or to create new tickets. Select "Ticket Editor..." fromthe 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" toinsert 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: theQ-WIN pic-format to be able to print on a ticket and the bitmap (bmp) format to be able topreview 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 tickettext that is currently displayed in the Ticket script box.

    Ticket creator and editor - BP2800087.01E Q-MATIC AB 47

  • Q-WIN Reference Manual - Vol 1, Basic

    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 andDecrease 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.picAT 146 322

    \eB4\eH4Welcome

    "\eb4\eh5\eS"GROUP_NUMBER LEN(3)

    "\n\eb3\eh3"BUTTON_NAME

    "\n\eb1\eh3" TIME DATE" "PRINTER_TICKETS_LEFTLEN(4 ) "\n\f"48 Q-MATIC AB 087.01E

  • Tickets

    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 complexactivities 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 theticket. It is for example possible to add the FUNC_CAMERA_SNAPSHOT script command totake picture of the customer.

    Copy the ticket layout program to the clipboard before it is saved. The program may beerased 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 knowthat 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 Insertbutton 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 ticketbutton. For example, you want one information text printed if the customer arrives before 8:00am and an ordinary ticket printed if the customer arrives after that time. You can create a ticketlayout program that does not print any ticket at all. The ticket layout program usesFUNC_RUN_TEXT to select which of the two tickets, information ticket or ordinary ticket, thatwill