Skip to end of metadata
Go to start of metadata

The Assessment domain deals with the structure of assessments, the educational standards and objectives measured by assessments, and assessment results. The assessment model is suitable for a wide variety of assessments, including early childhood learning assessments, complex tests like state standardized assessments and college entrance exams, and simple tests like benchmark assessments and course assessments.

Key Entities

This domain contains:

  • A LearningStandard entity that drives the curriculum and the assessments.
  • An Assessment entity that describes assessments along with associated metadata.
  • A StudentAssessmentResult entity that follows a parallel structure of StudentAssessment, StudentObjectiveAssessment, and StudentAssessmentItem.

Key Concepts

The key concepts include the following:

  • Assessments are essentially tests, quizzes, or other instruments that evaluate student learning.
  • The overall domain is designed to capture student assessment results, not to recreate assessment instruments. The assessment instrument information is modeled to support recording and proper interpretation of a student’s results.

  • The assessment model is flexible enough to convey results from complex tests such as the SAT and ACT exams, large tests such as state-level standardized tests, and simple tests such as classroom benchmark assessments or quizzes.
  • The LearningObjective entity usually models a general representation of an abstract learning concept or skill, whereas the LearningStandard entity models specific elements within the realm of an objective.

  • The ObjectiveAssessment entity is essentially a grouping of items on an assessment that may have its own score and can be tied to learning objectives and learning standards.

The Ed-Fi data model for assessments contains a number of entities and reference patterns. While its scope may make it a bit imposing to newcomers, understanding a few design principles enable it to be easily understood and adopted.

Hierarchical Modeling

Many assessments are multi-tier in the sense that they provide multiple scores or result sets for each assessment. An example would be a single "reading" assessment that tested multiple skill areas, such as "Reading Comprehension," "Accuracy and Fluency," "Phonemic Awareness," and so forth.

In the Assessment domain, the top-level assessment is an Assessment entity and the skill areas are ObjectiveAssessment entities. This structure is recursive, so that there can be any number of levels of ObjectiveAssessments.

Once a student takes an assessment, the results can be modeled in the StudentAssessment and StudentObjectiveAssessment entities, each of which has references back to its parent or peer entities.

Support for Mapping to Local Learning Objectives and Learning Standards

Field implementation has shown that, while school systems will intake into their systems the results of student assessments in areas like "Reading Comprehension" (in other words, the ObjectiveAssessment entity with student results held in the StudentObjectiveAssessment entity), they also commonly need to map those "Reading Comprehension" results to local learning benchmarks. The LearningObjective entity enables the ObjectiveAssessment to be mapped to a local benchmark. Further, the LearningObjective entity may be mapped to a formal, external learning standard, such as one provided by the state or Common Core State Standards.

The structure looks like this:

The source of the data is typically as follows:

 Ed-Fi Entity
 ObjectiveAssessmentLearningObjectiveLearningStandard
Who provides ("owns") the entity data?The assessment providerThe local school agencyA third party
Example of a provider"DIBELS""Grand Bend School District""Common Core State Standards"

The practice of mapping to a local benchmark is not universal, and so it is also possible to associate a LearningStandard from an ObjectiveAssessment, as shown in the diagram below:

Who "Owns" What (or, Where Does the Data Come From)?

The assessment model combines data that originate with many entities, for example:

  • An assessment provider (College Board, DIBELS, NWEA, or any number of useful new web tools) is generally the provider of the core metadata for what the assessment looks like and what it is assessing. This information maps to the Assessment, ObjectiveAssessment, and AssessmentItems entities.
  • A student generates data when interacting with an assessment. This information generally maps to the StudentAssessment and StudentObjectiveAssesment entities.
  • The enterprise hosting or managing the data often provides contextual metadata, mapping the provider elements to local standards via the LearningObjectives entity. The LearningStandard entity is often managed by the enterprise as well.

The following diagram captures this:


UDM Documentation Contents

Explore the Ed-Fi Unified Data Model:

CompetencyObjective vs. LearningObjectives

Students, and particularly students in lower grades, are often assessed on skills that are more developmental than academic. "Plays well with others" or "Pays attention in class" are typical examples. In the Ed-Fi Assessment domain, these are typically modeled as CompetencyObjectives to distinguish them from the more formal LearningObjectives.

Optional Inheritance via AssessmentFamily

