POS Technical Reference User Guide
POS Technical Reference User Guide
This confidential document is issued pursuant to non-disclosure agreements in place and subject to the terms and conditions
contained therein. Reproduction or use, without the express permission from Heartland of any portion of this manual is
prohibited. Copyright © Heartland Payment Systems, a Global Payments company
TABLE OF CONTENTS
PREREQUISITES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Server Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Server Platform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Explanations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
District Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Online prepayments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Whitelist Additions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Database Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
SQL Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
*.LBS Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Environmental Factors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Interference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Windows Personalization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Windows Authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
SQL Authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Backup Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Fields Defined . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Transfer Pictures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Bar Code Card Specifications for the IDR2 Pin Pad & Bar Code Reader. . . . . . . . . . . . . . . . . . . . . . . 49
ID Cards. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Windows Defender . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Windows Aero. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Windows Personalization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Setting Up the SQL End Day Process & Enable SQL Refresh Data. . . . . . . . . . . . . . . . . . . . . . . . 59
Central.LBS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Configuring Central. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Group by Sub-Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Touchscreen MONITOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
1300G Programming. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Discontinued Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
All Nutrikids POS products require Microsoft .NET Framework 2.0 or 3.5. Some
require Microsoft .NET Framework 3.5. Windows 7 automatically satisfies this
requirement since it includes Microsoft .NET Framework 3.5.
Microsoft .NET Framework 4.0 does NOT satisfy these requirements at all.
For more details concerning the server requirements, please see the section Server Requirements
below.
Please note that with Express versions of SQL Server there are performance limitations
and data size restrictions which can impact the use of NUTRIKIDS® POS software.
SERVER REQUIREMENTS
The following includes a detailed listing of the supported requirements for your servers when preparing
to install the NUTRIKIDS® POS software. Note that a dedicated SQL Server for the NUTRIKIDS® POS
Enterprise software is not required.
SERVER PLATFORM
Operating System Microsoft Windows Server® 2003 or 2008 (32-bit/64-bit)
Database Software Microsoft SQL Server® 2008 or 2012 (32-bit/64-bit)
HARDWARE
Processors Dual 2.5GHz single-core processors (or greater)
Memory 4GB (or greater)
Hard Disk RAID Array (recommended)*
Disk Space 20GB free (variable)*
* Storage space requirements can vary greatly from district to district. Database backups are created daily, and while these
are compressed, in larger districts each backup will occupy a considerable amount of space. Regardless of the disk space
requirements, we highly recommend that the server utilizes RAID technology for its hard drive configuration to protect against hard
drive failure.
For more on database licensing for Microsoft SQL Server®, please visit http://www.microsoft.com/sqlserver/2008/en/us/
licensing-faq.aspx
TECHNICAL SPECIFICATIONS
Features Recommended Minimum
Processor 2.9GHz Dual Core 1.86GHz Single Core
Memory (RAM) 4GB 2 GB
Hard Disk Space 200MB - 10GB 200MB - 10GB
Networking 100/1000 Mb Ethernet LAN 10/100 Mb Ethernet LAN
Operation System Microsoft Windows 7 Pro SP1
® ®
Microsoft® Windows® 7 Pro SP1
Interfaces (Serving Line only) One (1) available USB or serial One (1) available USB or serial
RS-232 port connection per input RS-232 port connection per input
device. Model selected determines device. Model selected determines
type of connection needed. type of connection needed.
Monitor SVGA SVGA
Touch-Capable (Serving Line Only) Touch-Capable (Serving Line Only)
Supplemental
District Server Files
NUTRIKIDS
SQL Database
OFFICE
INTERNET
WAN
SIS Server
mySchoolBucks
Online Prepayments
(Optional Service)
WAN
WAN
HIGH SCHOOL MIDDLE SCHOOL ELEMENTARY SCHOOL
LAN LAN
LAN POS
POS Serving Line
Manager +
POS Manager
EXPLANATIONS
PREFERRED NETWORK SPECS* TOPOLOGY EXPLANATIONS
Local Area Network (LAN) Supplemental Files: District Server: POS Serving Line: mySchoolBucks:
Wired: DATABASES
100Mbps or greater AND SUPPLEMENTAL FILES
Wireless:** 802.11g or greater This network share stores system This server can be either shared or In buildings with multiple serving mySchoolBucks automatically
This network share stores system files that facilitate communication between the POS Manager and POS
Wide Area Network (WAN)
files that facilitate communication
between the POS Manager and
dedicated. The NUTRIKIDS POS
SQL database along with the
line computers, transactional data
(e.g. meal purchases, prepay-
downloads online prepayments
into the POS database. It also
Wired/Wireless: Serving
10Mbps orLine
greatercomputers. It also stores student pictures, system backups, and installation files necessary
POS Serving Line computers.
It also stores student pictures,
supplemental files can be hosted
on the same server or separate
ments) is shared between serving
lines via a central file, which can
automatically uploads POS
transactional data for the past 90
for automatic system
* Districts that don’t meet these network specifications may
still be eligible for implementation of NUTRIKIDS POS. updates.
system backups, and installation servers. Student/adult data can be setup on the district server or days so parents can view their
Please consult with your sales representative for more files necessary for automatic be imported automatically from a locally if preferred. In the event of child’s account activity online.
information. Performance of some system functions may system updates. scheduled SIS export or through a network outage, serving line
vary based on your network environment. For additional
details please reference our technical documentation. the Mizuni SIF agent. computers will continue to allow
DISTRICT SERVER
** Wired connections are the preferred method of
connectivity for local area networks.
transactions to be processed.
Copyright © 2012
This server can be either shared or dedicated. Student/adult data can be imported automatically from a
scheduled SIS export.
ONLINE PREPAYMENTS
Online prepayments are imported into the POS database automatically via a sync service. This import
process also automatically uploads POS transactional data for the past 90 days so parents can view their
child’s account activity online.
DATABASE DEFINITIONS
SQL DATABASE
Description: The SQL Database acts as the medium to which student accounts, transactions, and
other data is accessed. NKPOS is the suggested name.
Note: If you are setting up SQL-based Central for multiple Serving Lines at the same building to
communicate with each other, the nkCentral database is also on the SQL Server. This is discussed in
the section titled SQL Central in Serving Line Setup section.
*.LBS FILES
Name: There are a large number of separate *.LBS files.
Description: These files are used for different purposes which include storing transactional
information, Free & Reduced applications, and flagging functionality within the POS
system.
Location: These files are created upon setup and all are located within the same POSData folder
(or other shared location) as NutKidMG.mdb.
Some LBS files are also stored on the local machine in the <appdata>\Nutrikids\
Enterprise folder tree.
Notes: *.LBS files include Manager- and Serving Line-level files.
Description: This database is the local copy of all the data transferred from the Manager’s Database
to the Serving Line.
Location: NutKidST.mdb is automatically placed in <appdata>\NUTRIKIDS\Point of Sale\
Serving Line\Data. DO NOT MOVE THIS FOLDER OR ITS CONTENTS FOR ANY
REASON.
Notes: This file helps the system continue to function in the event of network connectivity loss.
INTERFERENCE
A limitation with wireless networks is interference. In this case it would be the signal traveling between
the wireless access point and the computer(s) running NUTRIKIDS POS. Interference can originate
from many sources, the most prevalent being the line of sight between the wireless access point and
the intended device using it, microwaves, refrigeration units (compressors), and cordless phones. On a
lesser scale, Bluetooth devices, fluorescent lights, other 802.11 wireless access points, and bad electrical
connections can also cause interference.
PROCEDURE
1. At the server console prompt, load either SERVMAN or MONITOR.
LOAD SERVMAN | MONITOR <Enter>
NOTE: You can also set parameters with the SET command. See SET in Utilities Reference.
2. Choose Server Parameters from the Available Options menu.
3. Choose Locks from the Categories menu.
4. Decrease the following parameter values to limit the total number of file and record locks allowed for
the server:
Maximum Record Locks
Maximum File Locks
5. Decrease the following parameter values to limit the total number of file and record locks allowed for
each workstation:
Maximum Record Locks Per Connection
Maximum File Locks Per Connection
6. Press <Esc> twice to reach the Update Options menu.
7. Choose Update AUTOEXEC.NCF and STARTUP.NCF from the Update Options menu. A window
appears, indicating the path to the AUTOEXEC.NCF file.
8. If desired, press <Enter> to update the file. If you press <Enter>, the system writes the parameters to
the AUTOEXEC.NCF file or updates the parameters if they are already in the file. The file is updated
immediately. You do not need to reboot the server. If you do not press <Enter>, the parameter
changes last only until you reboot the server.
PROCEDURE
1. At the server console prompt, load either SERVMAN or MONITOR.
LOAD SERVMAN | MONITOR <Enter>
NOTE: You can also set parameters with the SET command. See SET in Utilities Reference.
2. Choose Server Parameters from the Available Options menu.
3. Choose Locks from the Categories menu.
4. Increase the following parameter values to increase the number of file and record locks allowed for
the server:
Maximum Record Locks
Maximum File Locks
5. Increase the following parameter values to increase the number of file and record locks allowed for
each workstation:
Maximum Record Locks Per Connection
Maximum File Locks Per Connection
6. Press <Esc> twice to reach the Update Options menu.
7. Choose Update AUTOEXEC.NCF and STARTUP.NCF now from the Update Options menu. A
window appears, indicating the path to the AUTOEXEC.NCF file.
8. Press <Enter> to update the file. If you press <Enter>, the system writes the parameters to the
AUTOEXEC.NCF file or updates the parameters if they are already in the file. The file is updated
immediately. You do not need to reboot the server. If you do not press <Enter>, the parameter
changes last only until you reboot the server.
You can set these individuals as POWER USERS, just note that all NUTRIKIDS
software and hardware updates will require an Administrator to perform these.
WINDOWS DEFENDER
We recommend excluding c:\<appdata>\Nutrikids and c:\<program files root> from Windows Defender
real-time protection. If this location is not excluded from Windows Defender real-time protection, it could
slow down Manager Program performance due to continuous scanning of files within the folder.
WINDOWS AERO
We recommend disabling Windows Aero when running Windows 7 Professional or Enterprise. While
the Manager programs will run with Aero enabled, the Aero interface may use large amounts of system
resources to deliver the 3-D window interface; this could impact the performance of the NUTRIKIDS POS
Manager software.
WINDOWS PERSONALIZATION
We recommend not using the High Contrast Themes in the Personalization Options for desktop themes.
Using the High Contrast Themes will cause the NUTRIKIDS POS Manager and Serving Line Programs to
display the text and windows improperly or not at all.
STEPS
1. Restore SQLbackup.bak to the NKPOS database.
I. Place SQLbackup.bak at the root of C:\. More than likely, you will need to unzip/extract
the actual backup file within SQLbackup.bak.
a. To extract the compressed file, right-click the file and choose RENAME.
b. Highlight the BAK file extension and type ZIP. Click OK to confirm the change.
c. Double-click the ZIP file and extract tempsqlXXXX.bak (where XXXX are numbers)
to C:\.
II. Open MICROSOFT SQL SERVER MANAGEMENT STUDIO.
III. Restore the database that you previously extracted to C:\
a. Right-click DATABASES. Choose NEW DATABASE.
b. In the NEW DATABASE window, type NKPOS in the DATABASE NAME field.
c. Click OK to create the database.
After the Database is restored, be sure to right-click NKPOS and choose PROPERTIES.
Go to OPTIONS and make sure that it’s set to SIMPLE RECOVERY MODEL.
i. If Windows Authentication is used, click SEARCH and search for the user or
group being set up.
ii. If you are setting up a group, go to OBJECT TYPES and select GROUP. You
may also need to change the Location to the Entire Directory. Click ADVANCED
to search by name if you are not having success using CHECK NAMES.
SQL AUTHENTICATION
1. Type in your chosen user name in the LOGIN NAME box.
2. Click the SQL Server Authentication radio button.
3. Choose a password then confirm it (for consistency, we suggest nutrikids).
4. Uncheck ENFORCE PASSWORD POLICY. This will automatically uncheck the two boxes
below it
Note: If you get an error once, click OK when you’re finished creating the SQL Authentication
user. You may need to enable the SQL Server and Windows Authentication mode
(Mixed Mode). This can be found by right-clicking the name of the SQL Server. It is the
outermost icon in the Object Explorer. Choose Properties, Security, SQL Server and Windows
Authentication mode. Click OK.
5. At the bottom of the screen, change the default Database to NKPOS.
6. Click SERVER ROLES at the top left and check SYSADMIN.
7. Click User Mapping and check off the NKPOS Database from the list.
8. Click db_owner from the other list below
9. Click OK.
You will need to restart the SQL server if making any changes (make sure there are no
other databases running on this server prior to restarting).
6. Check the SQL Server Agent in Services.msc (NOT available if the district uses SQL Express)
a. Click on the Recovery tab, and set the First failure, Second failure, and
Subsequent failures to “Restart the Service”.
b. Double check that on the General tab, and the startup type is set to “Automatic”.
1. From the Director/Manager computer, browse to the POSData folder (Verify folder permissions - all
user accounts must have FULL CONTROL).
2. Double-click SQLMG_SETUP.EXE.
3. Accept all default settings. (Essentially, click NEXT twice and then FINISH when the installation
completes.)
4. If you are prompted to restart the computer, click OK.
5. Repeat Steps 2 through 5 at every Director/Manager workstation.
If this is the first time you are installing files and thus do not have an
existing POSData folder on the network, you will have to open the CD
in My Computer (or Windows Explorer) and copy the files to the network
share.
2. The first time the POS Manager program launches, the CONFIGURE DATABASE CONNECTION
opens. (Accessible after initial setup by clicking CONFIGURE CONNECTION after launching the
program.)
3. On the SQL PROPERTIES Tab, fill in the following information:
• Database Server: The IP Address or SQL Server and Instance name of the SQL Server. If
there is a server instance, include it here. The proper naming convention is server\instance
(note that the opening \\ are not needed)
• Database Name: The name of the database on the SQL Server you will connect to. (Default
database name: NKPOS)
• Database Port: Port number to establish connections to your SQL Server. (MS SQL Server
Default: 1433)
4. Click CONNECT. If a connection is successful, the Data Path window displays.
If your SQL server operates through Windows Authentication, you will not need
to specify a User or Password, so these fields must remain blank. If it uses SQL
Authentication, you must specify the account user name and password, created
on the SQL server, which has been granted access to the SQL database.
The Data Path should be specified using a UNC (Uniform Naming Convention)
path name or an IP Address. This means that mapping a drive to the POSData
folder and using that drive letter name in the path is not recommended.
3. From within this folder, click OPEN; this sets the current data path.
4. Click CLOSE and the NUTRIKIDS Enterprise POS Manager program opens.
3. If the database is set up correctly, the Buildings within your database are listed.
Click
Transfer/Refresh
3. Click TRANSFER/REFRESH.
4. The TRANSFER COMPLETE pop up appears when the transfer is finished. Check the STATUS
column on the grid to make sure all transfers were successful. This is indicated with a green highlight
and the text Transfer Completed Successfully.
5. Click OK when done. Click CLOSE and then click CLOSE again to return to the Main Menu.
3. Click NEXT.
4. Select a Building or click SELECT ALL to select all buildings.
5. Click NEXT.
6. Select the fields that you would like in your Excel Spreadsheet by selecting it and clicking the right-
pointing arrow. Remove an item by selecting it from the right-hand list and clicking the left-pointing
arrow.
7. Click NEXT.
8. From the next window select the options you wish to export (All, Active Only, or Inactive Only
students, Student Eligibilities, and Eligibility Codes).
9. Click EXPORT.
10. Click OK at the confirmation prompt when the export completes.
11. Go to Excel and save the spreadsheet.
IMPORTABLE FIELDS
In order for the each record to import successfully it must include the five required§ field identified below.
* IF THE DATE OF BIRTH (DOB) FIELD IS SELECTED, ANY RECORD THAT DOES NOT CONTAIN A DATE OF BIRTH IS WILL BE POPULATED WITH A DEFAULT DATE OF
1/1/1900.
** . PLEASE NOTE THAT THE PROGRAM ONLY ALLOWS ONE ELIGIBILITY CODE PER ELIGIBILITY TYPE.
3. Click BROWSE. Locate the SIS file. (The file type will either be .TXT or .CSV. This is the file created
by your Student Information System. Contact the file’s creator or your Technology Department if you
are not sure where this file is located.)
4. Click OPEN to save the location.
5. Click NEXT.
6. Select DELIMITED or FIXED WIDTH from the DATA SOURCE TYPE window. (If you’re unsure,
contact the file’s creator or your Technology Department.)
7. Click NEXT. Depending on the Data Source Type that you select, follow the steps on the following
pages for the appropriate type.
1. Check which delimiter you are using. Notice that you may use the OTHER field in case the .txt/.csv
file has a unique delimiter.
►► A Comma Delimited (.csv) file could look like this:
FirstName, LastName, Address, City, State, ZIP
2. Select the row at which you want the import to start. (If the .txt/.csv file has a header row, then you
should start the import at Row 2, otherwise leave this option set to 1.)
3. From the drop-down, select a Text Qualifier. (The Text Qualifier is used to identify text groupings in
the .txt/.csv file. For example, if the .txt/.csv file contains Student ID Numbers but these are enclosed
in quotations, it is these quotations that represent the beginning and end of each text field in the .txt/.
csv file (for example, if last name = “Jones Jr.”).
4. Click NEXT.
Click NEXT
If you have the NUTRIKIDS Free & Reduced Module, DO NOT import F&R eligibilities.
If your import file contains an Eligibility field, you can select the Skip Column option
(delimited files only) to ignore that field during import, or uncheck it (fixed width files only).
If your .txt/.csv file contains ALL of the Active Students in your District, and NO
Deactivated Students, you may check the option labeled ACTIVE ONLY LISTED.
Please call 1.800.724.9853 if you have any questions regarding Active Only Imports.
MAIN TAB
ELIGIBILITY CODES – Covert codes for Free, Reduced,
and Full Paid students. If you have the NUTRIKIDS Free &
Reduced Module, DO NOT import F&R eligibilities. If your
import file contains an Eligibility field, you can select the
Skip Column option to ignore that field during import.
MATCH BUILDINGS BY – Indicate how the building(s) is
identified in the import file (Building Number or Building
Code).You must choose one or both.
NOTE: If you are using the Building Import Codes feature
be sure to check Building Code.
GENDER CODES – If the import includes the students’
gender, include the codes for male and female. M (male)
and F (female) are the default codes if these fields are left
blank.
ACTIVATION CODES – Codes for Active and Inactive
students, if used. Also indicate if this import is ACTIVE
ONLY LISTED (no inactive accounts are listed within the
import file).
DATE OF BIRTH FORMATTING – If the date of birth field
is being imported, check DATE OF BIRTH FORMATTING
and select a format order. If the date is within a delimiter,
enter it in the field provided. If the DOB is a set number
of characters, select FIXED LENGTH and choose the
appropriate length (6 or 8).
BUILDINGS TAB
This feature allows you to map multiple building import
codes to an existing NUTRIKIDS building ID. When the
student’s Student Information System (SIS) assigned
building ID is different than the NUTRIKIDS Building ID,
the student record can import and it is programmatically
assigned to the appropriate building code. One building
can be assigned per building import code, however
there can be multiple import codes created to the same
NUTRIKIDS building. (Refer to the example in sample
screenshot. T. Jefferson Elementary has been setup with
two building import codes- 2222 and 4444).
Using Notepad can help you determine the Start Positions of each field in your .txt file. Be
sure that Word Wrap is turned OFF (choose FORMAT and uncheck WORD WRAP) and
also make sure the Status Bar is showing (choose VIEW and then choose STATUS BAR).
MAIN TAB
ELIGIBILITY CODES – Covert codes for Free, Reduced,
and Full Paid students. If you have the NUTRIKIDS Free &
Reduced Module, DO NOT import F&R eligibilities. If your
import file contains an Eligibility field, you can select the
Skip Column option to ignore that field during import.
MATCH BUILDINGS BY – Indicate how the building(s) is
identified in the import file (Building Number or Building
Code).You must choose one or both.
NOTE: If you are using the Building Import Codes feature
be sure to check Building Code.
GENDER CODES – If the import includes the students’
gender, include the codes for male and female. M (male)
and F (female) are the default codes if these fields are left
blank.
ACTIVATION CODES – Codes for Active and Inactive
students, if used. Also indicate if this import is ACTIVE
ONLY LISTED (no inactive accounts are listed within the
import file).
DATE OF BIRTH FORMATTING – If the date of birth field
is being imported, check DATE OF BIRTH FORMATTING
and select a format order. If the date is within a delimiter,
enter it in the field provided. If the DOB is a set number
of characters, select FIXED LENGTH and choose the
appropriate length (6 or 8).
3. Browse through the Student Import Samples to verify accuracy. (There are five students that are
previewed in this section. Look through each Student’s information and confirm that the data looks
correct. Click the arrow [>>] keys located at the top to see the next student on the preview screen.)
4. Click IMPORT when you are done previewing the import. (If any of the import fields do NOT look
correct, click CLOSE. Review the import file and return to the DDU setup to analyze for issues.)
3. From the list of District Data Updates performed, check the ones you wish to review.
4. Click NEXT. The results window displays. Click PRINT to print out the log file. Click CLOSE to exit.
7. Click OK.
When the scheduler is about to perform a task it will grant you the
opportunity to cancel it if you happen to be working in the program.
3. Click BROWSE in the BACKUP DATA window. Browse to a safe location (NOT in the same location
of your main database) and record the location of this backup on a separate sheet of paper for future
reference. When you’ve chosen a location to save your backup, click SAVE.
4. Click BACKUP. A Progress Window appears.
5. Click OK to confirm that the database has been backed up.
FIELDS DEFINED
Items marked with an asterisk (*) are required for proper functionality.
Field Definition
SMTP Server* IP or network name of the server that hosts the SMTP server.
Use Authentication Check to enable basic user authentication to the SMTP server, meaning that
the user account and password that exist on that server need to be supplied.
Windows SSPI authentication is currently not supported.
SMTP Server Port* The port on which the SMTP Server is listening. Ensure that virus scanning is
not blocking communications with this port, typically Port 25.
From Email Address* The email address that the alert emails are being sent from.
From Display Name* The name that is displayed by the recipient’s email client when the email
is delivered. For example, in Microsoft® Outlook®, a display name of Gloria
Johnson with an email address of g_johnson@nksd.k12.ny.us appears as
Gloria Johnson <g_johnson@nksd.k12.ny.us>.
Use SSL If your district’s SMTP Server has a Secure Sockets Layer (SSL) certificate and
uses encryption for communication between the client and the server, check this
option.
Send Test Email Enables you to send a test message to a specified account. The test message
uses the settings allocated on the other tabs.
Enable Debugging Checking this option allows for further debugging, but most likely will be handled
by a NUTRIKIDS Customer Service Representative (1.800.724.9853, option #5).
Debugging Options Write Emails To A Log File Without Sending goes through and generates all of
the intended emails, yet rather than send them, writes each to a log file.
Override Recipient With allows the user to specify an explicit email address that
all emails are sent to, rather than the actual recipients (substitutes the actual
email address with this one.)
Test Connection Click to see if your connection to the SMTP server successfully works.
1. Create a folder in the same directory as the main database, NutKidMG.mdb, and name it
DistrictPicts. You can locate this directory in the Manager Program. (In the Manager Program,
choose TOOLS, DATAPATH. POS DATA PATH to see the location of the POSData folder share or
directory.)
2. Copy/upload the student pictures into the DistrictPicts folder.
You may disable the auto-show picture feature by deleting the file AutoPict.
LBS, located on the Serving Line computer in <appdata>\Nutrikids\Point
of Sale\Serving Line\Data. Deleting this file will also remove the REFRESH
PICTURES button from the Serving Line’s NAVIGATOR Screen.
READER
The NUTRIKIDS IDR2 Pin Pad & Bar Code Reader is a very versatile device. The specifications for
the type of cards and ink required for clean and accurate reads are provided here to help when making
decisions concerning bar code/ID card creation.
The IDR2 emits its beam in the red/yelllow spectrum at 635 nanometers and requires a bar code’s
contrast ratio to be at least 90%. Essentially, this means to avoid red and yellow ink on bar code ID
Cards. Black ink is the easiest to decipher, however greens and blues work well too.
ID CARDS
The NUTRIKIDS POS Manager Program can generate ID Cards that can be used with the NUTRIKIDS
IDR2 Pin Pad & Bar Code Reader and the Orbit Scanner.
1. Click STUDENTS.
2. Click LIST/PRINT STUDENTS.
Using Biometrics devices in some or all of the buildings in your district? Please refer to the
NUTRIKIDS Biometrics documentation, since additional folders will require full access.
You can set these individuals as POWER USERS, just note that all NUTRIKIDS
software and hardware updates will require an Administrator to perform these.
Make sure MANAGE OFFLINE FILES is disabled. You can check this by choosing START, CONTROL
PANEL, SYNC CENTER, MANAGE OFFLINE FILES. It should display that MANAGE OFFLINE FILES
is currently disabled.
WINDOWS DEFENDER
We recommend excluding C:\Program Files\NK_Station from Windows Defender real-time protection. If
this location is not excluded from Windows Defender real-time protection, it could slow down Serving Line
operations due to continuous scanning of files within the folder.
WINDOWS AERO
We recommend disabling Windows Aero when running Windows 7 Professional or Enterprise. While the
Serving Line programs will run with Aero enabled, the Aero interface may use large amounts of system
resources to deliver the 3-D window interface; this could impact the performance of the NUTRIKIDS POS
Serving Line software.
WINDOWS PERSONALIZATION
We recommend not using the High Contrast Themes in the Personalization Options for desktop themes.
Using the High Contrast Themes will cause the NUTRIKIDS Serving Line Programs to display the text
and windows improperly or not at all.
1. Access the NUTRIKIDS CD-ROM and copy all of the files to the POSData folder on the server. This
may have been completed during the installation of the Manager’s Software.
2. From the Serving Line computer, browse to the POSData folder.
3. Locate the file named St_Setup.exe and double-click it.
4. Follow the default, on-screen prompts by clicking NEXT. Click FINISH when the installation
completes. Do not change any of the default settings!
5. If you are prompted to restart the computer, click OK.
6. Complete Steps 1 through 5 above at each Serving Line workstation.
1. Navigate to C:\PROGRAM FILES (this will be C:\PROGRAM FILES (x86) on a 64-bit operating
system).
2. Double-click NK_STATION to access the folder.
3. Within the folder, choose FILE. Choose NEW, then choose TEXT DOCUMENT.
Extensions showing
4. Press DELETE to completely remove the default file name of New Text Document.
5. Type mouse.txt.
6. If file extensions are NOT showing, simply type mouse.
7. CLOSE any open windows and programs and RESTART the computer, if necessary.
When setting the Manager Database’s path, you MUST browse for NutKidMG.mdb.
Typing the location and filename does not set the path correctly.
If NutKidMG.mdb is not present when you browse, return to the Manager Program and,
from the Toolbar, choose S.L. DATA (or TRANSFERS) then TRANSFER TO SERVING
LINES.
2. Navigate the POSData folder, where NutKidMG.mdb resides. Click to select the file.
3. Click OPEN. The LINK TO MANAGER’S DATABASE field displays the location of the file that you
selected. If you use a mapped drive letter to set your data path, the system offers to convert it to a
more secure method by using a Uniform Naming Convention (UNC). You can choose to accept (click
YES) or decline (click NO) this change. WE STRONGLY SUGGEST USING A UNC DATA PATH.
Data path is set.
If Mapped Drive was used for Data
path:
4. If this is the only Serving Line for the building that you are setting up (called a standalone station),
click CLOSE. The Serving Line launches and the LOGIN Screen appears. Please go to the section
titled Set the Station Name. If this is one of multiple Serving Lines in the building that you are setting
up, proceed to the section titled Central.LBS.
5. If using the NUTRIKIDS® POS Manager Enterprise Version, proceed to the section titled If Using
SQL End Day Process (POS Manager Enterprise Version Only) on the next page.
1. Check the RUN SQL END DAY & ENABLE SQL REFRESH DATA check boxes. When these
boxes are checked, a new Tab marked SQL PROPERTIES becomes available.
2. On the SQL Properties tab, you must fill in the following information:
• Server: The IP Address or SQL Server name plus Instance name (SQL Server\Instance).
• Database: The name of the database on the SQL Server you will connect to (Default database
name is NKPOS).
• Port: Number of port to establish a connection to your SQL Server (MS SQL Server Default is
1433).
The SQL End Day Process and SQL Refresh are user-specific and must be set for
EACH NETWORK ACCOUNT that will use the Serving Line that you are setting up.
You can save time with regards to this by using Group Logins for cashiers within your
district..
Benefits Risks
WAN Centralized data location External connection to reach Central.LBS; single
point of connection failure
LAN Housed internally, local traffic only Lack of centralized data location
There are a wide variety of factors that can dictate WHERE to best locate Central. If you have questions
regarding this, NUTRIKIDS is available to help you consider the proper location of Central and the
benefits and risks involved.
CONSIDERATIONS
Consider the following when making the determination of whether a LAN or WAN is the right choice for
you. The factors to consider when setting up Central are:
• Volume of transactions at the Serving Lines
• Network Speed
• Throughput—The number of Serving Lines attempting to communicate with Central at any given
time
For assistance, please call NUTRIKIDS Customer Support at 1.800.724.9853, Option #5.
NETWORK SETUP FOR CENTRAL
We STRONGLY RECOMMEND the use of UNIFORM NAMING CONVENTION (UNC) paths
when setting up Central.
It is strongly recommended that the folders and files within a UNC path do not contain spaces, as in HS
Central. To avoid broken UNC paths, HS_Central, HS-Central, or HSCentral are preferred naming
options.
It is STRONGLY RECOMMENDED NOT to use MAPPED DRIVES when configuring Central
for your Serving Lines.
Microsoft discourages the use of mapped drives because drives can become disconnected after a regular
interval of inactivity. This inherent behavior requires manually reconnecting to an idle mapped drive in
order to re-establish communications.
Further reasons for these recommendations:
• A UNC path is stable, since the name of a computer or its IP address rarely change.
• A mapped drive letters are user-specific (for instance, the M drive on John Doe’s computer may
point to a different location than the M drive on Jane Doe’s computer).
• A mapped drive can disconnect if no activity to the drive is registered. The seconds it takes to
reconnect are vital to proper operation of the NUTRIKIDS POS Serving Line program.
• The speed of information transfer can be slower using a mapped drive as reported by Microsoft in
this support article (http://support.microsoft.com/kb/885189).
A fictitious example of a high school setup is shown below. Your paths WILL be different.
4. Central.lbs appears in the FILE NAME field. Click to the left of Central.lbs and TYPE THE PATH OF
THE NETWORK SERVER AND SUB FOLDERS WHERE CENTRAL.LBS FILE WILL RESIDE. This
will look like what is shown in the example here (your path will be different).
SYNCHRONIZATION INTERVALS
It is recommended that you do not set any station higher than 9 seconds when it comes to central
database communication. This may reduce the effectiveness of synchronization between stations.
Note above that the location of Central.LBS for HS Line #4 is in the POSDATA folder, not the MLKCentral
sub folder, where the other three (3) lines within the High School are located. Therefore, these lines will
NOT communicate with HS Line #4.
Serving Lines in a cafeteria with only one Serving Line do not require Central. These Serving Lines should
be configured as STANDALONE STATIONS.
Building Building Station Station Name Central Setup Type UNC Data Path location
Number Number
00005 Wilson Elementary 00011 Wilson Line #1 None - N/A None - N/A
00006 Clinton Elementary 00012 Clinton Line #1 None - N/A None - N/A
If this process is not completed, your district will have multiple Serving
Lines all listed as the same station, thus causing issues during Serving
Line operation and major problems on reports in the Manager program.
3 0 0 7
2. Press ADMINISTRATOR.
Press to
confirm
selection
Press to
select a
station
When you change a Station Name you MUST exit the program for the setting to be
accepted. Launch the program again after exiting to confirm that the station change
occurred.
If you see *SELECT STATION* in the upper-left corner of the LOGIN Screen, return
to the Manager program and, from the Toolbar, choose TRANSFERS, TRANSFER
DATA TO SERVING LINES. Select all stations and click TRANSFER/REFRESH.
Stations will now be populated for selection in the Serving Line program.
7. Click EXIT to exit the NUTRIKIDS POS Serving Line program. You are returned to the desktop.
5. The NAVIGATOR Screen appears. Check the SERVING LINE NAME in the upper-left corner of the
screen to ensure that the Serving Line is correctly assigned.
Is My Name showing?
What Day is it?
7. Press REFRESH DATA to ensure all settings and information has been applied locally.
8. Press OPEN BREAKFAST to verify that Students’ Accounts can be viewed from this Serving Line.
9. After pressing OPEN BREAKFAST, the STUDENT IDENTIFICATION screen provides options for
searching Student Accounts.
• The SEARCH RESULTS screen displays all accounts visible at this Serving Line, which are a
close match for the search pattern.
• Using any or all of the above searching options, verify that this Serving Line can see accounts for
children who belong to the Building to which this Serving Line is assigned.
TOUCHSCREEN MONITOR
If your district purchased a touchscreen monitor from Heatland School Soluions, but are using a district-
owned PC, you will need to install the monitor driver and install the NUTRIKIDS POS Serving Line
software.
POWERVAR
CONDITIONER
POWER
COMPUTER OUTLET
Either
All-In-One Unit PLUG BAR
or PC & Monitor or
(Input Device SURGE PROTECTOR
powered by USB) (if necessary)
POWERVAR UPS
CONDITIONER
POWER
OUTLET
COMPUTER
Either
All-In-One Unit PLUG BAR
or PC & Monitor or
(Input Device SURGE PROTECTOR
powered by USB) (if necessary)
USB
UTILITY
1. Double-click the NUTRIKIDS Device Configuration Utility icon in the System Tray. The Device
Configuration Utility window appears.
2. The Utility’s window is divided into two tabs: LEFT DEVICE and RIGHT DEVICE. By default, the
LEFT DEVICE displays. Click either side to assign the Pin Pad. LEFT DEVICE is shown in the
graphic.
As the cashier faces the Serving Line computer screen, their left refers to the
LEFT DEVICE and their right refers to the RIGHT DEVICE.
3. From the INPUT DEVICE MODEL drop-down, click and select NUTRIKIDS IDR2.
The NUTRIKIDS Device Configuration Utility automatically runs in the System Tray on the computer’s
Desktop, next to the System Clock. It is also accessible by choosing START, ALL PROGRAMS (or
PROGRAMS), NUTRIKIDS, POINT OF SALE, POINT OF SALE DEVICE CONNECTION UTILITY,
NKDEVCON.EXE.
6. Minimize the Utility to keep it running in the System Tray. This is crucial if you plan on launching
the NUTRIKIDS POS Serving Line for daily use.
Clicking the X in the corner of the Utility’s window closes it. A warning prompts you prior to
closing. Click YES to continue if you wish to discontinue using the Utility.
As the cashier faces the Serving Line computer screen, their left refers to the
LEFT DEVICE and their right refers to the RIGHT DEVICE.
If you are planning to set up and use two (2) Pin Pads on the Serving Line, the process is quite simple:
follow the setup procedures shown on the previous pages for the device that you have. If you set up one
device on the LEFT DEVICE tab, select the RIGHT DEVICE tab to set up the second device. Follow all
appropriate steps to ensure that the setups are correct.
REMOVING A DEVICE
Depending on the side from which you are removing a device, open the NUTRIKIDS Device
Configuration Utility and select the appropriate device tab. Set the device tab to NONE.
AA Check the physical connection of the NUTRIKIDS IDR2 device to the Serving Line machine. It may
have become unplugged, or the connection is loose. Click OK, plug the IDR2 back in, and return
to the NUTRIKIDS Device Configuration Utility and verify that the IDR2 device is set on one of the
Device tabs.
Anti-virus Exclusions
Set your anti-virus software to exclude the following directories:
• c:\<programs files root>\NUTRIKIDS
• c:\<appdata>\NUTRIKIDS
Display Settings
ID Number Settings
Adult Settings
Test Result
Status
Display Settings
Display Name Displays the account name on the LCD Screen when a PIN is typed or
when a card is scanned.
Display Custom Displays a custom message on the LCD Screen that you create here
Message when a PIN is typed or when a card is scanned. There are two (2)
available fields.
ID Number Settings
Ignore Leading Zeroes If the ID # has leading zeroes on the ID Card but it appears in the
in ID Numbers database without leading zeroes, activate this option.
Mask ID Numbers For When checked, **** appears on the LCD Display when students enter
Security their ID numbers.
Adult Settings
Adults Are NOT Adult ID Numbers will NOT work on the Input Device.
Allowed On This Line
Adult ID Numbers Do This feature is for Adult ID Cards only! If the Bar Code does not have the
Not Begin With “A” letter “A” at its beginning, check this option.
Test Results
Echo I/O Data Test the communication of the Pin Pad by entering numbers or swiping a
card.
Status
Current Status CONNECTED displays green and means that the device is functioning
correctly. NOT CONNECTED flashes red and means that the device is
not attached to the machine. DRIVER ERROR is solid red and means
that the IDR2 USB Driver is not installed (no hardware found or no IDR2
devices are attached).
Chipset ID Number The ID number for the Chipset of the IDR2. THIS IS NOT THE SERIAL
NUMBER.
Although Windows locates a driver for this device, installation is not complete. Do not
be misled by the FOUND NEW HARDWARE prompt that appears in the System Tray!
1 2
3 4
5 6
7 8
The UTC 3170s and PioneerPOS Asterix X5 come with the necessary
Honeywell driver installed.
1. Go to http://www.honeywellaidc.com/en-US/resources/Pages/download.aspx.
2. From the drop-down, select the Hyperion 1300g Linear-Imaging Scanner.
3. Under Product Software, Drivers, click the link for the Honeywell Scanning and Mobility USB Serial
Driver.
4. Fill out the form in order to download the driver.
5. Navigate to the location of where the file was saved. Extract the contents. Included in the files is a
HSM USB Serial Driver Getting Started Guide.pdf which provides detailed instructions for installing
the drivers for your scanner.
6. Plug in the Hyerperion 1300g Scanner and, when driver installation is complete, a prompt in the
computer’s System Clock appears notifying you that the device is ready for use.
1300G PROGRAMMING
Note: The scanners are shipped pre-configured and programmed.
The programming chart is available in the Hyperion 1300g Quick Start guide and is available on the
Honeywell website. The latest version can be obtained from the following link: http://www.honeywellaidc.
com/en-US/Pages/Product.aspx?category=hand-held-barcode-scanner&cat=HSM&pid=1300g
1. Double-click the NUTRIKIDS Device Configuration Utility icon in the System Tray. The Device
Configuration Utility window appears.
The NUTRIKIDS Device Configuration Utility automatically runs in the System Tray on the computer’s
Desktop, next to the System Clock. It is also accessible by choosing START, ALL PROGRAMS (or
PROGRAMS), NUTRIKIDS, POINT OF SALE, POINT OF SALE DEVICE CONNECTION UTILITY,
NKDEVCON.EXE.
2. The Utility’s window opens. It is divided into two tabs: LEFT DEVICE and RIGHT DEVICE. By default,
the LEFT DEVICE displays. Click either side to assign the Pin Pad. LEFT DEVICE is shown in the
graphic.
4. The Advance Device Settings window opens. Set the Port Name to COM3, (Verify the remaining
fields match as the following example. These are the default settings and are correct.) and click Save.
5. From the INPUT DEVICE MODEL drop-down, click and select HONEYWELL 1300G.
Clicking the X in the corner of the Utility’s window closes it. A warning prompts you prior to
closing. Click YES to continue if you wish to discontinue using the Utility.