Monitorar execuções de ações em massa
Toda ação em massa que você dispara — atribuir, presença, excluir, enviar mensagem, editar — aparece em /bulk-actions como uma linha no histórico de execuções. Essa página é seu ponto de inspeção: a execução terminou, linhas falharam, você precisa tentar de novo, e o que exatamente mudou.
A página faz auto-poll a cada 5 segundos enquanto qualquer execução está ativa, então você não precisa atualizar.
Estados de execução
Cada linha tem um badge de status:
| Estado | Significado |
|---|---|
| Queued | A execução está na fila de trabalho mas o worker ainda não a iniciou. Geralmente milissegundos. |
| Running | Worker está processando linhas. A barra de progresso mostra N de M concluídos. |
| Completed | Todas as linhas aplicadas sem falhas. |
| Partial | Algumas linhas aplicadas, algumas falharam. Estado mais acionável — você geralmente vai tentar de novo. |
| Failed | Um erro de nível de sistema parou a execução (banco de dados indisponível, permissão revogada no meio da execução). |
| Cancelled | Você apertou Cancelar. Linhas já aplicadas ficam; linhas pendentes pulam. |
Abrir uma execução
Clique em qualquer linha e você verá a página de detalhe da execução:
- Cartões de resumo — total de linhas, aplicadas, falhadas, puladas, duração.
- Snapshot de seleção — a lista exata de IDs de membros que a execução visou, capturada no momento de clicar Aplicar.
- Itens com falha — toda linha que não se aplicou, com um motivo.
- Botão Tentar novamente as falhas (quando existem falhas).
- Botão Cancelar (quando a execução está na fila ou rodando).
- Botão Re-executar (quando a execução terminou, independente do resultado).
A lista de itens com falha
Uma linha falha quando o worker tenta escrevê-la e o banco de dados rejeita a operação. Motivos comuns:
| Erro | O que significa | Geralmente |
|---|---|---|
permission denied | O usuário atual perdeu a permissão desde que clicou em Aplicar | Permissão foi revogada no meio da execução |
member not found | O membro foi excluído por outra pessoa durante a execução | Condição de corrida |
unique violation | A escrita criaria uma duplicata | Reexecutando uma atribuição antiga em membros já no alvo |
null value violates not-null | Um campo obrigatório estava faltando | Quase sempre uma má configuração de workflow |
O texto do motivo aparece inline ao lado de cada membro com falha, para você varrer a lista e decidir se a execução vale a pena tentar de novo como está ou se você precisa corrigir o problema subjacente primeiro.
Tentar novamente as falhas é idempotente
O botão de tentar de novo re-enfileira apenas as linhas que falharam, com os mesmos parâmetros. Linhas já aplicadas ficam aplicadas — a ação não as reaplica. Seguro clicar quantas vezes você precisar até que toda linha tenha sucesso ou o motivo da falha mude (ex.: permissão foi restaurada).
Cancelar no meio
Para ações longas em milhares de linhas, você pode Cancelar pela página de detalhe da execução. O worker para de buscar o próximo lote e a execução vai para Cancelled. Linhas já aplicadas ficam aplicadas. O snapshot de seleção é preservado, então você pode re-executar na mesma lista depois.
Cancelar não é desfazer
Cancelar para escritas adicionais, mas não desfaz o que já foi escrito. Se você cancelou uma exclusão e 200 de 500 membros já foram excluídos suavemente, esses 200 ficam excluídos suavemente. Use a lixeira para restaurá-los se necessário.
Por quanto tempo o histórico é mantido
As linhas de execução vivem em bulk_action_runs e ficam por 90 dias. Depois disso, um job noturno as arquiva fora da tabela ativa. A auditoria permanente de quem-mudou-o-quê está no registro de auditoria, que retém indefinidamente.
Notificações
Se uma execução leva mais de 30 segundos, o GCM envia e-mail ao usuário que a iniciou quando ela termina. Se a execução atinge Partial ou Failed, o e-mail inclui um link direto para a página de detalhe da execução. Para execuções abaixo de 30 segundos, você verá o resultado na página, sem e-mail.
Próximos passos
- Atribuição e presença em massa — as ações em massa mais comuns.
- Excluir e restaurar — exclusão suave e a janela de 30 dias.
- Registro de auditoria — registro de longo prazo do que mudou.
- Usuários e papéis → Registro de auditoria — para rastrear concessões e revogações de permissão.