Adicionando campos de registro a telas de fluxo
Crie telas de fluxo mais rápidas adicionando campos diretamente de seus objetos do Salesforce. Ao adicionar um campo de registro a uma tela de fluxo, seu nome, tipo de dados, texto de ajuda, obrigatoriedade e, em alguns casos, valores existentes, são automaticamente configurados. Campos de registro usam variáveis de registro para determinar quais campos podem ser colocados em uma tela de fluxo e sua configuração.
Edições obrigatórias
| Exibir edições com suporte. |
| Permissões necessárias ao usuário | |
|---|---|
| Para abrir, editar, criar, ativar ou desativar um fluxo usando todos os tipos de fluxo, elementos e recursos disponíveis no Flow Builder, incluindo Einstein e Agentforce para Fluxo: | Gerenciar fluxo |
Colocar campos de registro diretamente em telas de fluxo
Para adicionar campos de registro a um fluxo de tela, siga estas etapas.
- Crie ou edite um elemento de tela.
-
Na guia Campos, selecione uma variável de registro ou crie uma variável com o tipo de dados Registro e o objeto que contém o campo desejado.
Como alternativa, selecione uma variável de registro automaticamente criada por um elemento Obter registros ou um elemento Loop.
- Na lista de campos que aparecem, arraste um campo para a tela.
- Para usar o valor existente de um campo de registro, use um elemento Obter registros para a variável de registro.
Considerações sobre campos de registro em telas de fluxo
Antes de adicionar campos de seus objetos do Salesforce diretamente às telas de fluxo, considere os comportamentos de campo de registro.
Campo de marcador de conta
Colocar o campo padrão Símbolo de marcador nos registros de Conta em sua tela impede que seu fluxo seja salvo.
Criar e atualizar registros
Assim como outros campos em uma tela, os campos de registro não salvam dados automaticamente. Para salvar os dados do campo de registro, use a variável de registro associada em um elemento Criar registros ou Atualizar registros.
Valores padrão
Os campos de registro não oferecem suporte aos valores padrão dos campos de origem. Se o campo de origem de um campo de registro tiver um valor padrão, o campo de registro ficará em branco.
Se o campo contiver um valor na variável de registro, esse valor será definido na tela em tempo de execução como um valor padrão.
Campos de registro de evento e tarefa
Alguns campos de registro de evento e tarefa não têm suporte. Os tipos de campo com suporte são Data, Data/hora, Caixa de seleção, Número, Texto, Área de texto e Área de texto (longo).
No tempo de execução, os campos de registro de evento e tarefa se comportam de maneira diferente em uma tela do que outros tipos de campos de registro.
- Os rótulos de campo de caixa de seleção não são mostrados em linha com a caixa de seleção. Eles são mostrados acima ou abaixo da caixa de seleção.
- Quando editado, o campo de registro não tem um segundo plano amarelo e o botão Desfazer não é mostrado.
Pesquisa
- Não há suporte para criar um registro usando a pesquisa nestes ambientes: Fluxos iniciados de URLs (como Botões de lista), Depurador de fluxo, Lightning Out, Experiências digitais (LWR) e Fluxos de serviço integrado.
- Os campos de pesquisa não são compatíveis com dispositivos móveis.
- Para visualizar ou alterar o valor de um relacionamento Mestre-Detalhe para registros existentes, a configuração Permitir reatribuição deve estar habilitada para esse campo.
- Campos de pesquisa com filtros aplicados não exibem imediatamente erros do tempo de execução do fluxo quando um usuário executando o fluxo tenta criar um registro. Os erros são exibidos apenas ao criar ou atualizar os registros que fazem referência ao registro recém-criado.
- A API da IU deve dar suporte ao objeto em que a Pesquisa está.
Filtros de pesquisa
Se um filtro de pesquisa depender dos valores de campo do registro atual no fluxo, os campos usados no filtro de pesquisa deverão ser adicionados na mesma tela. Se você precisar limitar os registros disponíveis em sua Pesquisa com base nas ações realizadas por um usuário em um fluxo, use o componente Pesquisa de opção.
Listas de opções de seleção múltipla
O uso do operador Adicionar item em atribuições permite valores duplicados em campos de lista de opções de seleção múltipla.
Dar um nome ao campo
Se o valor de um subcampo Nome for alterado no tempo de execução, o novo valor será definido e o subcampo mostrará o novo valor. Porém, o campo de registro Nome completo ainda mostra o valor original.
Permissões
O contexto do sistema não se aplica a campos de registro. Se um usuário não tiver acesso a um campo de registro, ele não poderá vê-lo em um fluxo.
Se nenhum ID for definido para a variável de registro, o usuário em execução precisará de acesso de Read e Create para alterar os valores de campo de registro.
Se um ID for definido, o usuário em execução precisará de acesso de Read e Edit para alterar os valores de campo do registro.
Nos detalhes do campo de registro, os valores em Atualizar compatível e Criar compatível refletem as propriedades do campo e suas permissões. Os valores não refletem as permissões dos usuários que executam o fluxo.
Fluxos de tela não exibem campos de registro definidos como somente leitura no nível do objeto.
Contas pessoais
Se PersonAccount estiver habilitado e os campos de registro de Conta tiverem sido adicionados a uma tela:
- Quando o tipo de registro é Conta pessoal, apenas campos Pessoa* e campos comuns são exibidos.
- Se o tipo de registro for uma Conta comercial, somente campos de conta comercial e campos comuns serão exibidos.
Todos os campos de registro da conta são exibidos e o tipo de registro é ignorado.
O Account.Name é exibido como um campo PersonName se o tipo de registro for Conta pessoal e como um campo Texto se o tipo de registro for uma conta comercial. Account.Name é exibido como um campo de Texto.
Lista de opções
Os campos de registro oferecem suporte a listas de opções dependentes apenas se o campo dependente estiver na mesma tela que seu campo de controle.
Se um campo de registro tiver um ID de tipo de registro definido ao entrar na tela, seus valores serão filtrados por tipo de registro. Se o ID do tipo de registro não estiver definido, todos os valores serão exibidos.
Fazendo referência a campos de registro
Não é possível fazer referência a campos de registro em outras áreas do fluxo, como fórmulas, decisões e visibilidade condicional. Em vez disso, faça referência à variável de registro usada para criar os campos de registro.
Ambientes de tempo de execução
Não há suporte para campos de registro em fluxos de tela em sites do Experience Cloud que usam o Lightning Web Runtime (LWR).
Tipos de dados de campo com suporte
Campos de registro dão suporte a estes tipos de dados de campo: Endereço, caixa de seleção, data, data e hora, email, pesquisa, nome, número, telefone, lista de opções, texto, área de texto e área de texto (longo).
Outras considerações
- Campos de registro oferecem suporte a campos de objeto compatíveis na API da interface de usuário (IU).
- Os campos de registro usam os rótulos retornados pela API da interface de usuário (UI), que podem ser diferentes dos rótulos que aparecem em páginas de registro e no Gerenciador de objetos. Para campos de registro do tipo de dados Nome, o rótulo aparece como Nome completo em vez de Nome para a maioria dos objetos.
- Não há suporte para campos de registro no componente de tela Repetidor.
- Não há suporte para validar a entrada do usuário.
