Componente Entrada da tela de pesquisa
Permita que os usuários pesquisem e selecionem um ou mais registros existentes em um fluxo de tela para que você possa usar esse registro mais tarde no fluxo. Ao configurar um componente de Pesquisa, você define o componente para simular um campo de pesquisa existente em um objeto para que ele obtenha a mesma funcionalidade. Por exemplo, se você estiver adicionando um componente de tela de pesquisa de conta, use o campo de pesquisa de conta no objeto Contato para simular a funcionalidade. O fluxo está temporariamente usando a definição do campo Contact.AccountId padrão para habilitar o componente da tela de pesquisa de conta, embora nenhum registro de contato esteja sendo criado ou atualizado.
Edições obrigatórias
Configurar o componente de pesquisa
| Atributo | Descrição |
|---|---|
| Nome da API | O nome da API do componente. Um nome de API pode conter sublinhados e caracteres alfanuméricos sem espaços. Ele deve começar com uma letra e não pode terminar com um sublinhado. Ele não pode também ter dois sublinhados consecutivos. |
| Nome de API do campo | O nome da API de um campo de pesquisa no objeto de origem referenciado em Nome da API do objeto. O campo de pesquisa referenciado em Nome da API do campo deve ser um campo no objeto referenciado em Nome da API do objeto. Por exemplo, se você quiser adicionar uma pesquisa para uma conta, encontre um objeto que tenha um campo de pesquisa de conta nele. Nesse caso, vamos usar o campo de pesquisa de conta no objeto Contato. O nome da API do campo de pesquisa de conta no objeto Contato é AccountId, portanto, insira AccountId para Nome da API do campo e, em seguida, insira Contact para Nome da API do objeto. |
| Rótulo | O texto exibido na parte superior do componente que informa ao usuário em execução como usar o componente de tela. Por exemplo, se você estiver adicionando uma pesquisa de conta, o rótulo poderá ser Selecionar conta. |
| Nome de API do objeto | O nome da API do objeto de origem que tem o campo de pesquisa referenciado em Nome da API do campo. O objeto de origem pode ser qualquer objeto que tenha o tipo de campo de pesquisa que você deseja usar. O campo de pesquisa referenciado em Nome da API do campo deve ser um campo no objeto referenciado em Nome da IA do objeto. Para usar o componente Pesquisa, o usuário em execução do fluxo deve ter a permissão Criar no objeto de origem. Por exemplo, se você quiser adicionar uma pesquisa para um contato, encontre um objeto que tenha um campo de pesquisa de contato nele. Nesse caso, vamos usar o campo de pesquisa de contato no objeto Caso. O nome da API do objeto Caso é Caso, portanto, insira Case para Nome da API do objeto e, em seguida, insira ContactId para Nome da API do campo. |
| Desativado | Se definido como verdadeiro, o usuário não poderá modificar o valor. O valor padrão é false. Esse atributo aceita um recurso com um valor booleano. |
| Máximo de seleções | O número máximo de registros que o usuário pode selecionar. O valor padrão é 1. |
| ID do registro | Inicialmente, se Máximo de seleções for 1 ou Máximo de seleções for maior do que 1 e o campo Coleção de IDs de registro for nulo, o ID do registro selecionado por padrão para a pesquisa. Quando um usuário executa o fluxo, o valor muda para a seleção do usuário do fluxo. |
| Coleção de IDs de registro | Inicialmente, se o Máximo de seleções for maior do que 1, os IDs de registro padrão para a pesquisa. Inicialmente, se Máximo de seleções for maior do que 1 e o campo de ID de registro for nulo, o primeiro valor será os IDs de registro selecionados por padrão para a pesquisa. Você pode especificar qualquer número de IDs de registro até o valor de Máximo de seleções. Quando um usuário executa o fluxo, o valor muda para as seleções do usuário do fluxo. |
| Obrigatório | Se definido como verdadeiro, o usuário em execução deverá inserir um valor. O valor padrão é false. Esse atributo aceita um recurso com um valor booleano. |
Armazene os valores do componente de pesquisa no fluxo
O fluxo armazena valores automaticamente. Se você armazenar valores manualmente, armazene o valor de saída do atributo em uma variável.
Para armazenar os valores manualmente, selecione Atribuir variáveis manualmente (avançado).
Todos os atributos estão disponíveis para armazenamento em variáveis de fluxo, mas é mais provável que você deva armazenar esses atributos.
| Atributo | Descrição |
|---|---|
| ID do registro | Se o valor de Máximo de seleções for 1, o ID do registro que o usuário seleciona. Você pode armazenar esse valor em uma variável de Texto. |
| Coleção de IDs de registro | Se o valor de Máximo de seleções for maior do que 1, a lista de IDs dos registros que o usuário seleciona. Se o valor de Máximo de seleções for 1 e o ID do registro for nulo, o primeiro valor na coleção será o ID do registro que o usuário seleciona. Você pode armazenar esse valor em uma variável de coleção de Texto. |
| Nome do registro | Se o valor de Máximo de seleções for 1, o valor do campo Nome do registro que o usuário seleciona. Se o valor de Máximo de seleções for maior do que 1, o valor do campo Nome do primeiro registro que o usuário seleciona. Você pode armazenar esse valor em uma variável de Texto. Esse valor não é preenchido quando o campo de Nome do registro for um objeto externo. |
- Navegue para outra tela e retorna à tela do componente.
- Pausa o fluxo e o retoma.
- Navega para a próxima tela e aciona um erro de validação de entrada.
Configurar o atributo habilita um fluxo a lembrar o valor. O fluxo armazena o valor automaticamente. Se você armazenar valores manualmente, armazene o valor de saída do atributo em uma variável.
Definir a visibilidade do componente
Especifique a lógica que determina quando o fluxo exibe o componente.
| Opção | Descrição |
|---|---|
| Quando exibir o componente | Configure quando o componente é exibido usando a lógica condicional. É possível definir os componentes como:
|
Validar a entrada
Forneça uma fórmula que avalie se o que o usuário inseriu é válido e a mensagem de erro a ser exibida, se inválido.
| Opção | Descrição |
|---|---|
| Mensagem de erro | Especifique a mensagem de erro que aparecerá abaixo do componente se o usuário inserir um valor inválido. |
| Fórmula | Forneça uma expressão de fórmula que retorne um valor booleano. Se a expressão da fórmula for avaliada como true, a entrada é válida. Se a expressão da fórmula for avaliada como false, a mensagem de erro aparecerá abaixo do componente. Se o usuário deixar o campo em branco e o campo não for obrigatório, o fluxo não realizará a validação. Se o usuário deixar o campo em branco e o campo for obrigatório, o fluxo mostrará a mensagem de erro padrão, não a sua mensagem de erro personalizada. |
Especificar o comportamento de valores em telas revisitadas
Especifique o que esse componente faz quando um usuário insere um valor, navega para uma tela anterior e depois retorna à tela com esse componente.
Considerações
- O componente da tela de fluxo de Pesquisa não é compatível com dispositivos móveis ou aplicativos Aura independentes.
- Filtros de pesquisa dependentes não são aplicados para o componente de Pesquisa em um fluxo. Outros filtros de pesquisa são aplicados da mesma maneira que em páginas de registro do Lightning Experience. Quando o fluxo acessa o banco de dados do Salesforce, os filtros de pesquisa são impostos. Por exemplo, quando o fluxo executa o elemento Criar registros, o fluxo falhará se o valor do campo de pesquisa não cumprir os requisitos do filtro de pesquisa.
- Para filtrar registros com base em recursos e informações do fluxo, considere usar um componente Pesquisa de opção.
- Não há suporte para um campo de pesquisa para um registro do usuário.Dica Para permitir que um usuário de fluxo escolha em uma lista de registros de usuário, use um campo de pesquisa de usuário padrão, como CreatedById ou LastModifiedById. Não há suporte para OwnerId.
- No tempo de execução, quando um usuário do fluxo digita dois caracteres no campo, ele mostra até cinco registros recentes cujo campo Name corresponde à consulta.
- Não há suporte para filtros de pesquisa dependentes.
- Não há suporte para pesquisas de um registro externo.
- Durante o tempo de execução, se o campo de pesquisa definido em Nome da API de campo não estiver em um layout de página atribuído, o componente de pesquisa exibirá
Search undefined.... Para exibir o texto correto, adicione o campo de pesquisa definido a todos os layouts de página do objeto de origem atribuídos a usuários em execução. - IDs de registro inválidos são ignorados. Um ID de registro é inválido se não for um ID de registro do Salesforce válido ou se seu prefixo de chave não corresponder ao objeto de nome da API do campo.
- Se o valor de Máximo de seleções for 1 e a coleção de IDs do registro e o ID do registro forem ambos alterados, o ID do registro terá precedência. A coleção de IDs de registro é ignorada.
- Se o valor de Máximo de seleções for maior do que 1, a coleção de IDs de registro terá precedência quando o ID do registro for preenchido. Porém, se a Coleta de IDs de registro não for preenchida, o ID do registro será usado para preencher a Coleta de IDs de registro como uma única unidade
- Os campos de relacionamento relacionados a mais de um objeto, também conhecidos como campos polimórficos, não têm suporte. Por exemplo, como o campo WhoId de um registro de tarefa pode ser relacionado a um contato ou lead, ele não tem suporte para esse componente.
- O Nome da API do campo e o Nome da API do objeto diferenciam maiúsculas de minúsculas.
- O componente da tela de fluxo de Pesquisa não oferece suporte à filtragem pelo tipo de registro do objeto de origem.
