Pilha de navegação

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 1 min. de leitura

    • A pilha de navegação é a parte do pacote ServiceNow de aplicações que determina para onde um usuário é redirecionado após a atualização de um registro.

    Um administrador pode fazer com que as referências de página sejam inseridas manualmente na pilha de navegação quando um link na Página de Navegação é clicado. Isso é feito modificando uma definição de módulo para incluir um argumento de sysparm_stack com um valor de cadeia de caracteres igual à referência de URL para a página a ser inserida na pilha. O administrador também pode substituir o redirecionamento determinado pela pilha criando uma regra de negócio ou editando uma existente para incluir gs.setRedirect("http://redirect_page.com").

    Parâmetros operacionais da pilha de navegação

    A pilha de navegação pode ser considerada o histórico de navegação de um usuário na instância. Ele é atualizado sempre que um usuário exibe uma nova página. A pilha de navegação é referenciada quando os usuários pressionam o botão de voltar. Ele também é referenciado quando um usuário envia ou atualiza um registro, momento em que os usuários são redirecionados para a última página na pilha de navegação.
    Figura 1. Voltar e Enviar ou Atualizar
    Ações que invocam a pilha de navegação

    Inserção de páginas na pilha de navegação

    O administrador pode inserir referências de página manualmente na pilha de navegação quando um link na página de navegação é clicado. A definição do módulo é modificada para incluir um argumento de sysparm_stack com um valor de cadeia de caracteres igual à referência de URL para a página a ser inserida na pilha. A imagem a seguir mostra a definição do sistema para o Incidente > Criar novo módulo. Ao passar um argumento de "sysparm_stack=incident_list.do", a exibição de lista de incidentes (incident_list.do) é adicionada à pilha. Depois de enviar um incidente, o usuário é direcionado para esta página.
    Figura 2. Exemplo de pilha do Sysparm
    Argumento em um link de módulo

    Substituindo os comportamentos de redirecionamento da pilha de navegação por regras de negócio onEvent

    Os comportamentos de redirecionamento que ocorrem como resultado de comportamentos de pilha de navegação podem ser substituídos usando regras de negócio onEvent. Esta substituição é realizada usando a função gs.setRedirect. Fazer isso substitui o redirecionamento conforme determinado pela pilha de navegação, quando o evento especificado ocorre. A função gs.setRedirect usa um argumento de cadeia de caracteres que é um URL da página para a qual o usuário é redirecionado. Este URL pode ser externo, por exemplo: gs.setRedirect('http://www.google.com').