Type de ressource educationSubmission
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Représente les ressources qu’un individu (ou un groupe) retourne pour un devoir et les résultats (tels que les notes ou les commentaires) associés à la soumission.
Les soumissions appartiennent à une affectation. Les soumissions sont automatiquement créées lors de la publication d’une affectation . La soumission possède deux listes de ressources. Les ressources représentent la zone de travail des utilisateurs/groupes, tandis que les ressources soumises représentent les ressources qui ont été activement retournées par les étudiants.
La propriété status est en lecture seule et l’objet est déplacé dans le flux de travail via des actions.
Si setUpResourcesFolder n’a pas été appelé sur une ressource educationSubmission , la propriété resourcesFolderUrl est null.
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| Obtenir une soumission | educationSubmission | Lit les propriétés et relations d’un objet educationSubmission . |
| Répertorier les ressources de soumission | collection educationSubmissionResource | Obtenez une collection d’objets educationSubmissionResource . |
| Répertorier les ressources soumises | collection educationSubmissionResource | Obtenez une collection d’objets educationSubmissionResource . |
| Répertorier les résultats | collection educationOutcome | Obtenez une collection d’objets educationOutcome . |
| Envoi d’excuses | educationSubmission | Indique que la soumission n’a aucune autre action pour l’étudiant et n’est pas incluse dans les calculs de note moyenne. |
| Renvoyer une soumission | educationSubmission | Un enseignant utilise le retour pour indiquer que les notes/commentaires peuvent être affichés à l’étudiant. |
| Réaffecter la soumission | educationSubmission | Réaffectez la soumission à l’étudiant avec des commentaires pour révision. |
| Configurer le dossier des ressources de soumission | educationSubmission | Créez un dossier SharePoint (sous un emplacement prédéfini) pour charger des fichiers en tant que ressources de soumission. |
| Envoyer une soumission | educationSubmission | Un étudiant utilise submit pour remettre le devoir. Cette opération copie les ressources dans le dossier submittedResources pour l’évaluation et met à jour les status. |
| Annuler l’envoi d’une soumission | educationSubmission | Un étudiant utilise l’insoumettre pour déplacer l’état de la soumission de retour au travail. Cette opération copie les ressources dans le dossier workingResources pour l’évaluation et met à jour les status. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| assignmentId | Chaîne | Identificateur unique de l’affectation à laquelle cette soumission est associée. Une soumission est toujours associée à une seule affectation. |
| excusedBy | identitySet | L’utilisateur qui a marqué la soumission comme étant excusée. |
| excusedDateTime | DateTimeOffset | Moment dans le temps où la soumission a été déplacée à l’état excusé. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| id | Chaîne | Identificateur unique de la soumission. |
| lastModifiedBy | identitySet | Identités de ceux qui ont modifié la soumission. |
| lastModifiedDateTime | DateTimeOffset | Date et heure de modification de la soumission. |
| reassignedBy | identitySet | Utilisateur qui a déplacé le status de cette soumission vers réaffecté. |
| reassignedDateTime | DateTimeOffset | Moment dans le temps où la soumission a été réaffectée. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| destinataire | educationSubmissionRecipient | À qui cette soumission est affectée. |
| resourcesFolderUrl | Chaîne | Dossier dans lequel toutes les ressources de fichier pour cette soumission doivent être stockées. |
| returnedBy | identitySet | Utilisateur qui a déplacé le status de cette soumission vers retourné. |
| returnedDateTime | DateTimeOffset | Moment dans le temps où la soumission a été retournée. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| status | educationSubmissionStatus | En lecture seule. Les valeurs possibles sont , workingsubmitted, returned, unknownFutureValuereassigned, et excused. 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 : reassigned, et excused. |
| submittedBy | identitySet | Utilisateur qui a déplacé la ressource dans l’état soumis. |
| submittedDateTime | DateTimeOffset | Moment dans le temps où la soumission a été déplacée dans l’état soumis. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| unsubmittedBy | identitySet | Utilisateur qui a déplacé la ressource de l’envoi à l’état de fonctionnement. |
| unsubmittedDateTime | DateTimeOffset | Moment dans le temps où la soumission a été déplacée de l’état soumis à l’état de fonctionnement. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| webUrl | Chaîne | URL de lien profond pour la soumission donnée. |
Relations
| Relation | Type | Description |
|---|---|---|
| Résultats | collection educationOutcome . Contient les notes, commentaires et/ou rubriques que l’enseignant attribue à cette soumission | Lecture-écriture. Peut avoir la valeur Null. |
| resources | collection educationSubmissionResource | Pouvant accepter la valeur Null. |
| submittedResources | collection educationSubmissionResource | En lecture seule. Pouvant accepter la valeur Null. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"excusedBy": {"@odata.type":"microsoft.graph.identitySet"},
"excusedDateTime": "String (timestamp)",
"id": "String (identifier)",
"reassignedBy": {"@odata.type":"microsoft.graph.identitySet"},
"reassignedDateTime": "String (timestamp)",
"recipient": {"@odata.type":"microsoft.graph.educationSubmissionRecipient"},
"resourcesFolderUrl": "String",
"returnedBy": {"@odata.type":"microsoft.graph.identitySet"},
"returnedDateTime": "String (timestamp)",
"status": "String",
"submittedBy": {"@odata.type":"microsoft.graph.identitySet"},
"submittedDateTime": "String (timestamp)",
"unsubmittedBy": {"@odata.type":"microsoft.graph.identitySet"},
"unsubmittedDateTime": "String (timestamp)",
"webUrl": "String"
}