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"
}