Um mapeamento de evento em Construtor de IUé o processo que permite mapear a carga de um evento ou valores contextuais para o objeto ou manipulador que atua nesse evento. Os quatro tipos de evento são: Componente, página, recurso de dados e ação declarativa.
O mapeamento de eventos é um processo importante no Construtor de IU. Ao criar páginas com componentes, você precisa desses componentes para executar açõespara usuários. Por exemplo, se você adicionar um componente de botão à página, um evento clicado no botão deverá ser mapeado para um manipulador de eventos. O manipulador de eventos executa uma ação clicada no botão quando é selecionado por um usuário. Um exemplo é quando você adiciona um recurso de dados, como um formulário, e faz com que um manipulador de eventos notifique o usuário quando o formulário é carregado com sucesso.
Tipos de eventos
Os tipos de evento disponíveis são baseados no componente. Por exemplo, eventos de ação declarativa estão disponíveis para componentes específicos, como a Barra de ação e Componentes de lista.
Você escolhe um tipo de evento com base na ação que deseja executar em sua página. Por exemplo, se você quiser vincular uma ação a um componente, como um botão que carrega uma página da web, use um evento de componente. Se você quiser que um evento seja aplicado à sua página inteira, como adicionar uma notificação de alerta a uma página, use um evento de página. A tabela a seguir descreve cada tipo de evento disponível no Construtor de IUe fornece alguns exemplos sobre como você pode usar os eventos.
Tabela 1. Descrições e tipos de evento
| Tipo de evento |
Descrição |
| Eventos de componente |
Ação que você configurou para um componente. Você configura um manipulador de eventos para configurar essa ação de componente. Por exemplo, adicione um manipulador de eventos para aplicar uma ação a um botão, como ir para uma página da web. Para obter mais informações sobre a vinculação de eventos a componentes, consulte Vincular um evento a um componente. |
| Eventos da página |
Evento de página que executa uma ação para a página inteira. Você pode configurar os seguintes eventos de página:
- Mapeamentos de eventos de página.
- Esses mapeamentos de eventos são salvos no registro de definição de página, que pode ser encontrado na tabela [sys_ux_macroponent].
- Os eventos de origem desses mapeamentos de eventos são Página pronta e Propriedade da página. Eles são definidos para sua página.
- Os manipuladores disponíveis para esses mapeamentos de eventos são:
- Eventos de sessão do usuário
- Eventos no nível da página
- Fonte de dados de Shell da aplicação de UXR
- Scripts de cliente definidos na página
- Operações de recursos de dados locais e herdados
- Mapeamentos de evento de variante.
- Esses mapeamentos de eventos são salvos no registro de variante, que você pode encontrar na tabela [sys_ux_screen].
- 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 dos recursos de dados herdados.
- Os mapeamentos de eventos de variante são usados como retransmissões para que os eventos que são expedidos de componentes em sua página possam ser retransmitidos para manipuladores de eventos de sessão do usuário.
- Os mapeamentos são criados automaticamente em um salvamento de página quando você mapeou o evento expedido de um componente para um manipulador de sessão do usuário. Por exemplo, mapeando um Botão clicado evento no nível da tela Link para o destino , o evento cria um evento de retransmissão expedido e um mapeamento de evento de variante quando a página é salva.
- Eventos expedidos.
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 variante.
Você pode selecionar Adicionar para criar novos eventos expedidos para sua página. 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 usados para criar mapeamentos de eventos de retransmissão. Você pode selecionar um Manipulador de evento primário de destino 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 manipulados.
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.
Você pode selecionar Adicionar para criar novos eventos expedidos para sua página. Os eventos manipulados 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.
 Para obter mais informações sobre como vincular um evento a uma página, consulte Vincule um evento a uma página. |
| Eventos de recurso de dados |
Eventos mapeados para recursos de dados para fornecer notificações sobre quando os dados são obtidos.
- Busca de dados iniciada. Quando um evento de recurso de dados é acionado, o manipulador de eventos executa o processo de busca de dados.
- Obtenção de dados bem-sucedida. Quando um evento de recurso de dados é acionado, o manipulador de eventos executa o processo para notificar um usuário quando a busca de dados é concluída com sucesso.
- Falha na busca de dados. Quando um evento de recurso de dados é acionado, o manipulador de eventos executa o processo para notificar um usuário se a busca de dados não tiver êxito.
 Para obter mais informações sobre como vincular um evento a um recurso de dados, consulte Vincule um evento a um recurso de dados. |
| Eventos de ação declarativa |
Vincular elementos de dados em Construtor de IUpara adicionar ações de evento a uma ação declarativa.
Você configura um mapeamento de evento de ação declarativa no ServiceNow AI Platform®tabela de atribuição de ação declarativa. Para obter um exemplo, navegue até e, em seguida, pesquise e abra uma ação declarativa existente.
Em Construtor de IU, você vincula um evento à ação declarativa. Para obter mais informações sobre como usar eventos de ação declarativa, consulte Vincular um evento a uma ação declarativa. |