Populi UAT / Field Mappings
Testing the Populi integration typically happens in two phases:
- Element451 → Populi
- Populi → Element451
Element451 → Populi testing is usually completed first. Populi → Element451 testing should only be completed if the partner has requested data to sync from Populi back into Element.
Both phases should begin after the required Populi configuration has been completed, API access has been confirmed, 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 (Populi)
Testing Element451 → Populi#
Preparation#
Create test student records in Element451 with applications. These records should represent a wide range of scenarios used by your institution.
Note: These records should be removed before go-live as they are test records.
Testing#
Follow the steps in How to Sync Records (Populi) to trigger a sync.
Validate Data in Anthology#
Once a record has synced successfully:
- Review the record in Populi
- Compare values using the Field Mappings section.
- Validate:
- Element451 fields (slugs)
- Corresponding Populi 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.
Field Mappings#
Below is an overview of the Element451 fields (slugs) and corresponding Populi API fields included in the standard integration.
| Element Profile Field | Element Slug | Populi Field |
|---|---|---|
| Populi Id | user-identities-populiid | id |
| School Email | user-identities-school-email | email (school) |
| First Name | user-first-name | first_name |
| Last Name | user-last-name | last_name |
| Middle Name | user-middle-name | middle_name |
| Former Last Name(s) | user-former-last-name | former_name |
| Preferred First Name | user-preferred-name | preferred_name |
| Name Prefix | user-prefix-name | prefix |
| Name Suffix | user-suffix-name | suffix |
| user-email-address | email (school) | |
| Home Phone | user-phone-home-number | number (home) |
| Cell Phone | user-phone-cell-number | number (home) |
| Social Security # | user-ssn | social_security_number |
| Date of Birth | user-dob | birth_date |
| Gender | user-gender | gender |
| Are You Hispanic/Latino? | user-race-hispanic | hispanic_latino |
| Your Race | user-race-categories | race_id |
| Address Line 1 | user-addresses-street1 | street |
| City | user-addresses-city | city |
| State | user-addresses-state | state |
| Zip/Postal Code | user-addresses-zip | postal |
| Country | user-addresses-country | country |
| Country of Citizenship | user-citizenship-country | country (ID) |
| Notes | user-notes-note-body | content |
| School Name | user-education-schools-name | name |
| CEEB | user-education-schools-ceeb | — |
| Start Date | user-education-schools-start | start_date |
| End Date | user-education-schools-end | end_date |
| Graduation Date | user-education-schools-graduate_date | highschool_graduation_date |
| App Submitted | user-applications-submitted-time | submitted_at |
| App Started | user-applications-registered-at | started_on |
| Major | user-applications-major | specialization_id |
| Term | user-applications-term | academic_term_id |
| Degree | user-applications-degree | degree_id |
| Campus | user-applications-campus | campus_id |
| Academic Load | user-education-academic-load | expected_enrollment |
Testing Populi → Element451#
Populi → Element testing should only be completed if the partner is using inbound sync from Populi to Element.
Preparation#
Identify the records you want to test in Populi.
- use records previously synced from Element451 → Populi
- make controlled changes in Populi, such as phone, email, address, demographic, or custom field updates
We recommend testing at least 5–10 records to cover a variety of scenarios.
Request or Trigger a Sync#
Notify Element staff via Basecamp with the records to be synced. Provide them a timestamp of BEFORE you started making the record changes.
Validate Data in Element451#
Once the sync is complete:
- review the records in Element451
- confirm that the existing records were updated correctly
Use the Field Mappings section to validate field-level accuracy.
Field Mappings#
Below is an overview of the Element451 fields (slugs) and corresponding Populi API fields included in the standard integration. Additional fields/properties can be set/read based on a partner’s SOW.
| Element Profile Field | Element Slug | Populi Field |
|---|---|---|
| Populi Id | user-identities-populiid | id |
| School Email | user-identities-school-email | email (school) |
| First Name | user-first-name | first_name |
| Last Name | user-last-name | last_name |
| Middle Name | user-middle-name | middle_name |
| Former Last Name(s) | user-former-last-name | former_name |
| Preferred First Name | user-preferred-name | preferred_name |
| Name Suffix | user-suffix-name | suffix |
| user-email-address | email (school) | |
| Home Phone | user-phone-home-number | number (home) |
| Cell Phone | user-phone-cell-number | number (home) |
| Social Security # | user-ssn | social_security_number |
| Date of Birth | user-dob | birth_date |
| Gender | user-gender | gender |
| Are You Hispanic/Latino? | user-race-hispanic | hispanic_latino |
| Your Race | user-race-categories | race_id |
| Address Line 1 | user-addresses-street1 | street |
| City | user-addresses-city | city |
| State | user-addresses-state | state |
| Zip/Postal Code | user-addresses-zip | postal |
| Country | user-addresses-country | country |
| Country of Citizenship | user-citizenship-country | country (ID) |
| School Name | user-education-schools-name | name |
| CEEB | user-education-schools-ceeb | — |
| Start Date | user-education-schools-start | start_date |
| End Date | user-education-schools-end | end_date |
| Graduation Date | user-education-schools-graduate_date | highschool_graduation_date |