Classic View: System Administration > Ed-Fi
Search Terms: Ed-Fi
This resource represents an individual for whom instruction, services, and/or care are provided in an early childhood, elementary, or secondary educational program under the jurisdiction of a school, education agency, or other institution or program. A student is a person who has been enrolled in a school or other educational institution.
For example, if one district put in a first name of "Robert" and the second district put in a first name of "Rob", the last district to update the student record is what will appear in Ed-Fi and on both District's reports. This is true for all field logic in the Student Resource.
Object Triggering Logic
This table describes logic for triggering syncing of this object.
Action | Trigger |
---|---|
POST | When an enrollment is created and saved for a person and the enrollment overlaps a configured year.
When student data is edited for the person in any of the Data Elements fields below:
When the person’s identity record is changed in one of the following fields:
|
Delete | Student records are never deleted because Student records are a shared resource among all districts. |
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 | Business Rule |
---|---|
None | If 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 | If an Ed-Fi Code mapping is changed to a new code or made NULL, a resync must be performed for the data to be updated in the ODS. |
Natural Key Changes, Cascading Updates, and Deletes Logic
This table describes the Natural Key Changes/Cascading Updates and Deletes logic of this object.
Action | Business Rule |
---|---|
Post | Natural Key change: Ed-Fi ID
|
Delete | Cascading Deletes: The following resources will be deleted and resent if the Ed-Fi ID is changed.
|
Scope Year Logic
This table describes scope year logic of this object.
Logic |
---|
A record will report when an enrollment is created and saved that is aligned to a configured year. (ALL student records need to be a POST to avoid generating errors)
|
When using data in Campus that has a single date, the following logic will be applied to determine the scope year(s) in which to report data:
|
When using data in Campus that have start and end dates, the following logic will be applied to determine the scope year(s) in which to report data:
|
Resource Preferences
Data Element Label | Mapping Needed | Database Field |
birthCountryDescriptor | Birth Country Override | identity.birthcountry |
birthStateDescriptor | Birth State Override | identity.birthstate |
Identity Mapping Object Key
This table describes the Identity Mapping Object Key of this object.
campusObjectType | Object Key Data Source |
---|---|
Person | personID |
If a Student and Student School Association record has been sent for a student, a Student and Student School Association record will be logged in the Ed-Fi Identity Mapping table. If the student's enrollment is deleted or their Ed-Fi ID is changed while the Student and/or Student School Association Resource Preference is turned off, the old record and resource id will remain in the table until the resource is turned back on and a resync is performed on either Students or Student School Associations.
The Students and Student School Associations records will be deleted from the identity mapping table if all enrollments that were sent to Ed-Fi are deleted.
Event Queue Detail
Campus Table | Ed-Fi Action | Fields |
---|---|---|
enrollment | Post/Put/Delete | The primary table used for sending data for this resource |
identity | Put | birthCity, birthCountryDescriptor, birthDate, birthSexDescriptor, birthStateAbbreviationDescriptor, dateEnteredUS, firstName, lastSurname, generationCodeSuffix, middleName, otherNames, visas (WI) |
person | Post/Delete | studentUniqueID |
Error Log
Error | Possible Causes/How to Fix |
---|---|
Error code return from Ed-Fi. 400: [message:Unable to resolve value 'http://doe.in.gov/Descriptor/LimitedEnglishProficiencyDescriptor.xml/4' to an existing 'LimitedEnglishProficiencyDescriptor' resource.]. | If you go to Index> Assessments> Test Set-up> WIDA ACCESS> Result Statuses> Value Column> Add a DOT Zero to all single digit scores, save. Refresh Campus Site, resync those students it should not fail again. |
No address found. Please either mark an address as Physical or mark the student as Homeless and mark an address as a PO Box. | This student is either homeless with no address in which a PO Box will suffice or this student does not have any address marked as Physical. Check the student’s household address for the Physical checkbox |
Error code return from Ed-Fi. 403: [message:Authorization denied. The claim does not have any established relationships with the requested resource.]. | Upstream resources were not able to post this student record. Typically, this happens on a resource in the student section. If the student does not have a student’s record, Student School Associations record, anything downstream of those (Student Ed Org, Student Attendance, Student Program) will fail with this error. It means the record has no student data to match with. |
Error code return from Ed-Fi. 400: [message:Validation of 'Student' failed. Validation of 'StudentLanguages' failed. StudentLanguage[0]: LanguageDescriptorId is required. ]. | Index> Sys Admin> Custom> Attribute/Dictionary> Identity> Home Primary Language. Set “211” as default on Attribute in Attribute/Dictionary. This will get a language error if not defaulted because every student needs a language. If you see “211” in this field, delete> Save> Add 211> Save and this will resolve the issue. |
Error code return from Ed-Fi. 403: [message:Access to the resource item could not be authorized because the 'StudentUSI' of the resource is empty.]. Error code return from Ed-Fi. 400: [message:Validation of 'StudentPost' failed. Student with unique id N00019315 was not matched successfully in the Identity system. Please verify through the identities API before resubmitting this student. ]. | These errors usually does not mean the STN was not present in the JSON that Campus sent to the state. Rather, this means that student data elements used for matching between Campus and IDOE is not the same in the STN App Center or the Unique ID is incorrect. The best course of action here is to check the STN and PII data of the student against the App Center. If there are differences, contact IDOE to manage the data. |
Unknown transformation error occurred: dataexchange.doe.in.gov:443 failed to respond |
Object Data Elements
This table describes data elements sent within the Student resource. Data Element Labels in bold are part of the Natural Key and are required for data to send to Ed-Fi.
Data Element Label | Business Requirement | Business Rules | M, C, or O | Location |
---|---|---|---|---|
id | The unique identifier of the resource. | M | ||
studentUniqueId | A unique alpha-numeric code assigned to a student. | Report the Ed-Fi ID. | M | Census > People > Demographics > Ed-Fi ID person.edfiid |
personalTitle Prefix | A prefix used to denote the title, degree, position or seniority of the person. | This is optional, does not report. | O | |
firstName | A name given to an individual at birth, baptism, or during another naming ceremony, or through legal change. | Report from the current identity record,
| M | Census > People > Identities > Legal First Name OR Census > People > Identities > First Name identity. legalFirst Name OR identity. firstName |
middleName | A secondary name given to an individual at birth, baptism, or during another naming ceremony. | Report from the current identity record,
| C | Census > People > Identities >Legal Middle Name OR Census > People > Identities > Middle Name identity. legalMiddle Name OR identity. middleName |
lastSurname | The name borne in common by members of a family. | Report from the current identity record:
| M | Census > People > Identities > Legal Last Name OR Census > People > Identities > Last Name identity. legalLast Name OR identity. lastName |
generation CodeSuffix | An appendage, if any, used to denote an individual's generation in his family (e.g., Jr., Sr., III) | Report from the current identity record:
| C | Census >People > Identities > Legal Suffix OR Census > People > Identities > Suffix identity. legalSuffix OR identity. suffix |
maiden Name | The person's maiden name, if applicable. | This is optional, does not report. | O | |
sexType | A person's gender. |
| M | Census > People > Identities > Gender identity. Gender |
birthDate | The month, day, and year on which an individual was born. | Report the Birth Date from the student's current identity record. | M | Census > People > Identities > Birth Date identity. birthdate |
birthCity | The set of elements that capture relevant data regarding a person's birth, including birth date and place of birth. | Report the Birth City if populated on the Demographics tab. | O | Census > People > Demographics > Birth City identity. birthcity |
birthState Abbreviation Type | The abbreviation for the name of the state (within the United States) or extra-state jurisdiction in which an individual was born. | Report the State from the Birth State saved on the student's current identity record.
| O | Census > People> Demographics > Birth State identity. birthstate |
birthCountry Descriptor | The country in which an individual is born. | Report the Country from the Birth Country saved on the student's current identity record.
Otherwise report NULL. | C | Census >People > Identities > Birth Country identity. birthcountry |
dateEntered US | For students born outside of the US, the date the student entered the US. |
| O | Census >People > Identities >Date Entered US identity. date EnteredUS |
multipleBirth Status | Indicator of whether the student was born with other siblings (i.e., twins, triplets, etc.) | This is optional, does not report. | O | |
profile Thumbnail | File name for the ProfileThumbnail photograph. | This is optional, does not report. | O | |
hispanicLatino Ethnicity | An indication that the individual traces his or her origin or descent to Mexico, Puerto Rico, Cuba, Central / South America, or other Spanish cultures, regardless of race. The term, "Spanish origin" can be used in addition to "Hispanic or Latino". | Report "Is the individual Hispanic/Latino?" from the student's current identity:
| M | Census > People > Demographics > Race/Ethnicity > Hispanic/Latino identity. hispanic Ethnicity |
oldEthnicity Type | Previous definition of Ethnicity combining Hispanic/Latino and race 1 - American Indian or Alaskan Native 2 - Asian or Pacific Islander 3 - Black, not of Hispanic origin 4 - Hispanic 5 - White, not of Hispanic origin | This is optional, does not report. | O | |
economic Disadvantaged | An indication of inadequate financial condition of an individual's family, as determined by family income, number of family members/dependents, participation in public assistance programs, and/or other characteristics considered relevant by federal, state, and local policy. |
| O | FRAM > Eligibility > Eligibility poseligibility. eligibility |
schoolFood Services Eligibility Descriptor | A unique identifier used as Primary Key, not derived from business logic, when acting as Foreign Key, references the parent table. | Reports on Student Program Association | O | FRAM > Eligibility > Eligibility poseligibility. eligibility |
limitedEnglish Proficiency Descriptor | An indication that the student has sufficient difficulty speaking, reading, writing, or understanding the English language, as to require special English Language service. | An EL record must be present for student EL assessment data to send.
| C | |
displacement Status | Indicates a state health or weather related event that displaces a group of students, and may require additional funding, educational, or social services. | This is a localized determination, no core logic required. | O | |
loginId | The login ID for the user; used for security access control interface. | This element is not collect, does not report. | O | |
citizenship Status Descriptor | A unique identifier used as Primary Key, not derived from business logic, when acting as Foreign Key, references the parent table. | This element is not collect, does not report. | O | |
learningStyle | This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. A student is a person who has been enrolled in a school or other educational institution. | This element is not collect, does not report. | O | |
addresses | Report the person's physical address(es). |
| M | Census > Household Addresses> Mailing Census > Household Membership> Start Date Census > Household Addresses> Start Date HouseholdLocation. mailing HouseholdMember. startDate Householdlocation. StartDate |
characteristics | An unordered collection of studentCharacteristics. This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. A student is a person who has been enrolled in a school or other educational institution. | See Array Logic below. | M | |
cohort Years | An unordered collection of studentCohortYears. This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. A student is a person who has been enrolled in a school or other educational institution. | This element is not collect, does not report. | O | |
disabilities | An unordered collection of studentDisabilities. This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. A student is a person who has been enrolled in a school or other educational institution. | See Array Logic below. | O | |
electronicMails | An unordered collection of studentElectronicMails. This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. A student is a person who has been enrolled in a school or other educational institution. | If 'email' on student demographics is populated, report the following in the electronicMails array:
If 'email' is populated AND secondary email is populated
Do not report the array if reportable email is marked Private. | M | Census > People> Demographics > Email contact.email |
identification Codes | An unordered collection of studentIdentificationCodes. This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. A student is a person who has been enrolled in a school or other educational institution. | See Array Logic below. | O | |
identification Documents | An unordered collection of studentIdentificationDocuments. This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. A student is a person who has been enrolled in a school or other educational institution. | This element is not collect, does not report. | O | |
indicators | An unordered collection of studentIndicators. This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. | See Array Logic below. | O | |
international Addresses | An unordered collection of studentInternationalAddresses. This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. A student is a person who has been enrolled in a school or other educational institution. | This element is not collect, does not report. | O | |
languages | An unordered collection of studentLanguages. This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. A student is a person who has been enrolled in a school or other educational institution. | See Array Logic below. | M | |
otherNames | An unordered collection of studentOtherNames. This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. A student is a person who has been enrolled in a school or other educational institution. |
| O | Census > People > Identities |
program Participations | An unordered collection of studentProgramParticipations. This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. A student is a person who has been enrolled in a school or other educational institution. | This element is not collect, does not report. | O | |
races | An unordered collection of student Races. This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. |
| O | Census > People > Identities > Race/Ethnicity IdentityRace Ethnicity and racethnicity. raceid |
telephones | An unordered collection of student Telephones. This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. |
2. If blank, does not report. 3. See Scope Year logic to determine the eligibility of records. | O | |
visas | An unordered collection of studentVisas. This entity represents an individual for whom instruction, services and/or care are provided in an early childhood, elementary or secondary educational program under the jurisdiction of a school, education agency or other institution or program. | This element is not collect, does not report. | O | |
USInitialSchool Entry | The initial date the student entered the US. | Report date in 'Date Entered US School', if no date is present, report date of first enrollment. | M | |
ELLInstrument Used DescriptorID |
| C | ||
LanguageUse Type | Language used by the student. | Hard-coded 'HomeLanguage' | C | |
_etag | A unique system-generated value that identifies the version of the resource. | O |
Array Data Elements
Type/Descriptors