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

Request Information

URI Parameters

NameDescriptionTypeAdditional information
elementId

integer

Required

Body Parameters

Itsolutions.Itslearning.Web.RestApi.Personal.Assignment.Requests.SubmitAssignmentAssessmentRequest
NameDescriptionTypeAdditional 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 means "no change", pass -1 to clear existing score.

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.

FeedbackFiles

A collection of files that are uploaded as part of the assessment, temp files uploaded using the .

Collection of Itsolutions.Itslearning.Web.RestApi.Personal.FileUpload.UploadedTempFile

None.

Request Formats

application/json, text/json

Sample:
{
  "PersonIds": [
    1,
    2
  ],
  "AssessmentItemId": 1,
  "AssessmentStatusItemId": 1,
  "Feedback": "sample string 1",
  "Score": 1.1,
  "TaskStatus": "Unknown",
  "FeedbackFiles": [
    {
      "FileRepoId": "sample string 1",
      "SignedFileRepoId": "sample string 2",
      "Name": "sample string 3",
      "MimeType": "sample string 4",
      "SourceType": 1,
      "IsTemplate": true
    },
    {
      "FileRepoId": "sample string 1",
      "SignedFileRepoId": "sample string 2",
      "Name": "sample string 3",
      "MimeType": "sample string 4",
      "SourceType": 1,
      "IsTemplate": true
    }
  ]
}

application/xml, text/xml

Sample:
<SubmitAssignmentAssessmentRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Itsolutions.Itslearning.Web.RestApi.Personal.Assignment.Requests">
  <AssessmentItemId>1</AssessmentItemId>
  <AssessmentStatusItemId>1</AssessmentStatusItemId>
  <Feedback>sample string 1</Feedback>
  <FeedbackFiles xmlns:d2p1="http://schemas.datacontract.org/2004/07/Itsolutions.Itslearning.Web.RestApi.Personal.FileUpload">
    <d2p1:UploadedTempFile>
      <d2p1:FileRepoId>sample string 1</d2p1:FileRepoId>
      <d2p1:IsTemplate>true</d2p1:IsTemplate>
      <d2p1:MimeType>sample string 4</d2p1:MimeType>
      <d2p1:Name>sample string 3</d2p1:Name>
      <d2p1:SignedFileRepoId>sample string 2</d2p1:SignedFileRepoId>
      <d2p1:SourceType>Dropbox</d2p1:SourceType>
    </d2p1:UploadedTempFile>
    <d2p1:UploadedTempFile>
      <d2p1:FileRepoId>sample string 1</d2p1:FileRepoId>
      <d2p1:IsTemplate>true</d2p1:IsTemplate>
      <d2p1:MimeType>sample string 4</d2p1:MimeType>
      <d2p1:Name>sample string 3</d2p1:Name>
      <d2p1:SignedFileRepoId>sample string 2</d2p1:SignedFileRepoId>
      <d2p1:SourceType>Dropbox</d2p1:SourceType>
    </d2p1:UploadedTempFile>
  </FeedbackFiles>
  <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>
</SubmitAssignmentAssessmentRequest>

application/x-www-form-urlencoded

Sample:
No sample available

Response Information

Resource Description

Itsolutions.Itslearning.Web.RestApi.Personal.Element.Responses.SubmitElementAssessmentResponse
NameDescriptionTypeAdditional information
Results

Collection of Itsolutions.Itslearning.Web.RestApi.Personal.Element.Responses.ElementAssessmentResult

None.

Feedback

Text to be displayed in view content block mode. Video and plugin content is preprocessed.

string

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"
    }
  ],
  "Feedback": "sample string 1"
}

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">
  <Feedback>sample string 1</Feedback>
  <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>