Scanning Tickets using Wireless Scanners

Wireless scanners are a convenient way of checking people into (or out of) a venue and tracking exactly who is on the premises. They are battery operated, portable and can be deployed from one entrance to another, depending on traffic or load. They are easy to operate, however they do require a few steps to get them working the first time. The general setup steps are:

  1. Contact ArtsMan Sales Dept to purchase a ticket scanner and licence (iOS device NOT included with purchase of scanner)
  2. Buy or get an iPhone or iPod donated that fits the ticket scanner you are going to purchase in step 1
  3. Install the ticket scanning software and mate with the network (usually a one time task).
  4. Set up the preferences to scan a particular event (once before the show)
  5. Scan the tickets as people enter and exit the venue.

 

Similar to the Web Scan method, you need to:

You use the scanner to check patrons in (step 3) or check them out of (step 4) the venue.

iOS device not included with purchase of scanner/licence. It must be acquired separately
Ensure you fully charge the devices before a performance so they have a full battery level. There is nothing worse than having the battery run out in the middle of admitting patrons. If necessasry, test the device while it is in the charger cradle and to make sure that it will still scan.
New Linea Pro scanners may arrive at your location not fully charged and occasionally drain completely during shipping or if they have not been used in a long time. In such instances, the scanner will appear non-responsive and probably won’t power up in a charging station. The solution is to remove it from any accessories (pistol grip) and plug it in directly with the provided mini-USB cable. It should start to charge normally within 1-2 hours at most.

If the scanner is still unresponsive after leaving it plugged in for a couple of hours, only then would something more serious be likely.
Print at home is wonderful and when enabled for a performance, it becomes the default ticket handling method online. Tickets are marked printed and the customer is prompted to download or print their tickets.

Print at home may be new behaviour for patrons at your venue. If so, we suggest doing an initial educational eblast to your current online purchasers that might mention things like:

  • Your Venue Name now offers print at home tickets which will be the the default way to get tickets for online purchases -and/or-
  • Patrons who purchased prior to this offering can log into their online account if they wish and print their tickets for upcoming shows and avoid waiting in line at the box office -and/or-
  • patrons can reprint tickets at any time after logging in to the online web sales portal

Step 1 - Installing Scanner Software

Follow the steps in this section to install the software on the iOS device you are using. If you encounter any issues, check the frequently asked questions for troubleshooting
  1. Install the TM Scanner app on an iPhone/iPod
  2. Add the purchased Linea Pro Scanner attachment around the iOS device
  3. Test the scanner on some sample tickets in your environment

The purchase of the linea pro scanner/licence does not include an iOS device.

It must be acquired separately

For installation instructions, click on the picture of the scanner.

IOS

TM Scanner App
iOS - iPhone/iPod Based

TM Scanner - with Linea Pro Bar Code Scanner

The purchase of the linea pro scanner/licence does not include an iOS device.

It must be acquired separately

TM Scanner - Arts Management Systems Ltd. TM Scanner - Arts Management Systems Ltd. You can download the TM Scanner application by visiting the Apple App Store using the link above or typing tm scanner in the app store search

The TM Scanner bar code scanner application can be used on iOS with a device like an iPhone in conjunction with a hardware scanner from Linea Pro.

IOS To use this application, you will need to:

  • Make sure your ticket face has a bar code that goes all across the ticket so that it can be scanned more easily. Refer to adding a field to the ticket.
  • Provide your own iPod or iPhone
    • iOS 10 is currently the earliest compatible OS
    • It is always recommended to keep the devices updated to the latest version of iOS, in order to maintain security compatibility
  • Download the app from Apple's App Store. The app is free and may be installed on any number of devices that you wish.
  • Contact our sales department to:
    • Purchase the Linea Pro to match your iOS device for rapid scanning.
    • Add scanner licensing to your second generation listener (happens automatically when you purchase the above scanner hardware)
    • You can also type the ticket number on the screen as an option if you don't want to have a scanner. This approach is far less efficient than having scanner hardware as the ticket number is manually typed rather than scanned.
  • Make some settings in the TM Scanner app to talk to your web server
  • Set the print at home barcode to QR Code format.

Step 2 - Setting Base Options in the Scanner

The scanner options is generally the same no matter which scanner you are using. Generally, they tell the scanner where the web services are located and the user id/password to use to allow the scan to be processed.

Most often, the settings can be made once and left alone if the intent is to scan tickets on the day of the show.

Scanner User Id in TM

Scanning tickets using a scanner requires a user id set up in theatre manager. We suggest dedicating a specific user id to this purpose.

The setup steps for a user id for scanning are:

  • Create a patron in Theatre Manager with a suitable name, like 'Ticket Scanner'. You could even make them a household member of your other special TM id's like the 'Master User' or 'Web Listener'
  • Turn the user into an employee
  • The only settings and permissions that the ticket scanner id really needs is:
    • a unique set of initials to log in with. These are created automatically when the employee login is created and can be found on the employee window
    • The Employee initials are placed in the scanner setup field on the device you are using to do the scanning.
    • This active user must is allowed to log in
    • the permission to Confirm Attendance at a Performance as per the image below.

