Available Destiny Fields

When preparing to use the Patron Import Converter, you can include any or all of the following fields in your CSV file. It is helpful to share this list with those who will be creating the CSV file, so they can see the available fields and limitations of those fields.

Note: For fields that require specific output (see the Comments in each field for expected values), you can use the Patron Import Converter’s mapping feature. If a field will have a consistent value that can be used to assign another field, you can map those CSV fields to the values Destiny is expecting.

Destiny Field	Configuration File Field	Max Length	Comments
Site Short Name	field_siteShortName	10	Required. Must match either the site short name, or an Alias, entered in district configuration. If not in the CSV file for a single school, enter it in the properties file.
Barcode	field_barcode	14	Required when adding a patron. Must be unique in a school. Use “autoassign” to assign the next available barcode number to the patron. “Autoassign” cannot be used when matching Site Short Name and Barcode.
District ID	field_districtID	40	Required if used for matching or on Edit District page. Must be unique in the district.
Last Name	field_lastName	42	Required.
First Name	field_firstName	42
Middle Name	field_middleName	42
Nickname	field_nickname	30
Patron Type	field_patronType	30	If not specified, default is used. If unknown, Patron Type is created. S and F are not accepted for Student and Faculty.
Access Level	field_accessLevel	30	If not specified, default is used.
Resource Group	field_resourceGroup	30	Only applies to Destiny Resource Manager sites. If not specified, default is used.
Status	field_status	1	Use Active (A), Inactive (I), or Restricted (R). Defaults to A if blank or invalid.
Gender	field_gender	1	Use Male (M), Female (F), or Unspecified (U). Defaults to U if blank or invalid.
Homeroom	field_homeroom	90
Grade Level	field_gradeLevel	30
Card Expires	field_cardExpires	10	Format as required on Edit District page.
Acceptable Use Policy on File	field_isAcceptableUsePolicyOnFile	5	True (T), False ( F), Yes (Y), or No (N)
Is Teacher	field_isTeacher	5	True (T), False (F), Yes (Y), or No (N)
User Defined 1	field_userDefined1	30
User Defined 2	field_userDefined2	30
User Defined 3	field_userDefined3	30
User Defined 4	field_userDefined4	30
User Defined 5	field_userDefined5	30
Graduation Year	field_graduationYear	4	YYYY
Birth Date	field_birthdate	10	Format as required on Edit District page.
User Name	field_username	50	Unique within the district. Required if updating the Password field.
Password	field_password	50
Email 1	field_emailPrimary	128
Email 2	field_emailSecondary	128
Email 3	field_email3	128
Email 4	field_email4	128
Email 5	field_email5	128
Address 1 Line 1	field_addressPrimaryLine1	42
Address 1 Line 2	field_addressPrimaryLine2	42
Address 1 City	field_addressPrimaryCity	42
Address 1 State	field_addressPrimaryState	42
Address 1 Postal Code	field_addressPrimaryZipCode	20
Address 1 Phone 1	field_addressPrimaryPhoneNumberPrimary	30
Address 1 Phone 2	field_ addressPrimaryPhoneNumberSecondary	30
Address 2 Line 1	field_addressSecondaryLine1	42
Address 2 Line 2	field_addressSecondaryLine2	42
Address 2 City	field_addressSecondaryCity	42
Address 2 State	field_addressSecondaryState	42
Address 2 Postal Code	field_addressSecondaryZipCode	20
Address 2 Phone 1	field_ addressSecondaryPhoneNumberPrimary	30
Address 2 Phone 2	field_ addressSecondaryPhoneNumberSecondary	30

Available Destiny Fields

_____________________________________________________________________________________