Vincule um evento a outra página

Adicione um link ao manipulador de eventos de destino em Construtor de IUpara 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 app até a página desejada.

Antes de Iniciar

Você deve ter uma página de espaço que contenha um componente que se destina a abrir outra página quando um usuário clica nela. A visão geral do painel é um exemplo de tal componente. Componentes como Link para o destino não é compatível com o identificador de evento de link para destino. A propriedade do link do componente tem prioridade sobre o manipulador de eventos de link para destino.

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 devem ser definidos no manipulador de eventos para passar os parâmetros necessários para a página de destino.

Dica:

Você pode encontrar exemplos dos componentes dos quais você deseja vincular e das páginas de destino às quais deseja vincular na experiência básica do Espaço do agente. Isso Next Experienceé fornecido no sistema base. Se você criar uma página a partir de um modelo de página, só deverá copiar o conteúdo do modelo. Não faça referência a ele. Para obter mais informações sobre a diferença entre copiar e fazer referência a um modelo de página, consulte Criar uma página a partir de modelo.

Procedimento

1. Abra sua experiência em Construtor de IU.
2. Opcional: Se a página de destino não existir na sua experiência, crie uma.
   Para obter informações sobre como criar páginas, consulte Crie uma página em Construtor de IU. Certifique-se de definir os parâmetros obrigatórios e opcionais para a página para que você possa usá-la como destino. Se um componente específico na página for um destino, você deverá incluir esse componente. Você também deve configurar as propriedades no componente para consumir os parâmetros da página em context.props.<parameter-name> valores.

   Você pode considerar criar a página a partir de um modelo de página. A experiência do Espaço do agente base tem vários modelos de página que já estão configurados para serem destinos para outros componentes. Se você criar uma página de destino a partir de um modelo, os componentes já estarão configurados com as propriedades corretas. Todos os parâmetros de estado necessários ou scripts de cliente também são copiados. Você precisa adicionar os parâmetros de página. Você pode copiar esses parâmetros da lista relacionada Rotas de app UX no registro de configuração da app do agente [sys_ux_app_config] da experiência que contém os modelos de página.

   Para garantir que as páginas que você está criando funcionem de forma confiável como destinos em sua experiência, sua experiência deve ter a mesma IU do shell da aplicação que a experiência com os modelos de página.

3. Mude para a página que você deseja vincular à página de destino.
4. Navegue até o componente relevante e selecione-o.
5. Selecione a guia Eventos.
6. Selecione - Adicionar mapeamento de evento .
7. Selecione o evento que você deseja usar.
8. Selecione - Adicionar manipulador de eventos .
   
9. Na seção Manipuladores de eventos herdados, selecione Link para o destino .
   
10. Clique em Selecione o destino .
    
11. Expandir Páginas e selecione a página na experiência à qual você deseja vincular.
    Os campos são exibidos para cada um dos parâmetros na página de destino para a qual a rota leva. Os parâmetros obrigatórios estão marcados com um asterisco (*).
12. Preencha cada campo de parâmetro obrigatório e os campos de parâmetro aplicáveis com um apropriado na carga.* valor.
    Se os desenvolvedores do seu componente incluíram valores de carga padrão no seu evento, você pode selecionar um por meio do preenchimento automático. Como mostrado no exemplo a seguir, o valor da carga 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 um Rota do app .

    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 consegue encontrar o necessário na carga.* valores, contato 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 Espaço de agente base, o componente conterá os manipuladores de eventos de retransmissão Link para destino. Esses manipuladores de eventos não funcionam. No entanto, eles contêm o aplicável na carga.* valores para os parâmetros.

Configurando os manipuladores de eventos para um componente de Perguntas e Respostas De Análise

Digamos que você queira fazer um novo Next ExperienceE adicione 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 da Central 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, em seguida, configura um manipulador de eventos para esse evento.

Navegando até Now Experiences > Experiências, Você verá a experiência de teste UX aplicação . Como ele usa a mesma IU do shell da aplicação do Espaço do agente que o Espaço do agente base, você pode usar os modelos de página do Espaço do agente base.

Em seguida, selecione o painel de administração do espaço de teste, encontre um registro de configuração do app de UX sem rotas ou páginas do app de UX e clique em Aberto .

Como o exemplo mostra, no Construtor de IU, Você criou uma página chamada Central de análises que é baseada no modelo de página da Central de análises do Espaço de agente base. Em seguida, selecione a opção para copiar somente o conteúdo do modelo de página.

Você seleciona o componente Perguntas e Respostas De Análise 1 e abre o. Eventos . A partir daqui, você pode abrir o. Retransmissão de Link para destino manipulador de eventos para Visualização de relatório clicada evento. 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. Em 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 que na carga.* os valores correspondem a, e a que Título o campo pode ser preenchido com Payload.listTitle .

Tabela 1. Parâmetros da página de destino da lista simples sugerida e cargas correspondentes

Parâmetro	valor.*
tabela (obrigatório)	na tabela.payload
listTitle	Payload.listTitle
consulta	payload.query
disableInlineEditing	nenhum

Em seguida, navegue até Menu > Criar página E criar 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 Central de análise. Nas últimas etapas do processo, você adicionaria tabela como parâmetro obrigatório e. Título da lista , consulta , e. DisableInlineEditing como parâmetros opcionais.

Como esta página já contém um componente Lista, quando você abre o. Configuração para este componente, você verá que os parâmetros já foram passados em a context.props.* valores.

Agora, você retorna à página da Central de análise. Em Visualização de relatório clicada evento, você adiciona um novo manipulador de eventos. Em seguida, selecione a página Lista de registros que você criou e adicione o. na carga.* valores no tabela , Título da lista , e. consulta , seguindo as informações que você obteve do Retransmissão de Link para destino manipulador de eventos. A digitação preditiva ajuda você a preencher esses campos.

Depois de clicar em OK e adicionar Payload.listTitle como Título , o manipulador de eventos está concluído. Agora você pode excluir o. Retransmissão de Link para destino manipulador de eventos para este evento.

O exemplo a seguir mostra uma página da Central de análise. Nesta página, você pode inserir uma consulta para incidentes por prioridade e obter um relatório como resultado. Além disso, ao clicar em uma coluna, você aciona um Visualização de relatório clicada evento. O manipulador de eventos permite que você veja uma lista simples de incidentes no relatório.

Figura 1. Acionando o evento configurado de Visualização de relatório clicado