Freigeben über


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.

Diagramm zu Übermittlungs- status Übergängen

Ü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.