---
sourceDocument: Interface do usuário da Now Platform Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-user-interface

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Interface do usuário da Now Platform Yokohama

ft:clusterId :

    - platux

bundleId :

    - platux

workflow :

    - Platform


---

# Crie um mapeamento de evento de complemento de UX

# Crie um mapeamento de evento de complemento de UX {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

Conete um botão a um modal usando o mapeamento de eventos de complemento de UX para que um botão de ação abra um modal personalizado.

## Antes de Iniciar

Execute as seguintes ações:

* [Crie uma ação de formulário](https://servicenow-prod.fluidtopics.net/Oe~pPhp_CEeXYhx62w~QDA "Adicione um botão de ação de formulário ao seu espaço configurável.")
* [Ative a Gestão de atendimento ao cliente](https://www.servicenow.com/docs/access?context=t_ActivateCustomerService&version=yokohama&pubname=yokohama-customer-service-management&ft:locale=en-US)
* Abra sua página de registro no UIB ou [Crie uma variante de página no UIB](https://www.servicenow.com/docs/access?context=create-variant&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)
* [Projete sua variante de página no UIB](https://servicenow-prod.fluidtopics.net/jUAYHl18aRZoezNO4oiHtQ#design-a-page-variant-in-uib "Configure uma variante de página do Construtor de IU para passar de um modal de espaço para a variante. Esta etapa atua como parte do processo para configurar um botão de ação para abrir um modal personalizado.")
* [Configure sua variante de página como um modal no UIB](https://servicenow-prod.fluidtopics.net/gk5wXxYupfMOGYddaUiKrw#configure-a-page-variant-as-a-modal-in-uib "Defina sua variante de página para aparecer como um modal usando as configurações do Construtor de IU. Estas etapas atuam como parte do processo para configurar um botão de ação para abrir um modal personalizado.")
{#create-a-ux-add-on-event-mapping__ul_gbv_jqm_d1c}

Função necessária: administrador

## Procedimento

1. Abra o mapeamento de evento de complemento \<instance-name\>.service-now.com/sys_ux_addon_event_mapping_list.doem seu navegador.
2. Selecione para criar um novo registro Novo .
3. Insira um nome para o mapa.
4. Selecione ui_action_barPara o campo ID do elemento de origem.
5. Selecione o nome da ação declarativa para o campo Ação declarativa de origem.
6. Defina o macroponent para o macroponent de registro do espaço usando o SYSID copiado da definição de página do registro.  
   Para obter mais informações, consulte [Configure uma variante de página como um modal no UIB](https://servicenow-prod.fluidtopics.net/gk5wXxYupfMOGYddaUiKrw#configure-a-page-variant-as-a-modal-in-uib "Defina sua variante de página para aparecer como um modal usando as configurações do Construtor de IU. Estas etapas atuam como parte do processo para configurar um botão de ação para abrir um modal personalizado.").
7. Acione o evento para abrir um modal selecionando \[Página de registro\] Abrir modal No campo Evento de destino.
8. Defina os campos a serem enviados para o modal colando o objeto JSON no campo Mapeamento de carga de destino.  

       {
       	"type": "MAP_CONTAINER",
       	"container": {
       		"route": {
       			"type": "EVENT_PAYLOAD_BINDING",
       			"binding": {
       				"address": ["route"]
       			}
       		},
       		"size": {
       			"type": "EVENT_PAYLOAD_BINDING",
       			"binding": {
       				"address": ["size"]
       			}
       		},
       		"fields": {
       			"type": "EVENT_PAYLOAD_BINDING",
       			"binding": {
       				"address": ["fields"]
       			}
       		},
       		"params": {
       			"type": "EVENT_PAYLOAD_BINDING",
       			"binding": {
       				"address": ["params"]
       			}
       		}
       	}
       }

9. Selecione Enviar.