Vincule um evento a uma página

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura
  • Use mapeamentos de eventos de página para vincular elementos de dados a Construtor de IUpara que você possa adicionar ações de evento à sua página.

    Antes de Iniciar

    Função necessária: ui_builder_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode vincular um evento a uma página usando os seguintes tipos de eventos:
    • Mapeamentos de eventos de página. Adicione, remova ou limpe notificações de alerta na sua página.
    • Mapeamentos de evento de variante. Adicione, remova ou limpe notificações de alerta na variante da sua página.
    • Eventos expedidos. Crie eventos expedidos para sua página para criar mapeamentos de eventos retransmitidos que modelam eventos após um manipulador de eventos primário. Selecione um manipulador de evento primário de destino para modelar os campos de carga após ele.
    • Eventos manipulados. Um evento tratado é um evento exposto e disponível para uso por outros usuários. Depois de criar um evento tratado, ele estará disponível em Page event mappingspara outros usuários usarem. Você também pode configurar campos de carga que você cria manualmente ou escolher um modelo para seu evento tratado, como abrir ou fechar uma caixa de diálogo modal.

    Procedimento

    1. Navegar até Tudo > Estrutura do Now Experience > Construtor de IU.
    2. Abra uma experiência para trabalhar ou crie uma experiência selecionando Criar > Experiência.
    3. Abra ou crie uma página.
      Para obter mais informações sobre como criar uma página no Construtor de IU, consulte Crie uma página no Construtor de IU .
    4. Destaque o corpo da página na árvore de conteúdo.

      O corpo é a linha de nível superior da árvore de conteúdo. Ao destacar a página inteira, você pode adicionar eventos no nível da página.

      Seta apontando para a opção de corpo na árvore de conteúdo.
    5. No painel de configuração, selecione Eventos .
      Painel de configuração com a guia Eventos.
    6. Adicione um manipulador de eventos de uma das seguintes maneiras.
      Para adicionar este manipulador de eventosFaça o seguinte
      Mapeamentos de eventos de página Page ready evento de origem:
      1. Selecione Adicione manipulador de eventos .
      2. Para adicionar, remover ou limpar notificações de alerta da página, escolha um manipulador de eventos de Page-level event handlers. Você pode adicionar, remover ou limpar notificações de alerta em sua página.
      3. Para adicionar o manipulador de eventos à sua página, selecione Adicionar .
      Page property changed evento de origem:
      1. Selecione Adicione um novo manipulador de eventos .
      2. Escolha um manipulador de eventos de Page-level event handlers. Você pode adicionar, remover ou limpar notificações de alerta em sua página. Você também pode escolher Defina o estado de carregamento para mostrar a palavra Carregando em sua página para que os usuários possam ver que a página está carregando. Você também pode selecionar Atualizar parâmetro de estado do cliente para mudar o nome do estado do cliente.
      3. Para adicionar o manipulador de eventos à sua página, clique em Adicionar .
      Mapeamentos de evento de variante Mapeamentos de evento de variante

      Você deve ter uma página de variante para executar um mapeamento de evento de variante. Os mapeamentos de evento de variante disponíveis dependem da página de variante. Se a página variante tiver uma lista, adicione manipuladores de eventos para itens como Linha clicada, Item de navegação e assim por diante. Quando a variante tem uma janela de visualização, você pode ter manipuladores de eventos diferentes para configurar.

      1. Selecione Adicione mapeamentos de eventos .Por exemplo, você pode adicionar um novo manipulador de eventos para Linha clicada .
      2. Selecione um manipulador de eventos na lista de manipuladores de eventos herdados disponíveis ou manipuladores de eventos locais, como a Fonte de dados do shell da aplicação UXR.
      3. Para adicionar o manipulador de eventos à sua variante, selecione Adicionar .

      Opções do manipulador de eventos de variante.

      • Esses mapeamentos de eventos estão no registro de variante encontrado no sys_ux_screen tabela.
      • Os eventos de origem desses mapeamentos de eventos são todos os eventos expedidos definidos para sua página.
      • Os manipuladores disponíveis para esses mapeamentos de eventos são eventos no nível da tela, a fonte de dados do shell da aplicação UXR e as operações de recursos de dados herdados.
      • Esses mapeamentos de eventos são usados como retransmissões para que os eventos que são expedidos de componentes em sua página sejam retransmitidos para os manipuladores de sessão do usuário.
      • Esses mapeamentos são criados automaticamente em um salvamento de página quando você mapeou um evento expedido de um componente para outro evento. Por exemplo, quando você mapeia um Button clickedevento para Link to destination, o evento cria um evento de retransmissão expedido e um mapeamento de evento variante depois que você salva a página.
      Eventos expedidos
      1. Selecione Eventos expedidos .
      2. Selecione Adicionar ícone..
      3. Em Adicione um evento , execute as seguintes ações:
        • Digite um rótulo para o seu evento.
        • Selecione um manipulador de evento primário de destino.
      4. Para adicionar o manipulador de eventos aos eventos expedidos, selecione Adicionar .

        Criar uma caixa de diálogo de evento.

      5. O novo manipulador de eventos que você criou aparece em Eventos expedidos . O exemplo a seguir mostra como adicionar um Link to destinationmanipulador de eventos.

        Manipulador de eventos adicionado aos eventos expedidos.

      • Esses eventos estão na tabela [sys_ux_event]. O registro de definição de página contém referências ao registro [sys_ux_event].

      • Esses eventos servem como eventos de origem para mapeamentos de eventos de variante.

      • Para criar novos eventos expedidos para sua página, selecione Adicionar ícone.. Configure o rótulo do evento para preencher automaticamente o nome do evento e os campos de carga do novo sys_ux_event .

      • Esses eventos são frequentemente usados para criar mapeamentos de eventos de retransmissão. Você pode selecionar um Target parent event handlerpara modelar os campos de carga após o evento selecionado. Você também pode criar manualmente campos de carga para o evento expedido.

      Eventos controlados
      • Esses eventos são salvos na tabela [sys_ux_event]. O registro de definição de página contém referências ao registro [sys_ux_event].

      • Esses eventos servem como eventos de origem para mapeamentos de eventos de página.

      • Para criar novos eventos expedidos para sua página, selecione Adicionar ícone.. Esses eventos não são modelados após manipuladores de eventos primários. Os campos de carga para eventos manipulados são criados manualmente. Para usar os campos de carga de um manipulador existente como modelo, selecione um modelo e edite os campos conforme necessário.

    7. Selecione Save (Salvar).
    8. Para visualizar sua página e testar o evento de recurso de dados que você configurou, selecione Botão Visualizar..