Page tree




Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Multiexcerpt include
SpaceWithExcerptKLIB
MultiExcerptNameImporting People - KnT University
PageWithExcerptKLIB:KeepnTrack University Videos

Operators with administrative privileges have the ability to import person data into their KeepnTrack system. The ability to perform an import is dependent on the operator's security level. Account—level operators have the access to run an import but not Facility or Regular—level operators.

Use Choose File to open an operating system standard explorer window, allowing you to guide KeepnTrack to the location your person information files. After you have chosen the file you would like to import, click Next to upload it to the KeepnTrack server and advance to the Field Mapping section.

Notifications

First, provide the contact information of the operators you want notified when a person import is complete.

Notification Email

Enter the email address of a person if you plan to use email for notification purposes; you can list more than one email address separated by spaces (johndoe@examplelibrary.com janedoe@examplelibrary.com) or commas. To ensure that your email notifications are being sent, click the Test box located to the right of the field.

Notification Text Message

Enter the phone number that should be used to notify staff during special circumstances. To ensure that your text messages are being sent, click the Test box to the right of the field.


Data File Encoding

Windows

Select this if the file you are importing was created using Windows Standard (ANSI) file encoding.

Macintosh

Select this if the file you are importing was created using Macintosh Standard (ASCII) file encoding.

UTF-8

Select this if the file you are importing was created using the 8—bit Unicode Transformation Format—the preferred encoding method for email, web pages, and other places where text characters are stored or streamed.


Duplicate Handling

Next, select how you would like KeepnTrack to handle duplicate records for import. For instance, if you were to import a Staff member that already exists in your database, you can have their existing person record updated or created anew.

Update existing records, and add unknown Persons as new records

If selected, existing person records will be updated if they are discovered; they will be added new if not matched on Person ID, SSN, Student ID, Staff ID, or Login ID.

Always add new records, reassign Person ID as necessary

If this is selected, every record in the file is added as a new person record if the data contains enough information to properly add them. If a duplicate Person ID is detected, it is reassigned.


Facility Assignment

Facility is the only supported field that is currently repeating. This means that person records can be assigned to multiple facilities. Every non-Visitor person record that is imported must be assigned to at least one Facility ID.

Replace Facility with imported copy

This will replace any pre-existing facilities with the facilities assigned in the data import file. This is useful when transferring students.

Merge Facility with imported copy

This will add newly assigned facilities to any pre-existing facilities stored in the person record. This is useful when Volunteers are willing to offer their services at multiple facilities.


Field Mapping

If the tab-delimited file you choose to import doesn’t have a recognizable header, it will require manual field mapping. Selecting Next from the Selected Import Pane section will open the Field Mapping dialog, allowing you to match KeepnTrack data fields to information in your tab-delimited import files.

The data from the import file is shown on the left-hand side of the dialog. KeepnTrack field names are contained in the drop-down menus on the right-hand side. Use these menus to match the contents of the import file. If you want to skip or ignore some of the information in the import file, you can change the drop-down menu to None.

If you find that there are blank or unmatched sections in the principle record of the import file, you may select None to ignore that entry throughout all remaining file records; be aware, however, that sometimes one person record will lack information that others contain.

Ignore First Record

If the first record in your tab-delimited import file contains an invalid header or a list of column headings rather than importable data, make sure that this box is checked—that way, this column will not be interpreted as legitimate person data.

Cancel

Closes the Field Mapping dialog and returns you to the People import interface.

Import

Once the proper fields have been aligned, click the Import button to send the import to the Operations Management queue.


Multiexcerpt include
SpaceWithExcerptKLIB
MultiExcerptNamePerson Field Codes
PageWithExcerptKLIB:KnT Content

Person Field Codes
FieldCodeNotesPerson ID1000

The Person ID must be between 4 and 15 characters in length, alpha-numeric only.

First Name1007Middle Name1008

Appends to the First Name data fields with a <space>.

Last Name1006Suffix1101Organization (Address)1102Address Line One/Two1011

Supports two Address lines for import. It breaks apart the address at the \ into two different address fields.

City1012State1013Postal Code1014Country1016

Country Code is two-digit code from ISO list.

Is Volunteer1110

Blank=No, Yes=Yes, No=No, Volunteer=Yes

Is Student1111

Blank=No, Yes=Yes, No=No, Student=Yes

Is Staff1112

Blank=No, Yes=Yes, No=No, Staff=Yes

Is Vendor1113

Blank=No, Yes=Yes, No=No, Vendor=Yes

Is Volunteer Type1120

Blank=Blank, No Match=Blank, Exact Match=Type

Home Phone1017Work Phone1130Mobile Phone1131Email Address1019Facility1027

Each facility in your import file will require its own column, meaning you'll have to repeat the 1027 tag in the import header. In other words, facility IDs in the record must be tab-delimited
(e.g. StudentID#<tab>FacilityID01<tab>FacilityID02<tab>FacilityID03...). Additionally, you can use %%%ALL to assign the person to ALL facilities.

Image Removed

Notes1020Ethnicity1132Gender1032

Male=1(or M), Female=2 (or F).

Birthdate1045Emergency Contact1133Medical Conditions1134Social Security Number1002Driver License Number1140Driver License State1141License Plate Number1142Vehicle Registration State1143Vehicle Description1144Teacher1150Grade1010Bus #11151Bus #21155Homeroom1004Student ID1001Family ID1152Block Student Checkout1153

Yes=Yes, No=No, Blank=No

Authorized to Check Out1154

Names of people who are authorized to check a student out of school.
A backslash (“ \ ”) in any field is converted into a carriage return.
Repeating - append together with two backslash (“ \\ ”) to make new a paragraph.

Staff Type1160Staff Hire Date1161

MM/DD/YYYY for staff hire date.

Staff ID1162Employer1170Security Approved1176

Yes=Yes, No=No, Blank=No

Criminal Conviction1172

Yes=Yes, No=No, Blank=No

Last Background Check Date1173Login ID1052Password1003Personal Message1174URL Code1999

Determines that file is being imported into correct account.

Status4500

1=Active, 2=Inactive, 3=Pending, 4=Access Denied

Effective Date4501

MM/DD/YYYY for person start date.

Expiration Date4502MM/DD/YYYY for person end date.