---
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


---

# Configure a adição de registros a uma lista relacionada

# Configure a adição de registros a uma lista relacionada {#ariaid-title1}

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

Crie um Adicionar Botão para que os agentes possam adicionar registros a uma Lista relacionada.

## Antes de Iniciar

Função necessária: Workspace_admin

## Por Que e Quando Desempenhar Esta Tarefa

Você pode criar um Adicionar botão que permite que os agentes adicionem registros às listas. Esta funcionalidade é compatível com tabelas de um para muitos (O2m) e muitos para muitos (m2m). No exemplo a seguir, usamos as tabelas task_location e criamos o. Adicionar botão para incidentes. Assim, ao abrir um incidente, você pode clicar na nova lista relacionada, Locais afetados , para ver incidentes (tarefas) que ocorreram no mesmo local. Muitos incidentes podem ocorrer em um local, e um incidente pode envolver muitos locais.

O procedimento geral é adicionar a Lista relacionada, Locais afetados Que está associado à tabela muitos para muitos, task_location e, em seguida, criar uma ação de espaço para criar o. Adicionar botão que adiciona, em nosso exemplo, locais a um incidente.

Quando um agente clica Adicionar um modal é aberto mostrando os locais do agente onde o incidente pode ser adicionado.

Para entender o exemplo a seguir, insira <kbd class="ph userinput">task_location.list </kbd>em Navegador de filtros para mostrar a tabela task_location.

A tabela mostra as associações entre as tabelas de local (cmn_location) e de tarefa (tarefa). No exemplo, não há nenhum.

## Procedimento

