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

Les devoirs et les soumissions sont un élément important de 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 au cours du flux de processus et les API d’enseignement dans Microsoft Graph sont impliquées.

États et transitions d’affectation

Une affectation représente une tâche ou une unité de travail affectée à un étudiant ou à des membres d’équipe dans une classe dans le cadre de son é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 de l’API REST Fonctionnalités disponibles pour la modification
Brouillon État initial 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 l’affectation est distribuée à chaque étudiant affecté. POST /education/classes/{id}/assignments/{id}/publish
Scheduled État lorsque l’enseignant a programmé l’affectation à publier ultérieurement. PATCH /education/classes/{id}/assignments/{id}
POST /education/classes/{id}/assignments/{id}/publish
Ressources, catégories, rubriques
Affecté Une fois la publication terminé, l’affectation est déplacée vers l’état Affecté et est disponible pour les étudiants. POST /education/classes/{id}/assignments/{id}/publish Soumissions
Pending État de traitement en arrière-plan 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.

Diagramme des transitions d’états d’affectation

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

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

Affectations états transitions en fonction des actions autorisées

État d’affectation actuel Nouvelle action Nouvel état
Brouillon L’enseignant planifiera l’affectation Scheduled
Brouillon Publier Published
Brouillon Modifié Brouillon
Brouillon Ignoré
Published Publication terminée Affecté
Published Échec de publication Brouillon
Published Ignoré
Scheduled Date d’échéance de la date d’échéance Published
Scheduled Annuler la planification Brouillon
Scheduled Reprogrammer Scheduled
Affecté Ignoré
Pending Copie terminée Brouillon
Pending Ignoré

Remarque : Toute action et transition d’état non répertoriée dans le tableau 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 seule lorsque l’opération est terminée peut démarrer l’opération suivante et le résultat est renvoyé jusqu’à ce que la dernière opération soit terminée. 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 effectuer une 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 et transitions de soumission

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

L’état est une propriété en lecture seule dans la soumission et les modifications en fonction des actions des étudiants et des enseignants.

État Description Appel de l’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 une fois que l’étudiant a désactivé l’affectation. POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit
Renvoyé Une fois que l’enseignant a renvoyé l’affectation à l’étudiant. POST /education/classes/{id}/assignments/{id}/submissions/{id}/return
Réassigné Une fois que l’enseignant a renvoyé l’affectation à l’étudiant pour révision. POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign

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

Diagramme des transitions des états de soumission

Les états des soumissions sont des transitions basées sur les actions autorisées

État de soumission actuel Nouvelle action Nouvel état
Working Turn in Submitted
Working Retour pour révision Réassigné
Working Return Renvoyé
Submitted Annuler Turn in Working
Submitted Return Renvoyé
Submitted Retour pour révision Réassigné
Renvoyé Turn in Submitted
Renvoyé Return Renvoyé
Renvoyé Retour pour révision Réassigné
Réassigné Turn in Submitted
Réassigné Return Renvoyé
Réassigné Retour pour révision Réassigné

Remarque : Toute action et transition d’état non répertoriée dans le tableau n’est pas autorisée.

Opérations de synchronisation et asynchrones sur les appels d’API de soumission

Le tableau suivant répertorie les appels d’API qui affectent l’état 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 démarrer avant la fin de la première. L’opération asynchrone effectue une activité en arrière-plan et l’appelant doit effectuer une 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 d’affectations et d’envois est de 10 pour l’enseignant et de plus 10 pour l’étudiant.
  • La taille maximale autorisée pour les ressources est de 50 Mo au total ou 10 ressources.
  • Les limites de limitation s’appliquent ; Pour plus d’informations, voir les conseils Graph limitation microsoft.