Considerações de variável de fluxo

Este vídeo explica o que são variáveis e como os fluxos as usam para conter dados.

Veja este vídeo em uma guia separada.

Este vídeo explica os tipos de variáveis, incluindo tipos comuns, variáveis booleanas, definidas pelo Apex e de coleção.

Veja este vídeo em uma guia separada.

Referenciando campos ou recursos em branco

• Se você deixar o valor de um campo ou recurso em branco, o valor será null na hora de execução. Para tratar um valor de texto como uma string vazia em vez de null, defina-o como {!$GlobalConstant.EmptyString}.

Variáveis booleanas

• Tipos booleanos tratam null de maneira diferente de false
• Um fluxo trata null como um valor diferente de false. Por exemplo, se você tentar localizar um registro cujo campo de caixa de seleção esteja definido como null, nenhum registro será retornado. Em vez disso, procure registros em que o campo de caixa de seleção esteja definido como false. Se você estiver usando uma variável (como myCheckbox = {!varBoolean}), certifique-se de que a variável não esteja definida como null antes de referenciá-la em sua condição ou seu filtro de registro.

Variáveis de número

• Variáveis de número são tratadas como inteiros por padrão.

Variáveis de porcentagem

• Se um fluxo usar variáveis de registro para manipular os valores percentuais, teste o fluxo cuidadosamente. Quando você insere um valor no campo de porcentagem da variável de um registro e, em seguida, faz referência a esse campo em uma fórmula, o valor é dividido por 100.

  Por exemplo, o campo Probabilidade de uma oportunidade é definido como 100. Se você atribuir esse valor à variável de registro {!Opportunity.Probability}, o valor ainda será 100. Porém, se você criar uma fórmula cuja expressão seja {!Opportunity.Probability}, o valor será 1.

Variáveis de registro

• As variáveis de registro e coleção de registros oferecem suporte apenas a objetos do Salesforce.

Disponível para entrada/saída

• A desativação do acesso de entrada ou de saída de uma variável existente pode interromper a funcionalidade de aplicativos e páginas que chamam o fluxo e acessam a variável. Por exemplo, você pode acessar variáveis a partir de parâmetros de URL, subfluxos e processos.
• Não é possível adicionar novas variáveis de entrada ou saída a uma substituição de fluxo. Embora você possa remover variáveis existentes, remover uma variável de entrada gerará um erro de tempo de execução se o componente de chamada, como um componente do Lightning, tentar usar a variável de entrada excluída.

Configurar variáveis de entrada

• Criador de processos: Quando um processo ou fluxo inicia outro fluxo, as variáveis de entrada desse fluxo podem ser valores atribuídos durante a inicialização. No entanto, para uma variável de texto, lista de opções ou lista de opções com seleção múltipla que não seja uma coleção, um valor de null será convertido em uma string vazia.
  

  Importante O suporte e as atualizações para o Criador de processos estão agendados para terminar em 31 de dezembro de 2025. Consulte Regras de fluxo de trabalho e fim do suporte para o Criador de processos.

  Após 31 de dezembro de 2025, você pode continuar ativando, desativando e editando qualquer processo existente. Para migrar processos existentes, planeje sua mudança para o Flow Builder e use a ferramenta Migrar para fluxo. Para novas automações, crie fluxos no Flow Builder.

• Ações: As ações de fluxo permitem que você passe o valor do campo de ID do registro no fluxo, mas somente isso. Se o seu fluxo tiver uma variável de Entrada de texto chamada recordId, a ação passa o ID do registro naquela variável no tempo de execução. Caso contrário, isso não será feito e o fluxo tentará ser executado de qualquer maneira.
• Criador de aplicativo Lightning: Variáveis de coleção, variáveis de registro e variáveis de coleção de registros não têm suporte. O componente de Fluxo suporta apenas valores inseridos manualmente para variáveis de entrada. As variáveis de entrada de texto aceitam um comprimento máximo de 4.000 caracteres.
• Elemento de subfluxo: Quando você passa uma variável para uma entrada de subfluxo, o nome da API da variável pode ter até 40 caracteres de comprimento.

Distribuindo fluxos

• Ao distribuir um fluxo, não passe um valor de campo de moeda de um registro do Salesforce para uma variável de moeda de fluxo com um parâmetro de URL. Quando um campo de moeda é referenciado por meio de um campo de mesclagem (como {!Account.AnnualRevenue}), o valor inclui o símbolo da unidade da moeda (por exemplo, $). As variáveis de moeda do fluxo podem aceitar somente valores numéricos, caso contrário, o fluxo falhará no tempo de execução. Em vez disso, passe o ID do registro para uma variável de texto com um parâmetro de URL. Em seguida, no fluxo, use o ID para pesquisar o valor do campo de moeda nesse registro.