Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
As submissões são uma parte importante da interação entre as ações de professores e alunos. Isso está relacionado a alterações no status de envio durante o fluxo do processo e quais APIs educacionais no Microsoft Graph estão envolvidas.
Status de submissão e transições
Um envio representa os recursos que um indivíduo ou grupo entrega para uma tarefa. Os envios são de propriedade de uma tarefa e são criados automaticamente quando uma tarefa é publicada.
O status é uma propriedade somente leitura no envio. Ele muda com base nas ações de alunos e professores.
| Status | Descrição | Chamada à API REST |
|---|---|---|
| Trabalhando | Status inicial após a criação do envio. | POST /education/classes/{id}/assignmentsPOST /education/classes/{id}/assignments/{id}/submissions/{id}/unsubmit |
| Enviado | O status após o aluno entregar a tarefa. | POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit |
| Retornado | O status após o professor devolver uma tarefa ao aluno. | POST /education/classes/{id}/assignments/{id}/submissions/{id}/return |
| Reatribuído | O status após o professor ter devolvido a tarefa ao aluno para revisão. | POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign |
| Desculpa | Os professores podem marcar um envio como dispensado 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 status.
Transições de status de envio com base em ações permitidas
| Status de envio atual | Nova ação | Novo status |
|---|---|---|
| Trabalhando | Entregar | Enviado |
| Trabalhando | Retornar para revisão | Reatribuído |
| Trabalhando | retornar | Retornado |
| Trabalhando | Desculpa | Desculpado |
| Enviado | Desfazer Entrega | Trabalhando |
| Enviado | retornar | Retornado |
| Enviado | Retornar para revisão | Reatribuído |
| Enviado | Desculpa | Desculpado |
| Retornado | Entregar | Enviado |
| Retornado | retornar | Retornado |
| Retornado | Retornar para revisão | Reatribuído |
| Retornado | Desculpa | Desculpado |
| Reatribuído | Entregar | Enviado |
| Reatribuído | retornar | Retornado |
| Reatribuído | Retornar para revisão | Reatribuído |
| Reatribuído | Desculpa | Desculpado |
| Desculpado | Retornar para revisão | Reatribuído |
| Desculpado | retornar | Retornado |
| Desculpado | Entregar | Enviado |
Observação
Qualquer transição de ação e status não listada na tabela não é permitida.
Sincronização vs. operações assíncronas sobre envios Chamadas à API
A tabela a seguir lista as chamadas à 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íncrono | 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 limites a seguir se aplicam a todas as chamadas à 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.