Microsoft Graph 中提交的状态、转换和限制

提交是教师和学生操作之间交互的重要组成部分。 这与流程流期间提交状态的更改以及 Microsoft Graph 中涉及的教育 API 相关。

提交状态和转换

提交表示个人或组为作业提交的资源。 提交归作业所有，并在发布作业时自动创建。

状态是提交中的只读属性。 它根据学生和教师的行为而变化。

状态	说明	REST API 调用
Working	创建提交后的初始状态。	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

下图显示了状态转换流。

基于允许的操作的提交状态转换

当前提交状态	新建操作	新建状态
Working	上交	Submitted
Working	返回修订	分配
Working	Return	返回
Working	借口	原谅
Submitted	撤消 上交	Working
Submitted	Return	返回
Submitted	返回修订	分配
Submitted	借口	原谅
返回	上交	Submitted
返回	Return	返回
返回	返回修订	分配
返回	借口	原谅
分配	上交	Submitted
分配	Return	返回
分配	返回修订	分配
分配	借口	原谅
原谅	返回修订	分配
原谅	Return	返回
原谅	上交	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 MB。
• 限制适用;有关详细信息，请参阅 Microsoft Graph 限制指南。

相关内容

• 工作分配的状态、转换和限制