Ações
Ações são operações que o Sincroniza executa nos provedores de identidade (Active Directory e Entra ID). Cada mudança detectada no RH pode gerar uma ou mais ações.
O que são Ações?
Uma ação representa uma operação atômica a ser executada, como:
- Criar uma conta de usuário
- Atualizar atributos de uma conta
- Adicionar um usuário a um grupo
- Atribuir uma licença
- Desabilitar uma conta
Tipos de Ações
Ações de Conta
| Tipo | Descrição |
|---|---|
CriarContaAD | Cria usuário no Active Directory |
CriarContaEntra | Cria usuário no Entra ID |
AtualizarContaAD | Atualiza atributos no AD |
AtualizarContaEntra | Atualiza atributos no Entra ID |
DesabilitarContaAD | Desabilita conta no AD |
DesabilitarContaEntra | Desabilita conta no Entra ID |
HabilitarContaAD | Habilita conta no AD |
HabilitarContaEntra | Habilita conta no Entra ID |
Ações de Grupo
| Tipo | Descrição |
|---|---|
AdicionarAoGrupoAD | Adiciona usuário a grupo AD |
AdicionarAoGrupoEntra | Adiciona usuário a grupo Entra |
RemoverDoGrupoAD | Remove usuário de grupo AD |
RemoverDoGrupoEntra | Remove usuário de grupo Entra |
Ações de Licença
| Tipo | Descrição |
|---|---|
AtribuirLicenca | Atribui licença Microsoft 365 |
RemoverLicenca | Remove licença Microsoft 365 |
Ciclo de Vida da Ação
Estados
| Estado | Descrição |
|---|---|
| Pendente | Ação criada, aguardando execução |
| AguardandoAprovação | Ação requer aprovação humana antes de executar |
| EmProgresso | Ação está sendo executada |
| Concluída | Ação executada com sucesso |
| Ignorada | Ação ignorada (o estado esperado já existe no provedor) |
| Falha | Ação falhou durante execução (pode ser retentada) |
| AguardandoRetentativa | Falhou, aguardando retry automático |
| Abandonada | Abandonada após máximo de tentativas ou timeout |
| Cancelada | Ação foi cancelada (rejeitada ou manualmente) |
| Substituída | Ação foi substituída por outra mais recente |
Transições de Estado
┌───────────────┐
│ Pendente │
└───────┬───────┘
│
┌───────────────────┼───────────────────┐
▼ ▼ ▼
┌──────────────┐ ┌────────────┐ ┌────────────────┐
│ Aguardando │ │ Em │ │ Substituída │
│ Aprovação │ │ Progresso │ │ │
└──────┬───────┘ └─────┬──────┘ └────────────────┘
│ │
┌──────┴──────┐ ┌────┴────────────┬─────────┐
▼ ▼ ▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌──────────┐ ┌──────────┐ ┌────────┐
│ Aprovada│ │Rejeitada│ │Concluída │ │ Ignorada │ │ Falha │
└────┬────┘ └────┬────┘ └──────────┘ └──────────┘ └────┬───┘
│ │ │
▼ ▼ ▼
┌────────────┐ ┌─────────┐ ┌─────────────────┐
│Em Progresso│ │Cancelada│ │ Aguardando │
└────────────┘ └─────────┘ │ Retentativa │
└────────┬────────┘
│
┌────────┴────────┐
▼ ▼
┌──────────┐ ┌────────────┐
│ Pendente │ │ Abandonada │
└──────────┘ └────────────┘Retry Automático
Quando uma ação falha, o sistema pode tentar novamente automaticamente:
Configuração de Retry
- Máximo de tentativas: Configurável (padrão: 5)
- Backoff exponencial: 2^n minutos entre tentativas
- Jitter: ±20% para evitar picos de carga
- Tempo máximo: 60 minutos entre tentativas
Exemplo de Tempo Entre Tentativas
| Tentativa | Tempo Base | Com Jitter |
|---|---|---|
| 1 | 2 min | 1.6-2.4 min |
| 2 | 4 min | 3.2-4.8 min |
| 3 | 8 min | 6.4-9.6 min |
| 4 | 16 min | 12.8-19.2 min |
| 5 | 32 min | 25.6-38.4 min |
Quando o Retry não é Tentado
- Erro de validação (dados inválidos)
- Permissão negada permanente
- Recurso não encontrado e não pode ser criado
Substituição de Ações
Quando os dados do RH mudam novamente antes de uma ação ser executada:
- A ação pendente é marcada como Substituída
- Uma nova ação é criada com os dados atualizados
- A ação substituída não é executada
Isso garante que apenas o estado mais recente seja aplicado.
Visualizando Ações
Lista de Ações
Acesse Ações no menu para ver todas as ações:
Filtros Disponíveis
- Status: Pendente, Em Progresso, Concluída, Falha, etc.
- Tipo: Criar Conta, Atualizar, Grupo, Licença, etc.
- Funcionário: Buscar por nome ou matrícula
- Período: Data de criação
Detalhes da Ação
Clique em uma ação para ver:
- Funcionário afetado
- Tipo e descrição da ação
- Parâmetros (grupos, atributos, etc.)
- Histórico de tentativas
- Mensagens de erro (se houver)
Operações Manuais
Retentar Ação
Para ações que falharam:
- Abra os detalhes da ação
- Clique em Retentar
- A ação volta para o estado Pendente
- O sistema tentará executar novamente
Cancelar Ação
Para ações pendentes:
- Abra os detalhes da ação
- Clique em Cancelar
- A ação é marcada como Cancelada
- Não será executada
Atenção
Ações canceladas podem ser recriadas na próxima sincronização se as condições ainda forem válidas.
Auditoria de Ações
Cada ação mantém um histórico completo:
- Data/hora de criação
- Mudanças de estado
- Tentativas de execução
- Erros encontrados
- Quem aprovou (se aplicável)
Dependências Entre Ações
Algumas ações têm dependências:
┌─────────────────┐
│ Criar Conta │
└────────┬────────┘
│ precede
┌────┴────┐
▼ ▼
┌───────┐ ┌───────────┐
│Grupos │ │ Licenças │
└───────┘ └───────────┘O sistema gerencia automaticamente a ordem de execução.
Boas Práticas
Recomendações
Monitore ações com falha: Configure alertas para falhas repetidas.
Investigue erros persistentes: Erros após múltiplas tentativas indicam problemas de configuração.
Use aprovações: Mantenha aprovações ativas para operações críticas.
Revise ações canceladas: Entenda por que ações foram canceladas.
Próximos Passos
- Aprovações - Entenda o fluxo de aprovação
- Monitoramento de Ações - Guia de uso
- Solução de Problemas - Resolva erros comuns