AssessmentFamily provides a means to group assessments logically (generally from the same provider covering the same subject area). Its use is optional. By convention in field implementations, it is an abstraction that provides a way for Assessments to inherit common characteristics from the AssessmentFamily.


Model Reference

This section contains reference information for the Assessment domain model. 

Learning Standard Subdomain

Many states have learning standards that drive the curriculum and the assessments. The Common Core State Standards Initiative (www.corestandards.org) is a national initiative for standards in this area. For states that use the Common Core, or have their own standards, the assessment model has entities for LearningStandard, which represents the lowest level of skills, and LearningObjective, which represents higher level aggregation of skills, as shown below. The model supports a hierarchical taxonomy of learning skills using multiple levels of LearningObjective, which may correspond to levels of subjects, domains, or strands; the Nomenclature element captures the appropriate naming of these levels whereas the SuccessCriteria element captures the criterion that teacher and students use to check for attainment of the objective.

The LearningStandard entity may also be hierarchically organized to support the use case that adopters of the Common Core often decompose a standard into lower level standards in their curriculum. The HasAssociatedPrerequisite association captures prerequisites for a learning standard as would be specified in a learning map.

Assessment, Learning Standards Model

Assessment Metadata Subdomain

Assessment metadata is information describing the assessment instrument itself.

There are two options to associate an Assessment that are mutually exclusive: by Section and by Program. For example, if an Assessment is defined to assess Common Core Standards, then the association shall be with Section. On the other hand, if the Assessment is defined to assess the Developmental Domains by an Early Learning program, then the association shall be with Program.



Assessment, Assessment Metadata Model


Student Assessment Subdomain

The Assessment entity represents a specific administration of an assessment. The Assessment entity contains the minimum amount of metadata required for an assessment.

  • If the Assessment entity is associated with one or more sections, an association is made to the section(s).
  • The ObjectiveAssessment entity is the optional identification of portions of the assessment that test specific learning objectives. If required, there can be multiple levels of hierarchical ObjectiveAssessments entities.
  • The AssessmentItem entity supports the optional identification of the individual questions or items on a test to be scored. Typically, the identification of AssessmentItems entities is done in conjunction with their mapping to LearningStandards entities.
  • If the assessment references the Common Core or other state standards for LearningStandards and LearningObjectives entities, then the assessment metadata would reference the preloaded standards. If the assessment references its own set of LearningObjectives and/or LearningStandards entities, then that data would be loaded as assessment metadata. An ObjectiveAssessment entity may test one or more LearningObjectives entities, and/or may test one or more LearningStandards entities.

The student's assessment results follow a similar structure to the assessment metadata.

  • The StudentAssessment entity holds the overall assessment score and other information about a specific student's results for a specific assessment. This entity is associated with a specific student.
  • The StudentObjectiveAssessment entity optionally holds the student's score for individually scored results for a specific learning objective. If the assessment metadata includes objective assessments, then there would be corresponding StudentObjectiveAssessments entities for each student.
  • The StudentAssessmentItem entity optionally holds the student's score for individual AssessmentItems entities. If the assessment metadata includes AssessmentItems, then there would be corresponding StudentAssessmentItems entities for each student.

Assessment, Student Assessment Model




Assessment Model Entities

NameDescription
AssessmentThis entity represents a tool, instrument, process, or exhibition composed of a systematic sampling of behavior for measuring a student's competence, knowledge,skills, or behavior. An assessment can be used to measure differences inindividuals or groups and changes in performance from one occasion to the next.
AssessmentItemThis entity represents one of many single measures that make up an assessment.
LearningObjectiveThis entity represents identified learning objectives for courses in specific grades.
LearningStandardThis entity is a sub-element of a learning objective consisting of a precise statement of the expectation of a student's proficiency.
ObjectiveAssessmentThis entity represents subtests that assess specific learning objectives.
ProgramThis entity represents any program designed to work in conjunction with, or as a supplement to, the main academic program. Programs may provide instruction, training, services, or benefits through federal, state, or local agencies. Programs may also include organized extracurricular activities for students.
SectionThis entity represents a setting in which organized instruction of course content is provided, in-person or otherwise, to one or more students for a given period of time. A course offering may be offered to more than one section.
StudentThis 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.
StudentAssessmentThis entity represents the analysis or scoring of a student's response on an assessment. The analysis results in a value that represents a student's performance on a set of items on a test.
StudentAssessmentItemThis entity represents the student's response to an assessment item and the item-level scores such as correct, incorrect, or met standard.
StudentObjectiveAssessmentThe student's score and/or performance levels earned for an ObjectiveAssessment.


