Tool Search: Ed-Fi

This educational entity represents the organization of subject matter and related learning experiences provided for the instruction of students on a regular or systematic basis.

Object Triggering Logic

Action	Trigger
Post	When an assessment is assigned to a student and the Assessment date is on or within the configuration year start and end dates. Does not send when the student does not have an active enrollment on the Assessment Start Date. Only one record per student Assessment reports, regardless of the number of active enrollments. When the student has multiple enrollments that are overlapping in the same school year, reports based on the Service Type: P: Primary S: Partial N: Special Education Does not send a student record for an enrollment that is marked as State Exclude or No Show. Does not send a record when the enrollment is in a calendar marked as Exclude. Does not send a record when the enrollment is in a school marked as Exclude.
Post	A field is changed and saved on the Test Information for the parent (non-child) assessment. When the test Date is changed.
Delete/Post	When any part of the natural key is changed.
Put	When any field that is not part of the natural key is changed and saved.
Delete	All valid parent or child assessments are removed from the student.
Delete	When the assessment scope year is changed to out of scope and that assessment is already tied to a student (which is still within the scope year), a delete isn't sent for StudentAssessment or Assessment as the record is tied to a student.

Scope Year

Logic
Record reports for students where Student test record exists within the scope year. Test Date must occur within the Scope Year.

Logic

Record reports for students where Student test record exists within the scope year.

Test Date must occur within the Scope Year.

Resync Logic

Action	Trigger
None	When a resource is toggled to OFF after data has sent, all sent data remains in the ODS but no new data is sent.
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.

Natural Key Changes, Cascading Updates, and Deletes Logic

Action	Trigger
Post/Delete	Natural Key changes: When an Ed-Fi ID changes, this happens with the cascading deletes from the Ed-Fi ID Change trigger. When the Test Date changes, which no longer matches the scope year.

Action

Trigger

Post/Delete

Natural Key changes:

When an Ed-Fi ID changes, this happens with the cascading deletes from the Ed-Fi ID Change trigger.
When the Test Date changes, which no longer matches the scope year.

Event Queue Detail

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

Resource Preferences

This table describes the Resource Preferences of this object.

Data Element Label	Mapping Needed
Score Type	Assessment Reporting Method Descriptor
Score Fields Selected	Result Datatype Type Descriptor

Object Data Elements

