Share via

Состояния, переходы и ограничения для отправки в Microsoft Graph

  • Статья

Представления являются важной частью взаимодействия между действиями преподавателей и учащихся. Это связано с изменениями в состоянии отправки во время потока процесса и с тем, какие API образования используются в Microsoft Graph.

Состояния отправки и переходы

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

Состояние — это свойство, доступное только для чтения в отправке. Он меняется в зависимости от действий учащихся и преподавателей.

Состояние Описание Вызов REST API
Выполняется Начальное состояние после создания отправки. POST /education/classes/{id}/assignments
POST /education/classes/{id}/assignments/{id}/submissions/{id}/unsubmit
Submitted Состояние после того, как учащийся выполняет задание. POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit
Возвращены Состояние после того, как учитель вернул задание учащемуся. POST /education/classes/{id}/assignments/{id}/submissions/{id}/return
Переназначить Состояние после того, как учитель вернул задание учащемуся для пересмотра. POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign
Оправдание Преподаватели могут пометить отправку как оправданную, чтобы указать, что отправка не имеет дальнейших действий для учащегося. POST /education/classes/{id}/assignments/{id}/submissions/{id}/excuse

На следующей схеме показан поток перехода состояния.

Схема переходов состояний отправки

Переходы состояния отправки на основе разрешенных действий

Текущее состояние отправки Новое действие Новое состояние
Выполняется Включай Submitted
Выполняется Возврат для редакции Переназначить
Выполняется Возврат Возвращены
Выполняется Оправдание Освобожден
Submitted Отмена поворота Выполняется
Submitted Возврат Возвращены
Submitted Возврат для редакции Переназначить
Submitted Оправдание Освобожден
Возвращены Включай Submitted
Возвращены Возврат Возвращены
Возвращены Возврат для редакции Переназначить
Возвращены Оправдание Освобожден
Переназначить Включай Submitted
Переназначить Возврат Возвращены
Переназначить Возврат для редакции Переназначить
Переназначить Оправдание Освобожден
Освобожден Возврат для редакции Переназначить
Освобожден Возврат Возвращены
Освобожден Включай Submitted

Примечание.

Любые действия и переход состояния, не перечисленные в таблице, не допускаются.

Синхронизация и асинхронные операции с вызовами API отправки

В следующей таблице перечислены вызовы API, влияющие на состояние отправки и тип операции.

В этом случае все вызовы являются асинхронными, что означает, что операция запускается, а другая операция может начаться до завершения первой. Асинхронная операция выполняет некоторое фоновое действие, и вызывающий объект должен опрашивать, чтобы получить результат.

API Синхронизация или асинхронная синхронизация Механизм получения последнего состояния
POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit Async Опрос
POST /education/classes/{id}/assignments/{id}/submissions/{id}/unsubmit Async Опрос
POST /education/classes/{id}/assignments/{id}/submissions/{id}/return Async Опрос
POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign Async Опрос
POST /education/classes/{id}/assignments/{id}/submissions/{id}/excuse Async Опрос

Ограничения

Следующие ограничения применяются ко всем вызовам API:

  • Максимальное количество ресурсов для отправки составляет 10 для учащегося.
  • Максимальный размер ресурсов — 500 МБ.
  • Применяются ограничения регулирования; Дополнительные сведения см. в руководстве по регулированию Microsoft Graph.

Связанные материалы