Contacts (Arizona 7.1)

This entity represents a parent or guardian of a student, such as mother, father or caretaker.

For the 23-24 Configuration year, this resource sends as Parents.

For the 24-25 Configuration year and future, this resource sends as Contacts

Object Triggering Logic

This table describes logic for triggering syncing of this object.

Action Trigger
Post

Reports a record when the Guardian checkbox is marked AND at least one related person is a student. 

  • The "parent" person must have a Parent Ed-Fi ID to send. 
  • When the "parent" person does not have a Parent Ed-Fi ID, a process runs to create a new Ed-Fi ID for them. The district does NOT need to do this manually. This is only done when Parents or Student Parent Associations are resynced or triggered.
    • This means that even when these resources are not manually resynced, when they are triggered in some way (e.g., Guardian checkbox being checked on someone), the Parent Ed-Fi ID populates
  • Does not report a record when any of the following exclusions are present:
    • Relationship Start Date must be on or before today's date.
    • Relationship End Date must be on or after today's date.
    • Enrollment State Exclude - All related students must be excluded.
    • Enrollment No Show - All related students must be excluded.
    • Enrollment Grade Exclude from State Reporting - All related students must be excluded.
  • The Guardian does NOT need to be a member of the same household as the student.
Put

A record updates when any of the following are changed and saved:


  • When a parent's Demographics information is changed:
    • Parent Ed-Fi ID
  • When a parent's identity information changes on any of the following fields:

    • First Name
    • Gender
    • Last Name
    • Middle Name
    • Suffix
  • When a parent's Related Pair information changes on any of the following fields:

    • End Date
    • Guardian
    • Person ID #1
    • Person ID #2
    • Start Date
Delete Parent records are shared resource among all districts; this record will not delete. 


School Exclude, Calendar Exclude, Resource Toggle and Resync Logic

This table describes the School Exclude, Calendar Exclude, Resource Toggle and Resync logic of this object.

Action Trigger
None When a resource is toggled to 'OFF' after data has sent, all sent data will remain in the ODS but no new data will send.
Resync When a record is in the Ed-Fi Identity Mapping table and not in the ODS, it is deleted from the Ed-Fi Identity Mapping table.
Resync When a record is in the ODS and it does not have a matching record in Campus or the Ed-Fi Identity Mapping table, it is deleted from the ODS.
Resync When a mapping is changed in Resource Preferences, a resync needs to be done to reflect the changes.


Natural Key Changes, Cascading Updates, and Deletes Logic

This table describes the Natural Key Changes/Cascading Updates and Deletes logic of this object.

Action Trigger
Delete/Post Cascading Deletes:  The logic for an Ed-FI ID change updates all resources impacted by this change.


Scope Year Logic

This table describes scope year logic of this object.

Business Rules

A parent record reports when they are a guardian to a student with an enrollment aligned to a scoped year.

  • The related pair start date must be null or on/before the scope year end date to report.
  • The related pair end date must be null or on/after the scope year end date to report.
  • Data only sends for the years that have valid configuration.
  • A resync must be completed on the Parents resource when a new scope year is connected in order for this data to send.

When using data in Campus that has an effective date, the following logic applies to determine which scope year(s) to report the data:

  • Current Year: Records are compared to today's date to determine whether the record is eligible to report.
  • Previous Years: The record's date must be on or before the schools year's end date defined in the School Years editor. When blank, the default date of 6/30/xxxx is used.
  • Future Years: The record's date must be on or after the school year's start date defined in the School Years editor. When blank, the default date of 7/01/xxxx is used.

When using data in Campus that have start and end dates, the following logic applies to determine which scope year(s) to report the data:

  • Current Year: The records start date must be on or before today's date and the records end date must be on or after today's date.
  • Previous Years: The record's start date must be on or before the school year's end date and the record's end date must be after the school year's end date defined in the School Years editor. If blank, the default date of 6/30/xxxx is used.
  • Future Years: The record's start date must be on or before the schools year's start date and the record's end date must be on or after the school year's start date defined in the School Years editor. If blank, the default date of 7/01/xxxx is used.

Identity Mapping Object Key

This table describes the Identity Mapping Object Key of this object.

campusObjectType Object Key Data Source
Person personID

Event Queue Detail

This table describes the Event Queue Detail of this object.

Campus Table Ed-Fi Action Fields
relatedPair Post/Put/Delete The primary table used for sending data for this resource.

Object Data Elements

This table describes data elements sent within the Parents resource.

Data Element Label Business Requirement and Rules Mandatory, Conditional or Optional Location
id The unique identifier of the resource. M  
contactUniqueId A unique alpha-numeric code assigned to a parent.

Reports Ed-Fi ID.
M Demographics > EdFi ID

Person.edfiid
firstName A name given to an individual at birth, baptism, or during another naming ceremony, or through legal change.

Reports the first name from the current Identity record. 
M Identifies > First Name

Identity.firstName
generationCodeSuffix An appendage, if any, used to denote an individual's generation in his family (e.g., Jr., Sr., III).

Reports the Suffix from the person's current identity record.
C Identities > Suffix

identity.suffix
lastSurname The name borne in common by members of a family.

Reports the last name from the person's current identity record.
M Identities > Last Name

identity.lastName
middleName A secondary name given to an individual at birth, baptism, or during another naming ceremony.

Reports the middle name from the person's current identity record.
O Identities > Middle Name

identity.middleName
sexDescriptor A person's gender.

Report the following based on the value selected in the dropdown:
  • Female report 'Female'.
  • Male report 'Male'.
  • All other values report Not Selected.
    • This is not a valid code and will error. Arizona only allows Male and Female to report. "Not Selected" sends to indicate an issue with the data.
O Identity > Gender

Identity.gender
telephones An unordered collection of parentTelephones. This entity represents a parent or guardian of a student, such as mother, father or caretaker.

This field is optional, does not report.
O