Data Element Label	Business Requirements and Rules	Mandatory, Conditional, or Optional	Location
id	The unique identifier of the resource.	M
studentAssessmentIdentifier	A unique number or alphanumeric code assigned to an assessment administered to a student. The identifier is concatenated as follows: Assessment +" _" + Student State Identifier + "_" + School Year For example, the Dyslexia Screener Assessment for a student with a state identifier of 00000001: Dyslexia_00000001_2024	M
assessmentReference	A reference to the related Assessment resource. Reports the data that is part of the Natural Key for the referenced Assessment resource. See the References section below.	M
reportedSchoolReference	A reference to the reported School resource. schoolID	O
schoolYearTypeReference	Optional, does not report.	O
studentReference	A unique alphanumeric code assigned to a student. Reports the student's State Student Identifier.	M
accommodations	An unordered collection of studentAssessmentAccommodations. The specific type of special variation used in how an examination is presented, how it is administered or how the test taker is allowed to respond. This generally refers to changes that do not substantially alter what the examination measures. The proper use of accommodations does not substantially change academic level or performance criteria (e.g., Braille, Enlarged Monitor View, Extra Time, Large Print, Setting, Oral Administration). Optional, does not report.	O
administrationDate	The date and time an assessment was completed by the student. The use of ISO-8601 formats with a timezone designator (UTC or time offset) is recommended in order to prevent ambiguity due to time zones. Reports a valid Administration Date for the assessment. When not known, a default value of 07/01/2023 reports.	M	Student Information > Assessment > Test Scores > Date TestScore.date Test.startDate
administrationEndDate	The date and time an assessment administration ended. Optional, does not report.	O
administrationEnvironmentDescriptor	The environment in which the test was administered. Optional, does not report.	O
administrationLanguageDescriptor	The language in which an assessment is written and/or administered. Optional, does not report.	O
assessedMinutes	Reported time student was assessed in minutes. Hard-coded to report 0 (zero).	O
eventCircumstanceDescriptor	An unusual event occurred during the administration of the assessment. This could include fire alarm, student became ill, etc. Optional, does not report.	O
eventDescription	Describes special events that occur before during or after the assessment session that may impact use of results. Optional, does not report.	O
items	An unordered collection of studentAssessmentItems. The student's response to an assessment item and the item-level scores such as correct, incorrect, or met standard. Optional, does not report.	O
performanceLevels	An unordered collection of studentAssessmentPerformanceLevels. The performance level(s) achieved for the student assessment. Optional, does not report.	O
period	The period or window in which an assessment is supposed to be administered. See the Array section below for details.	O
platformTypeDescriptor	The platform with which the assessment was delivered to the student during the assessment session. Optional, does not report.	O
reasonNotTestedDescriptor	The primary reason student is not tested. For example: Absent Refusal by parent Refusal by student Medical waiver Illness Disruptive behavior LEP Exempt. Optional, does not report.	O
reportedSchoolIdentifier	A reported school identifier for the school the enrollment at the time of the assessment used when the assigned SchoolId is not known by the assessment vendor. Optional, does not report.
retestIndicatorDescriptor	Indicator for whether the test was retaken. For example: Primary administration First retest Second retest. Optional, does not report.	O
scoreResults	An unordered collection of studentAssessmentScoreResults. A meaningful score or statistical expression of the performance of an individual. The results can be expressed as a number, percentile, range, level, etc. See the Array section below for details. Does not report when any of the array Data Elements are either not mapped or score value is not entered.	O
serialNumber	The unique number for the assessment form or answer document. Optional, does not report.	O
studentObjectiveAssessments	An unordered collection of studentAssessmentStudentObjectiveAssessments. The student's score and/or performance levels earned for an objective assessment. For Dyslexia and State History/Government Assessments, reports the Identification Code and PerformanceLevelDescriptor. See Array section below for more information.	O
whenAssessedGradeLevelDescriptor	The grade level of a student when assessed. Optional, does not report.	O
proctorStaffReference	A unique alphanumeric code assigned to the staff. Reports for Kansas English Language Proficiency Assessments (KELPA). (staffUniqueId = State Staff ID )	C	Census > Demographics > Staff State ID
assessmentRequestDescriptor	The type of assessment requested for the student. Reports for Kansas English Language Proficiency Assessments (KELPA)	C
_etag	A unique system-generated value that identifies the version of the resource.	O

References

Click here to expand...

Assessment Reference

Data Element Label

Business Requirements and Rules

Mandatory, Conditional or Optional

Location

assessmentIdentifier

Unique number or alphanumeric code assigned to an assessment.

Submit AssessmentIdentifier values per Assessment table below:

Assessment	Logic
Dyslexia Screener	Reports the assigned value for students in grades 05, 06, 07, 08, or 13. Otherwise, does not report.
State Mathematics Assessment	Reports value
State English Language Arts - ELA Assessment	Reports value
State Science Assessment	Reports value
History/Gov Claim/ Thesis Score	Reports the assessment result when the following conditions are met: Assessment has a Subject of 'Hist/Gov' and Code of 01. Assessment date falls within the student's current enrollment: When there is more than one assessment that falls within the current enrollment, the most recent result is used. When there is no date, the scoreID is used to to determine the most recent entry. Otherwise, reports a value of 00. Allowable values: 00 - Student not assessed 01 - Student scored at performance level 1 02 - Student scored at performance level 2 03 - Student scored at performance level 3 04 - Student scored at performance level 4 05 - Student refused to test 06 - Student exempt from testing (must be approved by KSDE)
History/Gov Evidence Score	Reports the assessment result when the following conditions are met: Assessment has a Subject of 'Hist/Gov' and Code of 02. Assessment date falls within the student's current enrollment: When there is more than one assessment that falls within the current enrollment, the most recent result is used. When no date, the scoreID is used to to determine the most recent entry. Otherwise, reports a value of 00. Allowable values: 00 - Student not assessed 01 - Student scored at performance level 1 02 - Student scored at performance level 2 03 - Student scored at performance level 3 04 - Student scored at performance level 4 05 - Student refused to test 06 - Student exempt from testing (must be approved by KSDE)
History/Gov Reasoning Score	Reports the assessment result when the following conditions are met: Assessment has a Subject of 'Hist/Gov' and Code of 03. Assessment date falls within the student's current enrollment: When there is more than one assessment that falls within the current enrollment, the most recent result is used. When there is no date, the scoreID is used to to determine the most recent entry. Otherwise, reports a value of 00. Allowable values: 00 - Student not assessed 01 - Student scored at performance level 1 02 - Student scored at performance level 2 03 - Student scored at performance level 3 04 - Student scored at performance level 4 05 - Student refused to test 06 - Student exempt from testing (must be approved by KSDE)
Comprehensive Agriculture Assessment
Animal Systems Assessment
Plan Systems Assessment
Kansas English Language Proficiency Assessment (KELPA)

