Design e Validação de Fluxos Salesforce

Aplique estas verificações a todos os Fluxos que você projetar, construir ou revisar.

Etapa 1 — Confirmar se o Fluxo é a Ferramenta Certa

Antes de projetar um Fluxo, verifique se uma opção declarativa mais leve não pode resolver o problema:

Se você estiver construindo um Fluxo que poderia ser substituído por um campo de fórmula ou regra de validação, peça ao usuário para confirmar se o requisito é genuinamente mais complexo.

Etapa 2 — Selecionar o Tipo de Fluxo Correto

Regra de decisão: escolha antes do salvamento quando você precisar apenas alterar os próprios campos do registro de disparo. Mova para após o salvamento no momento em que precisar tocar em registros relacionados, enviar e-mails ou fazer chamadas externas.

Etapa 3 — Checklist de Segurança para Lotes

Estes padrões são falhas nos limites do governador em escala. Verifique todos eles antes que o Fluxo seja ativado.

DML em Loops — Falha Automática

Loop element
  └── Create Records / Update Records / Delete Records  ← ❌ DML inside loop

Correção: colete os registros dentro do loop em uma variável de coleção, então execute o elemento DML fora do loop.

Obter Registros em Loops — Falha Automática

Loop element
  └── Get Records  ← ❌ SOQL inside loop

Correção: execute a consulta Obter Registros antes do loop, então itere sobre a variável de coleção.

Padrão de Lote Correto

Get Records — collect all records in one query
└── Loop over the collection variable
    └── Decision / Assignment (no DML, no Get Records)
└── After the loop: Create/Update/Delete Records — one DML operation

Transformar vs Loop

Quando o objetivo é remodelar uma coleção (por exemplo, mapear valores de campos de um objeto para outro), use o elemento Transformar em vez de um padrão Loop + Atribuição. Transformar é seguro para lotes por design e produz gráficos de Fluxo mais limpos.

Etapa 4 — Requisitos de Caminho de Falha

Todo elemento que pode falhar em tempo de execução deve ter um conector de falha. Fluxos sem caminhos de falha exibem erros brutos do sistema para os usuários.

Elementos que Requerem Conectores de Falha

• Criar Registros
• Atualizar Registros
• Excluir Registros
• Obter Registros (ao acessar um registro obrigatório que pode não existir)
• Enviar E-mail
• Chamada HTTP / Ação de Serviço Externo
• Ação Apex (invocável)
• Subfluxo (se o subfluxo puder gerar uma falha)

Padrão de Manipulador de Falha

Fault connector → Log Error (Create Records on a logging object or fire a Platform Event)
               → Screen element with user-friendly message (Screen Flows)
               → Stop / End element (Record-Triggered Flows)

Nunca conecte um caminho de falha de volta ao mesmo elemento que falhou — isso cria um loop infinito.

Etapa 5 — Verificação de Densidade de Automação

Antes de implantar, verifique se não há automações sobrepostas no mesmo objeto e evento de disparo:

• Outros Fluxos Registro-Disparados ativos na mesma combinação Object + When to Run
• Regras de Process Builder legadas ainda ativas no mesmo objeto
• Regras de Fluxo de Trabalho que disparam nas mesmas alterações de campo
• Gatilhos Apex que também executam no mesmo contexto before insert / after update

Automações sobrepostas podem causar ordenação inesperada, recursão e falhas nos limites do governador. Documente o inventário de automação para o objeto antes de ativar.

Etapa 6 — Diretrizes de UX para Fluxo de Tela

…