Vincular um evento a uma página

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 5 min. de leitura
  • Use mapeamentos de evento 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 evento 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 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ários. Selecione um manipulador de eventos primários de destino para modelar os campos de carga após ele.
    • Eventos manipulados. Um evento manipulado é um evento 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 uso de outros usuários. 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é Todos > Estrutura do Now Experience > Construtor de IU.
    2. Abra uma experiência para trabalhar ou crie uma experiência selecionando + Criar.
    3. Abra ou crie uma página.
      Para obter mais informações sobre como criar uma página em Construtor de IU, consulte Criar uma página no Construtor de IU.
    4. Realce 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 de página.

      Seta apontando para a opção de 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 na 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 na 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 possam ver 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 da 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 diferentes manipuladores de eventos para configurar.

      1. Selecione Adicionar mapeamentos de evento. 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 do shell da aplicação UXR.
      3. Para adicionar o manipulador de eventos à sua variante, selecione Adicionar.

      Opções do manipulador de eventos da variante.

      • Esses mapeamentos de evento estão no registro da variante encontrado na tabela sys_ux_screen.
      • Os eventos de origem para esses mapeamentos de evento são todos os eventos expedidos que são definidos para sua página.
      • Os manipuladores disponíveis para esses mapeamentos de eventos são eventos no nível de tela, a fonte de dados do shell da aplicação UXR e operações de recursos de dados herdados.
      • Esses mapeamentos de evento são usados como retransmissões 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 Criar um evento, execute as seguintes ações:
        • Digite um rótulo para o seu 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 evento de variante.

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

      • Esses eventos geralmente são usados para criar mapeamentos de evento de retransmissão. Você pode selecionar um Target parent event handler para modelar os campos de carga útil após o evento selecionado. Você também pode criar manualmente campos de carga útil 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 evento 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 Salvar.
    8. Para visualizar sua página e testar o evento de recurso de dados que você configurou, selecione o botão Visualizar..