Compartilhar via

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

  • Artigo

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

Status 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 no status de atribuição. A tabela a seguir lista o status de atribuição e as APIs disponíveis para alterar o status.

Status 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 processamento em segundo plano status 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 status atribuído, ficando disponível para os alunos ou permanece em um 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á 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 status que podem ocorrer para atribuições.

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

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 status de atribuição com base nas ações permitidas

Atribuição atual status Nova ação Novo status
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 status transições 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 status 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 status 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