É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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour