Vincular um evento a uma página

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 5 min. de leitura
  • Use mapeamentos de eventos de página para vincular elementos de dados em Construtor de IU para 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 eventos de variante. Adicione, remova ou limpe notificações de alerta na sua variante de 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 eventos primários de destino para modelar os campos de carga após ele.
    • Eventos manipulados. Um evento tratado é um evento que está exposto e disponível para uso por outros usuários. Depois de criar um evento manipulado, ele fica disponível em Page event mappings para outros usuários usarem. Você também pode configurar campos de carga criados manualmente ou escolher um modelo para o 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 em Construtor de IU, consulte Criação de 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 realçar a página inteira, você pode adicionar eventos no nível da página.

      Seta apontando para a opção do corpo na árvore de conteúdo.
    5. No painel de configuração, selecione a guia Eventos.
      Painel de configuração com a guia Eventos.
    6. Adicione um manipulador de eventos de uma das maneiras a seguir.
      Para adicionar este manipulador de eventosFaça o seguinte
      Mapeamentos de eventos de página Page ready evento de origem:
      1. Selecione Adicionar 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 Adicionar 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 Definir estado de carregamento para mostrar a palavra Carregando na página para que os usuários vejam que a página está sendo carregada. 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 da variante. Se a página de variantes tiver uma lista, você adiciona 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 diferentes manipuladores de eventos para configurar.

      1. Selecione Adicionar mapeamentos de eventos. Por exemplo, você pode adicionar um novo manipulador de eventos para a 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 UXR App Shell.
      3. Para adicionar o manipulador de eventos à sua variante, selecione Adicionar.

      Opções de manipulador de eventos de variante.

      • Esses mapeamentos de eventos estão no registro de variante encontrado na tabela sys_ux_screen.
      • Os eventos de origem para esses 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 do app UXR e operações de recursos de dados herdados.
      • Esses mapeamentos de eventos são usados como retransmissão para que os eventos 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ê mapeia o evento expedido de um componente para outro evento. Por exemplo, quando você mapeia um evento Button clicked para o evento Link to destination, o evento cria um evento de retransmissão expedido e um mapeamento de evento de variante depois que você salva a página.
      Eventos expedidos
      1. Selecione Eventos expedidos.
      2. Selecione o ícone +Adicionar..
      3. Na tela Adicionar um evento, execute as seguintes ações:
        • Digite um rótulo para o evento.
        • Selecione um manipulador de eventos primários de destino.
      4. Para adicionar o manipulador de eventos aos eventos expedidos, selecione Adicionar.

        Crie 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 manipulador de eventos Link to destination.

        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 o ícone +Adicionar.. Configure o rótulo do evento para preencher automaticamente o nome do evento e os campos de carga do seu novo sys_ux_event.

      • Esses eventos geralmente são usados para criar mapeamentos de eventos de retransmissão. Você pode selecionar um Target parent event handler para 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 o ícone +Adicionar.. 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 o botão Visualizar..