Поделиться через


Тип ресурса educationAssignment

Пространство имен: microsoft.graph

Представляет задачу или единицу работы, назначенную учащемуся или участнику команды в классе в рамках его исследования.

Задания содержат раздаточные материалы и задачи, над которыми преподаватель хочет, чтобы учащийся работал. Каждое задание учащегося имеет связанную отправку , которая содержит любую работу, которую преподаватель попросил о сдаче. Создавать задания могут только преподаватели или владельцы команд. Преподаватель может добавить оценки и отзывы в отправку , поданную учащимся.

При создании назначения оно находится в состоянии черновика. Учащиеся не видят задание, и отправок не создаются. Состояние назначения можно изменить с помощью действия публикации . Вы не можете использовать запрос PATCH для изменения состояния назначения .

API-интерфейсы назначения предоставляются в пространстве имен класса.

Наследует от сущности.

Методы

Метод Возвращаемый тип Описание
Создание ресурса задания educationAssignmentResource Создайте новый объект educationAssignmentResource , опубликовав его в коллекции ресурсов.
Получение задания educationAssignment Чтение свойств и связей объекта educationAssignment .
Обновление educationAssignment Обновление объекта educationAssignment .
удаление; Нет Удаление объекта educationAssignment .
публикация; educationAssignment Измените состояние объекта educationAssignment с черновика на опубликовано.
Настройка папки ресурсов назначения string Создайте папку SharePoint (в предопределенном расположении) для отправки файлов в качестве ресурсов назначения.
Настройка папки ресурсов обратной связи о назначении educationAssignment Создайте папку SharePoint для отправки файлов отзывов для данного educationSubmission.
Вывод списка ресурсов Коллекция educationAssignmentResource Получение коллекции объектов educationAssignmentResource .
Вывод списка отправленных данных educationSubmission collection Получение коллекции объектов educationSubmission .
Перечисление категорий Коллекция educationCategory Получение коллекции объектов educationCategory .
Добавление категорий educationCategory Назначьте этому заданию категорию educationCategory , принадлежащую классу.
Удаление категории Нет Удалите из этого задания объект educationCategory , принадлежащий классу.
Прикрепление рубрики Нет Прикрепите к этому заданию существующую educationRubric .
Удаление рубрики Нет Отсоедините educationRubric от этого назначения.
Получение дельты Коллекция educationAssignment Получение списка вновь созданных или обновленных объектов educationAssignment без необходимости полного считывания коллекции.
Добавление educationGradingCategory educationGradingCategory Добавьте educationGradingCategory в коллекцию educationGradingCategory .
Удаление educationGradingCategory Нет Удалите объект educationGradingCategory из коллекции educationGradingCategory .
Активация назначения educationAssignment inactive Активируйте educationAssignment, чтобы сообщить о том, что задание содержит дополнительные элементы действий для преподавателей или учащихся.
Деактивация назначения educationAssignment Пометьте assignededucationAssignment как inactive сигнал о том, что задание не содержит элементов дальнейших действий для преподавателей и учащихся.

Свойства