Student Information > Program Participation > State Programs > Dyslexia > Dyslexia Screener

Student Information > General > Enrollments > State Reporting Fields > Math Assessment Type

EnrollmentKS.mathAssessmentType

Student Information > General > Enrollments > State Reporting Fields > Reading Assessment Type

EnrollmentKS.readingAssessmentType

Student Information > General > Enrollments > State Reporting Fields > State Science Assessment Type

Student Information > General > Assessment > Result

Student Information > General > Enrollments > State Reporting Fields > General Comprehensive Agriculture Assessment

Student Information > General > Enrollments > State Reporting Fields > General Animal Systems Assessment

Student Information > General > Enrollments > State Reporting Fields > General Plant Systems Assessment

Student Information > General > Enrollments > State Reporting Fields > KELPA Exam

EnrollmentKS.KelpaExam

namespace

Namespace for the assessment.
uri://ksde.org/Assessment/Assessment.xml

Assessment Identifier Table

AssessmentIdentifier	Namespace	Assessment Title
Animal Systems Assessment	uri://ksde.org/Assessment/Assessment.xml	Animal Systems Assessment
Comprehensive Agriculture Assessment	uri://ksde.org/Assessment/Assessment.xml	Comprehensive Agriculture Assessment
Dyslexia Screener_Acadience	uri://ksde.org/Assessment/Assessment.xml	Dyslexia Screener - Acadience
Dyslexia Screener_AIMSPlus	uri://ksde.org/Assessment/Assessment.xml	Dyslexia Screener - AIMSPlus
Dyslexia Screener_easyCBM	uri://ksde.org/Assessment/Assessment.xml	Dyslexia Screener - easyCBM
Dyslexia Screener_FASTBridge	uri://ksde.org/Assessment/Assessment.xml	Dyslexia Screener - FASTBridge
Dyslexia Screener_iReady	uri://ksde.org/Assessment/Assessment.xml	Dyslexia Screener - iReady
Dyslexia Screener_KS Alternate Screener	uri://ksde.org/Assessment/Assessment.xml	Dyslexia Screener – KS Alternate Screener
Dyslexia Screener_Other	uri://ksde.org/Assessment/Assessment.xml	Dyslexia Screener - Other (Meets Rubric Requirements)
Dyslexia Screener_Renaissance Star	uri://ksde.org/Assessment/Assessment.xml	Dyslexia Screener – Renaissance Star
Kansas English Language Proficiency Assessment (KELPA)	uri://ksde.org/Assessment/Assessment.xml	Kansas English Language Proficiency Assessment (KELPA)
Plant Systems Assessment	uri://ksde.org/Assessment/Assessment.xml	Plant Systems Assessment
State English Language Arts Assessment	uri://ksde.org/Assessment/Assessment.xml	State English Language Arts Assessment
State History/Gov Assessment	uri://ksde.org/Assessment/Assessment.xml	State History/Gov Assessment
State Mathematics Assessment	uri://ksde.org/Assessment/Assessment.xml	State Mathematics Assessment
State Science Assessment	uri://ksde.org/Assessment/Assessment.xml	State Science Assessment

Arrays

Click here to expand...

Student Objective Assessments

Data Element Label	Business Requirements and Rules	Mandatory, Conditional, or Optional
administrationDate	Date and time an assessment was completed by the student.	O
administrationEndDate	Date and time an assessment administration ended.	O
assessedMinutes	Reported time the student was assessed in minutes.	O
objectiveAssessmentReference		M
assessmentIdentifier	Unique number or alphanumeric code assigned to an assessment.	M
identificationCode	Unique number or alphanumeric code assigned to an objective assessment by a school, school system, state, or other agency or entity.	M
namespace	Namespace for the assessment.	M
performanceLevels	Unordered collection of studentAssessmentStudentObjective AssessmentPerformanceLevels. The performance level(s) achieved for the objective assessment.
assessmentReportingMethodDescriptor	Method that the instructor of the class uses to report the performance and achievement.	M
performanceLevelDescriptor	Specification of which performance level value describes the student proficiency.
performanceLevelIndicatorName	Name of the indicator being measured for a collection of performance level values.	O
scoreResults	Unordered collection of studentAssessmentStudentObjective AssessmentScoreResults.
assessmentReportingMethodDescriptor	The method that the administrator of the assessment uses to report the performance and achievement of all students.	M
resultDatatypeTypeDescriptor	Datatype of the result. The results can be expressed as a number, percentile, range, level, etc.	M
result	The value of a representing the performance of an individual.	M

