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


---

# Exemplos de referência com pontos

# Exemplos de referência com pontos {#ariaid-title1}

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

Acesse campos em uma tabela relacionada a partir de um formulário, lista ou script com pontos. Este tópico inclui exemplos das diferentes maneiras de você fazer um ponto-walk.

## Lista de Campos {#dot-walking-examples__section_m2n_3dy_h1b}

Você pode percorrer campos relacionados em uma lista, como a lista de campos em um filtro. Este exemplo demonstra como filtrar a tabela Incidente \[incidente\] pela empresa do chamador que registrou o incidente.  
Ao abrir a lista de campos que você deseja filtrar, você verá a lista de campos da tabela Incidentes disponíveis. Os campos de referência são seguidos pelos campos relacionados. Por exemplo, Solicitante é seguido por SolicitanteCampos de usuário, o que significa que Solicitante é um campo de referência e os campos relacionados são campos de usuário no Solicitante registro. Se os campos relacionados não estiverem presentes na lista, você selecionará Mostrar campos relacionados na parte inferior da lista.  

Quando você seleciona Mostrar campos relacionados , o menu recarrega para exibir os campos relacionados.  
Quando você seleciona um campo relacionado, o menu é recarregado com os campos da tabela relacionada.  

Quando você seleciona Empresa em Campos de solicitante → Usuário , o campo se torna Caller.Company .  
O exemplo a seguir mostra onde você está no ponto-walk. Cada referência selecionada é armazenada na parte superior do menu de campos, e o número de pontos antes do rótulo do campo indica quantos pontos do registro inicial o usuário atingiu.  

O exemplo mostra que o usuário está em Incident.Caller.Company . Você pode retornar a níveis mais altos na hierarquia selecionando os campos localizados na parte superior do menu. Por exemplo, selecionando Campos de incidente retorna à lista de campos de incidente.  
Os campos relacionados podem ser removidos selecionando Remover campos relacionados na parte inferior da lista.  

## Construtores de condição {#dot-walking-examples__section_aj3_d53_lfb}

Você pode fazer uma consulta detalhada em uma tabela colocando pontos no construtor de condições.

Para fazer uma referência com pontos em um construtor de condições, primeiro selecione Mostrar campos relacionados no menu de campos. Esta ação permite que você adicione campos de tabelas relacionadas à sua consulta.

O GIF a seguir mostra como você passaria campos com pontos em um construtor de condições para encontrar todos os registros de incidente atribuídos a um usuário específico, Beth Anglin. No exemplo, o usuário navega para IncidenteAbertos(as) e, em seguida, abre o construtor de condições. No menu de campos, o usuário seleciona primeiro Mostrar campos relacionados e, em seguida, abre o menu de campos novamente para selecionar Campos Atribuído a → Usuário . O usuário abre o menu de campos novamente para selecionar Sobrenome . O usuário cria a seguinte condição: \[Sobrenome\] \[É\] \[Anglin\]. Após o usuário selecionar Executar , A lista Incidente exibe somente os registros atribuídos a Beth Anglin.  

<br />

## Coletores de lista {#dot-walking-examples__ListCollectors}

Nota:  
Não há suporte para adicionar novos campos por meio de referência com pontos preenchendo a seção Criar novo campo ("A" no exemplo) no campo Nome ("B" no exemplo). A adição de campos não autorizados e a adição de campos em relação às recomendações por meio de referência com pontos pode resultar em comportamentos inesperados na plataforma. Ao selecionar uma lista de campos de um coletor de lista (por exemplo, ao configurar um formulário), você pode percorrer campos de outros formulários com pontos.  
Para ver quais campos são campos de referência e podem ser analisados com pontos, procure campos verdes com um símbolo de mais.  

Quando um campo de referência é realçado, o ícone Expandir ( ![Ícone Expandir]()) aparece acima do ícone de adicionar.  

Selecionar o ícone Expandir abre a lista de campos da lista relacionada no Disponível painel. O exemplo a seguir mostra que o. Atribuído a. os campos foram selecionados. As listas anteriores de campos aparecem na parte superior da lista.  

Quando o campo for adicionado ao Selecionado , ele aparece com sua sintaxe completa com pontos. O exemplo a seguir mostra isso Atribuído a.Ativo foi selecionado.  

## Scripts {#dot-walking-examples__section_nb2_kdy_h1b}

Você pode fazer referência com pontos em um script invocando a sintaxe de referência com pontos. Esta funcionalidade requer conhecimento de JavaScript.

