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.
| Action | Trigger |
|---|---|
| Post | When a new Grading Period is created and saved in Resource Preferences and a resync is completed.
|
| Put | When the Grading Period Start or End Date is updated and saved and a resync is completed. |
| Put | When the Instructional checkbox is marked or unmarked, the totalInstructionalDays field updates with the correct number of instructional days. |
| Put | When the Period Sequence is changed. |
| Delete | When the Grading Period is removed and saved in Resource Preferences and a resync is completed. |
| Delete | When the last day record is deleted from the days table. |
| Delete/Post | When the Grading Period's Grading Period Descriptor or Sequence is edited and saved in the Resource Preferences and a resync is completed. |
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 | When a resource is toggled to OFF after data has sent, all sent data remains in the ODS but no new data sends. |
| Delete | When a resource is toggled to OFF after data has sent and an action is performed that would trigger a delete, that data remains in the ODS until a resync is done. |
| 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. |
| Resync | When doing a resync, look to make sure the Grading Task is still mapped in the Grades Resource Preferences prior to sending. |
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 | When the Natural Key changes:
|
| Delete/Post | When the Grading Period Descriptor or Sequence changes and a resync is completed. |
| Delete/Post | When the natural key changes or the record is deleted, the Sessions Grading Periods reference is updated. |
| Delete/Post | When the natural key of Grading Periods changes, all existing dependent data is deleted or moved to the correct Grading Period. When a grade has not been posted yet and a Grading Period changes, a resync on the Grades resource needs to be completed. |
| Dependent Resources | Sessions Reference, Grades |
Scope Year Logic
This table describes scope year logic of this object.
| Logic |
|---|
Reports the grading periods in the configured year to which they are aligned.
|
Resource Preferences
This table describes the Resource Preferences of this object.
| Data Element Label | Mapping Needed |
|---|---|
| Schools/Calendars/Schedule Structures/Term Schedules | Grading Period Detail |
Identity Mapping Object Key
campusObjectType | Object Key Data Source |
|---|---|
| EdFiGradingPeriod | edFiGradingPeriodID |
Event Queue Detail
This table describes the Event Queue Detail of this object.
Campus Table | Ed-Fi Action | Fields |
|---|---|---|
| edfiGradingPeriods | Post/Put/Delete | The primary table used for sending data for this resource. |
Error Log
| Error | Possible Causes/How to Fix |
|---|---|
| Student Over, 57744 does not have a Student Section Association record for the course 1014 ACP English 9. This record must exist before Grades can be sent. | Causes: Student has a grade for a course section that attempted to send during a resync of gradingPeriods. Student did not have a studentSectionAssociation on record. Resolution: Resync studentSectionAssociation for this student to send studentSectionAssociation and grade to Ed-Fi. |
Object Data Elements
This table describes data elements sent within the Grading Periods resource.
| Data Element Label | Business Requirements and Rules | Mandatory, Conditional or Optional | Database Field |
|---|---|---|---|
| id | The unique identifier of the resource. | M | |
| gradingPeriodDescriptor | The name of the grading period. Reports the code value from the Grading Period Name selected. | M | Resource Preferences > Grading Periods > Grading Period Descriptor edfigradingperiod.name |
| periodSequence | The sequence of the grading period.
| M | Resource Preferences > Grading Periods > Grading Period Sequence edfigradingperiod.sequence |
| schoolReference | Provide user information to lookup and link to an existing school record. Reports the natural key of the School resource to which the grading period is aligned. | M | |
| schoolYearTypeReference | A reference to the related SchoolYearType resource. Reports the end year from the calendar the term is reported. Reports XXXX. | M | |
| beginDate | The start date of the grading period. Reports the start date from the Grading Period being reported. When there is more than one grading period with the same School, Descriptor and Sequence, the earliest start date reports. | M | Resource Preferencess> Grading Periods > Grading Period Start Date edfigradingperiod.startDate |
| endDate | The end date of the grading period. Reports the end date from the Grading Period being reported. When there is more than one grading period with the same School, Descriptor and Sequence, reports the latest end date. | M | Resource Preferences > Grading Periods > Grading Period End Date edfigradingperiod.endDate |
| totalInstructionalDays | The total number of instructional days in the grading period. Counts the number of instructional days on the Days tool that occur during the start and end date for the grading period.
| M | Day Setup > Day Detail > Instruction |
| _etag | O |
