Import Cards - Conventions

Keyscan strongly urges that you have some familiarity with the Client software before you import a CSV file. You should review door and, if applicable, elevator groups. Review the Cardholder Information page to see how the field captions compare to your current CSV field headings. Use the Optional Card Holder fields not covered by the Cardholder Information fields so your CSV file dovetails as closely as possible to the Client cardholder fields.

The CSV file cannot have any commas between names for any field, otherwise the import will fail. Edit out any commas in the CSV file from the spreadsheet before you import the file into the Client software.

Please note the following if you use Excel when saving CSV formatted files:

Mandatory Cardholder Database Fields

You must include the following 5 data field headings in your CSV file. They must be formatted exactly as they are shown below since headings are case sensitive. You cannot have spaces between words in the headings. The column headings can be in any order. Any of these data fields can be empty if there is no matching or comparable content. But these 5 headings must be included.

Field Heading

Character

CardNumber

Numeric

CardBatch

Numeric

FirstName

Alpha

LastName

Alpha

GroupANumber

Numeric

 

If the site has elevators, include a column for Elevator Group A as shown below:

GroupANumber refers to a Door Group assignment in the Client software and is generally expressed as a department name. The Client software, however, assigns each Door Group a number from 001 to 511. The GroupANumber field in the CSV file must list the number, not the alpha description. You can change an alpha description to a numeric value in the spreadsheet. You do not have to enter the zeros that precede the number.

ElevatorAGroupNumber refers to an Elevator Group assignment. The same conventions apply as with GroupANumber.

Non-mandatory Cardholder Database Fields

The following fields are found on the Cardholder Information page in the Client software that are non-mandatory. These fields are optional and would only be included if your CSV file had a comparable field. They must be formatted exactly as they are shown below since headings are case sensitive. You cannot have spaces between words in the headings.

Field Heading

Character

GroupBNumber

Numeric

ElevatorGroupBNumber

Numeric

ArchivedCard

Not Applicable

CardLimitedNumber

Numeric (1-249)

ValidFrom

Date - Format (MM/DD/YY)  Must be equal to today or greater

ValidTo

Date - Format (MM/DD/YY)  Must be equal to today or greater

PhotoLocation

Path to users picture file (c:\Pictures\)

PhotoName

Filename of picture (MaryAnn.jpg)

Non-mandatory Additional Cardholder Fields

The following fields are the Additional Cardholder Information in the Client software. These fields are optional and would only be included if your CSV file had a comparable field. They must be formatted exactly as they are shown below since headings are case sensitive. You cannot have spaces between words in the headings.

Field Heading

Character

TelephoneNumber

Numeric with no hyphens

TelephoneExt

Numeric

FaxNumber

Numeric

EmailAddress

Alpha/Numeric

CardLocation

Alpha/Numeric

Parkingspot

Alpha/Numeric

Carplate

Alpha/Numeric

Barcode

Alpha/Numeric

Non-mandatory Optional Cardholder Fields

There are 10 Optional Card Holder fields that are user-defined in the Client software.

Open the CSV file in the spreadsheet and enter the applicable OptionalField# as the heading. Do not use the description given to the optional field for the heading. The headings must be formatted exactly as shown. Headings are case sensitive. You cannot have spaces between words in the headings.

Field Heading

Character

OptionalField1

exactly as shown

OptionalField2

exactly as shown

OptionalField3

exactly as shown

OptionalField4

exactly as shown

OptionalField5

exactly as shown

OptionalField6

exactly as shown

OptionalField7

exactly as shown

OptionalField8

exactly as shown

OptionalField9

exactly as shown

OptionalField10

exactly as shown

If there are any redundant fields that are not relevant to the Client cardholder fields, delete those fields before you import the CSV file.