Banner UAT / Field Mappings
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:
- If there are errors:
- Review Integration Errors - Troubleshooting (Ethos)
- If needed, reach out in Basecamp for assistance.
- If the record is successful:
- Proceed to validate the data in Banner
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.
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 Field | Element Slug | Banner Field | Banner Form |
|---|---|---|---|
| Element ID | user-elementid | GORADID_ADDITIONAL_ID | SPAIDEN |
| School ID | user-identities-school-id | SPRIDEN_ID | SPAIDEN |
| First Name | user-first-name | SPRIDEN_FIRST_NAME | SPAIDEN |
| Last Name | user-last-name | SPRIDEN_LAST_NAME | SPAIDEN |
| Middle Name | user-middle-name | SPRIDEN_MI | SPAIDEN |
| Former Last Name(s) | user-former-last-name | (name type = BIRTH) | SPAIDEN |
| Preferred First Name | user-preferred-name | (name type = PREFERRED/CHOSEN) | SPAIDEN |
| Name Prefix | user-prefix-name | SPRIDEN_SURNAME_PREFIX | SPAIDEN |
| Name Suffix | user-suffix-name | SPBPERS_NAME_SUFFIX | SPAIDEN |
| user-email-address | GOREMAL_EMAIL_ADDRESS | GOAEMAL | |
| Social Security # | user-ssn | SPBPERS_SSN | SPAPERS |
| Date of Birth | user-dob | SPBPERS_BIRTH_DATE | SPAIDEN |
| Gender | user-gender | SPBPERS_SEX | SPAPERS |
| Gender Pronouns | user-gender-pronouns | SPBPERS_PPRN_CODE | SPAPERS |
| Native Language | user-citizenship-native-language | GOBINTL_LANG_CODE | GOAINTL |
| Citizenship Status | user-citizenship-us-statuses | SPBPERS_CITZ_CODE | SPAPERS |
| Visa Type | user-citizenship-visa-type | GORVISA_VTYP_CODE | GOAINTL |
| Are You Hispanic/Latino? | user-race-hispanic | SPBPERS_ETHN_CODE | SPAPERS |
| Your Race | user-race-categories | GORPRAC_RACE_CDE | SPAPERS |
| Country of Citizenship | user-citizenship-country | GOBINTL_NATN_CODE_LEGAL | SPAIDEN |
| Country of Birth | user-citizenship-country-of-birth | GOBINTL_NATN_CODE_BIRTH | SPAIDEN |
| Home Address / Mailing Address | user-addresses-type | (HOME vs. MAILING addresses) | SPAIDEN |
| Address Line 1 | user-addresses-street1 | SPRADDR_STREET_LINE1 | SPAIDEN |
| Address Line 2 | user-addresses-street2 | SPRADDR_STREET_LINE2 | SPAIDEN |
| Address Line 3 | user-addresses-street3 | SPRADDR_STREET_LINE3 | SPAIDEN |
| City | user-addresses-city | SPRADDR_CITY | SPAIDEN |
| State | user-addresses-state | SPRADDR_STAT_CODE | SPAIDEN |
| Province | user-addresses-province | SPRADDR_STAT_CODE | SPAIDEN |
| Zip/Postal Code | user-addresses-zip | SPRADDR_ZIP | SPAIDEN |
| Country | user-addresses-country | SPRADDR_NATN_CODE | SPAIDEN |
| County | user-addresses-county | SPRADDR_CNTY_CODE | SPAIDEN |
| Home Phone | user-phone-home-country-code | SPRTELE_PHONE_AREA | SPATELE |
| Home Phone | user-phone-home-number | SPRTELE_PHONE_NUMBER | SPATELE |
| Cell Phone | user-phone-cell-country-code | SPRTELE_PHONE_AREA | SPATELE |
| Cell Phone | user-phone-cell-number | SPRTELE_PHONE_NUMBER | SPATELE |
| CEEB | user-education-schools-ceeb | Used to look up Institution Attended | |
| Approximate GPA | user-education-schools-gpa | SORHSCH_GPA or SORPCOL_GPA | SOAHSCH/SOAPCOL |
| Start Date | user-education-schools-start | SORDEGR_ATTEND_FROM | SOAHSCH/SOAPCOL |
| End Date | user-education-schools-end | SORDEGR_ATTEND_TO | SOAHSCH/SOAPCOL |
| Graduation Date | user-education-schools-graduate-date | SORHSCH_GRADUATION_DATE | SOAHSCH |
| App Submitted | user-applications-submitted-time | SARADAP_APPL_DATE | SAAADMS |
| Major | user-applications-major | SARADAP_MAJR_CODE_1 | SAAADMS |
| Term | user-applications-term | SARADAP_TERM_CODE_ENTRY | SAAADMS |
| Degree | user-applications-degree | SARADAP_DEGC_CODE | SAAADMS |
| Campus | user-applications-campus | SORLCUR_CAMP_CODE | SAAADMS |
| Student Type | user-applications-student-type | SARADAP_STYP_CODE | SAAADMS |
| Released Decision | user-applications-decision-released-at | SARAPPD_APDC_DATE | SAAADMS |
| Decision Status (SIS Code) | user-applications-board-status | SARAPPD_APDC_CODE | SAAADMS |
| Admission Type | user-custom-{subdom}-admission-type | SARADAP_ADMT_CODE | SAAADMS |
| Academic Load | user-education-academic-load | (SARADAP_FULL_PART_IND or SARADAP_FULL_PART_IND) | SAAADMS |
| Relationship | user-family-relationship | SORFOLK_DIR_RELT_ID / SORFOLK_RELT_CODE | SOAFOLK |
| user-family-email | GOREMAL_EMAIL_ADDRESS | SOAFOLK / SPAIDEN | |
| First Name | user-family-first-name | SPRIDEN_FIRST_NAME | SOAFOLK / SPAIDEN |
| Last Name | user-family-last-name | SPRIDEN_LAST_NAME | SOAFOLK / SPAIDEN |
| Middle Name | user-family-middle-name | SPRIDEN_MI | SOAFOLK / SPAIDEN |
| Gender | user-family-gender | SPBPERS_GNDR_CODE | SPAPERS |
| Phone Number | user-family-phone-number | SPRTELE_PHONE_NUMBER | SPATELE |
| Phone Number | user-family-phone-country-code | SPRTELE_PHONE_AREA | SPATELE |
| Phone Type | user-family-phone-type | (used to determine if we write to HOME or CELL phone in SPATELE) | Not displayed |
| Address Line 1 | user-family-address-street-1 | SPRADDR_STREET_LINE1 | SPAIDEN |
| Address Line 2 | user-family-address-street-2 | SPRADDR_STREET_LINE2 | SPAIDEN |
| City | user-family-address-city | SPRADDR_CITY | SPAIDEN |
| State | user-family-address-state | SPRADDR_STAT_CODE | SPAIDEN |
| Province | user-family-address-province | SPRADDR_STAT_CODE | SPAIDEN |
| Zip/Postal Code | user-family-address-zipcode | SPRADDR_ZIP | SPAIDEN |
| Country | user-family-address-country | SPRADDR_NATN_CODE | SPAIDEN |
| Same Address? | user-family-same-address | Not displayed | |
| First Name | user-emergency-contacts-first-name | SPREMRG_FIRST_NAME | SPAEMRG |
| Last Name | user-emergency-contacts-last-name | SPREMRG_LAST_NAME | SPAEMRG |
| Relationship Type | user-emergency-contacts-relationship-type | SPREMRG_RELT_CODE | SPAEMRG |
| Cell Number | user-emergency-contacts-cell-phone-country-code | SPREMRG_CTRY_CODE_PHONE | SPATELE |
| Cell Number | user-emergency-contacts-cell-phone-number | SPREMRG_PHONE_NUMBER | SPATELE |
| Home Number | user-emergency-contacts-home-phone-country-code | SPREMRG_CTRY_CODE_PHONE | SPATELE |
| Home Number | user-emergency-contacts-home-phone-number | SPREMRG_PHONE_NUMBER | SPATELE |
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.
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 Field | Element Slug | Banner Field | Banner Form |
|---|---|---|---|
| School ID | user-identities-school-id | SPRIDEN_ID | SPAIDEN |
| School Email | user-identities-school-email | GOREMAL_EMAIL_ADDRESS | GOAEMAL |
| Username ID | user-identities-usernameid | GOBTPAC_EXTERNAL_USER | GOATPAC |
| Ethos ID | user-identities-ethosid | GORGUID_GUID | |
| First Name | user-first-name | SPRIDEN_FIRST_NAME | SPAIDEN |
| Last Name | user-last-name | SPRIDEN_LAST_NAME | SPAIDEN |
| Middle Name | user-middle-name | SPRIDEN_MI | SPAIDEN |
| Preferred First Name | user-preferred-name | (Depends on Name Type Setting) | SPAIDEN |
| Name Prefix | user-prefix-name | SPRIDEN_SURNAME_PREFIX | SPAIDEN |
| Name Suffix | user-suffix-name | SPBPERS_NAME_SUFFIX | SPAIDEN |
| user-email-address | GOREMAL_EMAIL_ADDRESS | GOAEMAL | |
| Social Security # | user-ssn | SPBPERS_SSN | SPAPERS |
| Date of Birth | user-dob | SPBPERS_BIRTH_DATE | SPAIDEN |
| Gender | user-gender | SPBPERS_SEX | SPAPERS |
| Gender Pronouns | user-gender-pronouns | SPBPERS_PPRN_CODE | SPAIDEN |
| Native Language | user-citizenship-native-language | GOBINTL_LANG_CODE | GOAINTL |
| Citizenship Status | user-citizenship-us-statuses | SPBPERS_CITZ_CODE | GOAINTL |
| Are You Hispanic/Latino? | user-race-hispanic | SPBPERS_ETHN_CODE | SPAPERS |
| Your Race | user-race-categories | GORPRAC_RACE_CDE | SPAPERS |
| Home Address / Mailing Address | user-addresses-type | (HOME vs. MAILING addresses) | SPAIDEN |
| Address Line 1 | user-addresses-street1 | SPRADDR_STREET_LINE1 | SPAIDEN |
| Address Line 2 | user-addresses-street2 | SPRADDR_STREET_LINE2 | SPAIDEN |
| City | user-addresses-city | SPRADDR_CITY | SPAIDEN |
| State | user-addresses-state | SPRADDR_STAT_CODE | SPAIDEN |
| Zip/Postal Code | user-addresses-zip | SPRADDR_ZIP | SPAIDEN |
| Country | user-addresses-country | SPRADDR_NATN_CODE | SPAIDEN |
| County | user-addresses-county | SPRADDR_CNTY_CODE | SPAIDEN |
| Home Phone | user-phone-home-country-code | SPRTELE_PHONE_AREA | SPATELE |
| Home Phone | user-phone-home-number | SPRTELE_PHONE_NUMBER | SPATELE |
| Cell Phone | user-phone-cell-country-code | SPRTELE_PHONE_AREA | SPATELE |
| Cell Phone | user-phone-cell-number | SPRTELE_PHONE_NUMBER | SPATELE |
| CEEB | user-education-schools-ceeb | STVSBGI_CODE | SSTVSBGI |
| Approximate GPA | user-education-schools-gpa | SORHSCH_GPA or SORPCOL_GPA | SOAHSCH/SOAPCOL |
| Start Date | user-education-schools-start | SORDEGR_ATTEND_FROM | SOAHSCH/SOAPCOL |
| End Date | user-education-schools-end | SORDEGR_ATTEND_TO | SOAHSCH/SOAPCOL |
| Graduation Date | user-education-schools-graduate-date | SORHSCH_GRADUATION_DATE | SOAHSCH |
| Graduated | user-educationa-schools-graduated | SORHSCH_GRADUATION_DATE | SOAHSCH |
| App Submitted | user-applications-submitted-time | SARADAP_APPL_DATE | SAAADMS |
| Major | user-applications-major | SARADAP_MAJR_CODE_1 | SAAADMS |
| Term | user-applications-term | SARADAP_TERM_CODE_ENTRY | SAAADMS |
| Degree | user-applications-degree | SARADAP_DEGC_CODE | SAAADMS |
| Campus | user-applications-campus | SORLCUR_CAMP_CODE | SAAADMS |
| Student Type | user-applications-student-type | SARADAP_STYP_CODE | SAAADMS |
| APPLICATION_SUBMIT | user-milestones-date | SARADAP_APPL_DATE | SAAADMS |
| WITHDRAW | user-milestones-date | SARADAPS_WITHDRAWN_ON | SAAADMS |
| ENROLL | user-milestones-date | Based on calculations from Banner on SARAPPD_APDC_DATE | SAADCRV |
| First Name | user-emergency-contacts-first-name | SPREMRG_FIRST_NAME | SPAEMRG |
| Last Name | user-emergency-contacts-last-name | SPREMRG_LAST_NAME | SPAEMRG |
| Relationship Type | user-emergency-contacts-relationship-type | SPREMRG_RELT_CODE | SPAEMRG |
| Cell Number | user-emergency-contacts-cell-phone-country-code | SPREMRG_CTRY_CODE_PHONE | SPAEMRG |
| Cell Number | user-emergency-contacts-cell-phone-number | SPREMRG_PHONE_NUMBER | SPAEMRG |
| Home Number | user-emergency-contacts-home-phone-country-code | SPREMRG_CTRY_CODE_PHONE | SPAEMRG |
| Home Number | user-emergency-contacts-home-phone-number | SPREMRG_PHONE_NUMBER | SPAEMRG |