Course Transcripts (Texas v4.0)

Tool Search Term: Ed-Fi

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, all valid transcript records for all years will send for the Student.

  • Transcript must have a value in the Pass/Fail Credit indicator drop list.
  • 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 one 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 checkbox is marked.
  • Do not send record if the Calendar Exclude checkbox is marked.
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.
DeleteUser removes value from Pass/Fail Credit drop list.
Delete

All Transcript records will only delete when a student has only one 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

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

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

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

Data Element LabelMapping Needed
Credit Earned/AttemptedCourse Attempt Result Descriptor

Identity Mapping Object Key

Campus Object TypeObject Key Data Source
TranscriptCoursetranscriptID

Event Queue Detail

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 Labels in bold are part of the Natural Key and are required data elements for Data to send to Ed-Fi.

Data Element LabelBusiness RequirementBusiness RulesM, C or O

Location


courseAttempt
ResultDescriptor  
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.


Reports 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 mapped Ed-Fi Code of Pass/Fail Credit.

MStudent Information> General > Transcripts > Credit Info > Pass/Fail Credit
externalEducation
OrganziationReference

The identifier assigned to an education organization.

This is optional, does not report.


O
studentAcademic
RecordReference  
 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.

Reports 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 Course Title.

This is optional, does not report.

O
attemptedCredit
Conversion 
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. 

This is optional, does not report.

O
attemptedCredit
TypeDescriptor 

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

This is optional, does not report.

O
courseRepeat
CodeDescriptor 
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.

Reports the Course Name from the transcript record.

OStudent Information > General > Transcripts > Course Name

transcriptcourse.courseName
earnedadditional
Credits 
 An unordered collection of courseTranscript AdditionalCredits. 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
earnedCredit
Conversion 
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
earnedCredit
TypeDescriptor 
The type of credits or units of value awarded for the completion of a course.

This is optional, does not report.

O
finalLetterGrade Earned  The final letter grade earned for the course. 

This is optional, does not report.

O
finalNumericGradeEarned The final numeric grade earned for the course. 

This is optional, does not report.


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

This is optional, does not report.

O
whenTakengrade
LevelDescriptor 
The student's grade level at the time of the course. 

This is optional, does not report.

O

CollegeCreditHours

The number of college hours a student earned for the completion of a dual credit course.


Reports the field value.
If blank, does not report.

Student must have a grading task with a Pass/Fail Indicator of 01, 04, 05 AND a Score on the transcript in order to report this value.


OCourse/Section > Course > College Credit Hours
DualCreditIndicator

Indicates whether the student was eligible to receive both high school and college credit for a college course.


If Dual Indicator is a No, reports '0'.
If Dual Indicator is Yes reports '1'.
OCourse/Section > Course Editor > Dual Credit Indicator
ATCIndicator

Indicates a high school course for which college credit may be awarded by a post-secondary

institution under the conditions of a local articulation agreement or the statewide Advanced Technical

Credit (ATC) program agreement.


If the ATC Indicator code box is marked, reports '1'.

Otherwise, reports '0'.


OCourse/Section > Course > ATC Indicator Code


Type/Descriptor

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