Status, Übergänge und Einschränkungen für Übermittlungen in Microsoft Graph
Einreichungen sind ein wichtiger Teil der Interaktion zwischen den Aktionen von Lehrern und Schülern. Dies bezieht sich auf Änderungen an der Übermittlung status während des Prozessablaufs und die beteiligten Bildungs-APIs in Microsoft Graph.
Übermittlungs-status und Übergänge
Eine Übermittlung stellt die Ressourcen dar, die eine Einzelperson oder Gruppe für eine Zuweisung eingibt. Übermittlungen gehören einer Aufgabe und werden automatisch erstellt, wenn eine Aufgabe veröffentlicht wird.
Die status ist eine schreibgeschützte Eigenschaft in der Übermittlung. Es ändert sich basierend auf den Aktionen von Schülern und Lehrern.
Status | Beschreibung | REST-API-Aufruf |
---|---|---|
Arbeiten | Anfänglicher status, nachdem die Übermittlung erstellt wurde. | POST /education/classes/{id}/assignments POST /education/classes/{id}/assignments/{id}/submissions/{id}/unsubmit |
Übermittelt | Die status, nachdem der Kursteilnehmer die Aufgabe eingewechselt hat. | POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit |
Zurückgegeben | Die status, nachdem der Lehrer eine Aufgabe an den Schüler zurückgegeben hat. | POST /education/classes/{id}/assignments/{id}/submissions/{id}/return |
Zugewiesen | Die status, nachdem der Lehrer die Aufgabe zur Überarbeitung an den Schüler zurückgegeben hat. | POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign |
Entschuldigung | Lehrer können eine Übermittlung als entschuldigt markieren, um anzugeben, dass die Übermittlung keine weiteren Aktionen für den Schüler hat. | POST /education/classes/{id}/assignments/{id}/submissions/{id}/excuse |
Das folgende Diagramm zeigt den status Übergangsfluss.
Übermittlung status Übergänge basierend auf zulässigen Aktionen
Aktuelle status | Neue Aktion | Neue status |
---|---|---|
Arbeiten | Geben Sie ein | Übermittelt |
Arbeiten | Zur Revision zurückkehren | Zugewiesen |
Arbeiten | Return | Zurückgegeben |
Arbeiten | Entschuldigung | Entschuldigt |
Übermittelt | Rückgängig machen | Arbeiten |
Übermittelt | Return | Zurückgegeben |
Übermittelt | Zur Revision zurückkehren | Zugewiesen |
Übermittelt | Entschuldigung | Entschuldigt |
Zurückgegeben | Geben Sie ein | Übermittelt |
Zurückgegeben | Return | Zurückgegeben |
Zurückgegeben | Zur Revision zurückkehren | Zugewiesen |
Zurückgegeben | Entschuldigung | Entschuldigt |
Zugewiesen | Geben Sie ein | Übermittelt |
Zugewiesen | Return | Zurückgegeben |
Zugewiesen | Zur Revision zurückkehren | Zugewiesen |
Zugewiesen | Entschuldigung | Entschuldigt |
Entschuldigt | Zur Revision zurückkehren | Zugewiesen |
Entschuldigt | Return | Zurückgegeben |
Entschuldigt | Geben Sie ein | Übermittelt |
Hinweis
Alle Aktionen und status Übergang, die nicht in der Tabelle aufgeführt sind, sind nicht zulässig.
Synchronisierung im Vergleich zu asynchronen Vorgängen über Übermittlungs-API-Aufrufe
In der folgenden Tabelle sind die API-Aufrufe aufgeführt, die sich auf die Übermittlung status und den Vorgangstyp auswirken.
In diesem Fall sind alle Aufrufe asynchron, d. h. der Vorgang wird gestartet, und ein anderer Vorgang kann beginnen, bevor der erste abgeschlossen ist. Der asynchrone Vorgang führt eine Hintergrundaktivität aus, und der Aufrufer muss abfragen, um das Ergebnis zu erhalten.
API | Synchronisieren oder asynchron | Mechanismus zum Abrufen der neuesten status |
---|---|---|
POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit |
Async | Umfrage |
POST /education/classes/{id}/assignments/{id}/submissions/{id}/unsubmit |
Async | Umfrage |
POST /education/classes/{id}/assignments/{id}/submissions/{id}/return |
Async | Umfrage |
POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign |
Async | Umfrage |
POST /education/classes/{id}/assignments/{id}/submissions/{id}/excuse |
Async | Umfrage |
Einschränkungen
Die folgenden Grenzwerte gelten für alle API-Aufrufe:
- Die maximale Anzahl von Übermittlungsressourcen beträgt 10 für den Kursteilnehmer.
- Die maximal zulässige Größe für Ressourcen beträgt 500 MB.
- Es gelten Drosselungsgrenzwerte; Weitere Informationen finden Sie unter Microsoft Graph-Drosselungsleitfaden.