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

Состояние, переходы и ограничения для отправки в 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.

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

  • Last updated on