Element451Integrations Guide

Banner UAT / Field Mappings

Updated Article

Testing the Ethos/Banner integration typically happens in two phases:

  • Element451 → Ethos/Banner
  • Ethos/Banner → Element451

Element451 → Ethos/Banner testing is usually completed first. This phase tends to take longer, as errors often originate in Banner and require investigation and updates on the partner side.

Ethos/Banner → Element451 testing is typically much faster, as there are fewer issues to resolve.

Both phases should begin after the Applications and Decisions modules have been configured and test records are available.

Triggering the Integration

During testing, integrations should be triggered manually. Once live, they can be automated.

For instructions, see How to Sync Records (Ethos).

Testing Element → Ethos/Banner#

Preparation#

Create test student records with applications. These should cover a wide range of scenarios used on your campus.

Note: These records will sync to your TEST SIS environment and should be removed before go-live.

Testing#

Follow the steps in How to Sync Records (Ethos) to trigger a sync.

Review the Sync Result#

After each sync, check the Integration Log:


Validate Data in Banner#

Once a record has synced successfully:

  • Review the record in Banner
  • Compare values using the Field Mappings section and/or testing script
  • Validate:
    • Element451 fields (slugs)
    • Corresponding Banner forms and fields

The Field Mappings reflect the standard integration configuration. If your implementation includes customizations, use this as a baseline and add any additional validation checks as needed.


Testing Script/Checklist#

An Excel file is available to support testing.

Banner - Element to Ethos UAT.xlsxAttachment, available from your Element451 team

The file includes:

  • Tabs for each data area
  • Field-level comparisons between Element451 and Banner
  • Space to track validation and notes

Notes:

  • This file is optional and does not need to be submitted
  • It is provided to help organize testing

Recommended usage:

  • Create a copy for each test student
  • Rename the file with the student name or ID
  • Use it to track which fields have been validated and any issues identified

Field Mappings#

Below is an overview of the Element451 fields (slugs) and corresponding Banner forms/fields included in the standard integration.

