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. 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.

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. 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.

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 the Parent Ed-Fi ID. 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 manually do this. This is only done when Contacts or Student Contact Associations are resynced or triggered.	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