Atualizar a tarefa e classificar dados

As instituições de ensino têm ferramentas personalizadas para atualizar os dados de tarefas e notas. Por exemplo, um professor poderá ter de fazer uma atualização a uma tarefa antes de os estudantes as submeterem ou efetuar uma alteração a uma nota (resultado) através de uma ferramenta personalizada.

Antes de poder atualizar os dados, tem de obter as informações relevantes sobre a classe e os membros.

Nota: Pode utilizar o Graph Explorer para testar as APIs de Educação mencionadas neste artigo.

Obter informações sobre a classe e o membro

Todas as tarefas e informações de classificação fazem parte da equipa no Microsoft Teams. Pode obter informações sobre turmas, membros e funções (estudante ou professor) numa equipa com as seguintes APIs do Teams:

• Listar turmas de um educationSchools: Devolve uma lista de todas as turmas no seu inquilino de educação.
• Listar membros de uma educationClass: Listas informações sobre membros de uma turma específica.

Depois de obter as informações relevantes sobre a turma e os membros, pode obter as informações de atribuição e classificação de que precisa.

Informações de atribuição e submissão

Todas as informações de tarefas e estudantes estão associadas às informações de turma e submissão, respetivamente. As SEGUINTES APIs obtêm informações sobre tarefas e submissões de turmas:

• tipo de recurso educationAssignment: Listas todos os métodos disponíveis para tarefas numa turma. Um utilizador pode obter todos os objetos educationAssignmentResource associados numa tarefa.
• educationSubmission resource type:A submissionId is created for every student for who an assignment is published. Pode utilizar esta API para obter a submissão status - por exemplo, se foi entregue e classificado, (recursos) submetidos pelo estudante e a nota (resultado) para a submissão.

Atualizar dados de nota (resultado)

Os utilizadores podem atualizar as propriedades de um objeto educationOutcome . As propriedades existentes que não estão incluídas no corpo do pedido irão manter os valores anteriores. Apenas os professores podem efetuar esta operação.

O exemplo seguinte descreve como atualizar um resultado de pontos.

Solicitação

O exemplo a seguir mostra a solicitação.

Nota: O corpo do pedido deve incluir apenas os valores dos campos que têm de ser atualizados.

PATCH https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/cf6005fc-9e13-44a2-a6ac-a53322006454/submissions/d1bee293-d8bb-48d4-af3e-c8cb0e3c7fe7/outcomes/9c0f2850-ff8f-4fd6-b3ac-e23077b59141
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.educationPointsOutcome",
    "points":{
        "@odata.type":"#microsoft.graph.educationAssignmentPointsGrade",
        "points":85.0
    }
}

Resposta

O exemplo seguinte mostra a nova composição.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.educationPointsOutcome",
    "id":"ea1351f6-ba33-4940-b2cb-6a7254af2dc8",
    "lastModifiedBy":{
        "user":{
            "id":"9391878d-903c-406c-bb1c-0f17d00fd878"
        }
    },
    "points":{
        "gradedDateTime":"2019-07-15T22:35:48.2429387Z",
        "points":85.0,
        "gradedBy":{
            "user":{
                "id":"9391878d-903c-406c-bb1c-0f17d00fd878"
            }
        }
    }
}

Este pedido devolve um objeto educationOutcome atualizado no corpo da resposta.

Permissões

As permissões delegadas e de aplicação são necessárias para atualizar dados em atribuições. As permissões de aplicação são atualmente suportadas apenas na versão beta.

Nota: Uma vez que as informações dos estudantes e das notas são dados confidenciais, certifique-se de que verifica quais as permissões necessárias.