Scanner Prefs - Linea Pro TM Scanner application

You may protect access to this entire screen (or parts of it) using an iPhones built in Accessibility Feature
Some configuration settings need to be made on the iPhone or iPod prior to using the Linea Pro scanner to scan tickets. These are very simple, and are all contained on one screen on the iPhone/iPod.

When using the TM Scan application, click on the settings icon at the bottom right of the screen to make changes to the settings. When done, click on the scan button at the lower left.

The values of the fields are in the table below and some troubleshooting steps are at the end.

Theatre Manager Server Address This is the URL address of the web listener that will be responding to checkin and checkout requests. Enter the address of either:
  • your web ticketing server address such as tickets.yourvenue.org. This will elevate the scanning to use https and can occur from anywhere in the world. It must be used for AMS cloud customers.
  • Do not add http:// or https:// in front of the URL. That will be added automatically.
Outlet This is the company number (normally 1). In multi-outlet venues, this number will be different for each outlet.
Performance (optional) You can enter the performance number that you are scanning for or leave it empty. Both options affect which tickets will be accepted by the scanner.

Please refer to the scanner rules for more detail.

Area (optional) This is an optional number that you may assign to scans. It is intended to identify entrance to a specific venue in the case where one ticket allows a patron access to one or more places and you need to monitor how many people are in each area. The venue number must exist in Theatre Manager and does not need to be the same as the venue for the ticket. Example: the ticket could be for a game or circus in an arena. However, there may be a 'bar tent' or 'children's play area' that only ticket holders can go to -- so you can scan them into those auxiliary areas for capacity tracking.

Normally, this field is not entered.

User Initials This is the uppercase initials for the user ID in Theatre Manager doing the scanning. This person does not need to be able to log on to TM for any other reason. You might wish to create a generic ID for this purpose.

The user initials for the scanner must be unique within each outlet.

Password The password used for these User Initials to log on to Theatre Manager.

Note: Passwords are case sensitive per PCI compliance. Please ensure you get the case correct.

Beep on go This function can be turned on if you want a beep to sound when a valid scan is entered. If this is off, the scanner will only vibrate - which may be nice if you are scanning in an area where silence is better. A higher pitched longer beep occurs if an invalid scan is attempted.

 

Troubleshooting the scanner

The first trouble shooting technique if you can't scan tickets, is to open safari on the iOS device and see if you can connect to your ticketing web site.

If you cannot, then usually the issue is the DNS on the wifi router you are connected to.

If some devices can scan tickets and others cannot on the same network, then compare the versions of iOS on the devices to find out which version is working.

Linea Pro Scanner Check Battery Health & RFID Laser

Infinite Peripherals offers an app via the Apple Store to download and install on iPod or iPhone devices used with the Linea Pro Scanner sleds.

The app is called IPCSupport and can only be downloaded from the apple store on your iOS device.

 

This app will provide:

  • the battery health of the scanner device
  • the ability to test the infrared laser.
  • Note: There are other features in this app that are NOT applicable because the Linea Pro is using Theatre Manager's TM Scanner ticket scanning software.

Only use the Device for battery health and RFID to test infrared laser.

Protecting Scanner Preferences Using Accessibility

If you wish to manage access to parts of you scanners so that volunteer ushers or unauthorized person cannot click on check out or the settings buttons on your scanner, Apple provides a great solution through the accessibility feature on the iPhone or iPod touch.

Guided Access limits your iOS device to a single app and lets you control which features are available. You can turn on Guided Access when you let a volunteer use your device, or when accidental gestures might distract you..

 

To Enable Guided Access

  1. open the Settings application and navigate through
    • General
    • Accessibility
    • Guided Access (as per the screen to the right)
  2. Turn on Guided Access.
  3. Tap Passcode Settings, then
    • tap Set Guided Access Passcode.
    • Enter a passcode, then reenter it.

 

To set up Guided Access for a Specific Application

Open the app that you want to manage (eg TM Scan - for purposes of this example) and decide if you want to control access to the entire settings tab or only parts of it.

 

Option 1: Control Access to Multiple Specific Parts of Settings Tab

