Definir eventos de mapa

Um mapeamento de evento em Construtor de IU é o processo que permite mapear a carga útil ou os valores contextuais de um evento 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 em Construtor de IU. Ao criar páginas com componentes, você precisa desses componentes para executar ações para os usuários. Por exemplo, se você adicionar um componente de botão à página, um evento clicado com o botão deverá ser mapeado para um manipulador de eventos. O manipulador de eventos executa uma ação de botão clicado 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 for 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 Ação e os componentes Lista.

Você escolhe um tipo de evento com base na ação que deseja executar na 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 se aplique a toda a página, 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 em Construtor de IU e fornece alguns exemplos de como você pode usar os eventos.

Tabela 1. Tipos e descrições de eventos

Tipo de evento	Descrição
Eventos de componente	Ação que você configura para um componente. Configure um manipulador de eventos para configurar essa ação do 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 como vincular eventos a componentes, consulte Vincular um evento a um componente.
Eventos de 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 para esses 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 eventos de variante. Esses mapeamentos de eventos são salvos no registro da variante, que você pode encontrar 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 dos recursos de dados herdados. Mapeamentos de eventos de variante são usados como retransmissão para que os eventos que são expedidos de componentes em sua página possam ser retransmitidos para manipuladores de eventos de sessão de usuário. Os mapeamentos são criados automaticamente em um salvamento de página quando você mapeia o evento expedido de um componente para um manipulador de sessão de usuário. Por exemplo, ao mapear um evento de Botão clicado para o evento Link para o destino no nível da tela, 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 seu novo sys_ux_event. Esses eventos são usados para criar mapeamentos de eventos de retransmissão. Você pode selecionar um manipulador de eventos primários 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 os 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 Vincular um evento a uma página.
Eventos de recursos de dados	Eventos que são 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 obtenção 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 Vincular um evento a um recurso de dados.
Eventos de ação declarativa	Vincule elementos de dados em Construtor de IU para adicionar ações de evento a uma ação declarativa. Você configura um mapeamento de evento de ação declarativa na tabela de atribuição de ação declarativa Now Platform®. Por exemplo, navegue até Navegador de filtros > sys_declarative_action_assignment.list 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.