Componente Entrada da tela do botão de ação
Use o componente Botão de ação para que o usuário em execução possa acionar uma ação de tela com o clique de um botão em uma tela. A ação de tela executa um fluxo iniciado automaticamente ativo e os resultados do fluxo iniciado automaticamente podem ser mostrados na mesma tela que o botão. Usar esse componente significa que você precisa de menos telas para que os usuários possam concluir fluxos de tela mais rapidamente.
Edições obrigatórias
| Exibir edições com suporte. |
Por exemplo, você pode permitir que os usuários selecionem um registro de conta em um componente de Pesquisa, cliquem em um botão para recuperar os registros de contato associados ao registro da conta e exibam os registros de contato em um componente de Tabela de dados na mesma tela.
Configurar o nome do botão de ação
| 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. |
| Rótulo | Se você selecionar Usar rótulo como o título da tabela, o texto fácil de usar que aparece acima do componente. |
| 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. |
Configurar a ação
| Atributo | Descrição |
|---|---|
| Ação | A ação da tela que inicia o fluxo iniciado automaticamente. Esse é o fluxo que é executado quando o usuário clica no botão renderizado pelo componente Botão de ação. O fluxo iniciado automaticamente deve estar ativo. |
| Rótulo | O nome fácil de usar para a ação associada ao componente. Esse valor pode ser diferente do rótulo do fluxo que você seleciona como ação. |
| Nome da API | O nome da API para a ação associada ao componente. Esse valor pode ser diferente do nome da API do fluxo que você seleciona como ação. 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. |
| Definir valores de entrada | Especifique o valor de cada campo de entrada exigido pela ação associada ao componente. Por exemplo, se você selecionar um fluxo iniciado automaticamente que exija um ID da conta como entrada, forneça o ID da conta. As variáveis disponíveis para entrada no fluxo iniciado automaticamente aparecerão nessa área. |
| Visualizar valores de saída | Visualize as saídas criadas pela ação. Para fazer referência a uma saída em outro ponto do fluxo, primeiro faça referência ao campo Resultados, por exemplo,
|
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:
|
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.
Especificar o comportamento de outro componente com o atributo Saída em andamento
Quando um usuário clica em um botão de ação, o atributo Em andamento para a ação de tela associada é definido como true. Quando a ação é concluída, o atributo Em andamento é definido novamente como false.
Use o atributo Em andamento para especificar o comportamento de outro componente. Por exemplo, use-o para desabilitar um componente de tela enquanto a ação está em execução. Defina o valor do campo Desabilitado no componente para o atributo Em andamento. Quando Em andamento é true, o campo Desabilitado também é definido como true. Quando a ação é concluída e Em andamento é definido como false, o campo desabilitado também é definido como false.
Considerações
- Se um usuário executar um fluxo com um componente Botão de ação em um navegador da Web, as saídas da ação associada ao componente estarão disponíveis ao navegador. Não compartilhe informações confidenciais como a saída de um componente Botão de ação.
- Fluxos iniciados automaticamente que incluem elementos Aguardar ou subfluxos com elementos Aguardar não têm suporte como ações de Botão de ação, pois o fluxo não será retomado após um elemento Aguardar.
- Não há suporte para botões de ação em componentes Repetidor.
- Não há suporte para iniciar um fluxo com um caminho assíncrono.
- Se um fluxo iniciado pelo botão de ação não tiver caminhos de falha e ocorrer um erro, uma mensagem de erro genérica será exibida abaixo do botão de ação. Para mostrar uma mensagem de erro útil aos usuários, adicione caminhos de falha ao fluxo iniciado. Em cada caminho de falha, defina uma variável de saída como
{!$Flow.FaultMessage}. Então, na tela de fluxo com o botão de ação, adicione um componente Texto de exibição que esteja condicionalmente oculto e contenha uma mensagem de erro útil junto com a variável da mensagem de falha.
Nota Mesmo que um conteúdo do componente Texto de exibição contenha uma mensagem de erro, os leitores de tela não anunciam o conteúdo como uma mensagem de erro. - Se uma variável de entrada ou saída no fluxo iniciado automaticamente da ação de tela for uma variável de registro e você alterar um nome de campo no objeto, o novo nome do campo não será refletido quando você atualizar as entradas e saídas.
- Se uma variável de entrada ou saída no fluxo iniciado automaticamente da ação de tela for uma variável do Apex e você alterar a estrutura do tipo Apex, essas alterações não serão refletidas ao atualizar as entradas e saídas.
