Compartilhar via

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 a status de uma tarefa com a ação de publicação. Não pode utilizar um pedido PATCH para alterar a atribuição status.

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 educationAssignment Crie uma nova tarefa.
Get 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.
Criar recurso de tarefa educationAssignmentResource Criar um recurso de atribuição.
Obter recurso de tarefa educationAssignmentResource Obtenha as propriedades de um recurso de tarefa de educação associado a uma tarefa.
Eliminar recurso de atribuição Nenhum Eliminar um recurso específico de atribuição de educação anexado a uma tarefa.
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 categoria de classificação educationGradingCategory Adicione uma gradaçãoCategory a um educationAssignment.
Remover categoria de classificação Nenhum Remova uma gradaçãoCategory de um educationAssignment.
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.
Adicionar esquema de classificação educationGradingScheme Adicione um educationGradingScheme existente a um educationAssignment existente.

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. Utilize 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 nos estudantes linha do tempo. 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.
languageTag Cadeia de caracteres Especifica o idioma no qual são apresentadas as notificações de IU para a atribuição. Se languageTag não for fornecido, o idioma predefinido é en-US. Opcional.
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 string 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 string 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 valores possíveis são: draft, scheduled, published, assigned, unknownFutureValue, inactive. Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes membros nesta enumeração em evolução: inactive.
webUrl string 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.
gradingCategory educationGradingCategory collection Quando definido, permite que os utilizadores ponderem as tarefas de forma diferente ao calcular uma nota média da turma.
gradingScheme educationGradingScheme Quando definido, permite que os utilizadores configurem notas de cadeias personalizadas com base na percentagem do total de pontos ganhos nesta tarefa.
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.

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"},
  "languageTag": "String",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "moduleUrl": "String",
  "notificationChannelUrl": "String",
  "resourcesFolderUrl": "String",
  "status": "String",  
  "webUrl": "String"
}
  • Last updated on