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


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

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

Состояние назначения и переходы

Задание представляет собой задачу или единицу работы, назначенную учащемуся или участнику команды в классе в рамках их обучения. Создавать, копировать или планировать задания могут только преподаватели или владельцы команд. Эти действия влияют на состояние назначения. В следующей таблице перечислены состояние назначения и API- интерфейсы, доступные для изменения состояния.

Состояние Описание Вызов REST API Функции, доступные для редактирования
Черновик Начальное состояние при создании или копировании нового назначения из существующего назначения. POST /education/classes/{id}/assignments Ресурсы, категории, рубрики
Published Состояние фоновой обработки, когда задание распространяется на каждого назначенного учащегося. POST /education/classes/{id}/assignments/{id}/publish
Scheduled Состояние, когда преподаватель запланировали публикацию задания в будущем. PATCH /education/classes/{id}/assignments/{id}
POST /education/classes/{id}/assignments/{id}/publish
Ресурсы, категории, рубрики
Назначенное После завершения процесса публикации задание перемещается в назначенное состояние, становится доступным для учащихся или остается в активном состоянии. POST /education/classes/{id}/assignments/{id}/publish
POST /education/classes/{id}/assignments/{id}/activate
Сданные работы
Pending Состояние фоновой обработки при копировании нового назначения из существующего. PATCH /education/classes/{id}/assignments/{id}
Неактивно Задание не содержит дополнительных элементов действий для преподавателей и учащихся. POST /education/classes/{id}/assignments/{id}/deactivate

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

Схема переходов состояния назначения

Проверка публикации назначения

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

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

Текущее состояние назначения Новое действие Новое состояние
Черновик Преподаватель планирует задание Scheduled
Черновик Публикация Published
Черновик Отредактированы Черновик
Черновик Отбрасываются
Published Публикация завершена Назначенное
Published Сбой публикации Черновик
Published Отбрасываются
Scheduled Дата достижения срока выполнения Published
Scheduled Отмена расписания Черновик
Scheduled Перенести Scheduled
Назначенное Отбрасываются
Назначенное Deactivated Неактивно
Pending Копирование завершено Черновик
Pending Отбрасываются
Неактивно Activated Назначенное

Примечание.

Разрешены только действия и переходы состояния, перечисленные в таблице.

Синхронизация и асинхронные операции над вызовами API назначений

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

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

API Синхронизация или асинхронная синхронизация Механизм получения последнего состояния
DELETE /education/classes/{id}/assignments/{id} Async Опрос
POST /education/classes/{id}/assignments/{id}/publish Async Опрос
PATCH /education/classes/{id}/assignments/{id} Async Опрос
POST /education/classes/{id}/assignments Async Опрос
POST /education/classes/{id}/assignments/{id}/deactivate Async Опрос
POST /education/classes/{id}/assignments/{id}/activate Async Опрос

Ограничения

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

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