Partager via

État, transitions et limitations des soumissions dans Microsoft Graph

  • Article

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

Status et transitions de soumission

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 Status initiale après la création de la soumission. POST /education/classes/{id}/assignments
POST /education/classes/{id}/assignments/{id}/submissions/{id}/unsubmit
Submitted La status après que l’étudiant a terminé le devoir. POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit
Retourné Le status une fois que l’enseignant a retourné un devoir à l’étudiant. POST /education/classes/{id}/assignments/{id}/submissions/{id}/return
Réaffecté Le status une fois 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 status.

Diagramme des transitions status de soumission

Envoi status transitions en fonction des actions autorisées

Status de soumission actuelle Nouvelle action Nouvelle status
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 status transition non répertoriées dans le tableau 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 le status de 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 les dernières status
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