Course Transcripts (Nebraska v3.6)

This entity is the final record of a student's performance in their courses at the end of a semester or school year.

Object Triggering Logic

This table describes logic for triggering syncing of this object.

ActionTrigger
Post

When transcript records are posted for a student and they have a valid Student School Association for the Scoped Year.

Or

When a resync is completed for the school the student is enrolled, all eligible transcript records for all years will send for the Student

  • Do not send a record if the course is marked as inactive or state exclude.
  • The course must exist in the ODS for the Course Reference to send as part of this resource.  Use the following logic to determine which Course Reference to send:
    • If the School Number and Course Number on the transcript record are in the configured year ODS, report the Course reference with those numbers.
    • If School Number and Course Number on the transcript record are in the ODS for the configured year but not the school where the student is enrolled, report the course reference with the School and Course Number that matches the School & Course in the ODS.
    • If School Number on the transcript record is in the ODS for the configured year but not the school where the student is enrolled but the Course number matches the school they are enrolled, the course reference will report with the School Number where the student is enrolled.
    • If the School Number on the transcript record is not in the ODS and the course number matches the school where the student is enrolled, the course reference will report where the student is enrolled.
    • If the School Number on the transcript is not in the ODS but the Course Number matches a school where the student is not enrolled, the course reference will report with the school where the course match is found.  If there is more than 1 school with that course number, pick the school with the highest schoolID.
    • If the School Number on the transcript is not in the ODS and the course number does not match any course in the district, a record will not send and will not trigger an error.
  • Do not send a record if the transcript's score is null.

  • Do not send record if the School Exclude check box is checked.

  • Do not send record if the Calendar Exclude check box is checked.

Post/DeleteWhen any part of the Natural Key is changed.
Put

When fields that are not part of the natural key are changed.

DeleteWhen a transcript record is deleted for a student.
Delete

All Transcript records will only delete when a student has only 1 Student School Association record for a specific Year and that record is deleted.

(Note:  If a new Student School Association record is created, existing records will not re-post, a resync must be completed to resend the data)

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.

ActionTrigger
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.
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
Post/Delete

Natural Key change:

  • If the Natural Key changes from the Course Reference or Student Academic Reference, the cascading delete/post logic from those resources will trigger updates to the Course Transcripts.

  • Records will delete/post if the Credits Earned or Credits Attempted are changed on a student's transcript record.

Scope Year Logic

This table describes scope year logic of this object.

Logic

Transcript records will send to each scope year where the student has a Student School Association, regardless of the Transcript School Year.

  • Data will only send for years that have valid configuration.
  • A resync must be completed at the beginning of each year so that all years transcript records will be loaded in the ODS.

Resource Preferences

This table describes the Resource Preferences of this object.

Data Element LabelMapping Needed
Credit Earned/AttemptedCourse Attempt Result Descriptor

Identity Mapping Object Key

Campus Object TypeObject Key Data Source
TranscriptCoursetranscriptID

Event Queue Detail

This table describes the Event Queue Detail of this object.

Campus TableEd-Fi ActionFields
transcriptcoursePost/Put/DeleteThe primary table used for sending data for this resource.
transcriptcreditPost/Put/DeleteThe primary table used for sending data for this resource.

Object Data Elements

This table describes data elements sent within the Course Transcripts resource.

Data Element LabelBusiness RequirementM, C or O

Data Source GUI Path

courseAttemptResultDescriptor  The result from the student''s attempt to take the course, for example: Pass, Fail, Incomplete, Withdrawn.

When reporting from Transcript Records use the Credits Earned vs. Credit Attempted to determine the result.

Report the Ed-Fi Code from the mapping for the following options:
  • When the sum of credits Earned is >= the sum of credits Attempted.
  • When the sum of credits Earned is blank or = 0.
  • When the sum of credits Earned is not blank or = 0 and < than the sum of credits Attempted. 
M

Student Information> General> Transcripts> Earned


AND


Student Information> General> Transcripts> Attempted


transcriptcredit.

creditsAttempted

AND

transcriptcredit.

creditsEarned

courseReference 
 A reference to the related Course resource. 

Reports the Natural Key fields for the Course resource.
M
externalEducationOrganziationReference

The identifier assigned to an education organization.

O
studentAcademicRecordReference   A reference to the related Student Academic Record resource. 

Reports the Natural Key fields for the Student Academic Record resource.
M
alternativeCourseCode
The local code assigned by the school that identifies the course offering, the code from an external educational organization, or other alternate course code.

Report the Course Number from the transcript record.
O Student Information> General> Transcripts> Course Number

transcriptCourse.courseNumber
alternativeCourseTitle  

The descriptive name given to a course of study offered in the school, if different from the CourseTitle.


Report the Course Name from the transcript record.

OStudent Information> General> Transcripts> Course Name

transcriptCourse.courseName
 attemptedCreditConversion  Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units. 

This is optional, does not report.
O
 attemptedCredits  The number of credits attempted for a course. 

Report the sum of credits from the Attempted field on the Transcript record being reported.
OStudent Information> General> Transcripts> Attempted

transcriptCredit.creditsAttempted
attemptedCreditTypeDescriptor 

The type of credits or units of value attempted for the completion of a course.


This is optional, does not report.

O
courseRepeatCodeDescriptor  Indicates that an academic course has been repeated by a student and how that repeat is to be computed in the student's academic grade average. 

This is optional, does not report.
O
 CourseTitle Reports the name of the course completed.

Report the Course Name from the transcript record.
OStudent Information> General> Transcripts> Course Name

transcriptCourse.courseName
 earnedadditionalCredits  An unordered collection of courseTranscriptAdditionalCredits. This entity is the final record of a student's performance in their courses at the end of a semester or school year.

This is optional, does not report.
O
 earnedCreditConversion  Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units. 

This is optional, does not report.
O
 earnedCredits  The number of credits awarded or earned for the course. 

Report the sum of credits from the Earned field on the Transcript record being reported.
MStudent Information> General> Transcripts> Earned

transcriptCredit.creditsAttempted
 earnedCreditTypeDescriptor The type of credits or units of value awarded for the completion of a course.

This is optional, does not report.
O
 finalLetterGradeEarned The final letter grade earned for the course. 

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 Final Number Grade Earned field below.
OStudent Information> General> Transcripts> Current Score

transcriptCourse.score
 finalNumericGradeEarned The final numeric grade earned for the course. 

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 Final Letter Grade Earned field above.
OStudent Information> General> Transcripts> Current Score

transcriptCourse.score
methodCreditEarnedType The method the credits were earned, for example: Classroom, Examination, Transfer. 

This is optional, does not report.
O
whenTakengradeLevelDescriptor  Student's grade level at time of course. 

If the grade selected on the transcript record matches a valid Ed-Fi code, report the grade.
  • When no matching grade found with a grade level mapping, do not report this property.
MStudent Info> General> Transcript> Transcript Course Editor> Grade


Type/Descriptor

Click here to expand...

Course Attempt Result Descriptor

Code ValueDescriptionNamespaceShort Description
PassPassuri://ed-fi.org/CourseAttemptResultDescriptorPass
IncompleteIncompleteuri://ed-fi.org/CourseAttemptResultDescriptorIncomplete
FailFailuri://ed-fi.org/CourseAttemptResultDescriptorFail
WithdrawnWithdrawnuri://ed-fi.org/CourseAttemptResultDescriptorWithdrawn
AuditedAuditeduri://ed-fi.org/CourseAttemptResultDescriptorAudited