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 dos professores e dos alunos. Isto diz respeito a alterações no status de submissão durante o fluxo do processo e às APIs de educação envolvidas no Microsoft Graph.
Submissão status e transições
Uma submissão representa os recursos que um indivíduo ou grupo entrega para uma atribuição. As submissões pertencem a uma atribuição e são criadas automaticamente quando uma atribuição é publicada.
O status é uma propriedade só de leitura na submissão. Muda com base nas ações dos estudantes e professores.
| Status | Descrição | Chamada à API REST |
|---|---|---|
| Trabalhando | Status inicial após a criação da submissão. | POST /education/classes/{id}/assignmentsPOST /education/classes/{id}/assignments/{id}/submissions/{id}/unsubmit |
| Enviado | O status depois de o aluno fazer a tarefa. | POST /education/classes/{id}/assignments/{id}/submissions/{id}/submit |
| Devolvido | O status depois de o professor ter devolvido uma tarefa ao aluno. | POST /education/classes/{id}/assignments/{id}/submissions/{id}/return |
| Reatribuído | O status depois de o professor ter devolvido a tarefa ao estudante para revisão. | POST /education/classes/{id}/assignments/{id}/submissions/{id}/reassign |
| Desculpa, desculpa. | Os professores podem marcar uma submissão como dispensada para indicar que a submissão não tem mais nenhuma ação para o aluno. | POST /education/classes/{id}/assignments/{id}/submissions/{id}/excuse |
O diagrama seguinte mostra o fluxo de transição status.
Submissão status transições com base em ações permitidas
| Status de submissão atual | Nova ação | Novo status |
|---|---|---|
| Trabalhando | Entregar | Enviado |
| Trabalhando | Devolução para revisão | Reatribuído |
| Trabalhando | retornar | Devolvido |
| Trabalhando | Desculpa, desculpa. | Dispensado |
| Enviado | Anular Entregar | Trabalhando |
| Enviado | retornar | Devolvido |
| Enviado | Devolução para revisão | Reatribuído |
| Enviado | Desculpa, desculpa. | Dispensado |
| Devolvido | Entregar | Enviado |
| Devolvido | retornar | Devolvido |
| Devolvido | Devolução para revisão | Reatribuído |
| Devolvido | Desculpa, desculpa. | Dispensado |
| Reatribuído | Entregar | Enviado |
| Reatribuído | retornar | Devolvido |
| Reatribuído | Devolução para revisão | Reatribuído |
| Reatribuído | Desculpa, desculpa. | Dispensado |
| Dispensado | Devolução para revisão | Reatribuído |
| Dispensado | retornar | Devolvido |
| Dispensado | Entregar | Enviado |
Observação
Não é permitida qualquer ação e status transição não listada na tabela.
Operações de sincronização vs. assíncronas através de chamadas à API de submissões
A tabela seguinte lista as chamadas à API que afetam a status de submissão e o tipo de operação.
Neste caso, todas as chamadas são assíncronas, o que significa que a operação é iniciada e outra operação pode começar antes de a primeira terminar. A operação assíncrona executa alguma atividade em segundo plano e o autor da chamada tem de estar a consultar para obter o resultado.
| API | Sincronizar ou assíncrona | Mecanismo para obter os status mais recentes |
|---|---|---|
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 aplicam-se a todas as chamadas à API:
- O número máximo de recursos de submissão é 10 para o estudante.
- O tamanho máximo permitido para recursos é de 500 MB.
- Aplicam-se limites de limitação; para obter detalhes, veja Orientações de limitação do Microsoft Graph.