Assessment Model

Example Usage

Assessment data often travels in bulk, so we'll use XML data files for an example.

Defining a Test or Other Assessment

The assessment metadata contains information about a test, quiz, or other assessment, and provides a way to define the structure of the assessment. Those definitions are included in the XML file snippet below, which is aligned to the Ed-Fi Interchange-AssessmentMetadata.xsd:

Example XML Data File - Student Assessment Metadata Snippet
	...
	<!-- Overall assessment information travels in the Assessment entity. -->
	<Assessment id="TA-Benchmark-Mathematics-44133444315097835126">
		<AssessmentTitle>PreAP Geometry 1st Six Weeks 2012 - 2013</AssessmentTitle>
		<AssessmentIdentificationCode>
			<IdentificationCode>a44f1b3e-34b4-4e3e-b150-af97f835126c</IdentificationCode>
			<AssessmentIdentificationSystem>
				<CodeValue>Test Contractor</CodeValue>
			</AssessmentIdentificationSystem>
		</AssessmentIdentificationCode>
		<AssessmentCategory>
			<CodeValue>Benchmark test</CodeValue>
		</AssessmentCategory>
		<AcademicSubject>
			<CodeValue>Mathematics</CodeValue>
			<Namespace>http://www.ed-fi.org/Descriptor/AcademicSubjectDescriptor.xml</Namespace>
		</AcademicSubject>
		<AssessedGradeLevel>
			<CodeValue>Ninth grade</CodeValue>
			<Namespace>http://www.ed-fi.org/Descriptor/GradeLevelDescriptor.xml</Namespace>
		</AssessedGradeLevel>
		<ContentStandard>
			<Title>State Essential Knowledge and Skills</Title>
		</ContentStandard>
		<Version>4956</Version>
		<RevisionDate>2012-09-25</RevisionDate>
		<MaxRawScore>10</MaxRawScore>
		<Namespace>http://ed-fi.org</Namespace>
	</Assessment>
	<!-- The AssessmentItem models individual test items (like a question and its answer) and relates the item to a learning standard. -->
	<AssessmentItem id="ID_1">
		<IdentificationCode>10202640</IdentificationCode>
		<AssessmentItemCategory>List Question</AssessmentItemCategory>
		<MaxRawScore>1</MaxRawScore>
		<CorrectResponse>A</CorrectResponse>
		<LearningStandardReference>
			<LearningStandardIdentity>
				<LearningStandardId>111.34.NA.G.1.A</LearningStandardId>
			</LearningStandardIdentity>
		</LearningStandardReference>
		<AssessmentReference ref="TA-Benchmark-Mathematics-44133444315097835126">
			<AssessmentIdentity>
				<AssessmentTitle>PreAP Geometry 1st Six Weeks 2012 - 2013</AssessmentTitle>
				<AcademicSubject>
					<CodeValue>Mathematics</CodeValue>
					<Namespace>http://www.ed-fi.org/Descriptor/AcademicSubjectDescriptor.xml</Namespace>
				</AcademicSubject>
				<AssessedGradeLevel>
					<CodeValue>Ninth grade</CodeValue>
					<Namespace>http://www.ed-fi.org/Descriptor/GradeLevelDescriptor.xml</Namespace>
				</AssessedGradeLevel>
				<Version>4956</Version>
			</AssessmentIdentity>
		</AssessmentReference>
	</AssessmentItem>
	...

For illustrative purposes, we chose an information-rich file as an example. It's worth noting that most of the elements are optional, so it's possible to use the same XML file structure for simple cases like establishing links to learning standards, or simply providing a list of correct responses to a test.

Defining a Student's Test Results

