Ed-Fi Data v3.1 - Grades [.2231 - .2343]

Tool Search: Ed-Fi

This educational entity represents an overall score or assessment tied to a course over a period of time (i.e., the grading period). Student grades are usually a compilation of marks and other scores.

Object Triggering Logic

This table describes logic for triggering syncing of this object.

ActionTrigger
Post

When a grade is posted to a Grading Task that is mapped to an Ed-Fi Grade Type:

  • Standards do not report to Ed-Fi.
  • Do not report if the Course is marked as Inactive or State Excluded.
  • Do not send records if the School or Calendar Exclude check box is checked.
  • Check to see if the student has a Student Section Association in the Ed-FI identity Mapping table before sending.
  • If the Student Section Association exits, continue with processing the record to Ed-Fi.
  • If the Student Section Association does not exist, the record will go to the Error Log with a message stating:  Student (First Name Last Name, Ed-Fi ID) does not have a Student Section Association record for the course (Course Number Course Name).  This record must exist before Grades can be sent.
  • The Grading Task must be mapped to a Grading Period to report.
  • Report to the Grading Period that over laps the Term the grade is Posted to.  
  • The end date of the Grading Period must be on or after the Term Start Date and on or before the Term End Date based on the Term to which the grade is posted.
  • If the Grade is aligned to more than 1 Grading Period that overlaps the Term, the grade will report to all eligible Grading Periods.
Put

When a grade is updated on a Grading Task that is mapped to an Ed-Fi Grade Type.

DeleteWhen a grade is deleted from a Grading Task that is mapped to an Ed-Fi Grade Type.
DeleteWhen Grade Type Descriptor is no longer mapped and a resync is performed.


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

NoneIf a resource is toggled to 'OFF' after data has sent, all sent data will remain in the ODS but no new data will send.
DeleteIf a resource is toggled to 'OFF" after data has sent and an action is performed that would trigger a delete, that data will remain in the ODS until a resync is done.
ResyncIf a record is in the Ed-Fi Identity Mapping table and not in the ODS, it will be deleted from the Ed-Fi Identity Mapping table.
ResyncIf a record is in the ODS and it does not have a matching record in Campus or the Ed-Fi Identity Mapping table, it will be deleted from the ODS.
ResyncIf a mapping is changed in Resource Preferences, a resync will need 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.

ActionTrigger
Delete/Post

Natural Key change: If the Natural Key of the Grading Period Reference or Student Section Association changes, a delete/post will occur.

Delete/PostIf the Grade Type Descriptor is changed or removed.


Scope Year Logic

This table describes scope year logic of this object.

Logic

Grades will post to the scope year the course's calendar is aligned to.

  • Data will only send for the years that have valid configuration.


Resource Preferences

This table describes the Resource Preferences of this object.

Data Element LabelMapping Needed
Grading TasksGrade Type Descriptors


Event Queue Detail

This table describes the Event Queue Detail of this object.

Campus Table

Ed-Fi Action

Fields

gradingscore.scorePost/Put/DeleteThe primary table used for sending data for this resource.
gradingTaskPost/Put/DeleteThe primary table used for sending data for this resource.


Object Data Elements

This table describes data elements sent within the Grades resource.

Data Element LabelBusiness RequirementBusiness RulesM, C or O

Data Source GUI Path

Database Field
idThe unique identifier of the resource.


M

gradeTypeDescriptorThe type of grade (e.g., Exam, Final, Grading Period, Progress Report).
  1. Reports the Ed-Fi Code from mapping for the Grading Task.
  2. If the grading task is not mapped, do not report.
M

Grading & Standards> Grading Tasks

 gradingTask
gradingPeriodReferenceA reference to the related GradingPeriod resource.
  1. Reports the fields that are part of the Natural Key for the Grading Periods resource.
M

studentSection
AssociationReference
A reference to the related Student Section Association resource.
  1. Reports the fields that are part of the Natural Key for the Student Section Association resource.
M

diagnostic
Statement
A statement provided by the teacher that provides information in addition to the grade or assessment score.
  1. This field is optional, does not report.
O

letterGradeEarnedA final or interim (grading period) indicator of student performance in a class as submitted by the instructor.
  1. Determine if the posted score is an integer or not:
    • If the posted value is not an Integer, then report the posted score here.
    • If the posted value is an Integer, then report in the Numeric Grade Earned field below.
OGrading & Standards> Score Groups & Rubrics> Scoregradingscore.score
numericGrade
Earned
A final or interim (grading period) indicator of student performance in a class as submitted by the instructor.
  1. Determine if the posted score is an integer or not:
    • If the posted value is an Integer, then report the posted score here.
    • If the posted value is not an Integer, then report in Letter Grade Earned field above.
OGrading & Standards> Score Groups & Rubrics> Scoregradingscore.score
performanceBase
ConversionDescriptor
The performance base conversion assessed for the student.
  1. This field is optional, does not report.
O


Type/Descriptor

Click here to expand...

Grade Type Descriptors

Code ValueDescriptionNamespaceShort Description
ConductConducturi://ed-fi.org/GradeTypeDescriptorConduct
FinalFinaluri://ed-fi.org/GradeTypeDescriptorFinal
SemesterSemesteruri://ed-fi.org/GradeTypeDescriptorSemester
ExamExamuri://ed-fi.org/GradeTypeDescriptorExam
Grading PeriodGrading Perioduri://ed-fi.org/GradeTypeDescriptorGrading Period
Mid-Term GradeMid-Term Gradeuri://ed-fi.org/GradeTypeDescriptorMid-Term Grade
Progress ReportProgress Reporturi://ed-fi.org/GradeTypeDescriptorProgress Report