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

Les soumissions sont une partie importante de l’interaction entre les actions des enseignants et des étudiants. Cela concerne les modifications de l’état de soumission pendant le flux de processus et les API d’éducation dans Microsoft Graph qui sont impliquées.

É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. Il 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	État après que l’étudiant a passé le devoir.	POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit
Retourné	État après que l’enseignant a retourné un devoir à l’étudiant.	POST /education/classes/{id}/assignments/{id}/submissions/{id}/return
Réaffecté	État après que l’enseignant a retourné le devoir à l’étudiant pour révision.	POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign
Excuse	Les enseignants peuvent marquer une soumission comme étant excusée pour indiquer que la soumission n’a aucune autre action pour l’étudiant.	POST /education/classes/{id}/assignments/{id}/submissions/{id}/excuse

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é
Working	Excuse	Excusé
Submitted	Annuler Activer	Working
Submitted	Return	Retourné
Submitted	Retour pour révision	Réaffecté
Submitted	Excuse	Excusé
Retourné	Retourner	Submitted
Retourné	Return	Retourné
Retourné	Retour pour révision	Réaffecté
Retourné	Excuse	Excusé
Réaffecté	Retourner	Submitted
Réaffecté	Return	Retourné
Réaffecté	Retour pour révision	Réaffecté
Réaffecté	Excuse	Excusé
Excusé	Retour pour révision	Réaffecté
Excusé	Return	Retourné
Excusé	Retourner	Submitted

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 commencer 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
POST /education/classes/{id}/assignments/{id}/submissions/{id}/excuse	Async	Sondage

Limites

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

• Le nombre maximal de ressources de soumission est de 10 pour l’étudiant.
• La taille maximale autorisée pour les ressources est de 500 Mo.
• Des limites de limitation s’appliquent ; Pour plus d’informations, consultez Guide de limitation de Microsoft Graph.

Contenu connexe

• États, transitions et limitations pour les affectations