Exemplos de referência com pontos
Acesse campos em uma tabela relacionada de um formulário, lista ou script por referência com pontos. Este tópico inclui exemplos das diferentes maneiras de fazer a referência com pontos.
Lista de Campos
Você pode fazer referência com pontos nos campos relacionados em uma lista, como a lista de campos em um filtro. Este exemplo demonstra como filtrar a tabela Incidente [incident] pela empresa do solicitante que registrou o incidente.
Quando você seleciona Mostrar campos relacionados, o menu é recarregado para exibir os campos relacionados.
Quando você seleciona Empresa nos campos Solicitante → Usuário, o campo se torna Empresa.Solicitante.
O exemplo mostra que o usuário está em Incident.Caller.Company. Você pode retornar a níveis superiores na hierarquia selecionando os campos localizados na parte superior do menu. Por exemplo, a seleção de Campos de incidente retorna à lista de campos de incidente.
Construtores de condição
Você pode fazer uma consulta detalhada em uma tabela fazendo referência com pontos no construtor de condição.
Para fazer referência com pontos em um construtor de condição, 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ê usaria a referência com pontos nos campos em um construtor de condição para encontrar todos os registros de incidentes atribuídos a um usuário específico, Beth Anglin. No exemplo, o usuário navega até e, em seguida, abre o construtor de condição. No menu de campos, o usuário primeiro seleciona Mostrar campos relacionados e, em seguida, abre o menu de campos novamente para selecionar Atribuído a → Campos do usuário. O usuário abre o menu de campos novamente para selecionar Sobrenome. O usuário cria a seguinte condição: [Last name] [is] [Anglin]. Depois que o usuário seleciona Executar, a lista de incidentes exibe somente os registros atribuídos a Beth Anglin.
Coletores de lista
de expansão ) aparece acima do ícone de adição.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.
try{
current.opened_by.manager;
}
catch(err){}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
Frequentemente, 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 do campo Atribuído a.
Conforme 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.
Selecionadores de árvore
- Itens de configuração (ICs) que sã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 para si mesmo. 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 selecionador de árvore para atribuir um registro de Incidente a um usuário no grupo Banco de Dados.
Você deve primeiro navegar até qualquer registro de incidente e, em seguida, inserir Banco de dados no campo Grupo de atribuição.
Neste exemplo, o grupo de banco de dados é um grupo primário com vários grupos secundários abaixo dele. Quando você seleciona o ícone de pesquisa (ícone de 
) ao lado do campo Atribuído a, uma janela exibe os campos de referência no grupo Banco de Dados.
Os campos de referência têm o ícone de expansão (+) ao lado do nome. Clicar em + expande uma lista dos campos nesse campo referenciado. Neste exemplo, expandir os campos Banco de dados Atlanta ou Banco de dados San Diego abre uma lista de registros de usuário em cada grupo secundário.
Você selecionaria qualquer um dos registros de usuário para adicioná-lo como um valor no campo Atribuído a.