Test results are conveyed by assessment references (which provide a pointer to a specific assessment) and the StudentAssessment entity (which contains an individual child's performance on the test). The StudentAssessment entity contains general information about the test (e.g., assessment date, the language in which the test was administered) and also a collection of AssessmentItems that breaks down the overall test results into individual test items.

The XML file snippet below shows an example of how that works. The snippet is aligned to the Ed-Fi Interchange-StudentAssessment.xsd:

Example XML Data File - Student Assessment Snippet
	...
	<!-- The AssessmentReference provides a link to a specific test.  -->
	<AssessmentReference id="ID_PreAPGeometry1stSixWeeks2012-2013_4956_3_9">
		<AssessmentIdentity>
			<AssessmentTitle>PreAP Geometry 1st Six Weeks 2012 - 2013</AssessmentTitle>
			<AcademicSubject>
				<CodeValue>Mathematics</CodeValue>
				<Namespace>http://www.ed-fi.org/Descriptor/AcademicSubjectDescriptor.xml</Namespace>
			</AcademicSubject>
			<AssessedGradeLevel>
				<CodeValue>Ninth grade</CodeValue>
				<Namespace>http://www.ed-fi.org/Descriptor/GradeLevelDescriptor.xml</Namespace>
			</AssessedGradeLevel>
			<Version>4956</Version>
		</AssessmentIdentity>
	</AssessmentReference>
	<!-- The StudentAssessment is a wrapper for one student's test results.  -->
	<StudentAssessment id="ID_604822_PreAPGeometry1stSixWeeks2012-2013_4956_3_9">
		<AdministrationDate>2012-09-28</AdministrationDate>
		<AdministrationLanguage>
			<CodeValue>English</CodeValue>
			<Namespace>http://www.ed-fi.org/Descriptor/LanguageDescriptor.xml</Namespace>
		</AdministrationLanguage>
		<AdministrationEnvironment>Testing Center</AdministrationEnvironment>
		<RetestIndicator>Primary Administration</RetestIndicator>
		<ScoreResult>
			<Result>8</Result>
			<ResultDatatypeType>Integer</ResultDatatypeType>
			<AssessmentReportingMethod>
				<CodeValue>Raw score</CodeValue>
			</AssessmentReportingMethod>
		</ScoreResult>
		<StudentReference>
			<StudentIdentity>
				<StudentUniqueId>604822</StudentUniqueId>
			</StudentIdentity>
		</StudentReference>
		<AssessmentReference ref="ID_PreAPGeometry1stSixWeeks2012-2013_4956_3_9">
			<AssessmentIdentity>
				<AssessmentTitle>PreAP Geometry 1st Six Weeks 2012 - 2013</AssessmentTitle>
				<AcademicSubject>
					<CodeValue>Mathematics</CodeValue>
					<Namespace>http://www.ed-fi.org/Descriptor/AcademicSubjectDescriptor.xml</Namespace>
				</AcademicSubject>
				<AssessedGradeLevel>
					<CodeValue>Ninth grade</CodeValue>
					<Namespace>http://www.ed-fi.org/Descriptor/GradeLevelDescriptor.xml</Namespace>
				</AssessedGradeLevel>
				<Version>4956</Version>
			</AssessmentIdentity>
		</AssessmentReference>
		<!-- The StudentAssessmentItem provides detail about responses to a individual test questions or components -->
		<StudentAssessmentItem>
			<AssessmentResponse>G</AssessmentResponse>
			<ResponseIndicator>Nonscorable response</ResponseIndicator>
			<AssessmentItemResult>Correct</AssessmentItemResult>
			<AssessmentItemReference>
				<AssessmentItemIdentity>
					<IdentificationCode>10202640</IdentificationCode>
					<AssessmentReference ref="ID_PreAPGeometry1stSixWeeks2012-2013_4956_3_9">
						<AssessmentIdentity>
							<AssessmentTitle>PreAP Geometry 1st Six Weeks 2012 - 2013</AssessmentTitle>
							<AcademicSubject>
								<CodeValue>Mathematics</CodeValue>
								<Namespace>http://www.ed-fi.org/Descriptor/AcademicSubjectDescriptor.xml</Namespace>
							</AcademicSubject>
							<AssessedGradeLevel>
								<CodeValue>Ninth grade</CodeValue>
								<Namespace>http://www.ed-fi.org/Descriptor/GradeLevelDescriptor.xml</Namespace>
							</AssessedGradeLevel>
							<Version>4956</Version>
						</AssessmentIdentity>
					</AssessmentReference>
				</AssessmentItemIdentity>
			</AssessmentItemReference>
		</StudentAssessmentItem>
	...

Similar to the assessment metadata example, we chose a fairly rich example for illustrative purposes. Many of the elements are optional, so the same XSD definition can convey basic, overall quiz results or can convey rich detail about each individual response given by a student.


  • No labels