Student Academic Records (New Mexico v3.5)

Tool Search: Ed-Fi

This educational entity represents the cumulative record of academic achievement for a student.

Object Triggering Logic

This table describes logic for triggering syncing of this object.

Action	Trigger
Post	Report a Student Academic Record instance when a student's primary enrollment is ended OR a Diploma Date is entered within the config year and they have a Student School Association record for the configured year. If reporting from an ended enrollment, only report if the ExitWithdrawType Descriptor in Student School Association reports "G". Note: This should only happen when the enrollment end status is 'WG'. Only post for the records in the Student Academic Record (SAR) and configured year the Diploma Date/Enrollment End Date is associated.
Put	Diploma Type field changes.
Delete	If the Diploma date and/or Diploma Type fields are made NULL.
Delete	If a Graduation record is deleted.
Delete	If the Diploma Date is changed to no longer occur in the configured year.
Delete	If there is no Diploma Date and the enrollment end status is changed to a non-graduated status.

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	Trigger
None	If a resource is toggled to 'OFF' after data has sent, all sent data will remain in the ODS but no new data will send.
Delete	If 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.
Resync	If 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.
Resync	If 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.
Resync	If 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.

Action	Trigger
Delete/Post	If any part of the Natural Key Changes If the District Number changes all data will remain under the old number. The delete tool would need to be used to remove all old data.
Delete/Post	If an Ed-Fi ID changes, this will happen with the cascading deletes from the Ed-Fi ID Change trigger.
Delete/Post	If the End Year the transcript record or diploma record is aligned to changes.
Delete/Post	If the Term Descriptor is changed in Sessions Resource Preferences or if the Transcript Term Override is changed in Student Academic Record Resource Preferences.
Delete/Post	If the Diploma Date changes.
Delete/Post	If the natural key changes all dependent resources will delete/post.
Dependent Resources	Course Transcripts

Scope Year Logic

This table describes scope year logic of this object.

Logic
Records will send to each scope year in which the Course Transcript record is posted.
Records will only post to the SAR records for the year the diploma date occurs in but SAR records will post to all scoped years. The Diploma Date must be on or after the school year's start date and on or before the school year's end date defined in the School Years editor. If blank, the default start date of 7/1/xxxx and end date of 6/30/xxxx are used.
Data will only send for years that have a valid configuration.

Logic

Records will send to each scope year in which the Course Transcript record is posted.

Records will only post to the SAR records for the year the diploma date occurs in but SAR records will post to all scoped years.

The Diploma Date must be on or after the school year's start date and on or before the school year's end date defined in the School Years editor. If blank, the default start date of 7/1/xxxx and end date of 6/30/xxxx are used.

Data will only send for years that have a valid configuration.

Resource Preferences

This table describes the Resource Preferences of this object.

Data Element Label	Mapping Needed
Diploma Type Descriptors	Graduation Diploma Type

Identity Mapping Object Key

This table describes the Resource Preferences of this object.

Campus Object Type	Object Key Data Source
TranscriptCourse	transcriptID
Graduation	graduationID

Event Queue Detail

This table describes the Event Queue Detail of this object.

Campus Table	Ed-Fi Action	Fields
transcriptcourse	Post/Put/Delete	The primary table used for sending data for this resource.
graduation	Post/Put/Delete	The primary table used for sending data for this resource.
transcriptcredit	Put	cumulativeAttemptedCredits, cumulativeEarnedCredits, sessionAttemptedCredits, sessionEarnedCredits

Object Data Elements

This table describes data elements sent within the Student Academic Records resource.

