Exemplos de referência com pontos

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 6 min. de leitura
  • Acesse campos em uma tabela relacionada a partir de um formulário, lista ou script por referência com pontos. Este tópico inclui exemplos das diferentes maneiras de fazer referência com pontos.

    Lista de Campos

    Você pode fazer referência com pontos para 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 solicitante que registrou o incidente.

    Ao abrir a lista de campos que 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 Solicitante > Campos 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.
    Mostrar campos relacionados
    Ao selecionar Mostrar campos relacionados , o menu é recarregado para exibir os campos relacionados.
    Campos relacionados
    Quando você seleciona um campo relacionado, o menu é recarregado com os campos da tabela relacionada.
    Campos da tabela relacionada

    Ao selecionar Empresa em Campos solicitante → Usuário , o campo se torna Caller.Company .

    O exemplo a seguir mostra onde você está na referência com pontos. 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.
    Campo com referência com pontos

    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.
    Remover campos relacionados

    Construtores de condição

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

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

    O GIF a seguir mostra como você faria campos de referência com pontos em um construtor de condições para encontrar todos os registros de incidentes atribuídos a um usuário específico, Beth Anglin. No exemplo, o usuário navega para incidente > Aberto e, em seguida, abre o construtor de condições. Primeiro, o usuário seleciona Mostrar campos relacionados e 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] [is] [Anglin]. Depois que o usuário seleciona Executar , A lista Incidente exibe somente os registros atribuídos a Beth Anglin.


    O GIF demonstra como fazer referência com pontos em um construtor de condições

    Coletores de lista

    Nota:
    A adição de novos campos por referência com pontos preenchendo a seção Criar novo campo ("A" no exemplo) no campo Nome ("B" no exemplo) não é compatível. Adicionar campos não autorizados e adicionar campos em relação às recomendações por meio de referência com pontos pode resultar em comportamentos inesperados na plataforma. Referência com pontos não autorizada da seção Criar novo campo
    Ao selecionar uma lista de campos de um coletor de listas (por exemplo, ao configurar um formulário), você pode fazer referência com pontos para campos de outros formulários.
    Para ver quais campos são campos de referência e podem ser referenciados com pontos, procure campos verdes com um símbolo de adição.
    Campos de referência
    Quando um campo de referência é realçado, o ícone Expandir ( Ícone Expandir) aparece acima do ícone adicionar.
    Campos de referência com a opção Expandir
    Selecionar o ícone Expandir abre a lista de campos da lista relacionada no Disponível painel. O exemplo a seguir mostra que Atribuído a. os campos foram selecionados. As listas anteriores de campos aparecem na parte superior da lista.
    Listas de campos
    Depois que o campo for adicionado ao Selecionado , ele aparece com sua sintaxe com referência a pontos completa. O exemplo a seguir mostra isso Atribuído a.Ativo selecionado.
    Campo com referência com pontos

    Scripts

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

    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 de cliente, atual não é necessário. Por exemplo, o script Realçar chamador VIP 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

    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, assigned_to é a variável para Atribuído a. campo.

    Como mostrado no exemplo, você pode fazer referência com pontos nos campos no registro original de qualquer campo de referência. É possível fazer referência com pontos em qualquer campo no registro assigned_to, por exemplo, assigned_to.manager .

    Ao fazer referência com pontos, você pode ter uma cadeia mais longa se precisar, como neste exemplo: (assigned_to.department.manager.mobile_phone} .

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

    Seletores de árvore

    A interface do seletor de árvore tem uma exibição hierárquica expansível que você pode usar para pesquisar os seguintes itens:
    • Itens de configuração (ICs) que estã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 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.

    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 insira Banco de dados em Grupo de atribuição campo.


    Campo de lista

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


    Campos de seleção

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


    Selecione os campos referenciados

    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 com 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 para o campo, e adicione tree_picker: verdadeiro para Atributos campo. Se houver vários atributos, use uma vírgula para separá-los sem espaços entre eles.