Compartilhar via

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

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

Tarefa status e transições

Uma tarefa representa uma tarefa ou unidade de trabalho atribuída a um estudante ou membro da equipa numa turma como parte do estudo. Apenas os professores ou proprietários de equipas podem criar, copiar ou agendar tarefas. Estas ações têm impacto na atribuição status. A tabela seguinte lista os status de atribuição e as APIs que estão disponíveis para alterar o status.

Status Descrição Chamada à API REST Funcionalidades 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 processamento em segundo plano status quando a tarefa é distribuída por cada estudante atribuído. POST /education/classes/{id}/assignments/{id}/publish
Agendada Estado quando o professor agendou a tarefa para publicar numa hora futura. PATCH /education/classes/{id}/assignments/{id}
POST /education/classes/{id}/assignments/{id}/publish		 Recursos, categorias, rubricas
Atribuído Após a conclusão do processo de publicação, a tarefa é movida para um status atribuído, ficando disponível para os estudantes ou permanece num status 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á a ser copiada de uma existente. PATCH /education/classes/{id}/assignments/{id}
Inativo A tarefa não tem itens de ação adicionais para professores e alunos. POST /education/classes/{id}/assignments/{id}/deactivate

O diagrama seguinte mostra o status transições que podem ocorrer para atribuições.

Diagrama de transições de status de atribuição

Como verificar se uma atribuição é publicada

O autor da chamada tem de utilizar 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.

Atribuição status transições com base nas ações permitidas

Status de atribuição atual Nova ação Novo status
Rascunho O professor agenda a tarefa Agendada
Rascunho Publicar Published
Rascunho Editado Rascunho
Rascunho Eliminado
Published Publicação concluída Atribuído
Published Falha na publicação Rascunho
Published Eliminado
Agendada Atingir data para conclusão Published
Agendada Cancelar agenda Rascunho
Agendada Reagendar Agendada
Atribuído Eliminado
Atribuído Deactivated Inativo
Pending Cópia concluída Rascunho
Pending Eliminado
Inativo Activated Atribuído

Observação

Só são permitidas ações e transições status listadas na tabela.

Operações de sincronização vs. assíncronas através de chamadas à API de atribuições

A tabela seguinte lista as chamadas à API que afetam a atribuição status e o tipo de operação.

As operações síncronas são executadas uma de cada vez. Cada operação tem de ser concluída antes de poder começar a operação seguinte e o resultado final só é devolvido depois de todas as operações estarem concluídas. As operações assíncronas permitem a execução simultânea de várias tarefas. Enquanto uma operação está em curso, outra operação pode ser iniciada antes de a anterior ser concluída. Normalmente, as operações assíncronas envolvem atividades em segundo plano e o autor da chamada tem de marcar ativamente para o resultado através de consulta ou monitorização até que fique disponível.

API Sincronizar ou assíncrona Mecanismo para obter os status mais recentes
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 aplicam-se a todas as chamadas à API:

Conteúdo relacionado

  • Last updated on