Microsoft Graph での申請の状態、遷移、制限事項
提出物は、教師と学生の行動の相互作用の重要な部分です。 これは、プロセス フロー中の申請状態の変更と、Microsoft Graph のどの教育 API が関与しているかに関連します。
申請の状態と遷移
申請は、個人またはグループが割り当てのために入れるリソースを表します。 申請は割り当てによって所有され、割り当てが発行されると自動的に作成されます。
状態は、申請の読み取り専用プロパティです。 学生と教師の行動に基づいて変化します。
| 状態 | 説明 | REST API 呼び出し |
|---|---|---|
| Working | 申請の作成後の初期状態。 | POST /education/classes/{id}/assignmentsPOST /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 の調整ガイダンス」を参照してください。