Vincular um evento a outra página
Adicione um link para o manipulador de eventos de destino em Construtor de IU para que uma ação de evento possa abrir outra página. Você também pode configurar o manipulador de eventos para seguir a rota do app até a página desejada.
Antes de Iniciar
Função necessária: ui_builder_admin
Por Que e Quando Desempenhar Esta Tarefa
Para configurar uma ação de evento para abrir outra página, você deve saber qual página deseja abrir, quais são os parâmetros obrigatórios e opcionais dessa página e quais valores de carga definir no manipulador de eventos para passar os parâmetros necessários para a página de destino .
Procedimento
-
Selecione + Adicionar manipulador de eventos.
-
Na seção Manipuladores de eventos herdados, selecione Vincular ao destino.
-
Clique em Selecionar destino.
-
Preencha cada campo de parâmetro obrigatório e os campos de parâmetro aplicáveis com um valor
@payload.*apropriado.Se os desenvolvedores do seu componente incluíram valores de carga padrão em seu evento, você pode selecionar um por meio do preenchimento automático. Conforme mostrado no exemplo a seguir, o valor da carga útil pode não corresponder ao nome do parâmetro.Nota:Você tem a opção de vincular a um URL externo em vez de especificar uma rota de aplicação.Se nenhum valor padrão for fornecido ou você não puder determinar quais valores estão corretos para alguns campos, consulte a configuração e a documentação da API do componente no Site do desenvolvedor ServiceNow®. Se você ainda não conseguir encontrar os valores
@payload.*necessários, entre em contato com Suporte e atendimento ao cliente.Dica:Se você criar seu componente de vinculação criando uma página a partir de um modelo de página do Espaço do agente de base, o componente conterá manipuladores de eventos de Retransmissão de Link para o destino. Esses manipuladores de eventos não funcionam. No entanto, eles contêm os valores@payload.*aplicáveis para os parâmetros.
Configuração dos manipuladores de eventos para um componente de perguntas e respostas de análise
Digamos que você queira usar um novo Next Experience e adicionar uma página com um componente de perguntas e respostas de análise. Primeiro, você cria a página a partir do modelo de página do Centro de análise fornecido na experiência do Espaço do agente de base. Em seguida, você cria uma página de destino para o primeiro dos três eventos em Perguntas e Respostas de Análise e, em seguida, configura um manipulador de eventos para esse evento.
Navegando até , você verá a aplicação Test experience UX . Como ele usa a mesma IU de Shell da app Espaço do agente que o Espaço do agente de base, você pode usar os modelos de página do Espaço do agente de base.
Em seguida, selecione o painel de administração do espaço de teste, localize um registro de configuração do aplicativo de UX sem rotas ou páginas do aplicativo de UX e clique em Abrir.
Como o exemplo mostra, em Construtor de IU, você criou uma página chamada Centro de análise que é baseada no modelo de página do Centro de análise do Espaço do agente de base. Em seguida, selecione a opção para copiar somente o conteúdo do modelo de página.
Selecione o componente Perguntas e Respostas de Análise 1 e abra a guia Eventos. A partir daqui, você pode abrir o manipulador de eventos deretransmissão de Link para o destino para o evento de visualização de relatório clicado. Quando uma pergunta nas perguntas e respostas de análise retorna um relatório, você pode acionar este evento clicando em um valor no relatório. Ao clicar em um valor, você também verá uma lista dos registros que contribuem para esse valor. No campo Rota, você vê que o destino deve ser uma página baseada no modelo de página Lista simples. Você também vê os parâmetros da página aos quais os valores @payload.* correspondem e que o campo Título pode ser preenchido com @payload.listTitle.
| Parâmetro | Valor @payload.* |
|---|---|
| tabela (obrigatório) | @carga.tabela |
| listTitle | @payload.listTitle |
| consulta | @carga.consulta |
| disableInlineEditing | nenhum |
Em seguida, navegue até e crie uma página baseada no modelo de lista simples. Digamos que você nomeie a página como Lista de registros. Em seguida, você segue um processo semelhante ao de quando criou a página do Centro de análise. Desta vez, nas últimas etapas do processo, você adicionaria a tabela como um parâmetro obrigatório e listTitle, querye disableInlineEditing como parâmetros opcionais.
Como esta página já contém um componente Lista, ao abrir a guia Configuração deste componente, você verá que os parâmetros já foram passados nos valores @context.props.*.
Agora, você retorna à página do Centro de análise. No evento Visualização de relatório clicado, você adiciona um novo manipulador de eventos. Em seguida, selecione a página da lista de registros que você criou e adicione os valores @payload.* na tabela, listTitlee campos de consulta, seguindo as informações que você obteve do manipulador de eventos de Retransmissão de Link para o destino. A digitação preditiva ajuda a preencher esses campos.
Depois de clicar em OK e adicionar @payload.listTitle como Título, o manipulador de eventos será concluído. Agora você pode excluir o manipulador de eventos deRetransmissão de Link para destino para este evento.
O exemplo a seguir mostra uma página do Centro de análise. Nesta página, você pode inserir uma consulta de incidentes por prioridade e obter um relatório como resultado. Além disso, ao clicar em uma coluna, você aciona um evento de Visualização de relatório clicada. O manipulador de eventos permite que você veja uma lista simples dos incidentes no relatório.