États, transitions et limitations pour les affectations et les soumissions dans Microsoft Graph

Les devoirs et les soumissions jouent un rôle important dans l’interaction entre les actions des enseignants et des étudiants. Cet article décrit les modifications apportées aux états d’affectation et d’envoi pendant le processus, ainsi que les API d’éducation de Microsoft Graph qui sont impliquées.

États d’affectation et transitions

Un devoir représente une tâche ou une unité de travail attribuée à un étudiant ou aux membres de l’équipe d’une classe dans le cadre de leur étude. Seuls les enseignants ou les propriétaires d’équipe peuvent créer, copier ou planifier des devoirs. Ces actions ont un impact sur les états d’affectation. Le tableau suivant répertorie les états d’affectation et les API disponibles pour modifier l’état.

État	Description	Appel d’API REST	Fonctionnalités disponibles pour la modification
Brouillon	La status initiale lorsqu’une nouvelle affectation est créée ou copiée à partir d’une affectation existante.	POST /education/classes/{id}/assignments	Ressources, catégories, rubriques
Published	État de traitement en arrière-plan lorsque le devoir est distribué à chaque étudiant affecté.	POST /education/classes/{id}/assignments/{id}/publish
Scheduled	État lorsque l’enseignant a planifié la publication du devoir à un moment ultérieur.	PATCH /education/classes/{id}/assignments/{id} POST /education/classes/{id}/assignments/{id}/publish	Ressources, catégories, rubriques
Affecté	Une fois la publication terminée, le devoir est déplacé vers l’état Affecté et est disponible pour les étudiants.	POST /education/classes/{id}/assignments/{id}/publish	Soumissions
Pending	Le traitement en arrière-plan status lorsqu’une nouvelle affectation est copiée à partir d’une affectation existante.	POST /education/classes/{id}/assignments/{id}/copy PATCH /education/classes/{id}/assignments/{id}

Le diagramme suivant montre les transitions d’état qui peuvent se produire pour les affectations.

Comment vérifier qu’une affectation est publiée

L’appelant doit utiliser l’opération d’affectation GET pour case activée le status d’affectation actuel et vérifier que le processus de publication a réussi.

Transitions d’état d’affectation en fonction des actions autorisées

État actuel de l’affectation	Nouvelle action	Nouvel état
Brouillon	L’enseignant planifie le devoir	Scheduled
Brouillon	Publier	Published
Brouillon	Édition	Brouillon
Brouillon	Jeté
Published	Publication terminée	Affecté
Published	Échec de la publication	Brouillon
Published	Jeté
Scheduled	Atteindre la date d’échéance	Published
Scheduled	Annuler la planification	Brouillon
Scheduled	Reporter	Scheduled
Affecté	Jeté
Pending	Copie terminée	Brouillon
Pending	Jeté

Remarque

Toute action et toute transition d’état non répertoriées dans la table n’est pas autorisée.

Synchronisation et opérations asynchrones sur les appels d’API d’affectations

Le tableau suivant mentionne les appels d’API qui affectent l’état d’affectation et le type d’opération.

Les opérations synchrones sont effectuées une par une et une seule opération peut démarrer l’opération suivante, et le résultat est retourné jusqu’à la fin de la dernière opération. Avec les opérations asynchrones, l’opération démarre et une autre opération peut s’exécuter avant la fin de la précédente. L’opération asynchrone effectue une activité en arrière-plan, et l’appelant doit être en cours d’interrogation pour obtenir le résultat.

API	Synchronisation ou asynchrone	Mécanisme permettant d’obtenir l’état le plus récent
DELETE /education/classes/{id}/assignments/{id}	Async	Sondage
POST /education/classes/{id}/assignments/{id}/publish	Async	Sondage
PATCH /education/classes/{id}/assignments/{id}	Async	Sondage
POST /education/classes/{id}/assignments	Async	Sondage

États de soumission et transitions

Une soumission représente les ressources qu’un individu (ou un groupe) retourne pour une affectation. Les soumissions appartiennent à une affectation et sont automatiquement créées lors de la publication d’une affectation.

Le status est une propriété en lecture seule dans la soumission et change en fonction des actions des étudiants et des enseignants.

État	Description	Appel d’API REST
Working	État initial après la création de la soumission.	POST /education/classes/{id}/assignments POST /education/classes/{id}/assignments/{id}/submissions/{id}/unsubmit
Submitted	Cela se produit après que l’étudiant a retourné le devoir.	POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit
Retourné	Une fois que l’enseignant a retourné le devoir à l’étudiant.	POST /education/classes/{id}/assignments/{id}/submissions/{id}/return
Réaffecté	Après que l’enseignant a retourné le devoir à l’étudiant pour révision.	POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign

Le diagramme suivant montre le flux de transition d’état.

Transitions d’état de soumission en fonction des actions autorisées

État actuel de la soumission	Nouvelle action	Nouvel état
Working	Retourner	Submitted
Working	Retour pour révision	Réaffecté
Working	Return	Retourné
Submitted	Annuler Activer	Working
Submitted	Return	Retourné
Submitted	Retour pour révision	Réaffecté
Retourné	Retourner	Submitted
Retourné	Return	Retourné
Retourné	Retour pour révision	Réaffecté
Réaffecté	Retourner	Submitted
Réaffecté	Return	Retourné
Réaffecté	Retour pour révision	Réaffecté

Remarque

Toute action et toute transition d’état non répertoriées dans la table n’est pas autorisée.

Synchronisation et opérations asynchrones sur les appels d’API de soumissions

Le tableau suivant répertorie les appels d’API qui affectent l’état de la soumission et le type d’opération.

Dans ce cas, tous les appels sont asynchrones, ce qui signifie que l’opération démarre et qu’une autre opération peut démarrer avant la fin de la première. L’opération asynchrone effectue une activité en arrière-plan, et l’appelant doit être en cours d’interrogation pour obtenir le résultat.

API	Synchronisation ou asynchrone	Mécanisme permettant d’obtenir l’état le plus récent
POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit	Async	Sondage
POST /education/classes/{id}/assignments/{id}/submissions/{id}/unsubmit	Async	Sondage
POST /education/classes/{id}/assignments/{id}/submissions/{id}/return	Async	Sondage
POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign	Async	Sondage

Limites

Les limites suivantes s’appliquent à tous les appels d’API :

• Le nombre maximal de ressources de devoirs et de soumissions est de 10 pour l’enseignant et de 10 pour l’étudiant.
• La taille maximale autorisée pour les ressources est de 50 Mo au total ou de 10 ressources.
• Des limites de limitation s’appliquent ; Pour plus d’informations, consultez Guide de limitation de Microsoft Graph.