Свойство Тип Описание
addedStudentAction String Необязательное поле для управления поведением заданий для учащихся, которые добавляются после публикации задания . Если значение не указано, по умолчанию используется значение none. Поддерживаемые значения: none, assignIfOpen. Например, преподаватель может использовать assignIfOpen , чтобы указать, что задание должно быть назначено любому новому учащемуся, который присоединяется к классу, пока задание еще открыто, и none чтобы указать, что задание не должно быть назначено новым учащимся.
addToCalendarAction educationAddToCalendarOptions Необязательное поле для управления поведением заданий для добавления заданий в календари учащихся и преподавателей при публикации задания . Возможные значения: none, studentsAndPublisher, studentsAndTeamOwners, unknownFutureValueи studentsOnly. Чтобы получить следующие значения в этой развиваемой перечислении, необходимо использовать Prefer: include-unknown-enum-members заголовок запроса: studentsOnly. Значение по умолчанию — none.
allowLateSubmissions Логический Определяет, могут ли учащиеся отправлять заявки после истечения срока выполнения. Если это свойство не указано во время создания, по умолчанию оно имеет значение true.
allowStudentsToAddResourcesToSubmission Логический Определяет, могут ли учащиеся добавлять собственные ресурсы в отправку или могут ли они изменять только ресурсы, добавленные преподавателем.
assignDateTime DateTimeOffset Дата, когда назначение должно стать активным. Если в будущем задание не отображается учащемуся до этой даты. Тип Timestamp представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
assignTo educationAssignmentRecipient Какие пользователи или весь класс должны получать объект отправки после публикации назначения .
assignedDateTime DateTimeOffset Момент публикации задания учащимся и его выполнение отображается на временной шкале учащихся. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
classId String Класс, которому принадлежит это назначение .
closeDateTime DateTimeOffset Дата закрытия назначения для отправки. Это необязательное поле, которое может иметь значение NULL, если назначение не разрешаетLateSubmissions или значение closeDateTime совпадает с dueDateTime. Но если указано значение, значение closeDateTime должно быть больше или равно dueDateTime. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
createdBy identitySet Кто создал назначение.
createdDateTime DateTimeOffset Момент создания назначения . Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
displayName String Имя назначения.
dueDateTime DateTimeOffset Дата окончания срока выполнения задания учащихся. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
feedbackResourcesFolderUrl String URL-адрес папки, где хранятся все ресурсы файла отзывов для этого назначения .
сортировка educationAssignmentGradeType Как будет оцениваться задание .
id String Уникальный идентификатор назначения. Наследуется от сущности. Только для чтения.
резолюция itemBody Инструкции по назначению. Инструкции и отображаемое имя сообщают учащемуся, что делать.
lastModifiedBy identitySet Кто в последний раз изменял назначение.
lastModifiedDateTime DateTimeOffset Дата и время изменения назначения . Отправка учащегося не изменяет задание; Только преподаватели могут обновлять задания. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
moduleUrl string URL-адрес модуля, из которого требуется получить доступ к назначению.
notificationChannelUrl String Необязательное поле для указания URL-адреса канала для отправки уведомления о публикации назначения . Если значение не указано или значение NULL, по умолчанию используется General канал. Это поле применяется только к назначениям, где значением assignTo является educationAssignmentClassRecipient. Обновление notificationChannelUrl запрещено после публикации назначения.
resourcesFolderUrl string URL-адрес папки, где хранятся все файловые ресурсы для этого назначения .
status educationAssignmentStatus Состояние назначения. Вы не можете установить исправление этого значения. Возможные значения: draft, scheduled, published, assigned, unknownFutureValue, inactive. Обратите внимание, что необходимо использовать Prefer: include-unknown-enum-members заголовок запроса, чтобы получить следующие значения в этом развиваемом перечислении: inactive.
webUrl string URL-адрес прямой ссылки для заданного назначения.

Связи

Связь Тип Описание
categories Коллекция educationCategory Если этот параметр задан, пользователи могут легко находить назначения заданного типа. Только для чтения. Допускается значение null.
resources Коллекция educationAssignmentResource Объекты обучения, связанные с этим назначением. Изменить этот список могут только преподаватели. Допускается значение null.
рубрика educationRubric Если задано значение , то к этому заданию прилагается рубрика оценки.
Представлений educationSubmission collection После публикации для каждого учащегося появится объект отправки , представляющий его работу и оценку. Только для чтения. Допускается значение null.
gradingCategory Коллекция educationGradingCategory Если задано значение , пользователи могут по-разному весить назначения при вычислении среднего класса.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "addedStudentAction": "String",
  "addToCalendarAction": "String",  
  "allowLateSubmissions": "Boolean",
  "allowStudentsToAddResourcesToSubmission": "Boolean",
  "assignDateTime": "String (timestamp)",
  "assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
  "assignedDateTime": "String (timestamp)",
  "classId": "String",
  "closeDateTime": "String (timestamp)",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "dueDateTime": "String (timestamp)",
  "feedbackResourcesFolderUrl": "String",
  "grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
  "id": "String (identifier)",
  "instructions": {"@odata.type": "microsoft.graph.itemBody"},
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "moduleUrl": "String",
  "notificationChannelUrl": "String",
  "resourcesFolderUrl": "String",
  "status": "String",  
  "webUrl": "String"
}