Score Results

Data Element Label	Business Requirement and Rules	Mandatory, Conditional, or Optional	Location
assessmentReportingMethodDescriptor	The method that the administrator of the assessment uses to report the performance and achievement of all students. It may be a qualitative method such as performance level descriptors or a quantitative method such as a numerical grade or cut score. More than one type of reporting method may be used. Reports the mapped Ed-Fi Code Value if the reporting assessment Score Fields value is populated. Does not report if not mapped.	M
resultDatatypeTypeDescriptor	The datatype of the result. The results can be expressed as a number, percentile, range, level, etc. Hard-coded value.	M
result	The value of a meaningful raw score or statistical expression of the performance of an individual. The results can be expressed as a number, percentile, range, level, etc. Reports the score value for corresponding assessment mapped score	M	Student Information > General > Assessment > Test Scores > Test Score Detail > Result Student Information > General > Assessment > Test Scores > Test Score Detail > Percent/Scale Score

Data Element Label

Business Requirement and Rules

Mandatory, Conditional, or Optional

Location

assessmentReportingMethodDescriptor

The method that the administrator of the assessment uses to report the performance and achievement of all students. It may be a qualitative method such as performance level descriptors or a quantitative method such as a numerical grade or cut score. More than one type of reporting method may be used.

Reports the mapped Ed-Fi Code Value if the reporting assessment Score Fields value is populated.

Does not report if not mapped.

resultDatatypeTypeDescriptor

The datatype of the result. The results can be expressed as a number, percentile, range, level, etc.
Hard-coded value.

result

The value of a meaningful raw score or statistical expression of the performance of an individual. The results can be expressed as a number, percentile, range, level, etc.
Reports the score value for corresponding assessment mapped score

Student Information > General > Assessment > Test Scores > Test Score Detail > Result

Student Information > General > Assessment > Test Scores > Test Score Detail > Percent/Scale Score

Period

Data Element Label	Business Requirements and Rules	Mandatory, Conditional, or Optional	Location
assessmentPeriodDescriptor	The period of time in which an assessment is supposed to be administered (e.g., Beginning of Year, Middle of Year, End of Year). Reports the mapped Ed-Fi Code Value. Tests available for mapping are those with an end year that matches the configuration end year or test's with no end year at all. Does not report period if test is not mapped.	M
beginDate	The first date the assessment is to be administered. Reports the start date from the assessment when it exists.	O	Assessment Center > Test Detail > Start Date Test.startDate
endDate	The last date the assessment is to be administered. Reports the end date from the assessment if it exists.	O	Assessment Center > Test Detail > End Date Test.endDate

Type/Descriptor

Click here to expand...

Assessment Request Descriptor

Ed-Fi Code Value	Description	Short Description	Namespace
Clear test subject indicator	Clear test subject indicator	Clear test subject indicator	uri://ksde.org/AssessmentRequestDescriptor
COMPAGRIC - No Test in Power, Structural, and Tech	COMPAGRIC - No assessment, Power, Structural, and Tech	COMPAGRIC - No assessment, Power, Structural, and Technical Systems module only.	uri://ksde.org/AssessmentRequestDescriptor
COMPAGRIC - Test in Power, Structural, and Tech	COMPAGRIC - Test in Power, Structural, and Tech	COMPAGRIC - Yes, test in this content area with Power, Structural, and Technical Systems module.	uri://ksde.org/AssessmentRequestDescriptor
General Assessment	General Assessment	General Assessment	uri://ksde.org/AssessmentRequestDescriptor
KELPA for current ESOL students only	KELPA for current ESOL students only	KELPA for current ESOL students only	uri://ksde.org/AssessmentRequestDescriptor
KELPA for ESOL program eligible student	KELPA for ESOL program eligible student	KELPA for student who is ESOL program eligible, but not currently receiving ESOL program services	uri://ksde.org/AssessmentRequestDescriptor
No test in this content area	No test in this content area	No test in this content area	uri://ksde.org/AssessmentRequestDescriptor
PLANTSYSTEMS - No Test in Horticulture Module	PLANTSYSTEMS - No Test in Horticulture Module	PLANTSYSTEMS - No Test in Horticulture Module	uri://ksde.org/AssessmentRequestDescriptor
PLANTSYSTEMS - Test in Horticulture Module	PLANTSYSTEMS - Test in Horticulture Module	PLANTSYSTEMS - Yes, test in this content area with Horticulture module.	uri://ksde.org/AssessmentRequestDescriptor
Yes test in this content area	Yes test in this content area	Yes test in this content area	uri://ksde.org/AssessmentRequestDescriptor

