Learner Import Specification in PICSWeb
Instructions on using this specification to create an import file are available in Uploading a New Import File.
A CSV or XLSX file import can be used to import Learner data from other data sources. The table below shows what types of imports are available for learners.
Supported Options |
|
|---|---|
CSV file format accepted | |
XLSX file format accepted | |
User Defined Fields supported | |
Record Handling |
|
Single record in file | User redirected to the New Learner window |
Multiple records in file | File added to the Import List with a status of Pending |
Further information is also available on the following:
Column Name | Required? | Format | Example | Notes | Data Type | FIeld Length |
|---|---|---|---|---|---|---|
FIRSTNAME |
| string | Roberta |
| String | 100 |
PREFFIRSTNAME |
| string | Ro | Preferred First Name | String | 30 |
SURNAME |
| string | Smith |
| String | 100 |
PREV_SURNAME |
| string | Jones |
| String | 30 |
SEX |
| string |
| 1: Male | String | 1 |
ETHNICORIGIN |
| numeric | 33 | ILR Ethnicity | String | 2 |
TITLE |
| numeric | 4 | 1: Mr 2: Mrs 3: Miss 4: Ms 5: Dr 6: Rev 7: Hon 8: Mx 9: Other | String | 1 |
BIRTHDATE |
| date | 13/03/2003 |
| DateTime |
|
NINUMBER |
| string | JB010101A |
| String | 9 |
PHOTOFILEID |
| File GUID |
| Must be an existing PICS File GUID | String | 32 |
MIAP_ULN |
| numeric | 100000009 | LRS Unique Learner Number (ULN) | String | 10 |
MIAP_FPN_SEEN |
| numeric |
| LRS Ability to Share / Privacy Notice seen 0 - No seen | String | 1 |
MIAP_PREFNAME |
| string |
| LRS Preferred Name | String | 35 |
MIAP_VERIFTYPE |
| numeric |
| LRS Identity Verification Type | String | 3 |
MIAP_VERIFTEXT |
| string |
| LRS Identity Verification Type Other details | String | 255 |
PROV_ID |
| string |
| Provider Assigned Internal Identifier | String | 20 |
LSC_ULIN |
| string | COB1234455 | ILR Learner Reference Number | String | 12 |
TAG_IDS |
| string | a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1*b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2* | INTERNAL USE ONLY A list of guids separated by an *. Each guid must be 32 chars long | String | ∞ |
TAG_NAMES |
| string | April 2022*Engineers* | A list of tags to create separated by an *. | String | ∞ |
ADDR1 |
| string | Flat A | First line of Home Address | String | 50 |
ADDR2 |
| string | 123 Acacia Avenue | Second line of Home Address | String | 50 |
ADDR3 |
| string | Suburb | Third line of Home Address | String | 50 |
ADDR4 |
| string | Townville | Fourth line of Home Address | String | 50 |
POSTCODE |
| string | TO1 1WN | Home Postcode | String | 8 |
L17POSTCODE |
| string | TO1 1WN | Home Postcode prior to enrolment | String | 8 |
PHONE |
| numeric | 01603492620 | Home Phone number | String | 18 |
MOBILEPHONE |
| numeric | 07799000001 | Mobile Phone number | String | 18 |
| string | bob@here.com |
| String | 100 | |
NOKNAME |
| string | A Smith | Next of Kin Name | String | 30 |
NOKREL |
| string | Parent | Next of Kin Relationship | String | 30 |
NOKPHONE |
| string | 01603492620 | First Next of Kin Phone Number | String | 15 |
NOKPHONE2 |
| string | 07799000002 | Second Next of Kin Phone Number | String | 15 |
NOKEMAIL |
| string | asmith@home.com | Next of Kin Email Address | String | 100 |
CONT_METH |
| string | PETS | Allowed Contact Methods between Provider & Learner T: Telephone | String | 5 |
PREF_CONTACT_METH |
| string | E | Preferred Contact Method between Provider & Learner | String | 1 |
SITE |
| string |
| PICS Internal Site code | String | 10 |
CLIENT_ID |
| string |
| Learner Internal Client structure Identifier. Used when importing new Episodes for an existing Learner | String | 5 |
ULIN_ID |
| string |
| Learner Internal Learner Reference Number structure Identifier. Used when importing new Episodes for an existing Learner Reference | String | 5 |
PICS_APIDENT |
| string |
| Source Applicant Identifier for linking between an existing Applicant and a Learner | String | 5 |
RISKLEVEL |
| string |
| Learner Risk Level 1: High 2: Medium 3: Low | String | 1 |
QUALPLAN |
| string |