Make external test assignment
Makes an external test assignment for the given student:
- Applies to ‘test-out’, ‘placement’, and ‘unit-test’ lessons.
This logic changes depending on the provided “toolProvider” value:
- For “edulastic”:
- Authenticates the student with their email on Edulastic
- Assigns the test to the student in Edulastic
- Stores the received “assignmentId” and “classId” in the lesson’s AssessmentResult
- Returns the test link, credentials, and IDs of the test for later results consumption
- For “mastery-track”:
- Authenticates the student with their email on MasteryTrack
- Assigns the test to the student in MasteryTrack (using the testId in the request or subject+grade from the lesson’s Resource metadata)
- Stores the received “assignmentId” in the lesson’s AssessmentResult
- Returns the test link, credentials, and IDs of the test
- Waits for a test result write-back to be performed by the MasteryTrack on test end
Will fail if:
- The lesson is not an external “test-out”, “placement”, or “unit-test”, or the student does not exist
- External tool (described in the resource.metadata.toolProvider) is not “edulastic” or “mastery-track”
- Any other problem on the Edulastic or MasteryTrack API being used that may happen
A ‘Lesson’ in this context is a ComponentResource object which has a Resource object with lessonType = “test-out”, “placement”, or “unit-test” associated with it.
Documentation Index
Fetch the complete documentation index at: https://docs.timeback.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
The sourcedId of the student
The sourcedId of the lesson (ComponentResource)
The name of the application to use for authenticating on the external tool
The specific test ID to assign for MasteryTrack tool provider. If provided, overrides subject+grade selection.
When true, skips automatic course enrollment after test completion. Only applies to the current attempt.
Response
Success
AlphaTest, edulastic, mastery-track test-out, placement, unit-test The attempt number
The credentials for accessing the assigned test on external tool
The id of the assignment on external tool for results retrieval
The id of the class on external tool for results retrieval (may be empty for some tools)
The URL of the test on external tool
The id of the test on external tool (may be assignment ID for some tools)