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

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

Estados e transições de atribuição

Uma atribuição 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 atribuições. Essas ações têm impacto nos estados de atribuição. A tabela a seguir lista os estados de atribuição e as APIs disponíveis para alterar o estado.

Estado	Descrição	Chamada de API REST	Recursos disponíveis para edição
Rascunho	O status inicial quando uma nova atribuição é criada ou copiada de uma atribuição existente.	POST /education/classes/{id}/assignments	Recursos, categorias, rubricas
Published	Um estado de processamento em segundo plano quando a atribuição é distribuída a cada aluno atribuído.	POST /education/classes/{id}/assignments/{id}/publish
Agendada	Status quando o professor agendou a atribuição para publicar em um momento futuro.	PATCH /education/classes/{id}/assignments/{id} POST /education/classes/{id}/assignments/{id}/publish	Recursos, categorias, rubricas
Atribuído	Depois que o processo de publicação é concluído, a atribuição é movida para um estado atribuído, ficando disponível para os alunos ou permanece em um estado ativo.	POST /education/classes/{id}/assignments/{id}/publish POST /education/classes/{id}/assignments/{id}/activate	Envios
Pending	O processamento em segundo plano status quando uma nova atribuição está sendo copiada de uma existente.	PATCH /education/classes/{id}/assignments/{id}
Inativo	A atribuição 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 estado que podem ocorrer para atribuições.

Como verificar se uma atribuição foi publicada

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

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

Estado de atribuição atual	Nova ação	Novo estado
Rascunho	O professor agenda a atribuição	Agendada
Rascunho	Publicar	Published
Rascunho	Edição	Rascunho
Rascunho	Descartado
Published	Publicar concluído	Atribuído
Published	Falha na publicação	Rascunho
Published	Descartado
Agendada	Alcançar a data de vencimento	Published
Agendada	Cancelar agendamento	Rascunho
Agendada	Remarcar	Agendada
Atribuído	Descartado
Atribuído	Deactivated	Inativo
Pending	Cópia concluída	Rascunho
Pending	Descartado
Inativo	Activated	Atribuído

Observação

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

Sincronizar versus operações assíncronas em relação a chamadas de API de atribuições

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

Operações síncronas são executadas uma por vez. Cada operação deve ser concluída antes que a próxima possa começar e o resultado final só seja retornado depois que todas as operações tiverem sido 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 começar antes que a anterior seja concluída. As operações assíncronas normalmente envolvem atividades em segundo plano, e o chamador precisa marcar ativamente para o resultado por sondagem ou monitoramento até que ele fique disponível.

API	Sincronização ou assíncrona	Mecanismo para obter o estado 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 seguintes limites se aplicam a todas as chamadas de 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

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