Element Profile FieldElement SlugBanner FieldBanner Form
Element IDuser-elementidGORADID_ADDITIONAL_IDSPAIDEN
School IDuser-identities-school-idSPRIDEN_IDSPAIDEN
First Nameuser-first-nameSPRIDEN_FIRST_NAMESPAIDEN
Last Nameuser-last-nameSPRIDEN_LAST_NAMESPAIDEN
Middle Nameuser-middle-nameSPRIDEN_MISPAIDEN
Former Last Name(s)user-former-last-name(name type = BIRTH)SPAIDEN
Preferred First Nameuser-preferred-name(name type = PREFERRED/CHOSEN)SPAIDEN
Name Prefixuser-prefix-nameSPRIDEN_SURNAME_PREFIXSPAIDEN
Name Suffixuser-suffix-nameSPBPERS_NAME_SUFFIXSPAIDEN
Emailuser-email-addressGOREMAL_EMAIL_ADDRESSGOAEMAL
Social Security #user-ssnSPBPERS_SSNSPAPERS
Date of Birthuser-dobSPBPERS_BIRTH_DATESPAIDEN
Genderuser-genderSPBPERS_SEXSPAPERS
Gender Pronounsuser-gender-pronounsSPBPERS_PPRN_CODESPAPERS
Native Languageuser-citizenship-native-languageGOBINTL_LANG_CODEGOAINTL
Citizenship Statususer-citizenship-us-statusesSPBPERS_CITZ_CODESPAPERS
Visa Typeuser-citizenship-visa-typeGORVISA_VTYP_CODEGOAINTL
Are You Hispanic/Latino?user-race-hispanicSPBPERS_ETHN_CODESPAPERS
Your Raceuser-race-categoriesGORPRAC_RACE_CDESPAPERS
Country of Citizenshipuser-citizenship-countryGOBINTL_NATN_CODE_LEGALSPAIDEN
Country of Birthuser-citizenship-country-of-birthGOBINTL_NATN_CODE_BIRTHSPAIDEN
Home Address / Mailing Addressuser-addresses-type(HOME vs. MAILING addresses)SPAIDEN
Address Line 1user-addresses-street1SPRADDR_STREET_LINE1SPAIDEN
Address Line 2user-addresses-street2SPRADDR_STREET_LINE2SPAIDEN
Address Line 3user-addresses-street3SPRADDR_STREET_LINE3SPAIDEN
Cityuser-addresses-citySPRADDR_CITYSPAIDEN
Stateuser-addresses-stateSPRADDR_STAT_CODESPAIDEN
Provinceuser-addresses-provinceSPRADDR_STAT_CODESPAIDEN
Zip/Postal Codeuser-addresses-zipSPRADDR_ZIPSPAIDEN
Countryuser-addresses-countrySPRADDR_NATN_CODESPAIDEN
Countyuser-addresses-countySPRADDR_CNTY_CODESPAIDEN
Home Phoneuser-phone-home-country-codeSPRTELE_PHONE_AREASPATELE
Home Phoneuser-phone-home-numberSPRTELE_PHONE_NUMBERSPATELE
Cell Phoneuser-phone-cell-country-codeSPRTELE_PHONE_AREASPATELE
Cell Phoneuser-phone-cell-numberSPRTELE_PHONE_NUMBERSPATELE
CEEBuser-education-schools-ceebUsed to look up Institution Attended
Approximate GPAuser-education-schools-gpaSORHSCH_GPA or SORPCOL_GPASOAHSCH/SOAPCOL
Start Dateuser-education-schools-startSORDEGR_ATTEND_FROMSOAHSCH/SOAPCOL
End Dateuser-education-schools-endSORDEGR_ATTEND_TOSOAHSCH/SOAPCOL
Graduation Dateuser-education-schools-graduate-dateSORHSCH_GRADUATION_DATESOAHSCH
App Submitteduser-applications-submitted-timeSARADAP_APPL_DATESAAADMS
Majoruser-applications-majorSARADAP_MAJR_CODE_1SAAADMS
Termuser-applications-termSARADAP_TERM_CODE_ENTRYSAAADMS
Degreeuser-applications-degreeSARADAP_DEGC_CODESAAADMS
Campususer-applications-campusSORLCUR_CAMP_CODESAAADMS
Student Typeuser-applications-student-typeSARADAP_STYP_CODESAAADMS
Released Decisionuser-applications-decision-released-atSARAPPD_APDC_DATESAAADMS
Decision Status (SIS Code)user-applications-board-statusSARAPPD_APDC_CODESAAADMS
Admission Typeuser-custom-{subdom}-admission-typeSARADAP_ADMT_CODESAAADMS
Academic Loaduser-education-academic-load(SARADAP_FULL_PART_IND or SARADAP_FULL_PART_IND)SAAADMS
Relationshipuser-family-relationshipSORFOLK_DIR_RELT_ID / SORFOLK_RELT_CODESOAFOLK
Emailuser-family-emailGOREMAL_EMAIL_ADDRESSSOAFOLK / SPAIDEN
First Nameuser-family-first-nameSPRIDEN_FIRST_NAMESOAFOLK / SPAIDEN
Last Nameuser-family-last-nameSPRIDEN_LAST_NAMESOAFOLK / SPAIDEN
Middle Nameuser-family-middle-nameSPRIDEN_MISOAFOLK / SPAIDEN
Genderuser-family-genderSPBPERS_GNDR_CODESPAPERS
Phone Numberuser-family-phone-numberSPRTELE_PHONE_NUMBERSPATELE
Phone Numberuser-family-phone-country-codeSPRTELE_PHONE_AREASPATELE
Phone Typeuser-family-phone-type(used to determine if we write to HOME or CELL phone in SPATELE)Not displayed
Address Line 1user-family-address-street-1SPRADDR_STREET_LINE1SPAIDEN
Address Line 2user-family-address-street-2SPRADDR_STREET_LINE2SPAIDEN
Cityuser-family-address-citySPRADDR_CITYSPAIDEN
Stateuser-family-address-stateSPRADDR_STAT_CODESPAIDEN
Provinceuser-family-address-provinceSPRADDR_STAT_CODESPAIDEN
Zip/Postal Codeuser-family-address-zipcodeSPRADDR_ZIPSPAIDEN
Countryuser-family-address-countrySPRADDR_NATN_CODESPAIDEN
Same Address?user-family-same-addressNot displayed
First Nameuser-emergency-contacts-first-nameSPREMRG_FIRST_NAMESPAEMRG
Last Nameuser-emergency-contacts-last-nameSPREMRG_LAST_NAMESPAEMRG
Relationship Typeuser-emergency-contacts-relationship-typeSPREMRG_RELT_CODESPAEMRG
Cell Numberuser-emergency-contacts-cell-phone-country-codeSPREMRG_CTRY_CODE_PHONESPATELE
Cell Numberuser-emergency-contacts-cell-phone-numberSPREMRG_PHONE_NUMBERSPATELE
Home Numberuser-emergency-contacts-home-phone-country-codeSPREMRG_CTRY_CODE_PHONESPATELE
Home Numberuser-emergency-contacts-home-phone-numberSPREMRG_PHONE_NUMBERSPATELE

