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

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 estado de envio durante o fluxo de processo e quais APIs de educação no Microsoft Graph estão envolvidas.

Estados 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.

Estado	Descrição	Chamada de API REST
Trabalhando	Estado inicial após a criação do envio.	POST /education/classes/{id}/assignments POST /education/classes/{id}/assignments/{id}/submissions/{id}/unsubmit
Enviado	O estado após o aluno se transformar na atribuição.	POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit
Retornado	O estado após o professor ter retornado uma atribuição ao aluno.	POST /education/classes/{id}/assignments/{id}/submissions/{id}/return
Reatribuída	O estado após o professor ter retornado 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 de estado.

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

Estado de envio atual	Nova ação	Novo estado
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 a transição de estado não listadas 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 estado 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 estado 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

• Estados, transições e limitações para atribuições