educationAssignment resource type
Namespace: microsoft.graph
As atribuições são tarefas ou unidades de trabalho atribuídas a um aluno ou membro da equipe em uma classe como parte do estudo.
As tarefas contêm folhetos e tarefas em que o professor quer que o estudante trabalhe. Cada tarefa de estudante tem uma submissão associada que contém qualquer trabalho que o seu professor tenha pedido para ser entregue. Apenas os professores ou proprietários de equipas podem criar tarefas. Um professor pode adicionar pontuações e feedback à submissão entregue pelo estudante.
Quando uma atribuição é criada, está num estado de rascunho. Os estudantes não podem ver a tarefa e as submissões não são criadas . Pode alterar o estado de uma atribuição com a ação de publicação . Não pode utilizar um pedido PATCH para alterar o estado da atribuição .
As APIs de atribuição são expostas no espaço de nomes da classe.
Herda de entidade.
Methods
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Criar recurso de tarefa | educationAssignmentResource | Crie um novo educationAssignmentResource ao publicar na coleção de recursos. |
| Obter a tarefa | educationAssignment | Ler propriedades e relações de um objeto educationAssignment . |
| Atualizar | educationAssignment | Atualizar um objeto educationAssignment . |
| Delete | Nenhum | Eliminar um objeto educationAssignment . |
| Publish | educationAssignment | Altere o estado de um objeto educationAssignment de rascunho para publicado. |
| Configurar a pasta de recursos de atribuição | string | Crie uma pasta do SharePoint (em localização predefinida) para carregar ficheiros como recursos de atribuição. |
| Configurar a pasta de recursos de comentários de atribuição | educationAssignment | Crie uma pasta do SharePoint para carregar ficheiros de feedback para uma determinada educationSubmission. |
| Listar recursos | coleção educationAssignmentResource | Obtenha uma coleção de objetos educationAssignmentResource . |
| Listar submissões | educationSubmission collection (coleção educationSubmission ) | Obter uma coleção de objetos educationSubmission . |
| Listar categorias | coleção educationCategory | Obtenha uma coleção de objetos educationCategory . |
| Adicionar categorias | educationCategory | Atribua uma educationCategory pertencente à turma a esta tarefa. |
| Remover categoria | Nenhum | Remova uma educationCategory pertencente à turma desta tarefa. |
| Anexar rubrica | Nenhum | Anexe um educationRubric existente a esta tarefa. |
| Remover rubrica | Nenhum | Desanexe o educationRubric desta tarefa. |
| Obter delta | coleção educationAssignment | Obtenha uma lista de objetos educationAssignment recentemente criados ou atualizados sem ter de efetuar uma leitura completa da coleção. |
| Adicionar educationGradingCategory | educationGradingCategory | Adicione um educationGradingCategory à coleção educationGradingCategory . |
| Remover educationGradingCategory | Nenhum | Remova um objeto educationGradingCategory da coleção educationGradingCategory . |
| Ativar atribuição | educationAssignment | Ative um inactiveeducationAssignment para sinalizar que a tarefa tem mais itens de ação para professores ou estudantes. |
| Desativar atribuição | educationAssignment | Marque um assignededucationAssignment como inactive para sinalizar que a tarefa não tem mais itens de ação para professores e alunos. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| addedStudentAction | Cadeia de caracteres | Campo opcional para controlar o comportamento da tarefa para os estudantes que são adicionados após a publicação da tarefa . Se não for especificado, a predefinição é none. Os valores suportados são: none, assignIfOpen. Por exemplo, um professor pode utilizar assignIfOpen para indicar que uma tarefa deve ser atribuída a qualquer novo estudante que participe na turma enquanto a tarefa ainda estiver aberta e none para indicar que uma tarefa não deve ser atribuída a novos estudantes. |
| addToCalendarAction | educationAddToCalendarOptions | Campo opcional para controlar o comportamento da tarefa para adicionar tarefas aos calendários dos estudantes e professores quando a tarefa é publicada. Os valores possíveis são: none, studentsAndPublisher, studentsAndTeamOwners, , unknownFutureValuee studentsOnly. Tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores nesta enumeração evoluível: studentsOnly. O valor padrão é none. |
| allowLateSubmissions | Booliano | Identifica se os estudantes podem submeter após a data para conclusão. Se esta propriedade não for especificada durante a criação, a predefinição será verdadeira. |
| allowStudentsToAddResourcesToSubmission | Booliano | Identifica se os estudantes podem adicionar os seus próprios recursos a uma submissão ou se só podem modificar os recursos adicionados pelo professor. |
| assignDateTime | DateTimeOffset | A data em que a atribuição deve ficar ativa. Se, no futuro, a tarefa não for apresentada ao estudante até esta data.
O tipo carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre na hora UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z |
| assignTo | educationAssignmentRecipient | Que utilizadores ou toda a classe devem receber um objeto de submissão assim que a tarefa for publicada. |
| assignedDateTime | DateTimeOffset | O momento em que a tarefa foi publicada para os alunos e a tarefa aparece na linha cronológica dos estudantes. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z |
| classId | Cadeia de caracteres | Classe à qual esta tarefa pertence. |
| closeDateTime | DateTimeOffset | Data em que a atribuição é fechada para submissões. Este é um campo opcional que pode ser nulo se a atribuição não permitirLateSubmissions ou quando closeDateTime for o mesmo que dueDateTime. No entanto, se especificado, closeDateTime tem de ser maior ou igual a dueDateTime. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z |
| createdBy | identitySet | Quem criou a tarefa. |
| createdDateTime | DateTimeOffset | Momento em que a tarefa foi criada. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z |
| displayName | Cadeia de caracteres | Nome da tarefa. |
| dueDateTime | DateTimeOffset | Data em que a tarefa dos estudantes está para conclusão. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z |
| feedbackResourcesFolderUrl | Cadeia de caracteres | URL da pasta onde todos os recursos de ficheiros de feedback para esta atribuição são armazenados. |
| classificação | educationAssignmentGradeType | Como a tarefa será classificada. |
| id | Cadeia de caracteres | O identificador exclusivo da atribuição. Herdado da entidade. Somente leitura. |
| instruções | itemBody | Instruções para a tarefa. As instruções e o nome a apresentar indicam ao estudante o que fazer. |
| lastModifiedBy | identitySet | Quem modificou a tarefa pela última vez. |
| lastModifiedDateTime | DateTimeOffset | A data e hora em que a atribuição foi modificada. A submissão de um estudante não modifica a tarefa; apenas os professores podem atualizar tarefas. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z |
| moduleUrl | cadeia de caracteres | O URL do módulo a partir do qual pode aceder à atribuição. |
| notificationChannelUrl | Cadeia de caracteres | Campo opcional para especificar o URL do canal para publicar a notificação de publicação da atribuição . Se não for especificado ou nulo, a predefinição é o General canal. Este campo aplica-se apenas a atribuições em que o valor assignTo é educationAssignmentClassRecipient. A atualização do notificationChannelUrl não é permitida após a publicação da atribuição. |
| resourcesFolderUrl | cadeia de caracteres | URL da pasta onde todos os recursos de ficheiro para esta atribuição são armazenados. |
| status | educationAssignmentStatus | Estado da atribuição. Não é possível corrigir este valor. Os possíveis valores são: draft, scheduled, published, assigned, unknownFutureValue, inactive. Tenha em atenção que tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores neste enum evoluível: inactive. |
| webUrl | cadeia de caracteres | O URL de ligação avançada para a atribuição especificada. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| categories | coleção educationCategory | Quando definido, permite que os utilizadores encontrem facilmente atribuições de um determinado tipo. Somente leitura. Anulável. |
| recursos | coleção educationAssignmentResource | Objetos de aprendizagem associados a esta atribuição. Apenas os professores podem modificar esta lista. Anulável. |
| rubrica | educationRubric | Quando definida, a rubrica de classificação anexada a esta tarefa. |
| submissões | educationSubmission collection (coleção educationSubmission ) | Depois de publicado, existe um objeto de submissão para cada estudante que representa o seu trabalho e nota. Somente leitura. Anulável. |
| gradingCategory | educationGradingCategory collection | Quando definido, permite que os utilizadores ponderem as tarefas de forma diferente ao calcular uma nota média da turma. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"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"
}