Partager via

État, transitions et limitations des affectations dans Microsoft Graph

  • Article

Les devoirs sont une partie importante de l’interaction entre les actions des enseignants et des étudiants. Cet article décrit les modifications apportées au status d’affectation pendant le flux de processus et les API d’éducation dans Microsoft Graph qui sont impliquées.

Status et transitions d’affectation

Un devoir représente une tâche ou une unité de travail attribuée à un étudiant ou à un membre de l’équipe d’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 status d’affectation. Le tableau suivant répertorie les status d’affectation et les API disponibles pour modifier les status.

État Description Appel d’API REST Fonctionnalités disponibles pour la modification
Première version 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 Un traitement en arrière-plan status 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 le processus de publication terminé, le devoir est déplacé vers un status affecté, devenant disponible pour les étudiants, ou il reste dans un status actif. POST /education/classes/{id}/assignments/{id}/publish
POST /education/classes/{id}/assignments/{id}/activate		 Soumissions
Pending Le traitement en arrière-plan status lorsqu’une nouvelle affectation est copiée à partir d’une affectation existante. PATCH /education/classes/{id}/assignments/{id}
Inactif Le devoir n’a pas d’éléments d’action supplémentaires pour les enseignants et les étudiants. POST /education/classes/{id}/assignments/{id}/deactivate

Le diagramme suivant montre les transitions status qui peuvent se produire pour les affectations.

Diagramme des transitions status d’affectation

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.

Affectation status transitions en fonction des actions autorisées

Status d’affectation actuelle Nouvelle action Nouvelle status
Première version L’enseignant planifie le devoir Scheduled
Première version Publier Published
Première version Édition Première version
Première version Jeté
Published Publication terminée Affecté
Published Échec de la publication Première version
Published Jeté
Scheduled Atteindre la date d’échéance Published
Scheduled Annuler la planification Première version
Scheduled Reporter Scheduled
Affecté Jeté
Affecté Deactivated Inactif
Pending Copie terminée Première version
Pending Jeté
Inactif Activated Affecté

Remarque

Seules les actions et les transitions status répertoriées dans le tableau sont autorisées.

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

Le tableau suivant répertorie les appels d’API qui affectent l’affectation status et le type d’opération.

Les opérations synchrones sont exécutées une par une. Chaque opération doit être terminée avant que la suivante puisse commencer, et le résultat final n’est retourné qu’une fois toutes les opérations terminées. Les opérations asynchrones permettent à plusieurs tâches de s’exécuter simultanément. Pendant qu’une opération est en cours, une autre peut démarrer avant la fin de la précédente. Les opérations asynchrones impliquent généralement des activités en arrière-plan, et l’appelant doit case activée activement le résultat par interrogation ou analyse jusqu’à ce qu’il soit disponible.

API Synchronisation ou asynchrone Mécanisme permettant d’obtenir les dernières status
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
POST /education/classes/{id}/assignments/{id}/deactivate Async Sondage
POST /education/classes/{id}/assignments/{id}/activate Async Sondage

Limites

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

  • Le nombre maximal de ressources de devoir est de 10 pour l’enseignant.
  • 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