Partager via


Type de ressource educationAssignment

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 l’état d’une affectation à l’aide de l’action de publication . Vous ne pouvez pas utiliser une requête PATCH pour modifier l’état de l’affectation .

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 Aucune 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 Aucune Supprimez une educationCategory appartenant à la classe de ce devoir.
Joindre la rubrique Aucune Attachez un objet educationRubric existant à ce devoir.
Supprimer la rubrique Aucune 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 Aucune Supprimez un objet educationGradingCategory de la collection educationGradingCategory .
Activer l’affectation educationAssignment Activez un inactiveeducationAssignment 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 assignededucationAssignment 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 Chaîne 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, unknownFutureValueet 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 Valeur booléenne 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 Valeur booléenne 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 la chronologie 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.
classId Chaîne 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 Chaîne 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 Chaîne 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 Chaîne 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 Chaîne 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 string 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"
}