Debug de Flow com Record ID digitado direto no depurador
Agora dá para testar um flow com um registro específico só colando o ID, sem depender da busca por lookup.
O Flow Builder ganhou uma forma de informar o registro de teste digitando o ID diretamente no depurador. Isso resolve um problema real com objetos que têm busca limitada, como Case e Campaign Member.
O que é
A partir da Winter '27, o depurador do Flow Builder aceita a entrada direta de um record ID estático, com 15 ou 18 caracteres, para testar o flow com um registro específico. Em vez de usar o campo de busca por lookup para localizar o registro, você simplesmente cola o ID.
Segundo as release notes, essa opção existe especificamente para ajudar a testar flows que usam objetos com capacidade de busca limitada, como Cases ou Campaign Members. Esses objetos costumam ter poucos campos indexados para pesquisa textual, o que torna a busca por lookup lenta ou pouco confiável no depurador tradicional.
O texto oficial não detalha mudanças de API version nem de permissão associadas a esse recurso, então trato como uma melhoria pontual de usabilidade dentro da experiência de debug já existente no Flow Builder.
Por que importa
Quem já tentou debugar um flow em Case sabe a dor, o campo de busca por lookup geralmente indexa Subject ou Case Number, e se você não lembra o texto exato, fica catando registro na lista relacionada ou no console. Já perdi minutos preciosos numa sessão de teste só procurando o Case certo dessa forma. Com Campaign Member a situação é pior ainda, porque a busca textual em objetos de junção é notoriamente limitada.
Na prática, isso reduz o atrito no ciclo de teste. Se você já sabe o ID do registro de teste, seja porque acabou de criá-lo, seja porque copiou de uma URL, o fluxo de trabalho fica mais direto. Não é uma mudança arquitetural, mas é o tipo de ajuste que economiza tempo real no dia a dia de quem constrói e valida flows com frequência, especialmente em orgs com volume grande de dados onde a busca por lookup tende a truncar resultados.
Como se preparar
- Mapeie os flows do seu projeto que usam objetos com busca limitada, como Case, Campaign Member ou objetos de junção customizados, para priorizar esse método de teste neles.
- Padronize com o time a prática de copiar o record ID de 18 caracteres direto da URL do registro antes de abrir o depurador, evitando ambiguidade entre IDs de 15 e 18 caracteres.
- Inclua esse fluxo de teste na documentação de QA de flows, principalmente para cenários em sandbox onde os dados de teste têm nomes genéricos e pouco pesquisáveis.
- Revise scripts de teste manual existentes que dependiam de busca por lookup e avalie se vale substituir por entrada direta de ID, reduzindo passos no processo de validação.
Nível de aplicação: Baixo
É uma melhoria de usabilidade na interface do depurador do Flow Builder, sem impacto em API, permissões ou arquitetura da org.
Considerações de arquiteto
- Priorize esse método de teste nos flows que operam sobre Case, Campaign Member ou objetos de junção customizados onde a busca por lookup no depurador costuma falhar.
- Padronize com a equipe o hábito de copiar o ID de 18 caracteres direto da URL do registro para evitar confusão entre truncamento de IDs de 15 e 18 caracteres.
- Atualize a documentação de QA de flows para incluir a entrada direta de record ID como método preferencial em sandboxes com dados de teste pouco pesquisáveis.
- Avalie os scripts de teste manual existentes que ainda dependem da busca por lookup e simplifique-os substituindo por entrada direta de ID quando aplicável.
Pegadinhas:
- As release notes não mencionam mudança de API version nem de permissão, então não há dependência técnica adicional para habilitar esse recurso.
Este artigo faz parte do guia Flow na Winter '27, um item oficial por artigo. Fonte: release notes de Automation.