---
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 listas relacionadas definidas

# Crie listas relacionadas definidas {#ariaid-title1}

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

Você pode adicionar listas relacionadas padrão ao formulário para que todos os usuários vejam ao exibir registros.

## Antes de Iniciar

Função necessária: administrador

## Por Que e Quando Desempenhar Esta Tarefa

Por exemplo, você pode incluir uma lista de incidentes relacionados na parte inferior de um registro de problema ou uma lista de membros na parte inferior de um registro de grupo. Esta funcionalidade depende de campos de referência ou relacionamentos de tabela muitos para muitos. Se duas tabelas estiverem relacionadas por meio do dicionário do sistema, uma poderá aparecer como uma lista relacionada na outra.  
As listas relacionadas definidas permitem que os relacionamentos entre tabelas arbitrárias sejam expressos como uma lista relacionada. Quaisquer duas tabelas que podem ter um relacionamento lógico podem aparecer como um par primário/secundário por meio de uma lista relacionada. A seguir estão alguns exemplos.

* Em um registro de incidente, mostre todos os incidentes abertos pelo mesmo chamador.
* Em um registro de usuário, mostre as últimas 20 transações que o usuário fez.
* Em um registro de incidente, mostre todos os problemas abertos no IC relatado.
{#t_CreateDefinedRelatedLists__ul_x4k_k5c_xp}

Esses relacionamentos estão além dos relacionamentos normalmente definidos no dicionário do sistema por meio de campos de referência e relacionamentos muitos para muitos.

Cada lista relacionada requer um registro de relacionamento. Antes de criar um relacionamento, verifique se não há um registro de relacionamento existente que já forneça as informações necessárias. Use as etapas a seguir para criar um registro de relacionamento.

## Procedimento

1. Clicar Definição do SistemaRelacionamentos.
2. Clique em Novo.
3. Especifique os campos de registro de relacionamento.  
   {#t_CreateDefinedRelatedLists__table_rqf_w5c_xp__entry__2}

   | Campo | Descrição |
   |-|-|
   | Nome | Digite o nome da lista relacionada. A página de configuração do formulário exibe este nome na lista de listas disponíveis. |
   | Avançado | Marque esta caixa de seleção para usar JavaScript no lugar de Aplica-se à tabela e. Consultas da tabela campos. |
   | Aplica-se à tabela | Selecione a tabela na qual a lista relacionada aparece. Por exemplo, para adicionar uma lista relacionada ao formulário do usuário, selecione a tabela Usuário \[sys_user\]. Este campo está oculto nos registros de relacionamento avançado. |
   | Consultas da tabela | Selecione a tabela da qual esta lista relacionada recupera dados. Por exemplo, para adicionar registros de tarefa relacionada à lista relacionada, selecione a tabela Tarefa \[tarefa\]. Este campo está oculto nos registros de relacionamento avançado. |
   | Aplicar a | Digite um script que defina o. <var class="keyword varname">resposta </var>variável para verdadeiro quando um usuário abre um formulário na tabela desejada. Este campo só está visível com Avançado caixa de seleção marcada. |
   | Consulta de | Digite um script que defina o. <var class="keyword varname">resposta </var>variável para o nome da tabela da qual a lista relacionada recupera dados. Este campo só está visível com Avançado caixa de seleção marcada. |
   | Consulta com | Digite um script para especificar os registros a serem incluídos. Por exemplo: current.addQuery('opened_by', parent.sys_id); * . `atual `o objeto especifica o registro atual no qual o script é acionado. * . `AddQuery `o método adiciona um filtro que retorna registros que atendem a uma condição especificada. * . `opened_by `a variável é o nome do campo do qual você está consultando na tabela Consultas da tabela . * . `sys_id.primário `a variável refere-se a. Aplica-se à tabela E o ID do registro que está sendo exibido. {#t_CreateDefinedRelatedLists__ul_tkg_yb4_jyb} |
   | Inserir retorno de chamada | Digite um script a ser executado após uma ação de inserção bem-sucedida. Este campo só está visível com Avançado caixa de seleção marcada. |
   [Tabela 1. Campos de registro de relacionamento]

   {#t_CreateDefinedRelatedLists__table_rqf_w5c_xp}
4. Clique em Enviar.
* **[Adicione incidentes pela mesma lista relacionada de solicitantes](https://servicenow-prod.fluidtopics.net/HR8a~KHOAt9SKijXIRKjTA)**   
  Este exemplo adiciona o relacionamento existente, Incidentes pelo mesmo solicitante, aos formulários de incidente.
* **[Adicione transações por lista relacionada ao usuário](https://servicenow-prod.fluidtopics.net/jnrw69zIIOO~9q5BcRUnQg)**   
  Este exemplo adiciona um relacionamento, últimas 20 transações, ao formulário do usuário.

**Tarefas relacionadas**   

* [Selecione ou crie registros em uma lista relacionada](https://servicenow-prod.fluidtopics.net/vFX0AdhbbQdhW3OUbrzhKQ "Quando um formulário contém uma lista relacionada, como Incidentes lista relacionada no formulário de problema, você pode selecionar registros existentes ou adicionar novos registros na lista relacionada.")
* [Configure quando uma lista relacionada for carregada](https://servicenow-prod.fluidtopics.net/2wdt2aVtSzn3lyeqPHQD1g "Se houver muitas listas relacionadas em um formulário ou muitos registros nas listas relacionadas, o formulário poderá carregar lentamente. Você pode melhorar os tempos de resposta do formulário configurando listas relacionadas para carregar manualmente, sob demanda ou automaticamente, após o carregamento do restante do formulário.")
* [Crie um filtro padrão para uma lista relacionada](https://servicenow-prod.fluidtopics.net/PRUDKzrnWKdYYfJdwSE2iQ "Crie um filtro padrão para os registros carregados quando sua lista relacionada for exibida.")
* [Configure a opção de edição](https://servicenow-prod.fluidtopics.net/A7FisndJDc7TBZrj51oWEw "Você pode configurar a opção de edição que permite que os usuários adicionem registros a listas relacionadas em formulários.")
* [Adicione campos às seleções em uma lista relacionada](https://servicenow-prod.fluidtopics.net/RyYchBfeO~4w7jR4MTEftw "Ao clicar em Editar em uma lista relacionada e selecione um item, as informações sobre o item aparecem abaixo da lista. Você pode expandir os campos que aparecem para o item para fornecer mais informações.")
* [Crie um filtro padrão para registros do seletor de lista](https://servicenow-prod.fluidtopics.net/3uLDeiapb7jEkvsea2LuFg "Você pode definir um filtro padrão para restringir quais registros relacionados os usuários podem selecionar ao editar um campo de referência. Os filtros padrão são simples de configurar, mas não têm um elemento de filtragem dinâmico, o que impede que o usuário final mude o filtro padrão.")