This can be used to limit access to some parts of the settings. You might use this approach if you want to allow staff to only change of the performance

  1. Click on Settings
  2. Triple-click the Home button.
  3. If you want to manager parts of your screen to stop responding to touch, use one finger to circle those areas. You can move or resize the circle, or tap the X to remove it. In our example to the right we have selected the:
    • URL to the ticketing web site,
    • Outlet (if you are scanning for multiple organizations in an outlet version, you may not want to select this
    • ID and Password
    • Refer to scanner settings for meaning of the fields to decide what you want to protect. You could, if you want, protect the entire screen
  4. Tap Start.
  5. Stay on the main screen

 

Option 2: Control Access to an entire screen

This can be used to limit access to some parts of the settings. You might use this approach if you want to allow staff to only change of the performance

  1. Click on Settings
  2. Triple-click the Home button.
  3. Select all the fields on the screen
  4. Adjust the corners of the rectangle as need be by dragging them
  5. Tap Start.
  6. Stay on the main screen

Step 3 - Checking a Patron INTO the venue

This page describes how to scan a ticket and check a patron INTO the venue. The process is very similar for both scanners.

TM Scanner (iPhone/iPod)
  • Make sure the 'white words' in the centre of the screen say 'Scan In'. If they do not, click the 'blue' words that say 'scan in'.
  • Aim the front of the scanner at a ticket
  • Press the 'black' button at the right side of the scanner so that the red laser scans the ticket
  • When you hear the beep (or the phone vibrates), the scan was successful and the words will say 'go'
  • If you hear a longer beep, the screen will say stop and the scan failed -- read the error message to find out why
If you have trouble doing a scan, you can enter the ticket number manually. To do so:
  • Click on the green word 'Start' (or on the blue 'Manual' at the upper left)
  • Type in the ticket number
  • Click the 'Go' Button
A successful scan looks similar to the image on the right.

it will include:

  • The patrons name
  • The ticket number
  • And if its a reserved seating event:
    • the door
    • section
    • row
    • and seat data
    If such data is available for the venue

Step 4 - Checking a Patron OUT of the venue

This page describes how to check a patron OUT OF the venue so that they can come back in another entrance. A checkout assumes that the patron has been checked in to the venue in the first place. If you receive an error checking the patron out, it would be an odd situation.

The process is very similar for both scanners.

TM Scanner (iPhone/iPod)
  • Make sure the 'white words' in the centre of the screen say 'Scan Out'. If they do not, click the 'blue' words that say 'Scan Out'.
  • Aim the front of the scanner at a ticket
  • Press the 'black' button at the right side of the scanner so that the red laser scans the ticket
  • When you hear the beep (or the phone vibrates), the scan was successful and the words will say 'go'
  • If you hear a longer beep, the screen will say stop and the scan failed -- read the error message to find out why
If you have trouble doing a scan, you can enter the ticket number manually. To do so:
  • Click on the green word 'Start' (or on the blue 'Manual' at the upper left)
  • Type in the ticket number
  • Click the 'Go' Button

Ticket Scanner Acceptance Rules

Entering a performance number or leaving it blank the scanner setup preferences directly affects which tickets the scanners will accept or reject.

These apply to checkin or checkout of the venue.

If you enter a Specific Performance Number into the scanner

While providing a performance number is generally the best option, it is especially important If you have multiple venues or multiple events on the same day.

  • Tickets for any other performance will be rejected.
  • The scanner will accepts tickets if the performance date is midnight or earlier. It means you:
    • can scan tickets for an event that goes on today because it has todays date on it
    • can scan ticket stubs you put aside from a prior days performance if you wish, up to any number of days in the past
    • cannot scan tickets for any event with tomorrows date on it
  • Provide this parameters if you want absolute certainty that patrons are entering the correct venue.
  • Find the performance number from the list within the event window

 

If you leave the Performance Number zero or blank

If you generally have one event per day, it may work best leaving the performance number blank as there is no configuration changes required for each day. You just need to pick up the scanners and use them.

  • Tickets for any event/play that day will be accepted.
  • Ticket for any other day will be rejected. (Provide specific performance number to scan prior days events)
  • Use this if you have
    • a festival situation occurring and patrons could have purchased tickets to any one of a number of events / plays to obtain entry to the area you are scanning for.
    • a multi venue situation where you quickly move scanners from one venue to another and don't want operators to enter performance numbers
  • Note: If you enter a zero in this field, tickets for events occurring on any other day will return the message that the ticket is for a future event, and is not valid on this date.

 

Tricking the scanning process for future performances

If you want to scan for tomorrow's performance for some reason, then:
  • Just before attempting to scan tickets, set the date/time on the performance to be just before midnight today.
  • Add a comment to the specific performance notes to clarify for online sales (eg 'this performance is friday all day and not at the time indicated').
  • When you have finished scanning advance tickets, then change the date/time back to the proper performance time.

Print-at-Home and coupon requirements

If a sales promotions is explicitly marked with the requirement for a coupon when sold online, then the following happens:

  • if the patron prints at home - all tickets in the order will be printed - this is so that a patron has the same number of tickets as their online order
  • The tickets that require an online coupon will have an invalid bar code. This means that the ticket cannot be scanned into the venue in anyway.
  • There will be instructions on the ticket to take the print-at-home copy to the box office or will call to have it exchanged for a hard ticket stock ticket - which of course can be scanned.
  • This way the box office can verify price eligibility for the promotion, such as AAA discount, 2 for 1 coupon, Active Military - any reason at all.