POST restapi/personal/assignments/{elementId}/assessments/v1

Submits an assessment for one or more students on a specific assignment. This endpoint is only accessible to users with evaluate permission (typically teachers).

Request Information

URI Parameters

Name	Description	Type	Additional information
elementId	The elementId for the assignment, unique within the customer scope.	integer	Required

Body Parameters

The assessment data to submit.

Itsolutions.Itslearning.Web.RestApi.Personal.Element.Requests.SubmitElementAssessmentRequest

Name	Description	Type	Additional information
PersonIds	List of person Ids to submit the assessment for. If the list contains more than one person, the same assessment will be applied to all of them.	Collection of integer	None.
AssessmentItemId	Assessment scale item. Null when no scale is used. Null also means "no change".	integer	None.
AssessmentStatusItemId	Assessment status item. Null when the assignment uses simple statuses. Null also means "no change".	integer	None.
Feedback	Feedback from teacher, can contain HTML. Null to not change existing feedback, empty string to clear existing feedback.	string	None.
Score	Entered score value in case when ElementSettingsResponse.UseScore is true. Null can also mean "no change".	decimal number	None.
TaskStatus	If this is passed, AssessmentStatusItemId will be ignored. Used when the assignment uses simple statuses. Null also means "no change".	Itslearning.RestApi.Entities.TaskStatus	None.

Request Formats

application/json, text/json

Sample:

{
  "PersonIds": [
    1,
    2
  ],
  "AssessmentItemId": 1,
  "AssessmentStatusItemId": 1,
  "Feedback": "sample string 1",
  "Score": 1.1,
  "TaskStatus": "Unknown"
}

application/xml, text/xml

Sample:

<SubmitElementAssessmentRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Itsolutions.Itslearning.Web.RestApi.Personal.Element.Requests">
  <AssessmentItemId>1</AssessmentItemId>
  <AssessmentStatusItemId>1</AssessmentStatusItemId>
  <Feedback>sample string 1</Feedback>
  <PersonIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:int>1</d2p1:int>
    <d2p1:int>2</d2p1:int>
  </PersonIds>
  <Score>1.1</Score>
  <TaskStatus>Unknown</TaskStatus>
</SubmitElementAssessmentRequest>

application/x-www-form-urlencoded

Sample:

No sample available

Response Information

Resource Description

containing the assessment results for each person.

Itsolutions.Itslearning.Web.RestApi.Personal.Element.Responses.SubmitElementAssessmentResponse

Name	Description	Type	Additional information
Results		Collection of Itsolutions.Itslearning.Web.RestApi.Personal.Element.Responses.ElementAssessmentResult	None.

Response Formats

application/json, text/json

Sample:

{
  "Results": [
    {
      "PersonId": 1,
      "AssessmentItemId": 1,
      "AssessmentStatusItemId": 1,
      "IsFeedbackChanged": true,
      "Score": 1.1,
      "TaskStatus": "Unknown"
    },
    {
      "PersonId": 1,
      "AssessmentItemId": 1,
      "AssessmentStatusItemId": 1,
      "IsFeedbackChanged": true,
      "Score": 1.1,
      "TaskStatus": "Unknown"
    }
  ]
}

application/xml, text/xml

Sample:

<SubmitElementAssessmentResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Itsolutions.Itslearning.Web.RestApi.Personal.Element.Responses">
  <Results>
    <ElementAssessmentResult>
      <AssessmentItemId>1</AssessmentItemId>
      <AssessmentStatusItemId>1</AssessmentStatusItemId>
      <IsFeedbackChanged>true</IsFeedbackChanged>
      <PersonId>1</PersonId>
      <Score>1.1</Score>
      <TaskStatus>Unknown</TaskStatus>
    </ElementAssessmentResult>
    <ElementAssessmentResult>
      <AssessmentItemId>1</AssessmentItemId>
      <AssessmentStatusItemId>1</AssessmentStatusItemId>
      <IsFeedbackChanged>true</IsFeedbackChanged>
      <PersonId>1</PersonId>
      <Score>1.1</Score>
      <TaskStatus>Unknown</TaskStatus>
    </ElementAssessmentResult>
  </Results>
</SubmitElementAssessmentResponse>