Personalizar um URL do fluxo para controlar o comportamento de conclusão

Formato

/lightning/flow/flowName?retURL=url

Nota Recomendamos usar o Lightning Experience e adicionar /Lightning ao início do URL do fluxo. No entanto, se você não adicionar /Lightning ao URL do fluxo, ele ainda funcionará, mas você não obterá os novos benefícios da execução no Lightning. Para saber mais, consulte A escolha entre formatos de URL de fluxo do Lightning e não do Lightning.

Por exemplo:

1. Crie ou identifique o fluxo de tela que deseja personalizar.
2. Determine o URL de destino para o qual você deseja que o fluxo redirecione os usuários depois que eles clicarem em Concluir na tela final.
3. Anexe ?retURL=url ao URL do fluxo, em que url é o URL relativo da página de destino.
4. Se você também estiver passando variáveis de entrada para o fluxo, adicione o parâmetro retURL após os parâmetros da variável, separados por &. Por exemplo: /lightning/flow/MyFlow?flow__varCaseId=500xx000000abc&retURL=lightning/page/home.
5. Use o URL completo com o parâmetro retURL em seu botão, link ou componente.

Opções de URL

Redirecione os usuários do fluxo para estes URLs do Salesforce.

• Códigos de objeto são prefixos de três dígitos que identificam objetos padrão e personalizados no Salesforce. Consulte o prefixo do ID do registro do objeto no URL ou nos detalhes do objeto. Por exemplo, os objetos Conta usam o prefixo 001, os objetos Caso usam 500 e os objetos Oportunidade usam 006. Como alternativa, crie um registro de teste do tipo de objeto e examine os três primeiros caracteres do ID do registro. O código do objeto corresponde a esses três caracteres.
• Para URLs do Salesforce Classic, o Salesforce redireciona seus usuários para a página certa na experiência do Salesforce que eles habilitaram: Lightning Experience ou Salesforce Classic. Se a página não existir no Lightning Experience, o Salesforce redirecionará o usuário para a página no Salesforce Classic.
• Com URLs do Lightning Experience, o Salesforce sempre redireciona os usuários para a página inicial do Lightning Experience (lightning/page/home), mesmo que o usuário tenha o Salesforce Classic ativado. Os usuários que não têm permissão para acessar o Lightning Experience recebem uma mensagem de erro.
• Guias da Web no Lightning Experience só podem redirecionar para páginas do Visualforce.
• Quando você passa um ID de registro no URL, por exemplo, flow__varCaseId=500xx000000abc, o comportamento depende do tipo de variável de fluxo no fluxo:
  • Para uma variável de texto, o Salesforce passa o ID do registro como uma string de texto. O fluxo recebe o valor de ID, por exemplo, 500xx000000abc.
  • Para uma variável de registro, o Salesforce tenta passar todo o objeto de registro. No entanto, passar um ID de registro no URL não carrega automaticamente o registro completo. O fluxo recebe o ID, mas use um elemento Obter registros em seu fluxo para recuperar os dados de registro completos com base nesse ID.
  • Para uma variável de registro que passa apenas um ID, o fluxo poderá falhar se espera que campos de registro não sejam fornecidos. Sempre use um elemento Obter registros depois de receber um ID de registro para preencher a variável de registro com os campos necessários.

Limitações

• Você não pode redirecionar usuários de fluxo para um URL que seja externo à sua organização do Salesforce.
• Não é possível usar uma variável de fluxo como o valor do parâmetro retURL. Para usar uma variável de fluxo para redirecionar um usuário, como para um registro específico, distribua o fluxo usando o Visualforce.
• retURL pode provocar o aparecimento de barras de navegação aninhadas na parte superior e nas laterais da página de destino.
• Se você não adicionar /lightning ao início do URL do fluxo, o retURL diferenciará maiúsculas de minúsculas. Se você usar retUrl, o URL não redirecionará o usuário.
• Os componentes da tela Botão de ação não oferecem suporte ao parâmetro retURL.

Exemplos

Antes de personalizar o URL do botão no objeto Caso, o botão inicia um fluxo. Quando os usuários concluem o fluxo, eles são redirecionados de volta para a primeira tela do fluxo.

/lightning/flow/Case_Update_Flow

Você então personaliza o URL do botão para redirecionar os usuários para o modo de exibição de lista Caso depois que eles concluem o fluxo.

/lightning/flow/Case_Update_Flow?retURL=500/o

Para personalizar o botão:

1. Em Configuração, clique em Gerenciador de objetos.
2. Clique em Caso e depois em Botões, links e ações.
3. Encontre seu botão personalizado e clique em Editar.
4. No campo URL, adicione ?retURL=500/o ao final do URL do fluxo.
   

   Nota

   O 500 é o código de objeto para Caso.

5. Clique em Salvar.

/lightning/flow/myFlow?retURL=001/o 

Quando os usuários do Lightning Experience concluem a entrevista de fluxo, o Salesforce os redireciona para http://MyDomainName.lightning.force.com/lightning/o/Account/home. Quando os usuários do Salesforce Classic concluem a entrevista de fluxo, o Salesforce os redireciona para http://MyDomainName.my.salesforce.com/001/o. Em ambos os casos, o Salesforce redireciona os usuários para o início de Contas na respectiva experiência.

/flow/myFlow?retURL=apex/myPage

Quando os usuários concluem a entrevista de fluxo, o Salesforce os redireciona para http://MyDomainName.my.salesforce.com/apex/myPage no Salesforce Classic. Quando os usuários saem da página do Visualforce, o Salesforce reverte à experiência original.

Por exemplo, depois de visualizar a página do Visualforce, os usuários vão para a página inicial. Para usuários do Lightning Experience, o Salesforce renderiza a página inicial do Lightning Experience (http://MyDomainName.lightning.force.com/lightning). Para usuários do Salesforce Classic, o Salesforce renderiza a página inicial do Salesforce Classic (http://MyDomainName.my.salesforce.com/home/home.jsp).