Freigeben über

Status, Übergänge und Einschränkungen für Zuweisungen in Microsoft Graph

  • Artikel

Aufgaben sind ein wichtiger Teil der Interaktion zwischen Lehrern und Den Handlungen der Schüler. In diesem Artikel werden die Änderungen an der Zuweisung status während des Prozessablaufs und die beteiligten Bildungs-APIs in Microsoft Graph beschrieben.

Zuweisungs-status und Übergänge

Eine Aufgabe stellt eine Aufgabe oder Arbeitseinheit dar, die einem Kursteilnehmer oder Teammitglied in einem Kurs im Rahmen des Studiums zugewiesen ist. Nur Lehrkräfte oder Teambesitzer können Aufgaben erstellen, kopieren oder planen. Diese Aktionen wirken sich auf die Zuweisung status aus. In der folgenden Tabelle sind die Zuweisungs-status und die APIs aufgeführt, die zum Ändern der status verfügbar sind.

Status Beschreibung REST-API-Aufruf Features, die bearbeitet werden können
Entwurf Anfängliche status, wenn eine neue Zuweisung erstellt oder aus einer vorhandenen Zuordnung kopiert wird. POST /education/classes/{id}/assignments Ressourcen, Kategorien, Rubriken
Veröffentlicht Eine Hintergrundverarbeitung status, wenn die Aufgabe an jeden zugewiesenen Kursteilnehmer verteilt wird. POST /education/classes/{id}/assignments/{id}/publish
Geplant Status, zu dem der Lehrer die Aufgabe geplant hat, die zu einem späteren Zeitpunkt veröffentlicht werden soll. PATCH /education/classes/{id}/assignments/{id}
POST /education/classes/{id}/assignments/{id}/publish		 Ressourcen, Kategorien, Rubriken
Zugewiesen Nach Abschluss des Veröffentlichungsprozesses wird die Aufgabe in eine zugewiesene status verschoben, wird für die Kursteilnehmer verfügbar, oder sie verbleibt in einem aktiven status. POST /education/classes/{id}/assignments/{id}/publish
POST /education/classes/{id}/assignments/{id}/activate		 Übermittlungen
Ausstehend Die Hintergrundverarbeitung status, wenn eine neue Zuweisung aus einer vorhandenen kopiert wird. PATCH /education/classes/{id}/assignments/{id}
Inaktiv Die Aufgabe enthält keine zusätzlichen Aktionselemente für Lehrer und Schüler. POST /education/classes/{id}/assignments/{id}/deactivate

Das folgende Diagramm zeigt die status Übergänge, die für Zuweisungen auftreten können.

Diagramm zu Zuweisungs- status Übergängen

So überprüfen Sie, ob eine Zuweisung veröffentlicht wird

Der Aufrufer muss den GET-Zuweisungsvorgang verwenden, um die aktuelle Zuweisung status zu überprüfen und zu überprüfen, ob der Veröffentlichungsprozess erfolgreich war.

Zuweisung status Übergänge basierend auf den zulässigen Aktionen

Aktuelle status Neue Aktion Neue status
Entwurf Der Lehrer plant die Aufgabe Geplant
Entwurf Veröffentlichen Veröffentlicht
Entwurf Bearbeitet Entwurf
Entwurf Verworfen
Veröffentlicht Veröffentlichung abgeschlossen Zugewiesen
Veröffentlicht Fehler beim Veröffentlichen Entwurf
Veröffentlicht Verworfen
Geplant Fälligkeitsdatum erreichen Veröffentlicht
Geplant Zeitplan abbrechen Entwurf
Geplant Verschieben Geplant
Zugewiesen Verworfen
Zugewiesen Deaktiviert Inaktiv
Ausstehend Kopieren abgeschlossen Entwurf
Ausstehend Verworfen
Inaktiv Aktiviert Zugewiesen

Hinweis

Nur Aktionen und status in der Tabelle aufgeführten Übergänge sind zulässig.

Synchronisierung im Vergleich zu asynchronen Vorgängen über Zuweisungs-API-Aufrufe

In der folgenden Tabelle sind die API-Aufrufe aufgeführt, die sich auf die Zuweisung status und den Vorgangstyp auswirken.

Synchrone Vorgänge werden einzeln ausgeführt. Jeder Vorgang muss abgeschlossen werden, bevor der nächste beginnen kann, und das Endergebnis wird erst zurückgegeben, wenn alle Vorgänge abgeschlossen sind. Asynchrone Vorgänge ermöglichen die gleichzeitige Ausführung mehrerer Tasks. Während ein Vorgang ausgeführt wird, kann ein anderer Vorgang gestartet werden, bevor der vorherige Vorgang abgeschlossen ist. Asynchrone Vorgänge umfassen in der Regel Hintergrundaktivitäten, und der Aufrufer muss aktiv nach dem Ergebnis suchen, indem er abruft oder überwacht, bis es verfügbar ist.

API Synchronisieren oder asynchron Mechanismus zum Abrufen der neuesten status
DELETE /education/classes/{id}/assignments/{id} Async Umfrage
POST /education/classes/{id}/assignments/{id}/publish Async Umfrage
PATCH /education/classes/{id}/assignments/{id} Async Umfrage
POST /education/classes/{id}/assignments Async Umfrage
POST /education/classes/{id}/assignments/{id}/deactivate Async Umfrage
POST /education/classes/{id}/assignments/{id}/activate Async Umfrage

Einschränkungen

Die folgenden Grenzwerte gelten für alle API-Aufrufe:

  • Die maximale Anzahl von Aufgabenressourcen beträgt 10 für den Lehrer.
  • Die maximal zulässige Größe für Ressourcen beträgt 500 MB.
  • Es gelten Drosselungsgrenzwerte; Weitere Informationen finden Sie unter Microsoft Graph-Drosselungsleitfaden.

Verwandte Inhalte