Topic Doc: Range Ball Solutions in RecTrac
RecTrac 3.1
Table of Contents
Document Summary
RecTrac interfaces with a number of third-party software products that are used to operate golf ball dispensers at driving ranges. Currently, the list includes:
- eRange
- Range Systems
- Range Express
- Range Servant
- Select PI by Range Servant
In all instances, RecTrac interfaces with the solution through the sale of a Service Item. The result of the sale generates a PIN, which is printed on the sales receipt. When the PIN is entered into the ball dispenser, the bucket of balls is provided. Generally speaking, PINs are one-time use only and they are coded to expire at a set time.
Note: The Range Servant solution can be configured to generate PINs and/or configured to add credits to a member's Range Servant card.
License – Maintenance Agreement
Range Ball Interfaces are free. Use of a Range Ball Interface requires a Vermont Systems license and annual maintenance agreement for RecTrac and the component modules discussed in this document. Prior to implementing any process outlined in this document, please contact the Vermont Systems Sales department at 1-877-883-8757 to verify that you are authorized to use the modules discussed in this document and if not, to obtain a quote and/or approval.
Setup Steps
This document provides set up and use information from within the RecTrac application for each interface solution. As all Range Ball solutions are third party software products, this document DO NOT provide specific installation instruction. If you have already settled on a Range Ball Solution, then simply return to the Table of Contents and click the appropriate link to skip directly to that section. If you have additional questions about Range Ball setup and operation within RecTrac after reading this document, please contact Vermont Systems Customer Service by phone at 887-883-8757 or generate a Support Case through the Customer portal of the Vermont Systems web site using your Customer ID and password.
eRange
eRange uses a .dll file to generate the PIN number that is printed on the customer’s receipt. When an eRange Service Item is sold in RecTrac, the sale prompts the .dll to pass information to the eRange server. eRange then passes information back to RecTrac, and the PIN is printed on the customer’s receipt.
Before You Proceed
This document is written with the following assumptions. If any of the items listed below is NOT true, contact Vermont Systems Support prior to continuing, as the steps in this document may prove difficult to complete and unexpected results may occur.
- eRange is installed on the server that houses RecTrac Client WebSpeed brokers and the .dll is located in the <x>\ VSI3\Progress\DLC117\bin directory of that server, where <x> is mapped partition on which RecTrac and Progress are installed. (See "eRange Cofiguration" below.)
- Your organization is running RecTrac 3.1.04.05 or greater.
- The User ID with which you sign into RecTrac has the requisite permissions and ability to access all modules and functions pertaining to ball dispenser program and eRange.
- You understand RecTrac DataGrids and how to maneuver through them.
- You understand RecTrac Profile Management and hierarchy.
- You understand RecTrac Fees and Criteria This document does not provide instruction for RecTrac Fee Maintenance beyond the minimum requirements necessary to set up a Range Ball Service Item.
eRange Configuration
The erangeSunDLL.dll must installed on the server that houses RecTrac Client WebSpeed brokers. Place the .dll in the <x>\ VSI3\Progress\DLC117\bin directory of that server, where <x> is mapped partition on which RecTrac and Progress are installed. Contact eRange or Vermont Systems for the current version of the erangeSunDLL.dll. This document was written using erangeSunDLL.dd v.30.64.18.3.
- The .dll is located in the Third Party directory on your server in <x>\VSI3\RecTrac\Programs\ThirdParty\eRange\eRangeSUNDLL_30_64_18_3.
- Copy this file to the bin folder <x>\VSI3\Progress\DLC117\bin.
- Without this 64-bit version you may run into the following error “Could not find the entry point _GetSunResultUPS@24. (3264)”
- Upon copying the file, the eRange software should be installed on your RecTrac server.
RecTrac Setup
The following provides the basic File Maintenance steps required to create a Range Ball Service Item and generate a PIN for your eRange golf ball dispensers.
Note: Any file paths and screen/tab locations in this document refer to file paths and screen/tab locations as they appear in the standard, default Vermont Systems design. Your setup and design may vary.
Create and Link an eRange Profile
The eRange profile allows you to store Customer ID and Password information for your eRange account.
- In RecTrac, search for and go to Profile Assignments.
- Click Add. You will continue to the Profile Add/Update screen.
- Enter a Profile Code for your eRange profile. For Example: eRange Profile.
- Expand Profile Type and select ERange.
- Expand Profile Subtype and select ERange.
- Enter a Profile Description, if desired, and click Create.
- Enter eRange Customer ID and Password in their respective fields.
- Expand PIN Font Size and select a value. The value you select will be the font size in which the PIN prints on receipts. Vermont Systems recommends using 10, 12, or 14.
- Click Save to save your changes. You will return to Profile Assignments.
- Determine where you want to link your eRange profile. If you have one (1) eRange Customer ID only, linking your profile at the Default Level of Hierarchy is a good option.
- In the Linked Profiles middle column, expand the Default folder.
- In the Available Profiles left-hand column, click to highlight the eRange profile you just created.
- Click again and hold the mouse button down. When you have "grabbed" the profile, a red box will appear that displays the profile name.
- Drag and drop. Drag to the Default Profiles folder in the middle column. When the box turns green, release the mouse. This will place the profile at the Default level of hierarchy. Profile Assignments are saved automatically and take effect immediately.
The level of hierarchy can be changed later, if needed. - Exit Profile Assignments.
Repeat these steps to create and link additional eRange profiles, if necessary. This completes the setup steps for your eRange profile.
Create Range Ball Service Items
Complete the following steps to create a Range Ball Service Item that will be used to record sales of buckets of golf balls sold at the range. A separate Service Item must be created for each bucket size you sell.
- In RecTrac, search for and go to Service Item Management.
- Click Add. You will continue to the POS Service Item Update screen.
- Enter a Service Item Code. Codes may be alphanumeric. This is a mandatory field in the standard Vermont Systems design. Your design may vary.
- Expand Record Type and select Range Ball.
Note: Your selection here MUST BE "Range Ball."
- Enter Long and Short Descriptions for your Service Item. For example, Range - Small Bucket.
The Short Description is printed on Receipts. - Expand Permissions, if desired, and add appropriate Permissions to this Service Items. Permissions allow you to control which users can "see" the Service Item on DataGrids and picklists in RecTrac.
- Expand the Miscellaneous Settings Group and ensure the Bucket Size field matches the size of the bucket the Service Item is meant to sell. Options for eRange are Small, Medium, and Large.
Notes: This field appears only if your Record Type is Range Ball. If you do not see this field, then return to Step 4 above and ensure your selection in the Record Type field is Range Ball. A separate Service Item must be created for each bucket size you offer.
- Make other selections and fill in other information on the various Groups of the Core tab as necessary.
Use the "i" Information icons for field definitions, if needed.
Note: You do not need to visit the WebTrac Settings Group. Range Ball Service Items can be sold via RecTrac GUI only at this time. Range Ball Service Items currently cannot be purchased by patrons using WebTrac.
- Click the Fees tab when ready.
-
Add Fees and criteria to your Service Item as necessary.
- The Fee Type should be Standard Fee.
- The Transaction Type should be Purchase.
- Revenue GL Code is a mandatory field in the standard Vermont Systems design.
- Add New Criteria as needed. If you charge the same amount to everyone for this Service Item, you likely will not need criteria.
- Click Save to save your Fee. It will move the Fees DataGrid at the top of the screen.
- Click the Rules, Questions, and Comments tabs in turn to Add rules, questions, and/or comments to this Service Item as needed.
- If there are no special allowances or restrictions regarding the purchase of this Service Item, you likely will not need Rules.
- If there are no questions to be answered when purchasing this Service Item, you likely will not need questions.
- Comments should be added as needed.
- Click Save when done to Save your Service Item. You will be returned to the Service Item Management DataGrid.
- Repeat these steps to create other Range Ball Service Items as needed. A separate Range Ball Service Item must be created for each Bucket Size you sell.
Sell a Range Ball Service Item and Generate an eRange PIN
Note: Range Ball Service Items can be sold via RecTrac GUI only at this time. Range Ball Service Items currently cannot be purchased by patrons using WebTrac.
- In RecTrac, sell the Service Item as you normally would.
- The subsequent receipt will contain the PIN. An example appears below.
- "PIN#" is a Vermont Systems Language Code and can be customized, if desired. Phrase ID=Rcpt-POS-00059.
- When at the ball machine, your patron will enter the PIN and a number balls equal to the bucket size linked to the Range Ball Service Item will be provided (i.e. Small in the example above).
- The PIN expires at midnight on the date of sale. This is hardcoded in the eRange software CANNOT be manipulated in RecTrac.
Note: An eRange PIN cannot be cancelled in RecTrac once a Range Ball Service Item has been sold. The PIN remains valid until midnight on the day of sale regardless of whether the Service Item sale in RecTrac is subsequently voided. This is a limitation of the RecTrac/eRange interface at this time.
For example, at 10:00am on June 18, 20xx, your Pro Shop clerk sells a Range Ball Service Item for a Large Bucket. The sale generates a PIN via the eRange software. At 10:05am, the clerk cancels/voids that sale by performing a negative sale in RecTrac for a Large Bucket Range Ball Service Item. The PIN generated by the 10:00am sale will remain valid until midnight.
Range Express
Range Express uses a .dll file to generate the PIN number that is printed on the customer’s receipt. When a Range Express Item is sold in RecTrac, the sale prompts the .dll to pass information to the Range Express server. Range Express then passes the information back to RecTrac, and the PIN is printed on the customer’s receipt.
Before You Proceed
This document is written with the following assumptions. If any of the items listed below is NOT true, contact Vermont Systems Support prior to continuing, as the steps in this document may prove difficult to complete and unexpected results may occur.
- Repins.dll is installed on the RecTrac Transaction server and the Repins.dll and Redp.xml are located in the <x>\ VSI3\Progress\DLC117\bin directory of that server, where <x> is mapped partition on which RecTrac and Progress are installed. (See "Range Express Configuration" below.)
- You must have either the Microsoft Access database engine (64-bit) installed on the transaction server or you must be running a SQL databse.
- If Microsft Access database - The RangeExpress.mdb file needs to be in a folder that both that client machine/Windows user and the RecTrac server can write to. Ensure your network permissions enable the needed permissions. The path will be \VSI3\Progress\DLC117\bin\Rangeexpress.mdb.
- If SQL database - Contact your Range Express support desk and request the SQL versions of the files Repins.dll, Resql.xml, and the SQL database. Once you receive these files, copy them into into the DLC117\bin folder.
- Your organization is running RecTrac 3.1.05.15 or greater.
- The User ID with which you sign into RecTrac has the requisite permissions and ability to access all modules and functions pertaining to ball dispenser program and eRange.
- You understand RecTrac DataGrids and how to maneuver through them.
- You understand RecTrac Profile Management and hierarchy.
- You understand RecTrac Fees, Rules, Questions, and Criteria This document does not provide instruction for RecTrac Fee/Rules/Questions Maintenance beyond the minimum requirements necessary to set up a Range Ball Service Item.
Range Express Configuration
Perform the following on your RecTrac Transaction Server.
Files Required
By default the following files will be located in <x>\VSI3\RecTrac\ThirdParty\Range Express, where <x> is the mapped drive on which RecTrac is installed.
- Repins.dll - This file is 64-bit compiled with .Net 4.x
- Redp.xml (If Microsoft Access database.)
- Rangeexpress.mdb - Microsoft Access DB file (If Microsoft Access database.)
- Resql.xml (If SQL databse. You must obatins this file from Range Express separately.)
- The SQL database (If SQL database. You must obtain this from Range Express separately.)
- In Windows on your RecTrac Transaction Server, browse to<x>\VSI3\RecTrac\ThirdParty\Range Express.
- Copy the files listed above to <x>\VSI3\Progress\DLC117\bin.
Note for RecTrac 10.3 to RecTrac 3.1 Migrations: If you are upgrading from the legacy RecTrac 10.3 to the new RecTrac 3.1, then copy the Rangeexpress.mdb from your old RecTrac 10.3 old server (the version within the \ThirdParty\ folder is is blank).
From this point forward, you are working exclusively within the \VSI3\Progress\DLC117\bin\ folder, you are done with the ThirdParty folder.
- Highlight/select Repins.dll, right-click and select Properties.
- On the General tab, check to see whether the Unblock button is displayed. If it is, then click on the Unblock button and then click Apply. Exit from Properties.
- Highlight/select Redp.xml, right-click and Open with… either an XML editor or Notepad or Wordpad.
- Change the <datapath> file location from its default entry to <x>\VSI3\Progress\DLC117\bin, where <x> is the mapped drive on which Progress is installed.
- Save your changes and exit the editor.
- Exit Windows Explorer on the Transaction Server and open a new Windows Explorer session. Search the Transaction Server for Assemblies.xml.
- When found, right-click and Open with… either an XML editor or Notepad or Wordpad.
- Add the following exactly as it appears:
<assembly name="repins, Version=5.9.9.9, Culture=neutral, PublicKeyToken=null"/> Note: If SQL, add the following:
<assembly name="repins, Version=2.9.9.3, Culture=neutral, PublicKeyToken=null"/>
Save changes and exit the editor. Exit Windows Explorer.
This completes the Range Express configuration.
RecTrac Setup
The following provides the basic File Maintenance steps required to create a Range Ball Service Item and generate a PIN for your Range Express golf ball dispensers.
Note: Any file paths and screen/tab locations in this document refer to file paths and screen/tab locations as they appear in the standard, default Vermont Systems design. Your setup and design may vary.
Create and Link an eRange - Range-Express Profile
The eRange - Range-Express Range Ball Solution and allows you to set the valid days parameter for PINs as well as the font size for printing PINs on receipts.
- In RecTrac, search for and go to Profile Assignments.
- Click Add. You will continue to the Profile Add/Update screen.
- Enter a Profile Code for your eRange Range Express profile. For Example: Range Express Profile.
- Expand Profile Type and select ERange.
- Expand Profile Subtype and select Range-Express.
- Enter a Profile Description, if desired, and click Create.
- Enter a value, 1-365, in the PIN Valid Days field. The value you enter is the number of days for which a PIN will be valid at the ball machine after purchase.
- For Example: "1" = "Today only," "2"="Today and tomorrow," 3="Today, tomorrow and the next day," etc….
- Expand PIN Font Size and select a value. The value you select will be the font size in which the PIN prints on receipts. Vermont Systems recommends using 10, 12, or 14.
- Click Save to save your changes. You will return to Profile Assignments.
- Determine where you want to link your Range Express profile. If you have one (1) Range Express account only, linking your profile at the Default Level of Hierarchy is a good option.
- In the Linked Profiles middle column, expand the Default folder.
- In the Available Profiles left-hand column, click to highlight the eRange profile you just created.
- Click again and hold the mouse button down. When you have "grabbed" the profile, a red box will appear that displays the profile name.
- Drag and drop. Drag to the Default Profiles folder in the middle column. When the box turns green, release the mouse. This will place the profile at the Default level of hierarchy. Profile Assignments are saved automatically and take effect immediately. (The level of hierarchy can be changed later, if needed.)
- Exit Profile Assignments.
Repeat these steps to create and link additional Range Express profiles, if necessary. This completes the setup steps for your eRange - Range Express profile.
Create Range Ball Service Items
Complete the following steps to create the Range Ball Service Item(s) that will be used to record sales of range balls sold.
- In RecTrac, search for and go to Service Item Management. You will continue to the POS Service Item Management DataGrid.
- Click Add. You will continue to the POS Service Item Update screen.
- Enter a Service Item Code. This is a mandatory field in the standard Vermont Systems design. Your design may vary.
- Expand Record Type and select Range Ball.
Note: Your selection here MUST BE "Range Ball."
- Enter Long and Short Descriptions for your Service Item. For example, Range Express Small Bucket.
The Short Description is printed on Receipts. - Expand the Permissions, if desired, and add appropriate Permissions to this Service Items. Permissions allow you to control which users can "see" the Service Item on DataGrids and picklists in RecTrac.
- Expand the Miscellaneous Settings Group and ensure the Bucket Size field matches the size of the bucket the Service Item is meant to sell.
Notes: This field appears only if your Record Type is Range Ball. If you do not see this field, then return to Step 4 above and ensure your selection in the Record Type field is Range Ball. separate Service Item must be created for each bucket size you offer.
- Make other selections and fill in other information on the various Groups of the Core tab as necessary.
Use the "i" Information icon for field definitions, if needed.
Note: You do not need to visit the WebTrac Settings Group. Range Ball Service Items can be sold via RecTrac GUI only at this time. Range Ball Service Items currently cannot be purchased by patrons using WebTrac.
-
Add Fees and criteria to your Service Item as necessary.
- The Fee Type should be Standard Fee.
- The Transaction Type should be Purchase.
- Revenue GL Code is a mandatory field in the standard Vermont Systems design.
- Add New Criteria as needed. If you charge the same amount to everyone for this Service Item, you likely will not need criteria.
- Click Save to save your Fee. It will move the Fees DataGrid at the top of the screen.
- Click the Rules, Questions, and Comments tabs in turn to AddRules, Questions, and/or Comments to this Service Item as needed.
- If there are no special allowances or restrictions regarding the purchase of this Service Item, you likely will not need Rules.
- If there are no questions to be answered when purchasing this Service Item, you likely will not need Questions.
- Comments should be added as needed.
- Click Save when done to Save your Service Item. You will be returned to the Service Item Management DataGrid.
- Repeat these steps to create other Range Ball Service Items as needed. A separate Range Ball Service Item must be created for each Bucket Size you sell.
-
Sell a Range Ball Service Item and Generate a Range Express PIN
Note: Range Ball Service Items can be sold via RecTrac GUI only at this time. Range Ball Service Items currently cannot be purchased by patrons using WebTrac.
- In RecTrac, sell the Service Item as you normally would.
- When the sale completes, the Range Express 6-digit PIN will print on the receipt.
- "PIN#" is a Vermont Systems Language Code and can be customized, if desired. Phrase ID=Rcpt-POS-00059.
- When at the ball machine, your patron will enter the PIN and balls will be dispensed.
- PINs are one-time use only
- The Range Express software handles the expiring of unused PINs based on the Valid Days you entered in your eRange - Range-Express profile
Troubleshooting
Problem
When I go to sell a Range Ball service item (with Range Express profile linked to my user ID), I get a spinning 'Please Wait' icon that never goes away. The client.LIVE broker freezes up on "busy" until I kill it. Nothing happens and I have to exit out of the session.
Solution
A spinning wheel and 'please wait' under these circumstances typically means the Rangexpress.mdb file is not running.
- Exit your RecTrac session.
- Ensure you have Microsoft Access loaded and that it is running on your RecTrac Transaction Server.
- Search your system for AccessDatabaseEngine_x64.exe. Once located, right-click on the file and 'Run as… Administrator.'
- Follow the prompts and allow the file to install to its defaults.
- Start a new session of RecTrac and attempt the transaction again.
- If you cannot find AccessDatabaseEngine_x64.exe, then contact Vermont Systems Support for a copy of the file.
Range Servant
Range Servant uses communication between the RecTrac Transaction Server and the Ranger Servant Server to pass an xml file that either generates a PIN OR places credits on a member's Range Servant card at the time of sale. Range Servant provides you (the client) with the Host Server Name/IP, Port and Register Number. Bucket size(s) is determined by RecTrac Service Items in the Shopping Cart at the time of sale. The Service Item Record Code must match values stored at Range Servant in order for the PIN to be generated and/or the customer's account credited.
Note: DonalWay Golf is a subsidiary of Range Servant. If you were using DonalWay Golf as your Range Ball solution, that functionally has been incorporated into Range Servant.
Before You Proceed
This document is written with the following assumptions. If any of the items listed below is NOT true, contact Vermont Systems Support prior to continuing, as the steps in this document may prove difficult to complete, and unexpected results may occur.
- You have created an account with Range Servant.
- Range Servant Contacts: Jim Watts (303) 679-0101 and Hormuz Minnia (404) 394.0670
- Range Servant has provided you with their Host Server Name/IP Address, Port, and Register IDs.
- You have conferred with Range Servant and understand the values they use to code the sizing of their ball buckets.
- Your organization is running RecTrac 3.1.05.12 or greater.
- You understand the Service Item Code(s) you create in RecTrac must match the values used by Range Servant.
- The User ID with which you sign into RecTrac has the requisite permissions and ability to access all modules and functions pertaining to ball dispenser program and Range Servant.
- You understand RecTrac DataGrids and how to maneuver through them.
- You understand RecTrac Profile Management and hierarchy.
- You understand RecTrac Fees, Rules, Questions, and Criteria. The determining factor in whether a Range Servant Service Item sale generates a PIN or credits a customer's account is the answer to a Question. This document does not provide instruction for RecTrac Fees/Rules/Question Maintenance beyond the minimum requirements necessary to set up a Range Ball Service Item.
RecTrac Setup
The following provides the basic File Maintenance steps required to create a Range Ball Service Item and generate a PIN for your Range Servant golf ball dispensers.
Note: Any file paths and screen/tab locations in this document refer to file paths and screen/tab locations as they appear in the standard, default Vermont Systems design. Your setup and design may vary.
Create and Link an eRange - Range Servant Profile
The eRange - Range Servant profile allows you to store Host Name, Port, Register ID and other information for your Range Servant account.
- In RecTrac, search for and go to Profile Assignments.
- Click Add. You will continue to the Profile Add/Update screen.
- Enter a Profile Code for your eRange Range Servant profile. For Example: Range Servant Profile.
- Expand Profile Type and select eRange.
- Expand Profile Subtype and select Range Servant.
- Enter a Profile Description, if desired, and click Create.
- Enter the Range Servant Host Name or IP Address for given to you by Range Servant when creating your account.
- Enter the Port Number as given to you by Range Servant.
- Enter the Register ID as given to you by Range Servant.
- Enter a value in the Response Time Out field. The value is a timeout threshold in seconds that the system will wait for a response from Range Servant when processing a transaction. When the first Range Ball Service Item is added to the cart, a check is done to verify the communication to the Range Servant server. Check is done once per sale. If communication is not available, then a message will be displayed and you will not be allowed to complete the sale.
- Accept the default value or expand the Drop-down list for PIN Font Size and select a value. The value you select will be the font size in which the PIN prints on receipts. Vermont Systems recommends using 10, 12, or 14.
- Click Save to save your changes. You will return to Profile Assignments.
- Determine where you want to link your Range Servant profile. If you have one (1) Range Servant account only, linking your profile at the Default Level of Hierarchy is a good option.
- In the Linked Profiles middle column, expand the Default folder.
- In the Available Profiles left-hand column, click to highlight the eRange profile you just created.
- Click again and hold the mouse button down. When you have "grabbed" the profile, a red box will appear that displays the profile name.
- Drag and drop. Drag to the Default Profiles folder in the middle column. When the box turns green, release the mouse. This will place the profile at the Default level of hierarchy. Profile Assignments are saved automatically and take effect immediately.
The level of hierarchy can be changed later, if needed. - Exit Profile Assignments.
Repeat these steps to create and link additional Range Servant profiles, if necessary. This completes the setup steps for your eRange - Range Servant profile.
Create Range Ball Service Items
Complete the following steps to create the Range Ball Service Item(s) that will be used to record sales of range balls sold.
- In RecTrac, search for and go to Service Item Management. You will continue to the POS Service Item Management DataGrid.
- Click Add. You will continue to the POS Service Item Update screen.
- Enter a Service Item Code. This is a mandatory field in the standard Vermont Systems design. Your design may vary.
The Codes for your various bucket sizes MUST MATCH the values stored at Range Servant. The following table presents an example only. DO NOT use these values; contact Range Servant for the correct values.
Value | Description |
---|---|
5060 | 50 for 60 |
1000 | Small |
2000 | Medium |
3000 | Large |
5000 | Open |
1001 | Daily Small |
- Expand Record Type and select Range Ball.
Note: Your selection here MUST BE "Range Ball."
- Enter Long and Short Descriptions for your Service Item. For example, Range Servant Small Bucket.
The Short Description is printed on Receipts. - Expand Permissions, if desired, and add appropriate Permissions to this Service Items. Permissions allow you to control which users can "see" the Service Item on DataGrids and picklists in RecTrac.
- Expand the Miscellaneous Settings Group and ensure the Bucket Size field matches the size of the bucket the Service Item is meant to sell. Options for Range Servant are Small, Medium, and Large.
Notes: This field appears only if your Record Type is Range Ball. If you do not see this field, then return to Step 4 above and ensure your selection in the Record Type field is Range Ball. A separate Service Item must be created for each bucket size you offer.
- Make other selections and fill in other information on the various Groups of the Core tab as necessary.
Use the "i" Information icon for field definitions, if needed.
Note: You do not need to visit the WebTrac Settings Group. Range Ball Service Items can be sold via RecTrac GUI only at this time. Range Ball Service Items currently cannot be purchased by patrons using WebTrac.
-
Add Fees and criteria to your Service Item as necessary.
- The Fee Type should be Standard Fee.
- The Transaction Type should be Purchase.
- Revenue GL Code is a mandatory field in the standard Vermont Systems design.
- Add New Criteria as needed. If you charge the same amount to everyone for this Service Item, you likely will not need criteria.
-
Add Rules to this Service Items as needed.
- If there are no special allowances or restrictions regarding the purchase of this Service Item, you likely will not need Rules.
- Click the Questions tab when ready and click the Link Individual Question button.
- Find and Select your Range Servant question.
- If the question exists, highlight it and click Select.
- If the question does not exist, click Add and create the question as follows.
- Question Text=Swipe Range Servant Loyalty Card.
- Question Type=Purchase.
- Order Number=1 This value must be '1.'
- Field Type=Fillin.
- Determine whether you wish to Require an Answer. Your selection here determines whether a PIN is generated.
- If you require an answer, then you are passing a member's loyalty number at the time of sale, and all sales of this Service Item will go to the member's Range Servant Loyalty Card. No PIN is generated.
- If you do NOT require an answer, then you can leave the question blank at the time of sale. When the field is left blank, Range Servant returns a PIN at the time of sale which is printed on the receipt. The patron can then enter the PIN manually at the ball machine.
- (Recommended) Opt not to Print on Receipt.
- Save your Question and link it.
- Add Comments to this Service Item as needed.
- Click Save when done to Save your Service Item. You will be returned to the Service Item Management DataGrid.
- Repeat these steps to create other Range Ball Service Items as needed. A separate Service Item must be created for each bucket size you offer.
Sell a Range Ball Service Item and Generate a Range Servant PIN
Note: Range Ball Service Items can be sold via RecTrac GUI only at this time. Range Ball Service Items currently cannot be purchased by patrons using WebTrac.
- In RecTrac, sell the Service Item as you normally would.
- The Range Servant Loyalty Card question will pop. As noted above, whether you require an answer determines whether a PIN is generated. For purposes of example, this document assumes No Answer is required.
- The subsequent receipt will contain the PIN. An example appears below.
- "PIN#" is a Vermont Systems Language Code and can be customized, if desired. Phrase ID=Rcpt-POS-00059.
- When at the ball machine, your patron will enter the PIN and balls will be dispensed.
- PINs are one-time use only
- The Range Management System software handles the expiring of unused PINs.
Cancellations
In the event of a cancellation, when you click Process, information is sent to Range Servant to deduct value from the member account or the PIN value.
If Communication to Range Servant is not Available
When using Range Servant and you sell a Range Ball Service Item, a check is done to verify the communication to the Range Servant server. This check is done once per sale, and it is done when you add the first Range Servant Service Item to the cart. If communication cannot be established, then there is no reason to sell the Service Item, as RecTrac will not be able to communicate with Range Servant to add value to the members account at the Range Servant database.
If communication is not available, then a message will be displayed. You will need to get your IT staff involved to troubleshoot the issue. Do not continue with additional range ball sales until the communication issue is resolved by the IT department.
Additionally, Range Servant can assist you with the download and running of a Tera Terma test, if needed, for testing connection to Range Servant.
Select PI
Select PI is the newest version of the Range Servant API and the newest machines will be using this instead of the previous Range Servant API. Select PI uses communication between the RecTrac Transaction Server and the Range Servant Server to pass a JSON file that generates a PIN at the time of sale. Range Servant provides you (the client) with the Host Server Name/IP, Port, Tenant ID, Username, Passkey, and Vendor Role. The number of golf balls is determined by the RecTrac Service Items in the Shopping Cart at the time of sale.
Before You Proceed
This document is written with the following assumptions. If any of the items listed below is NOT true, contact Vermont Systems Support prior to continuing, as the steps in this document may prove difficult to complete and unexpected results may occur.
- You have created an account with Range Servant.
- Range Servant Contacts: Jim Watts (303) 679-0101 and Hormuz Minnia (404) 394.0670
- Range Servant has provided you with their Host Server Name/IP, Port, Tenant ID, Username, Passkey, and Vendor Role.
- Your organization is running RecTrac 3.1.10.08 or greater.
- The User ID with which you sign into RecTrac has the requisite permissions and ability to access all modules and functions pertaining to ball dispenser program and Range Servant.
- You understand RecTrac DataGrids and how to maneuver through them.
- You understand RecTrac Profile Management and hierarchy.
- You understand RecTrac Fees, Rules, Questions, and Criteria. This document does not provide instruction for RecTrac Fees/Rules/Question Maintenance beyond the minimum requirements necessary to set up a Range Ball Service Item.
RecTrac Setup
The following provides the basic File Maintenance steps required to create a Range Ball Service Item and generate a PIN for your Range Servant golf ball dispensers.
Note: Any file paths and screen/tab locations in this document refer to file paths and screen/tab locations as they appear in the standard, default Vermont Systems design. Your setup and design may vary.
Create and Link an eRange - Range Servant Profile
The eRange - Range Servant profile allows you to store Host Server Name/IP, Port, Tenant ID, Username, Passkey, Vendor Role, and other information for your Range Servant account.
- In RecTrac, search for and go to Profile Assignments.
- Click Add. You will continue to the Profile Add/Update screen.
- Enter a Profile Code for your eRange Range Servant profile. For Example: Range Servant Profile.
- Expand Profile Type and select eRange.
- Expand Profile Subtype and select Range Servant.
- Enter a Profile Description, if desired, and click Create.
- Enter the Range Servant Host Name or IP Address for given to you by Range Servant when creating your account.
- Enter the Port Number as given to you by Range Servant.
- Enter the Tenant ID as given to you by Range Servant.
- Enter the Username as given to you by Range Servant.
- Enter the Passkey as given to you by Range Servant.
- Enter the Vendor Role as given to you by Range Servant.
- Accept the default value or expand the Drop-down list for PIN Font Size and select a value. The value you select will be the font size in which the PIN prints on receipts. Vermont Systems recommends using 10, 12, or 14.
- Click Save to save your changes. You will return to Profile Assignments.
- Determine where you want to link your Range Servant profile. If you have one (1) Range Servant account only, linking your profile at the Default Level of Hierarchy is a good option.
- In the Linked Profiles middle column, expand the Default folder.
- In the Available Profiles left-hand column, click to highlight the eRange profile you just created.
- Click again and hold the mouse button down. When you have "grabbed" the profile, a red box will appear that displays the profile name.
- Drag and drop. Drag to the Default Profiles folder in the middle column. When the box turns green, release the mouse. This will place the profile at the Default level of hierarchy. Profile Assignments are saved automatically and take effect immediately. (The level of hierarchy can be changed later, if needed.)
- Exit Profile Assignments.
Repeat these steps to create and link additional Range Servant profiles, if necessary. This completes the setup steps for your eRange - Range Servant profile.
Create Range Ball Service Items
Complete the following steps to create the Range Ball Service Item(s) that will be used to record sales of range balls sold.
- In RecTrac, search for and go to Service Item Management. You will continue to the POS Service Item Management DataGrid.
- Click Add. You will continue to the POS Service Item Update screen.
- Enter a Service Item Code. This is a mandatory field in the standard Vermont Systems design. Your design may vary.
- Expand Record Type and select Range Ball.
-
Note: Your selection here MUST BE "Range Ball."
- Enter Long and Short Descriptions for your Service Item. For example, Range Servant Small Bucket.
The Short Description is printed on Receipts. - Expand Permissions, if desired, and add appropriate Permissions to this Service Items. Permissions allow you to control which users can "see" the Service Item on DataGrids and picklists in RecTrac.
- Expand the Miscellaneous Settings Group and ensure the Ball Count field matches the number of balls corresponding to this item. The Bucket Size field will not be used by the Range Servant process so it can be left as Not Applicable
- Enter Long and Short Descriptions for your Service Item. For example, Range Servant Small Bucket.
-
Notes: This field appears only if your Record Type is Range Ball. If you do not see this field, then return to Step 4 above and ensure your selection in the Record Type field is Range Ball. A separate Service Item should be created for each bucket size you offer for ease of configuration.
- Make other selections and fill in other information on the various Groups of the Core tab as necessary.
Use the "i" Information icon for field definitions, if needed.
- Make other selections and fill in other information on the various Groups of the Core tab as necessary.
-
Note: You do not need to visit the WebTrac Settings Group. Range Ball Service Items can be sold via RecTrac GUI only at this time. Range Ball Service Items currently cannot be purchased by patrons using WebTrac.
-
AddFees and criteria to your Service Item as necessary.
- The Fee Type should be Standard Fee.
- The Transaction Type should be Purchase.
- Revenue GL Code is a mandatory field in the standard Vermont Systems design.
- Add New Criteria as needed. If you charge the same amount to everyone for this Service Item, you likely will not need criteria.
-
AddRules to this Service Items as needed.
- If there are no special allowances or restrictions regarding the purchase of this Service Item, you likely will not need Rules.
- Add Comments to this Service Item as needed.
- Click Save when done to Save your Service Item. You will be returned to the Service Item Management DataGrid.
- Repeat these steps to create other Range Ball Service Items as needed. A separate Service Item must be created for each bucket size you offer.
-
AddFees and criteria to your Service Item as necessary.
Sell a Range Ball Service Item and Generate a Range Servant PIN
Note: Range Ball Service Items can be sold via RecTrac GUI only at this time. Range Ball Service Items currently cannot be purchased by patrons using WebTrac.
- In RecTrac, sell the Service Item as you normally would.
- The subsequent receipt will contain the PIN. An example appears below.
- "PIN#" is a Vermont Systems Language Code and can be customized, if desired. Phrase ID=Rcpt-POS-00059.
- When at the ball machine, your patron will enter the PIN and balls will be dispensed.
- PINs are one-time use only
- The Range Management System software handles the expiring of unused PINs.
Cancellations
If there is a cancellation, when you click Process, information is sent to Range Servant to cancel the generated PIN.
If Communication to Range Servant is not Available
When using Range Servant and you sell a Range Ball Service Item, a check is done to verify the communication to the Range Servant server. This check is done once per sale, and it is done when you add the first Range Servant Service Item to the cart. If communication cannot be established, then there is no reason to sell the Service Item, as RecTrac will not be able to communicate with Range Servant to generate the PIN.
If communication is not available, then a message will be displayed. You will need to get your IT staff involved to troubleshoot the issue. Do not continue with additional range ball sales until the communication issue is resolved by the IT department.
Additionally, Range Servant can assist you with the download and running of a Tera Terma test, if needed, for testing connection to Range Servant.
Range Systems
Range Automation Systems (aka Range Systems) uses a Curl to generate a PIN at the time of sale. Range Systems provides you (the client) with a URL and assists you with the creation of a Resource on your server that the URL points to. When the sale of a Range Systems Service Item is being completed at the payment screen, RecTrac communicates with the Range Systems resource to get the PIN(s). During the completion of the sale, a Curl request is sent to Range Systems. The request includes the Fee Amount (which is used to determine the number of range balls to be dispensed) and the receipt number. The response includes the Range Systems Coupon Code (the PIN), which is used at the Golf Ball dispenser.
Before You Proceed
This document is written with the following assumptions. If any of the items listed below is NOT true, contact Vermont Systems Support prior to continuing, as the steps in this document may prove difficult to complete and unexpected results may occur.
- You have created an account with Range Systems.
- Range Systems Contact: Greg Harris - grreg@rangesystems.com
- Range Systems has provided you with their URL and they have assisted you with the creation of the Resource on your server.
- You have conferred with Range Systems and understand their pricing schema. The number of balls dispensed upon the sale of Range Systems Service Items is dependent upon the amount of the sale, and in some cases, the time of the sale.
- Your organization is running RecTrac 3.1.06.13 or greater.
- The User ID with which you sign into RecTrac has the requisite permissions and ability to access all modules and functions pertaining to ball dispenser program and Range Systems.
- You understand RecTrac DataGrids and how to maneuver through them.
- You understand RecTrac Profile Management and hierarchy.
- You understand RecTrac Fees and Criteria. As noted above, the number of balls dispensed upon the sale of Range Systems Service Items is dependent upon the amount of the sale, and in some cases, the time of the sale. This document does not provide instruction for RecTrac Fee Maintenance beyond the minimum requirements necessary to set up a Range Ball Service Item.
RecTrac Setup
The following provides the basic File Maintenance steps required to create a Range Ball Service Item and generate a PIN for your Range Systems golf ball dispensers.
Note: Any file paths and screen/tab locations in this document refer to file paths and screen/tab locations as they appear in the standard, default Vermont Systems design. Your setup and design may vary.
Create and Link an eRange - Range Systems Profile
The eRange Range Systems profile allows you to store URL and PIN size information for your Range Systems account.
- In RecTrac, search for and go to Profile Assignments.
- Click Add. You will continue to the Profile Add/Update screen.
- Enter a Profile Code for your eRange Range Systems profile. For example, Range Systems Profile.
- Expand Profile Type and select eRange.
- Expand Profile Subtype and select Range Systems.
- Enter a Profile Description, if desired, and click Create.
- Enter the URL given to you by Range Systems when creating your account. When establishing your account, Range Systems should have assisted you in the creation of a Resource on your Server. The URL in this field points to that Resource and is used during a sale to determine the number of balls to be dispensed and to generate the one-time use PIN.
- Expand PIN Font Size and select a value. The value you select will be the font size in which the PIN prints on receipts. Vermont Systems recommends using 10, 12, or 14.
- Click Save to save your changes. You will return to Profile Assignments.
- Determine where you want to link your Range Systems profile. If you have one (1) Range Systems account only, linking your profile at the Default Level of Hierarchy is a good option.
- In the Linked Profiles middle column, click to expand the Default folder.
- In the Available Profiles left-hand column, click to highlight the eRange profile you just created.
- Click again and hold the mouse button down. When you have "grabbed" the profile, a red box will appear that displays the profile name.
- Drag and drop. Drag to the Default Profiles folder in the middle column. When the box turns green, release the mouse. This will place the profile at the Default level of hierarchy. Profile Assignments are saved automatically and take effect immediately.
The level of hierarchy can be changed later, if needed. - Exit Profile Assignments.
Repeat these steps to create and link additional Range Systems profiles, if necessary. This completes the setup steps for your eRange - Range Systems profile.
Create Range Ball Service Items
Complete the following steps to create a Range Ball Service Item that will be used to record sales of range balls sold.
- In RecTrac, search for and go Service Item Management. You will continue to the POS Service Item Management DataGrid.
- Click Add. You will continue to the POS Service Item Update screen.
- Enter a Service Item Code. Codes may be alphanumeric. This is a mandatory field in the standard Vermont Systems design. Your design may vary.
- Expand Record Type and select Range Ball.
-
Note: Your selection here MUST BE "Range Ball."
- Enter Long and Short Descriptions for your Service Item. For example, Range Systems Ball Dispenser.
The Short Description is printed on Receipts. - Expand Permissions, if desired, and add appropriate Permissions to this Service Items. Permissions allow you to control which users can "see" the Service Item on DataGrids and picklists in RecTrac.
- Expand the Miscellaneous Settings Group and ensure the Bucket Size field is set to Not Applicable. The number of balls dispensed upon the sale of Range Systems Service Items is dependent upon the amount of the sale, and in some cases, the time of the sale, so a Bucket Size is not needed.
- Enter Long and Short Descriptions for your Service Item. For example, Range Systems Ball Dispenser.
-
Note: This field appears only if your Record Type is Range Ball. If you do not see this field, then return to Step 4 above and ensure your selection in the Record Type field is Range Ball
- Make other selections and fill in other information on the various Groups of the Core tab as necessary.
Use the "i" Information icon for field definitions, if needed.
- Make other selections and fill in other information on the various Groups of the Core tab as necessary.
-
Note: You do not need to visit the WebTrac Settings Group. Range Ball Service Items can be sold via RecTrac GUI only at this time. Range Ball Service Items currently cannot be purchased by patrons using WebTrac.
-
AddFees and criteria to your Service Item as necessary.
- The Fee Type should be Standard Fee.
- The Transaction Type should be Purchase.
- Revenue GL Code is a mandatory field in the standard Vermont Systems design.
- Add New Criteria as needed. If you charge the same amount to everyone for this Service Item, you likely will not need criteria.
-
AddRules, Questions and Comments to this Service Item as needed.
- If there are no special allowances or restrictions regarding the purchase of this Service Item, you likely will not need Rules.
- If there are no questions to be answered when purchasing this Service Item, you likely will not need Questions.
- Comments should be added as needed.
- Click Save when done to Save your Service Item. You will be returned to the Service Item Management DataGrid.
- Repeat these steps to create other Range Ball Service Items as needed. The Range Systems API dispenses balls based on the dollar value of the sale. Whether you opt to create a number of Range Systems Service Items each with one fixed Fee (Large, Medium, and Small for example) OR whether you create one (1) Service Item only and link multiple Fee Prompts, Rules and Criteria to it, OR whether you mix and match will be up to your local policy and pricing schema with Range Systems.
-
AddFees and criteria to your Service Item as necessary.
Sell a Range Ball Service Item and Generate a Range Systems PIN
Note: Range Ball Service Items can be sold via RecTrac GUI only at this time. Range Ball Service Items currently cannot be purchased by patrons using WebTrac.
- In RecTrac, sell the Service Item as you normally would.
- The subsequent receipt will contain the PIN. An example appears below.
- "PIN#" is a Vermont Systems Language Code and can be customized, if desired. Phrase ID=Rcpt-POS-00059.
- When at the ball machine, your patron will enter the PIN and a number balls equal to the dollar value of the Service Item will be dispensed.
- PINs are one-time use only. Once the PIN is entered into the ball machine, the status of the PIN is changed to "Redeemed."
- A "Redeemed" PIN cannot be refunded.
- The Range Management System software handles the expiring of unused PINs.
Processing a Refund in RecTrac
- Process a Refund as normal through Purchase History. This is true regardless of whether the sale was to a Household or was done using the Daily/Guest HH.
- Negative quantity sales will not void the PIN. When you click the Process button to complete the Refund, RecTrac will send a request to Range Systems to void the PIN.
- A PIN that has been refunded cannot be redeemed.