Vincular um evento a outra página
Adicione um link ao 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 da aplicação para 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 para essa 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 no 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 uma URL externa 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 em 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 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 nas perguntas e respostas de análise e configura um manipulador de eventos para esse evento.
Ao navegar 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 de 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 se baseia 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.
Você seleciona o componente Análise Q&A 1 e abre a guia Eventos. A partir daqui, você pode abrir o manipulador de eventos deRetransmissão de Link para o destino para o evento 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 vê 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 de 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 table como um parâmetro obrigatório e listTitle, querye disableInlineEditing como parâmetros opcionais.
Como esta página já contém um componente de 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.* nos campos tabela, listTitlee consulta, seguindo as informações obtidas 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 clicado. O manipulador de eventos permite que você veja uma lista simples dos incidentes no relatório.