Type de ressource educationAssignment

Article
02/26/2024

Espace de noms: microsoft.graph

Représente une tâche ou une unité de travail affectée à un étudiant ou à un membre de l’équipe d’une classe dans le cadre de son étude.

Les devoirs contiennent des documents et des tâches sur lesquels l’enseignant souhaite que l’étudiant travaille. Chaque devoir d’étudiant a une soumission associée qui contient tout travail que son enseignant a demandé d’être retourné. Seuls les enseignants ou les propriétaires d’équipe peuvent créer des devoirs. Un enseignant peut ajouter des scores et des commentaires à la soumission retournée par l’étudiant.

Lorsqu’une affectation est créée, elle est à l’état brouillon. Les étudiants ne peuvent pas voir le devoir et les soumissions ne sont pas créées. Vous pouvez modifier la status d’une affectation à l’aide de l’action de publication. Vous ne pouvez pas utiliser une requête PATCH pour modifier l’affectation status.

Les API d’affectation sont exposées dans l’espace de noms de classe.

Hérite de l’entité.

Méthodes

Méthode	Type renvoyé	Description
Créer une ressources de devoirs	educationAssignmentResource	Créez un élément educationAssignmentResource en publiant dans la collection resources.
Obtenir un devoir	educationAssignment	Lit les propriétés et les relations d’un objet educationAssignment .
Mettre à jour	educationAssignment	Mettre à jour un objet educationAssignment .
Supprimer	Aucun	Supprime un objet educationAssignment .
Publier	educationAssignment	Modifiez l’état d’un objet educationAssignment de brouillon à publié.
Configurer le dossier des ressources d’affectation	string	Créez un dossier SharePoint (sous un emplacement prédéfini) pour charger des fichiers en tant que ressources d’affectation.
Configurer le dossier des ressources de commentaires sur les affectations	educationAssignment	Créez un dossier SharePoint pour charger des fichiers de commentaires pour un educationSubmission donné.
Répertorier les ressources	collection educationAssignmentResource	Obtenez une collection d’objets educationAssignmentResource .
Répertorier les soumissions	collection educationSubmission	Obtenez une collection d’objets educationSubmission .
List categories	collection educationCategory	Obtenez une collection d’objets educationCategory .
Ajouter des catégories	educationCategory	Attribuez une educationCategory appartenant à la classe à ce devoir.
Enlever une catégorie	Aucun	Supprimez une educationCategory appartenant à la classe de ce devoir.
Joindre la rubrique	Aucun	Attachez un objet educationRubric existant à ce devoir.
Supprimer la rubrique	Aucun	Détachez educationRubric de ce devoir.
Obtenir delta	collection educationAssignment	Obtenez la liste des objets educationAssignment nouvellement créés ou mis à jour sans avoir à effectuer une lecture complète de la collection.
Ajouter educationGradingCategory	educationGradingCategory	Ajoutez un élément educationGradingCategory à la collection educationGradingCategory .
Supprimer educationGradingCategory	Aucun	Supprimez un objet educationGradingCategory de la collection educationGradingCategory .
Activer l’affectation	educationAssignment	Activez un `inactive`educationAssignment pour signaler que le devoir comporte d’autres éléments d’action pour les enseignants ou les étudiants.
Désactiver l’affectation	educationAssignment	Marquez un `assigned`educationAssignment comme `inactive` pour signaler que le devoir n’a pas d’autres éléments d’action pour les enseignants et les étudiants.

Propriétés