1. Adicionar uma nova Lista relacionada, Locais afetados , que abre com registros de incidente.
   1. Abra um incidente navegando até IncidenteAbertos(as) e clique em um incidente.
   2. Confirme se você está na Exibição do espaço clicando no ícone do seu perfil ( ![ícone de menu]()), selecionando Página de configuração e, em seguida, selecionando Layout do formulário .
   3. Para configurar uma lista relacionada para a tabela Incidente, clique no ícone do seu perfil ( ![ícone de menu]()), selecionando Página de configuração e, em seguida, selecionando Listas relacionadas .
   4. No formulário Configurar listas relacionadas no incidente, em Nome da exibição , selecione Espaço .
   5. Selecione Locais afetados e use as setas para movê-lo para Selecionado coluna.  
      O valor task_location é chamado Locais afetados .
   6. Clique em Salvar.  
      Você adicionou Locais afetados como uma lista relacionada para todos os registros de incidentes.

   {#set-up-adding-records-to-related-lists__substeps_p1g_nbx_njb}
2. Use uma Ação de espaço para criar um Adicionar botão que permite que os agentes adicionem locais a um incidente.
   1. Navegar até Experiência de espaçoAções e ComponentesAções de Lista relacionada e clique em Novo .
   2. No formulário, preencha os campos.  
      {#set-up-adding-records-to-related-lists__table_awd_vvl_kjb__entry__2}

      | Campo | Descrição |
      |-|-|
      | Rótulo da ação | Rótulo que aparece no botão na área de Listas relacionadas. Faça isso <kbd class="ph userinput">Adicionar </kbd>. Na imagem anterior, o. Adicionar o botão aparecerá ao lado de Novo botão. |
      | Nome da ação | O nome deste registro que aparece na lista de ações da lista relacionada, Experiência de espaçoAções e ComponentesAções de Lista relacionada. |
      | Implementados como | Selecione Componente de IU porque você está criando um botão. |
      | Especificar componente de IU | Selecione associador de vários registros sn . |
      | Tipo de botão | Selecione Primária . Os botões primários estão verdes. Os botões secundários são cinza. |
      | Seleção de Registro Solicitada | Caixa de seleção para tornar necessária a seleção de registro. |
      | Dica da ferramenta | Texto que aparece quando os agentes passam o mouse sobre o componente de IU. |
      | Descrição | Descrição detalhada desta ação de espaço. |
      | Aplicação | Aplicação à qual este componente se aplica. Global significa que o componente se aplica a todas as aplicações. |
      | Espaço | Espaço em que este componente de IU aparece. |
      | Tabela | Tabela em que esta ação de lista relacionada aparece. * Para um relacionamento o2m, certifique-se de que a tabela seja sua tabela de lista relacionada o2m. Por exemplo, incidente. * Para um relacionamento m2m, certifique-se de que a tabela seja sua tabela m2m. Por exemplo, task_location. {#set-up-adding-records-to-related-lists__ul_fk3_v3t_vlb}Em nosso exemplo, selecione task_location. |
      | Exibição | Selecione espaço . |
      | Ativo | Alterne para ativar (selecionado) e desativar este componente de IU. |
      | Ordem | A ordem de sequência em que este componente de IU aparece em uma lista horizontal de componentes de IU. Quanto menor o valor, mais à esquerda do local. |
      [Tabela 1. Formulário Atribuição de ação]

      {#set-up-adding-records-to-related-lists__table_awd_vvl_kjb}
   3. Em Links relacionados , clique em Exibição avançada para fornecer ao componente as propriedades que ele precisa para funcionar.
   4. Em Atributos do componente preencha os campos.  
      {#set-up-adding-records-to-related-lists__table_zw4_2fx_njb__entry__2}

      | Campo | Descrição |
      |-|-|
      | rótulo | Nome que aparece na parte superior do modal quando você clica em Adicionar botão. |
      | extensionPoint | Em nosso exemplo, deixe isso em branco. Este campo filtra a lista no modal. Quando um agente clica Adicionar todas as associações possíveis são mostradas entre as tabelas cmn_location e de tarefas. Este campo impede algumas dessas associações. Para saber como criar um ponto de extensão, consulte [Usando pontos de extensão para estender a funcionalidade da aplicação](https://www.servicenow.com/docs/access?context=extension-points&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US). |
      | userGivenTable | Tabela que aparece no modal. Em nosso exemplo, queremos abrir os locais que os agentes podem adicionar, portanto, selecione cmn_location. * Selecione task_location para relacionamentos m2m. * Para relacionamentos o2m, selecione a tabela associada à parte Muitos do o2m. Por exemplo, Incidente . {#set-up-adding-records-to-related-lists__ul_ab4_wnn_vlb} |
      | hideSelectAll | Campo que permite ocultar Selecionar tudo. Selecione Verdadeiro Para ocultar Selecionar tudo. |
      | Nome do campo referenciado | Campo exibido no modal do UserGivenTable . Em nosso exemplo, insira <kbd class="ph userinput">local </kbd>(minúsculas). Para encontrar o nome do campo, clique com o botão direito do mouse em Local título do campo no formulário de tabela muitos para muitos. Este campo não é usado para relacionamentos de 2m. |
      | tipo | Tipo de relacionamento de registro. Selecione um 2m ou m2m relacionamento para os registros. * 2m habilita um registro primário em uma tabela que pode fazer referência a vários registros secundários. * m2m habilita vários registros em uma tabela que estão associados a vários registros em outra tabela. {#set-up-adding-records-to-related-lists__ul_tpx_yln_vlb} |
      | parentFieldName | O nome do campo do qual você está fazendo a referência. Neste exemplo, é <kbd class="ph userinput">tarefa </kbd>. Para encontrar o nome do campo, clique com o botão direito do mouse no título do campo. |
      | colunas | Lista separada por vírgulas de colunas que você deseja exibir no modal. Por exemplo, na tabela cmn_location, você pode querer nome e cidade. Então, insira <kbd class="ph userinput">nome, cidade </kbd>. |
      | exibição | A visualização da lista. Não adicione um valor; a exibição padrão está correta. |
      [Tabela 2. Formulário Atributos do componente]

      {#set-up-adding-records-to-related-lists__table_zw4_2fx_njb}
   5. Clique em Atualizar.  
      Você criou um Adicionar Botão que aparece na área Listas relacionadas quando um registro de incidente é aberto.
   {#set-up-adding-records-to-related-lists__substeps_qnv_4dx_njb}
3. Certifique-se de Adicionar o botão aparece e funciona.
   1. Abra um incidente navegando até IncidenteAbertos(as) e clicando em um incidente.
   2. Clique em Locais afetados Lista relacionada.  
      Você deve ver Adicionar Botão nas listas relacionadas.
   3. Clique em Adicionar.  
      Um modal é exibido.

   4. Marque várias caixas de seleção para adicionar esses endereços ao registro do incidente e clique em Adicionar .  
      Os endereços selecionados aparecem em Locais afetados .

   5. Insira <kbd class="ph userinput">task_location.list </kbd>em Navegador de filtros para mostrar a tabela task_location.  
      Os novos locais devem aparecer na tabela.
   {#set-up-adding-records-to-related-lists__substeps_edf_f3x_njb}
4. Adicione uma ação de remoção.  
   Você pode criar um botão Remover que permite que os agentes removam registros de uma lista relacionada e desassociem esse registro da tabela primária. Esta funcionalidade é compatível com tabelas O2m e m2m.
   1. Navegar até Experiência de espaçoAções e ComponentesAções de Lista relacionada e clique em Novo .
   2. No formulário, preencha os campos.  
      {#set-up-adding-records-to-related-lists__table_lx5_tht_vlb__entry__2}

      | Campo | Descrição |
      |-|-|
      | Rótulo da ação | Rótulo que aparece no botão na área de Listas relacionadas. Certifique-se de que o rótulo de ação inclua ({{count}}) . |
      | Nome da ação | O nome deste registro que aparece na lista de ações da lista relacionada, Experiência de espaçoAções e ComponentesAções de Lista relacionada. |
      | Implementados como | Selecione Script do servidor . |
      | Especificar componente de IU | Selecione associador de vários registros sn . |
      | Tipo de botão | Selecione Primária . Os botões primários estão verdes. Os botões secundários são cinza. |
      | Seleção de Registro Solicitada | Caixa de seleção para tornar necessária a seleção de registro. Alterne a caixa de seleção. |
      | Dica da ferramenta | Texto que aparece quando os agentes passam o mouse sobre o componente de IU. |
      | Descrição | Descrição detalhada desta ação de espaço. |
      | Aplicação | Aplicação à qual este componente se aplica. Global significa que o componente se aplica a todas as aplicações. |
      | Espaço | Espaço em que este componente de IU aparece. |
      | Tabela | Tabela em que esta ação de lista relacionada aparece. * Para um relacionamento o2m, certifique-se de que a tabela seja sua tabela de lista relacionada o2m. Por exemplo, incidente. * Para um relacionamento m2m, certifique-se de que a tabela seja sua tabela m2m. Por exemplo, task_location. {#set-up-adding-records-to-related-lists__ul_a5q_bjt_vlb}Em nosso exemplo, selecione task_location. |
      | Exibição | Selecione espaço . |
      | Ativo | Alterne para ativar (selecionado) e desativar este componente de IU. |
      | Ordem | A ordem de sequência em que este componente de IU aparece em uma lista horizontal de componentes de IU. Quanto menor o valor, mais à esquerda do local. |
      [Tabela 3. Formulário Atribuição de ação]

      {#set-up-adding-records-to-related-lists__table_lx5_tht_vlb}
   3. Clique no ícone de menu ( ![Ícone de menu]()) e clique em Salvar .
   4. Em Links relacionados clique em Exibição avançada .
   5. Clique em Script do servidor .
   6. Insira um script de servidor no campo de script. <kbd class="ph userinput">current.deleteRecord(); </kbd>no campo de script do servidor.  
      * Para Relacionamentos m2m, insira <kbd class="ph userinput">current.deleteRecord(); </kbd>.
      * Para Relacionamentos o2m, insira <kbd class="ph userinput">[field_name]: ''; current.update(); </kbd>.
      {#set-up-adding-records-to-related-lists__ul_rxf_ykt_vlb}
   7. Em Links relacionados clique em Exibição avançada e clique em Configurações de confirmação .
   8. Alternância Confirmação necessária .
   9. Clique em Atualizar.
   {#set-up-adding-records-to-related-lists__substeps_dgs_ygx_wlb}

## O que Fazer Depois

Clique em um componente para configurá-lo.

|-|-|-|
| * [Guias](https://servicenow-prod.fluidtopics.net/sduyjOJ53KRRfb6WSGI_Ag "Permita que os agentes criem os registros de que precisam para que possam fazer seu trabalho no Espaço.") * [Notificações](https://servicenow-prod.fluidtopics.net/rYcBFR7UlnkSx6DZ4~eAUQ "Envie notificações para um agente ou um pequeno grupo de agentes quando houver atualizações em registros importantes.") * [Cabeçalho do Formulário](https://servicenow-prod.fluidtopics.net/QfmoEHNbQC7hZ_DEY0N2oQ "Configure o campo primário e os valores secundários nos cabeçalhos do formulário para que os agentes possam se orientar rapidamente para um problema.") * [Ações de IU](https://servicenow-prod.fluidtopics.net/IhhVp9MuX~ihypohkL4YPg "Configure ações de IU para personalizar espaço legadopara sua organização. As ações de IU incluem botões personalizados, itens de menu e limitação de acesso a formulários com base na função de um usuário.") {#set-up-adding-records-to-related-lists__ul_stg_plv_pjb} | * [Faixa de opções](https://servicenow-prod.fluidtopics.net/3mhQkVNlbJxwJiU_~WFBEQ "Configure fitas em espaço legadoPara ajudar os agentes a verificar rapidamente informações relevantes sobre um registro, como o cronograma do registro, um resumo do cliente e ANS de registro.") * [Itens Relacionados](https://servicenow-prod.fluidtopics.net/SCwN8~dLbJ9Bq4Ln1cRTZg "Configure os itens relacionados ao registro aberto para que os agentes possam entender melhor o registro e seu impacto.") * [Painel de formulário](https://servicenow-prod.fluidtopics.net/ZN3tDVpVBDc3oX4ASJJ_Jw "Selecione os campos que aparecem no painel de formulário para ajudar os agentes a realizar seu trabalho.") * [Ações e Componentes](https://servicenow-prod.fluidtopics.net/eRJVPVOtolnWHkbzSoj9_g "Envolva-se com formulários, campos, listas e páginas de lista relacionadas do espaço adicionando ações personalizadas.") {#set-up-adding-records-to-related-lists__ul_lyk_qlv_pjb} | * [Fluxo de atividades](https://servicenow-prod.fluidtopics.net/uZEk1~o5bhhCPoa9FVKZZw "Configure as opções de como os agentes podem interagir com Fluxo de atividadespara facilitar o trabalho.") * [Painel Lateral Contextual](https://servicenow-prod.fluidtopics.net/iBEYQWit5~t3jDq2l2g8jQ "O painel lateral contextual fornece aos agentes ferramentas para pesquisar e resolver problemas. Os diferentes componentes fornecem aos agentes diferentes tipos de ajuda.") {#set-up-adding-records-to-related-lists__ul_hgc_rlv_pjb} |
[ ]

{#set-up-adding-records-to-related-lists__table_dxj_nlv_pjb}