Assessment Reporting Method Descriptor

Ed-Fi Code Value	Description	Short Description	Namespace
Achievement/proficiency level	Achievement/proficiency level	Achievement/proficiency level	uri://ed-fi.org/AssessmentReportingMethodDescriptor

Performance Level Descriptor

Ed-Fi Code Value	Description	Short Description	Namespace
Not Assessed	Student not assessed	Student not assessed	uri://ksde.org/PerformanceLevelDescriptor
Accuracy at or Above, Rate at or Above Benchmark	Accuracy at or Above Benchmark, Rate at or Above Benchmark	Accuracy at or Above Benchmark, Rate at or Above Benchmark	uri://ksde.org/PerformanceLevelDescriptor
Accuracy at or Above, Rate Below Benchmark	Accuracy at or Above Benchmark, Rate Below Benchmark	Accuracy at or Above Benchmark, Rate Below Benchmark	uri://ksde.org/PerformanceLevelDescriptor
Accuracy Below, Rate at or Above Benchmark	Accuracy Below Benchmark, Rate at or Above Benchmark	Accuracy Below Benchmark, Rate at or Above Benchmark	uri://ksde.org/PerformanceLevelDescriptor
Accuracy Below, Rate Below Benchmark	Accuracy Below Benchmark, Rate Below Benchmark	Accuracy Below Benchmark, Rate Below Benchmark	uri://ksde.org/PerformanceLevelDescriptor
At or Above Benchmark	At or Above Benchmark	At or Above Benchmark	uri://ksde.org/PerformanceLevelDescriptor
Below Benchmark	Below Benchmark	Below Benchmark	uri://ksde.org/PerformanceLevelDescriptor
Performance Level 1	Performance Level 1	Performance Level 1	uri://ksde.org/PerformanceLevelDescriptor
Performance Level 2	Performance Level 2	Performance Level 2	uri://ksde.org/PerformanceLevelDescriptor
Performance Level 3	Performance Level 3	Performance Level 3	uri://ksde.org/PerformanceLevelDescriptor
Performance Level 4	Performance Level 4	Performance Level 4	uri://ksde.org/PerformanceLevelDescriptor
Student exempt from testing	Student exempt from testing - must be approved by KSDE	Student exempt from testing - must be approved by KSDE	uri://ksde.org/PerformanceLevelDescriptor
Student refused to test	Student refused to test	Student refused to test	uri://ksde.org/PerformanceLevelDescriptor

Result Datatype Type Descriptor

Ed-Fi Code Value	Description	Short Description	Namespace
Decimal	Decimal	Decimal	uri://ed-fi.org/ResultDatatypeTypeDescriptor
Integer	Integer	Integer	uri://ed-fi.org/ResultDatatypeTypeDescriptor
Level	Level	Level	uri://ed-fi.org/ResultDatatypeTypeDescriptor
Percentage	Percentage	Percentage	uri://ed-fi.org/ResultDatatypeTypeDescriptor
Percentile	Percentile	Percentile	uri://ed-fi.org/ResultDatatypeTypeDescriptor
Range	Range	Range	uri://ed-fi.org/ResultDatatypeTypeDescriptor

Student Assessments (Kansas v3.6)

Object Triggering Logic

Scope Year

Resync Logic

Natural Key Changes, Cascading Updates, and Deletes Logic

Event Queue Detail

Resource Preferences

Object Data Elements

References

Assessment Reference

Assessment Identifier Table

Arrays

Student Objective Assessments

Score Results

Period

Type/Descriptor

Assessment Request Descriptor

Assessment Reporting Method Descriptor

Performance Level Descriptor

Result Datatype Type Descriptor

Related Articles