Propriété	Type	Description
addedStudentAction	String	Champ facultatif pour contrôler le comportement des devoirs pour les étudiants qui sont ajoutés après la publication du devoir . S’il n’est pas spécifié, la valeur par défaut est `none`. Les valeurs prises en charge sont : `none`, `assignIfOpen`. Par exemple, un enseignant peut utiliser `assignIfOpen` pour indiquer qu’un devoir doit être attribué à tout nouvel étudiant qui rejoint la classe alors que le devoir est encore ouvert, et `none` pour indiquer qu’un devoir ne doit pas être attribué à de nouveaux étudiants.
addToCalendarAction	educationAddToCalendarOptions	Champ facultatif pour contrôler le comportement des devoirs pour ajouter des devoirs aux calendriers des étudiants et des enseignants lors de la publication du devoir . Les valeurs possibles sont , `none`, `studentsAndPublisherstudentsAndTeamOwners`, `unknownFutureValue`et `studentsOnly`. Vous devez utiliser l’en-tête `Prefer: include-unknown-enum-members` de requête pour obtenir les valeurs suivantes dans cette énumération évolutive : `studentsOnly`. La valeur par défaut est `none`.
allowLateSubmissions	Boolean	Détermine si les étudiants peuvent soumettre une soumission après la date d’échéance. Si cette propriété n’est pas spécifiée lors de la création, la valeur par défaut est true.
allowStudentsToAddResourcesToSubmission	Boolean	Identifie si les étudiants peuvent ajouter leurs propres ressources à une soumission ou s’ils peuvent uniquement modifier les ressources ajoutées par l’enseignant.
assignDateTime	DateTimeOffset	Date à laquelle l’affectation doit être active. Si à l’avenir, le devoir n’est pas présenté à l’étudiant avant cette date. Le type Timestamp représente les informations de date et d’heure au format ISO 8601 et est toujours en heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : `2014-01-01T00:00:00Z`.
assignTo	educationAssignmentRecipient	Les utilisateurs ou la classe entière qui doivent recevoir un objet d’envoi une fois l’affectation publiée.
assignedDateTime	DateTimeOffset	Le moment où le devoir a été publié aux étudiants et que le devoir s’affiche sur les étudiants chronologie. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : `2014-01-01T00:00:00Z`.
classId	String	Classe à laquelle appartient cette affectation .
closeDateTime	DateTimeOffset	Date à laquelle le devoir est fermé pour les soumissions. Il s’agit d’un champ facultatif qui peut être null si l’affectation n’autorise pasLateSubmissions ou lorsque closeDateTime est identique à dueDateTime. Mais si elle est spécifiée, la valeur closeDateTime doit être supérieure ou égale à dueDateTime. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : `2014-01-01T00:00:00Z`.
createdBy	identitySet	Qui a créé l’affectation.
createdDateTime	DateTimeOffset	Moment où l’affectation a été créée. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : `2014-01-01T00:00:00Z`.
displayName	String	Nom de l’affectation.
dueDateTime	DateTimeOffset	Date d’échéance du devoir des étudiants. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : `2014-01-01T00:00:00Z`.
feedbackResourcesFolderUrl	String	URL du dossier où sont stockées toutes les ressources du fichier de commentaires pour cette affectation .
Classement	educationAssignmentGradeType	Comment l’affectation sera évaluée.
id	String	Identificateur unique de l’affectation. Hérité de l’entité. En lecture seule.
Instructions	itemBody	Instructions pour l’affectation. Les instructions et le nom d’affichage indiquent à l’étudiant ce qu’il doit faire.
lastModifiedBy	identitySet	Qui a modifié l’affectation pour la dernière fois.
lastModifiedDateTime	DateTimeOffset	Date et heure auxquelles l’affectation a été modifiée. Une soumission d’étudiant ne modifie pas le devoir ; seuls les enseignants peuvent mettre à jour les devoirs. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : `2014-01-01T00:00:00Z`.
moduleUrl	string	URL du module à partir duquel accéder à l’affectation.
notificationChannelUrl	String	Champ facultatif pour spécifier l’URL du canal pour publier la notification de publication d’affectation . S’il n’est pas spécifié ou null, la valeur par défaut est le `General` canal. Ce champ s’applique uniquement aux affectations pour lesquelles la valeur assignTo est educationAssignmentClassRecipient. La mise à jour de notificationChannelUrl n’est pas autorisée après la publication de l’affectation.
resourcesFolderUrl	chaîne	URL du dossier où sont stockées toutes les ressources de fichier pour cette affectation .
status	educationAssignmentStatus	État de l’affectation. Vous ne pouvez pas corriger cette valeur. Les valeurs possibles sont `draft`, `scheduled`, `published`, `assigned`, `unknownFutureValue`, `inactive`. Notez que vous devez utiliser l’en-tête `Prefer: include-unknown-enum-members` de requête pour obtenir la ou les valeurs suivantes dans cette énumération évolutive : `inactive`.
webUrl	chaîne	URL de lien profond pour l’affectation donnée.

Relations

Relation	Type	Description
categories	collection educationCategory	Lorsqu’il est défini, permet aux utilisateurs de trouver facilement les affectations d’un type donné. En lecture seule. Peut avoir la valeur Null.
resources	collection educationAssignmentResource	Objets d’apprentissage associés à ce devoir. Seuls les enseignants peuvent modifier cette liste. Pouvant accepter la valeur Null.
Rubrique	educationRubric	Lorsqu’elle est définie, la rubrique de notation attachée à cette affectation.
Soumissions	collection educationSubmission	Une fois publié, il existe un objet de soumission pour chaque étudiant représentant son travail et sa note. En lecture seule. Pouvant accepter la valeur Null.
gradingCategory	collection educationGradingCategory	Lorsqu’il est défini, permet aux utilisateurs de ponder les devoirs différemment lors du calcul d’une note moyenne de classe.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "addedStudentAction": "String",
  "addToCalendarAction": "String",  
  "allowLateSubmissions": "Boolean",
  "allowStudentsToAddResourcesToSubmission": "Boolean",
  "assignDateTime": "String (timestamp)",
  "assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
  "assignedDateTime": "String (timestamp)",
  "classId": "String",
  "closeDateTime": "String (timestamp)",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "dueDateTime": "String (timestamp)",
  "feedbackResourcesFolderUrl": "String",
  "grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
  "id": "String (identifier)",
  "instructions": {"@odata.type": "microsoft.graph.itemBody"},
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "moduleUrl": "String",
  "notificationChannelUrl": "String",
  "resourcesFolderUrl": "String",
  "status": "String",  
  "webUrl": "String"
}