Compartilhar via

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

  • Artigo

Os envios são uma parte importante da interação entre as ações dos professores e dos alunos. Isso se refere a alterações no status de envio durante o fluxo de processo e quais APIs de educação no Microsoft Graph estão envolvidas.

Status e transições de envio

Um envio representa os recursos que um indivíduo ou grupo entrega para uma atribuição. Os envios pertencem a uma atribuição e são criados automaticamente quando uma atribuição é publicada.

O status é uma propriedade somente leitura no envio. Ele muda com base nas ações de alunos e professores.

Status Descrição Chamada de API REST
Trabalhando O status inicial após a criação do envio. POST /education/classes/{id}/assignments
POST /education/classes/{id}/assignments/{id}/submissions/{id}/unsubmit
Enviado O status depois que o aluno entrega a tarefa. POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit
Retornado O status depois que o professor retornou uma tarefa ao aluno. POST /education/classes/{id}/assignments/{id}/submissions/{id}/return
Reatribuída O status depois que o professor retornou a atribuição ao aluno para revisão. POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign
Desculpa Os professores podem marcar um envio conforme desculpado para indicar que o envio não tem mais nenhuma ação para o aluno. POST /education/classes/{id}/assignments/{id}/submissions/{id}/excuse

O diagrama a seguir mostra o fluxo de transição status.

Diagrama de transições de status de envio

Transições de status de envio com base em ações permitidas

Status de envio atual Nova ação Novo status
Trabalhando Ativar Enviado
Trabalhando Retornar para revisão Reatribuída
Trabalhando retornar Retornado
Trabalhando Desculpa Dispensado
Enviado Desfazer Entregar Trabalhando
Enviado retornar Retornado
Enviado Retornar para revisão Reatribuída
Enviado Desculpa Dispensado
Retornado Ativar Enviado
Retornado retornar Retornado
Retornado Retornar para revisão Reatribuída
Retornado Desculpa Dispensado
Reatribuída Ativar Enviado
Reatribuída retornar Retornado
Reatribuída Retornar para revisão Reatribuída
Reatribuída Desculpa Dispensado
Dispensado Retornar para revisão Reatribuída
Dispensado retornar Retornado
Dispensado Ativar Enviado

Observação

Nenhuma ação e status transição não listada na tabela não são permitidas.

Sincronizar operações vs. assíncronas em chamadas de API de envios

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

Nesse caso, todas as chamadas são assíncronas, o que significa que a operação é iniciada e outra operação pode começar antes que a primeira seja concluída. A operação assíncrona executa algumas atividades em segundo plano e o chamador deve estar sondando para obter o resultado.

API Sincronização ou assíncrona Mecanismo para obter o status mais recente
POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit Async Enquete
POST /education/classes/{id}/assignments/{id}/submissions/{id}/unsubmit Async Enquete
POST /education/classes/{id}/assignments/{id}/submissions/{id}/return Async Enquete
POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign Async Enquete
POST /education/classes/{id}/assignments/{id}/submissions/{id}/excuse Async Enquete

Limites

Os seguintes limites se aplicam a todas as chamadas de API:

  • O número máximo de recursos de envio é 10 para o aluno.
  • 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