Testing Ethos/Banner → Element#

Preparation#

Identify the records you want to test.

  • If testing updates:
    • Use records previously synced from Element451 → Ethos/Banner
    • Make changes in Banner (e.g., phone, address, race, etc.)
  • If only using Ethos/Banner → Element:
    • Select a group of recent Banner applicants
    • Note their name and Banner ID

We recommend testing at least 5–10 records to cover a variety of scenarios.

Request a Sync#

Notify Element staff via Basecamp with the records to be synced:

  • If using previously synced records:
    • Provide a list of Element IDs
  • If syncing new records from Banner:
    • Provide Banner names and Banner IDs

Review the Sync Result#

Element staff will notify you once the records have been processed.

After notification:

  • Check the Integration Log for any errors
  • Resolve any issues if needed

Validate Data in Element#

Once the sync is complete:

  • Review the records in Element451
  • Confirm that:
    • New records appear as expected, or
    • Updates made in Banner are reflected correctly

Use the Field Mappings section and/or testing script to validate field-level accuracy.


Testing Script / Checklist#

An Excel file is available to support testing.

Banner - Ethos to Element UAT.xlsxAttachment, available from your Element451 team

The file includes:

  • Tabs for each data area
  • Field-level comparisons between Element451 and Banner
  • Space to track validation and notes

Notes:

  • This file is optional and does not need to be submitted
  • It is provided to help organize testing

Recommended usage:

  • Create a copy for each test record
  • Rename the file with the student name or ID
  • Use it to track validation progress and issues

Field Mappings#

Below is an overview of the Element451 fields (slugs) and corresponding Banner forms/fields included in the standard integration.

