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

Figura 1: Estados possíveis de uma 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 agenda novas tentativas automaticamente, com intervalos crescentes e variação aleatória para distribuir a carga. O sistema realiza até 10 tentativas, com intervalos crescentes de até 60 minutos entre elas. Após esgotar as tentativas ou ultrapassar 48 horas desde a criação, a ação passa ao estado Abandonada e fica disponível para reprocessamento manual.

Quando o Retry não é Tentado

• Erros de validação (dados inválidos)
• Permissão negada de forma permanente
• Recursos referenciados que não podem ser criados

Substituição de Ações

Quando os dados do RH mudam novamente antes de uma ação ser executada:

1. A ação pendente é marcada como Substituída
2. Uma nova ação é criada com os dados atualizados
3. 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

Auto-aprovação dentro de lotes

Ações cujos tipos estão na lista de auto-aprovação são executadas imediatamente, mesmo quando fazem parte de um lote que aguarda revisão. O lote então passa a conter apenas as ações que efetivamente exigem aprovaçã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:

1. Abra os detalhes da ação
2. Clique em Retentar
3. A ação volta para o estado Pendente
4. O sistema tentará executar novamente

Cancelar Ação

Para ações pendentes:

1. Abra os detalhes da ação
2. Clique em Cancelar
3. A ação é marcada como Cancelada
4. 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

1. Monitore ações com falha: Configure alertas para falhas repetidas.

2. Investigue erros persistentes: Erros após múltiplas tentativas indicam problemas de configuração.

3. Use aprovações: Mantenha aprovações ativas para operações críticas.

4. 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