Cargas do evento em Construtor de IU

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura
  • Use cargas de evento para vincular dados a uma ação.

    Cargas de evento são partes de dados enviadas por um componente quando um evento selecionado é acionado. Os dados enviados por um evento podem incluir o tipo de evento, carimbos de data/hora, ações do usuário ou dados de recursos, como um SysID. Você pode usar cargas de evento em Construtor de IU para compartilhar informações entre componentes em uma página.

    Você pode usar esses dados de carga ao configurar um manipulador de eventos para que a interação resultante possa ser vinculada aos dados emitidos. Por exemplo, um SysID pode ser passado para outros componentes em uma página para exibir informações relacionadas a um registro especificado.

    Caixa vermelha que contém as cargas de evento disponíveis para o componente selecionado.

    Cada componente e evento tem um conjunto exclusivo de opções de carga. As cargas do evento podem não estar definidas corretamente para cada componente. Se for esse o caso, defina um client script para que o console registre cargas úteis, como console.log(event.payload).

    Criar um evento com cargas úteis para compartilhar informações entre componentes

    Use cargas de evento em Construtor de IU para compartilhar informações entre componentes em uma página.

    Antes de Iniciar

    Função necessária: ui_builder_admin

    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. Crie ou abra 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. Adicione um componente que tenha eventos, como o componente de visualização de dados.
      Para obter mais informações sobre como adicionar componentes a uma página, consulte Adicionar e configurar componentes.
    5. Para adicionar um manipulador de eventos ao seu componente, selecione a guia Eventos.
      Para obter mais informações sobre como adicionar manipuladores de eventos ao seu componente, consulte Gerenciar ações nas páginas do Construtor de IU.
      1. Para iniciar o processo de configuração de um manipulador de eventos para o seu componente, clique em Adicionar mapeamento de eventos.
        Seta apontando para adicionar a opção de mapeamento de eventos.
      2. Selecione na lista o mapeamento de eventos que você deseja configurar.
        Lista de mapeamentos de eventos disponíveis para o componente de visualização de dados.
      3. Selecione Continuar.
      4. Na seção Visualização do manipulador de eventos, selecione um manipulador de eventos para vincular ao seu componente.
        Limpar notificações de alerta quando uma linha for clicada em uma lista. Atualize o manipulador de parâmetro de estado do cliente selecionado na lista.
      5. Selecione Continuar.
      6. Selecione Criar um novo parâmetro de estado do cliente no menu suspenso Nome do parâmetro de estado do cliente.
      7. Digite um nome no campo Nome.
      8. Selecione o tipo de parâmetro de estado do cliente no menu suspenso Tipo.
      9. Insira um valor no campo Valor inicial.
      10. Selecione o ícone de dados de vinculação no campo Valor a ser usado após o acionamento do evento.
        Seta apontando para o ícone de vinculação de dados no campo Valor a ser usado após o acionamento do evento.
      11. Selecione o valor que você deseja vincular ao evento acionado.
        Vincular modal de dados
      12. Selecione Aplicar.
      13. Selecione Adicionar.
        O manipulador de dados aparecerá abaixo do mapeamento de eventos na guia de eventos.

        Seta apontando para o manipulador de eventos configurado para o componente de visualização de dados.

    6. Selecione o componente ao qual você deseja vincular o parâmetro de estado do cliente. Neste exemplo, usaremos um componente de título.
    7. Selecione o ícone de vincular dados no campo ao qual você deseja vincular o parâmetro de estado do cliente.
      Seta apontando para o ícone de vinculação de dados no campo de rótulo do componente de título.
    8. Selecione Estados do cliente.
    9. Selecione a seta ao lado do parâmetro de estado do cliente que você deseja vincular.
      Seta apontando para a seta que vincula um parâmetro de estado do cliente ao campo de rótulo.
    10. Selecione Aplicar.
    11. Selecione Save (Salvar).
    12. Selecione Visualizar para testar o evento que você acabou de configurar.