Data Element Label	Business Requirement	Business Rules	M, C or O	Data Source GUI Path	Database Field
id	The unique identifier of the resource.		M
termDescriptor	The term for the session during the school year.	When reporting Transcript records with an end year that is equal to the configured year and are posted from a course and have a scoreID: Report the mapped Ed-Fi code for the value selected in "Ed-Fi Transcript Term Override" field on the transcript. If Ed-Fi Transcript Term Override is NULL, report the mapped Term Descriptor based on the Course Ed-Fi Term Descriptor Override, else Section Ed-Fi Term Descriptor Override. When the Ed-Fi Transcript Term Override field and the Ed-Fi Term Descriptor Override on both the Course Term and the Section Term Override fields are Null, report the Term Descriptor for the term aligned to the Grading Score for the posted Grade Else, report the Ed-Fi Code from the Ed-Fi Transcript Term Descriptor Override in the SAR preferences. If a Term cannot be determined, provide error When reporting Transcript records with an end year that is not equal to the configured year and are posted from a course and have a scoreID: Report the mapped Ed-Fi code for the value selected in "Ed-Fi Transcript Term Override" field on the transcript. If the Ed-Fi Transcript Term Override field is NULL, look at the sequence from the term the score ID is aligned to in the year the record was posted. Then report the Term Descriptor from the term with the same sequence in the configured year in the same school. Use Primary Term schedule if there is more than 1 Term Schedule. If more than 1 primary Term Schedule, pick the highest TermID Else, report the Ed-Fi Code from the Ed-Fi Transcript Term Descriptor Override in the SAR preferences. If a Term cannot be determined, provide error When reporting Transcript records that are manually added without a scoreID: Report the Ed-Fi Term Descriptor Override selected on the transcript record. Else, report the Ed-Fi Code from the Ed-Fi Transcript Term Descriptor Override in the SAR preferences If a Term cannot be determined, provide error When the SAR is posted only from the Graduation Record because there are no Course Transcripts records for the student, report the Ed-Fi Term Descriptor from the Sessions Resource Preferences that the Diploma Date overlaps in the School where the student is enrolled If the Term is not mapped or the diploma date does not overlap a term, use the term descriptor from the term with the latest end date If more than 1 term schedule, report from the Primary term schedule If the Diploma Date is aligned to more than 1 eligibile Term Descriptor, report the value from the highest TermId	M
educationOrganization Reference	A reference to the related Education Organization resource.	Reports from the Ed-Fi District Number.	M
schoolYearType Reference	A reference to the related SchoolYearType resource.	Reports the end year for the enrollment record being reported. Reports the end year the Diploma Date is aligned to.	M
studentReference	A reference to the related Student resource.	Reports the fields that are part of the Natural Key for the Student resource.	M
academicHonors	An unordered collection of studentAcademicRecordAcademicHonors. This educational entity represents the cumulative record of academic achievement for a student.	This is optional, does not report.	O
classRanking	This educational entity represents the cumulative record of academic achievement for a student.	This is optional, does not report.	O
cumulativeEarned CreditConversion	Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units.	This is optional, does not report.	O
cumulativeAttempted Credits	The cumulative number of credits an individual earns by completing courses or examinations during his or her enrollment in the current school as well as those credits transferred from schools in which the individual had been previously enrolled.	Sum the total number of credits the student has attempted based on the total number of Credits Attempted the student has in the Transcript Credit table. Report '0' if the student does not have any Attempted Credits Earned. This value will be the same for all Student Academic Records that are being updated, regardless of Term Type or Year. If the student does not have any Course Transcript records and is only reporting from Graduation, this field will be NULL.	O	Student Information> General> Transcripts	Calculated value from the attempted credit field in the transcriptcredit table
cumulativeAttempted CreditTypeDescriptor	The type of credits or units of value awarded for the completion of a course.	This is optional, does not report.	O
cumulativeAttempted CreditConversion	Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units.	This is optional, does not report.	O
cumulativeEarned Credits	The cumulative number of credits an individual earns by completing courses or examinations during his or her enrollment in the current school as well as those credits transferred from schools in which the individual had been previously enrolled.	Sum the total number of credits the student has earned based on the total number of Credits Earned the student has in the Transcript Credit table. Report '0' if the student does not have any Credits Earned. This value will be the same for all Student Academic Records that are being updated, regardless of Term Type or Year. If the student does not have any Course Transcript records and is only reporting from Graduation, this field will be NULL.	O	Student Information> General> Transcripts	Calculated value from the earned credit field in the transcriptcredit table
cumulativeEarned CreditType Descriptor	The type of credits or units of value awarded for the completion of a course.	This is optional, does not report.	O
cumulativeGradePoint Average	A measure of average performance in all courses taken by an individual during his or her school career as determined for record-keeping purposes. This is obtained by dividing the total grade points received by the total number of credits attempted. This usually includes grade points received and credits attempted in his or her current school as well as those transferred from schools in which the individual was previously enrolled.	Reports the student's Cumulative GPA This will report the same value on all eligible Student Academic Records that are eligible to report for the student for any year that has a valid configuration.	O	Student Information > General > Credit Summary	v_CumGPA.cumGPA
cumulativeGrade PointsEarned	The cumulative number of grade points an individual earns by successfully completing courses or examinations during his or her enrollment in the current school as well as those transferred from schools in which the individual had been previously enrolled.	This is optional, does not report.	O
diplomas	An unordered collection of studentAcademicRecordDiplomas. This educational entity represents the cumulative record of academic achievement for a student.	Report based on the array section below.	O
gradeValueQualifier	The scale of equivalents, if applicable, for grades awarded as indicators of performance in schoolwork. For example, numerical equivalents for letter grades used in determining a student's Grade Point Average (A=4, B=3, C=2, D=1 in a four-point system) or letter equivalents for percentage grades (90-100%=A, 80-90%=B, etc.).	This is optional, does not report.	O
projectedGraduation Date	The month and year the student is projected to graduate.	This is optional, does not report.	O
recognitions	An unordered collection of studentAcademicRecordRecognitions. This educational entity represents the cumulative record of academic achievement for a student.	This is optional, does not report.	O
reportCards	An unordered collection of studentAcademicRecordReportCards. This educational entity represents the cumulative record of academic achievement for a student.	This is optional, does not report.	O
sessionAttempted CreditConversion	Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units.	This is optional, does not report.	O
sessionAttempted Credits	The number of an credits an individual attempted to earn in this session.	Sum the total number of credits the student has attempted in the reporting session based on the total number of Credits Attempted the student has in the Transcript Credit table. Sum the transcript records that are in the same end year and are aligned to the same Term Descriptor as the Student Academic Record. Report '0' if the student does not have any Credits Earned. If the student does not have any Course Transcript records and is only reporting from Graduation, this field will be NULL.	O	Student Information> General> Transcripts	Calculated value from the attempted credit field in the transcriptcredit table
sessionAttemptedCredit TypeDescriptor	Key for Credit.	This is optional, does not report.	O
sessionEarnedCredit Conversion	Conversion factor that when multiplied by the number of credits is equivalent to Carnegie units.	This is optional, does not report.	O
sessionEarnedCredits	The number of an credits an individual earned in this session.	Sum the total number of credits the student has earned in the reporting session based on the total number of Credits Earned the student has in the Transcript Credit table. Sum the transcript records that are in the same end year that are aligned to the same Term Descriptor as the Student Academic Record. Report '0' if the student does not have any Credits Earned. If the student does not have any Course Transcript records and is only reporting from Graduation, this field will be NULL.	O	Student Information> General> Transcripts	Calculated value from the earned credit field in the transcriptcredit table
sessionEarnedCredit TypeDescriptor	Key for Credit.	This is optional, does not report.	O
sessionGradePoints Earned	The number of grade points an individual earned for this session.	This is optional, does not report.	O
sessionGradePoint Average	The grade point average for an individual computed as the grade points earned during the session divided by the number of credits attempted.	This is optional, does not report.	O
etag	A unique system-generated value that identifies the version of the resource.	This is optional, does not report.	O

