Status, transições e limitações para atribuições no Microsoft Graph

As tarefas são uma parte importante da interação entre as ações de professores e alunos. Este artigo descreve as alterações no status da atribuição durante o fluxo do processo e quais APIs de educação no Microsoft Graph estão envolvidas.

Status e transições da atribuição

Uma tarefa representa uma tarefa ou unidade de trabalho atribuída a um aluno ou membro da equipe em uma classe como parte de seu estudo. Somente professores ou proprietários de equipe podem criar, copiar ou agendar tarefas. Essas ações têm impacto no status da atribuição. A tabela a seguir lista o status da atribuição e as APIs disponíveis para alterar o status.

Status Descrição Chamada à API REST Recursos disponíveis para edição
Rascunho Status inicial quando uma nova atribuição é criada ou copiada de uma atribuição existente. POST /education/classes/{id}/assignments Recursos, categorias, critérios de avaliação
Published Um status de processamento em segundo plano quando a tarefa é distribuída para cada aluno atribuído. POST /education/classes/{id}/assignments/{id}/publish
Agendada Status quando o professor agendou a tarefa para publicar em um momento futuro. PATCH /education/classes/{id}/assignments/{id}
POST /education/classes/{id}/assignments/{id}/publish		 Recursos, categorias, critérios de avaliação
Atribuído Após a conclusão do processo de publicação, a tarefa é movida para um status atribuído, tornando-se disponível para os alunos ou permanece em um status ativo. POST /education/classes/{id}/assignments/{id}/publish
POST /education/classes/{id}/assignments/{id}/activate		 Envios
Pending Status de processamento em segundo plano quando uma nova atribuição está sendo copiada de uma existente. PATCH /education/classes/{id}/assignments/{id}
Inativo A tarefa não tem itens de ação adicionais para professores e alunos. POST /education/classes/{id}/assignments/{id}/deactivate

O diagrama a seguir mostra as transições de status que podem ocorrer para atribuições.

Diagrama de transições de status de atribuição

Como verificar se uma tarefa foi publicada

O chamador deve usar a operação de atribuição GET para marcar o status de atribuição atual e verificar se o processo de publicação foi bem-sucedido.

Transições de status de atribuição com base nas ações permitidas

Status da atribuição atual Nova ação Novo status
Rascunho O professor agenda a tarefa Agendada
Rascunho Publicar Published
Rascunho Editado em Rascunho
Rascunho Descartados
Published Publicação concluída Atribuído
Published Falha na publicação Rascunho
Published Descartados
Agendada Atingir data de conclusão Published
Agendada Cancelar agendamento Rascunho
Agendada Reagendar Agendada
Atribuído Descartados
Atribuído Deactivated Inativo
Pending Cópia concluída Rascunho
Pending Descartados
Inativo Activated Atribuído

Observação

Somente ações e transições de status listadas na tabela são permitidas.

Sincronização vs. operações assíncronas em atribuições Chamadas à API

A tabela a seguir lista as chamadas à API que afetam o status da atribuição e o tipo de operação.

As operações síncronas são executadas uma de cada vez. Cada operação deve ser concluída antes que a próxima possa começar, e o resultado final só será retornado quando todas as operações forem concluídas. As operações assíncronas permitem que várias tarefas sejam executadas simultaneamente. Enquanto uma operação está em andamento, outra operação pode ser iniciada antes que a anterior seja concluída. As operações assíncronas normalmente envolvem atividades em segundo plano, e o chamador precisa marcar ativamente o resultado por meio de sondagem ou monitoramento até que ele esteja disponível.

API Sincronização ou assíncrono Mecanismo para obter o status mais recente
DELETE /education/classes/{id}/assignments/{id} Async Enquete
POST /education/classes/{id}/assignments/{id}/publish Async Enquete
PATCH /education/classes/{id}/assignments/{id} Async Enquete
POST /education/classes/{id}/assignments Async Enquete
POST /education/classes/{id}/assignments/{id}/deactivate Async Enquete
POST /education/classes/{id}/assignments/{id}/activate Async Enquete

Limites

Os limites a seguir se aplicam a todas as chamadas à API:

  • O número máximo de recursos de atribuição é 10 para o professor.
  • O tamanho máximo permitido para recursos é de 500 MB.
  • Limites de limitação se aplicam; Para obter detalhes, consulte Diretrizes de limitação do Microsoft Graph.

Conteúdo relacionado

  • Last updated on