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

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 aux états d’affectation pendant le flux de processus et 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 à 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 é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
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	É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 le processus de publication terminé, le devoir est déplacé vers un état attribué, devenant disponible pour les étudiants, ou il reste dans un état 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 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
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 d’état 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’état d’affectation 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 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
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

• États, transitions et limitations pour les soumissions