educationAssignment resource type

  • Artigo

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