Arrays

Click here to expand...

Diplomas

Data Element Label	Business Requirement	Business Rules	M, C or O	Data Source GUI Path	Database Field
DiplomaTypeDescriptor	The type of diploma/credential that is awarded to a student in recognition of his/her completion of the curricular requirements.	Report the Ed-Fi Code value for the Diploma Type selected . If Diploma Type is not populated, report EdFi Code '1'.	C	Student Information> General> Graduation> Diploma Type	graduation.diplomaType
diplomaAwardDate	The month, day, and year on which the student met graduation requirements and was awarded a diploma.	Report the Diploma Date if populated. Else, report the enrollment end date.	M	Student Information> General> Graduation > Diplomat Date Student Information > General > Enrollment > Enrollment End Date	graduation.diplomaDate
achievementCategory Descriptor	This descriptor defines the category of achievement attributed to the learner.	Report the Ed-Fi Code from the mapping for this field based on the Diploma Type the student associated.	M	Student Information> General> Graduation	graduation.diplomaType
diplomaLevelDescriptor	The type of diploma/credential that is awarded to a student in recognition of his/her completion of the curricular requirements. Minimum high school program Recommended high school program Distinguished Achievement Program.	This is optional, does not report.	O
achievementCategorySystem	The system that defines the categories by which an achievement is attributed to the learner.	This is optional, does not report.	O
achievementTitle	The title assigned to the achievement.	This is optional, does not report.	O
criteria	The criteria for competency-based completion of the achievement/award.	This is optional, does not report.	O
criteriaURL	The Uniform Resource Locator (URL) for the unique address of a web page describing the competency-based completion criteria for the achievement/award.	This is optional, does not report.	O
cteCompleter	Indicated a student who reached a state-defined threshold of vocational education and who attained a high school diploma or its recognized state equivalent or GED.	This is optional, does not report.	O
diplomaAwardExpiresDate	Date on which the award expires.	This is optional, does not report.	O
diplomaDescription	The description of diploma given to the student for accomplishments.	This is optional, does not report.	O
evidenceStatement	A statement or reference describing the evidence that the learner met the criteria for attainment of the achievement.	This is optional, does not report.	O
imageURL	The Uniform Resource Locator (URL) for the unique address of an image representing an award or badge associated with the achievement.	This is optional, does not report.	O
issuerName	The name of the agent issuing the award.	This is optional, does not report.	O
issuerOriginURL	The Uniform Resource Locator (URL) from which the award was issued.	This is optional, does not report.	O

Type/Descriptor