Element Profile FieldElement SlugBanner FieldBanner Form
School IDuser-identities-school-idSPRIDEN_IDSPAIDEN
School Emailuser-identities-school-emailGOREMAL_EMAIL_ADDRESSGOAEMAL
Username IDuser-identities-usernameidGOBTPAC_EXTERNAL_USERGOATPAC
Ethos IDuser-identities-ethosidGORGUID_GUID
First Nameuser-first-nameSPRIDEN_FIRST_NAMESPAIDEN
Last Nameuser-last-nameSPRIDEN_LAST_NAMESPAIDEN
Middle Nameuser-middle-nameSPRIDEN_MISPAIDEN
Preferred First Nameuser-preferred-name(Depends on Name Type Setting)SPAIDEN
Name Prefixuser-prefix-nameSPRIDEN_SURNAME_PREFIXSPAIDEN
Name Suffixuser-suffix-nameSPBPERS_NAME_SUFFIXSPAIDEN
Emailuser-email-addressGOREMAL_EMAIL_ADDRESSGOAEMAL
Social Security #user-ssnSPBPERS_SSNSPAPERS
Date of Birthuser-dobSPBPERS_BIRTH_DATESPAIDEN
Genderuser-genderSPBPERS_SEXSPAPERS
Gender Pronounsuser-gender-pronounsSPBPERS_PPRN_CODESPAIDEN
Native Languageuser-citizenship-native-languageGOBINTL_LANG_CODEGOAINTL
Citizenship Statususer-citizenship-us-statusesSPBPERS_CITZ_CODEGOAINTL
Are You Hispanic/Latino?user-race-hispanicSPBPERS_ETHN_CODESPAPERS
Your Raceuser-race-categoriesGORPRAC_RACE_CDESPAPERS
Home Address / Mailing Addressuser-addresses-type(HOME vs. MAILING addresses)SPAIDEN
Address Line 1user-addresses-street1SPRADDR_STREET_LINE1SPAIDEN
Address Line 2user-addresses-street2SPRADDR_STREET_LINE2SPAIDEN
Cityuser-addresses-citySPRADDR_CITYSPAIDEN
Stateuser-addresses-stateSPRADDR_STAT_CODESPAIDEN
Zip/Postal Codeuser-addresses-zipSPRADDR_ZIPSPAIDEN
Countryuser-addresses-countrySPRADDR_NATN_CODESPAIDEN
Countyuser-addresses-countySPRADDR_CNTY_CODESPAIDEN
Home Phoneuser-phone-home-country-codeSPRTELE_PHONE_AREASPATELE
Home Phoneuser-phone-home-numberSPRTELE_PHONE_NUMBERSPATELE
Cell Phoneuser-phone-cell-country-codeSPRTELE_PHONE_AREASPATELE
Cell Phoneuser-phone-cell-numberSPRTELE_PHONE_NUMBERSPATELE
CEEBuser-education-schools-ceebSTVSBGI_CODESSTVSBGI
Approximate GPAuser-education-schools-gpaSORHSCH_GPA or SORPCOL_GPASOAHSCH/SOAPCOL
Start Dateuser-education-schools-startSORDEGR_ATTEND_FROMSOAHSCH/SOAPCOL
End Dateuser-education-schools-endSORDEGR_ATTEND_TOSOAHSCH/SOAPCOL
Graduation Dateuser-education-schools-graduate-dateSORHSCH_GRADUATION_DATESOAHSCH
Graduateduser-educationa-schools-graduatedSORHSCH_GRADUATION_DATESOAHSCH
App Submitteduser-applications-submitted-timeSARADAP_APPL_DATESAAADMS
Majoruser-applications-majorSARADAP_MAJR_CODE_1SAAADMS
Termuser-applications-termSARADAP_TERM_CODE_ENTRYSAAADMS
Degreeuser-applications-degreeSARADAP_DEGC_CODESAAADMS
Campususer-applications-campusSORLCUR_CAMP_CODESAAADMS
Student Typeuser-applications-student-typeSARADAP_STYP_CODESAAADMS
APPLICATION_SUBMITuser-milestones-dateSARADAP_APPL_DATESAAADMS
WITHDRAWuser-milestones-dateSARADAPS_WITHDRAWN_ONSAAADMS
ENROLLuser-milestones-dateBased on calculations from Banner on SARAPPD_APDC_DATESAADCRV
First Nameuser-emergency-contacts-first-nameSPREMRG_FIRST_NAMESPAEMRG
Last Nameuser-emergency-contacts-last-nameSPREMRG_LAST_NAMESPAEMRG
Relationship Typeuser-emergency-contacts-relationship-typeSPREMRG_RELT_CODESPAEMRG
Cell Numberuser-emergency-contacts-cell-phone-country-codeSPREMRG_CTRY_CODE_PHONESPAEMRG
Cell Numberuser-emergency-contacts-cell-phone-numberSPREMRG_PHONE_NUMBERSPAEMRG
Home Numberuser-emergency-contacts-home-phone-country-codeSPREMRG_CTRY_CODE_PHONESPAEMRG
Home Numberuser-emergency-contacts-home-phone-numberSPREMRG_PHONE_NUMBERSPAEMRG