Skip to main content

engage_AssignmentSubmissionFact View

Purpose

Describes a student's Submission for an Assignment created in a  Learning Management System (LMS)

SQL Object Name

analytics.engage_AssignmentSubmissionFact

Usage Notes

None

Data Definition and Sources

Depends on the lmsx.Assignment and lmsx.AssignmentSubmission tables that are introduced by the LMSX extension from the LMS Toolkit. In theory this table can be populated directly through API calls, if the LMSX extension is called. However, in most cases the data will be loaded using the custom components in the LMS Toolkit. When using the Toolkit, recall the workflow:

  1. Extractors pull data from a source system into CSV files.
  2. The Data Store Loader uploads those CSV files into tables in the lms schema
  3. The Harmonizer synchronizes those records with Sections and Students defined in the core Ed-Fi tables, resulting in records loaded into lmsx.Assignment  and lmsx.AssignmentSubmission.

In the table below, the immediate source is given, along with the source from the LMS Toolkit table / CSV files. For more information on the upstream sources from the LMS, please see the mapping notes documentation: Schoology Mapping NotesGoogle Classroom Mapping notes, and Canvas Mapping Notes.

ColumnData TypeSourceDescription
AssignmentSubmissionKeyvarcharlmx.AssignmentSubmission.AssignmentSubmissionIdentifier



→ When using the LMS Toolkit, this value comes from SourceSystemIdentifier in lms.AssignmentSubmission.
This is the natural key from the source system
AssignmentKeyvarcharlmsx.Assignment.AssignmentIdentifier



→ This is the Assignment's natural key from the source system. When using the LMS Toolkit, this value comes from SourceSystemIdentifier in lms.Assignment.
Unique key for the related assignment (see engage_AssignmentDim View)
SchoolKeyintlmsx.Assignment.SchoolId



→ When using the LMS Toolkit, this value is inferred from the relationship of the SisSectionIdentifier in the lms.LMSSection  table to SectionIdentifier  in the edfi.Section table.
Unique key for the related school
StudentSchoolKeyvarcharConcatenation of edfi.Student.UniqueId and SchoolId from lmsx.Assignment.

* See notes above and below for LMS Toolkit sources
Unique key for a student-in-a-school
StudentKeyvarcharedfi.Student.UniqueId

* When using the LMS Toolkit, this value originally comes from the SISUserIdentifier  value in lms.AssingnmentSubmission.
Unique key for a student
SubmissionDateKeyvarcharlmsx.AssignmentSubmission.SubmissionDateTime formatted as YYYYMMDD

When using the LMS Toolkit, this value comes from SubmissionDateTime  in lms.AssignmentSubmission.
If the assignment is Past Due, then this value will be null.
Date key for joining to the DateDim View.
EarnedPointsintlmsx.AssignmentSubmission.EarnedPoints

When using the LMS Toolkit, this value comes from EarnedPOints  in lms.AssignmentSubmission.
If the assignment is Past Due, then this value will be null.
Number of points earned by the student on the submission
NumericGradeintlmsx.AssignmentSubmission.EarnedPoints / lmsx.Assignment.MaxPoints

When using the LMS Toolkit, see description above for EarnedPoints. The MaxPoints value comes from lms.Assignment.
If the assignment is Past Due, then this value will be null.
The numeric percentage grade
LetterGradevarcharlmsx.AssignmentSubmission.LetterGrade

When using the LMS Toolkit, this value comes from LetterGrade  in lms.AssignmentSubmission.
If the assignment is Past Due, then this value will be null.
The letter grade given on the submission
IsPastDuebool1 if the lmsx.SubmissionStatusDescriptor maps to descriptor constant "SubmissionStatus.IsPastDue", else 0.

* When using the LMS Toolkit, this value is inferred from the SubmissionStatus  in lms.AssignmentSubmission.
Boolean indicating if the submission is past due (missing)
SubmittedLatebool1 if the lmsx.SubmissionStatusDescriptor maps to descriptor constant "SubmissionStatus.SubmittedLate", else 0.

* When using the LMS Toolkit, this value is inferred from the SubmissionStatus  in lms.AssignmentSubmission.
Boolean indicating if the submission was turned in after the due date
SubmittedOnTimebool1 if the lmsx.SubmissionStatusDescriptor maps to descriptor constant "SubmissionStatus.SubmittedOnTime", else 0.

* When using the LMS Toolkit, this value is inferred from the SubmissionStatus  in lms.AssignmentSubmission.
Boolean indicating if the submission was turned in before the due date
LastModifiedDatedatetimelmsx.AssignmentSubmission.LastModifiedDate

* When using the LMS Toolkit, this value comes from LastModifiedDate  in lms.AssignmentSubmission.
The last modified date for the submission