Para scripts executados no lado do servidor, como regras de negócios, é necessário adicionar <kbd class="ph userinput">atual. </kbd>  
O script a seguir, por exemplo, é uma regra de aprovação com script que solicita uma aprovação do gerente do usuário que abriu o tíquete.

    try{
      current.opened_by.manager;
    }
    catch(err){}

Para scripts executados no lado do cliente, como scripts do cliente, <kbd class="ph userinput">atual </kbd>não é necessário. Por exemplo, o script do Chamador VIP de Destaque a seguir é executado no lado do cliente.

    function onChange(control, oldValue, newValue, isLoading){
      //wait until there is a valid record in the field
      if(newValue){ 
        //get the caller object so we can access fields
        var caller = g_form. getReference('caller_id');
        var callerLabel = document.getElementById('label.incident.caller_id');
        var callerField = document.getElementById('sys_display.incident.caller_id');
     
      //check for VIP status
      if(caller.vip == 'true') { 
        //change the caller label to red background
        //style object is CSSStyleDeclaration, style names are not standard css names
      if(callerLabel) 
        document.getElementById('label.incident.caller_id').style.backgroundColor = 'red';
     
      //change the caller's name field to red text
      if(callerField)
         document.getElementById('sys_display.incident.caller_id').style.color = 'red';
      } 
        else { //not a VIP, remove temporary styles if(callerLabel)
         document.getElementById('label.incident.caller_id').style.backgroundColor = '';

        if(callerField)
          document.getElementById('sys_display.incident.caller_id').style.color = '';
        }
      }
    }

## Variáveis {#dot-walking-examples__section_t4q_kdy_h1b}

Muitas vezes, você pode adicionar variáveis em modelos, notificações ou outros formulários em que um valor está sendo chamado do formulário.

Por exemplo, <var class="keyword varname">(assigned_to) </var>é a variável para Atribuído a. campo.

Como mostrado no exemplo, você pode percorrer com pontos os campos no registro original de qualquer campo de referência. É possível fazer uma referência com pontos em qualquer campo no registro assigned_to, por exemplo, <var class="keyword varname">(assigned_to.manager) </var>.

Quando você faz um ponto-walk, você pode ter uma cadeia mais longa se precisar, como neste exemplo: <var class="keyword varname">(assigned_to.department.manager.mobile_phone} </var>.

Às vezes, você pode selecionar esta variável em um seletor de árvore.

## Seletores de árvore {#dot-walking-examples__section_zny_m2z_tfb}

A interface do seletor de árvore tem uma exibição hierárquica expansível que você pode usar para pesquisar os seguintes itens:

* ICs (itens de configuração) subordinados a outro IC de nível superior.
* Membros de um determinado grupo. Por exemplo, você usaria um seletor de árvore para pesquisar um usuário no grupo da Central de serviços.
* Elementos de referência para qualquer tabela hierárquica. Uma tabela hierárquica é qualquer tabela que tenha um campo primário apontando de volta para si mesma. A tabela Grupo \[sys_user_group\], por exemplo, seria considerada uma tabela hierárquica porque determinados grupos são secundários de grupos primários.
{#dot-walking-examples__ul_cbz_kjy_h1b}

O exemplo a seguir mostra como você usaria um seletor de árvore para atribuir um registro de incidente a um usuário no grupo Banco de dados.

Primeiro, navegue até qualquer registro de incidente e, em seguida, insira <kbd class="ph userinput">Banco de dados </kbd>em Grupo de atribuição campo.  

![Campo de lista]()  

Neste exemplo, o grupo de banco de dados é um grupo primário com vários grupos secundários. Ao selecionar o ícone de pesquisa ( ![Ícone de pesquisa.]()) ao lado de Atribuído a. Uma janela exibe campos de referência no grupo Banco de dados.  

<br />

Os campos de referência têm o ícone de expansão ao lado do nome. Clicando em . expande uma lista de campos nesse campo referenciado. Neste exemplo, expandindo o. Banco de dados Atlanta ou Banco de dados San Diego campos abre uma lista de registros de usuário em cada grupo secundário.  

<br />

Você selecionaria qualquer um dos registros de usuário para adicioná-lo como um valor em Atribuído a. campo.  

![Variável com referência a pontos]()  
Nota:  
Você pode configurar o seletor de árvore para escolher até 1 000 nós ao configurar o. glide.ui.group_heirarchy.max_nodespropriedade. Para definir a propriedade, abra [Atributos do dicionário](https://www.servicenow.com/docs/access?context=c_DictionaryAttributes&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US)para o campo, e adicione <kbd class="ph userinput">tree_picker: verdadeiro </kbd>para Atributos campo. Se houver vários atributos, use uma vírgula para separá-los sem espaços entre eles.