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 como você pode fazer referência com pontos.
Lista de Campos
Você pode fazer referência com pontos aos 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.
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 Solicitante.Empresa.
O exemplo mostra que o usuário está em Incident.Caller.Company. Você pode retornar a níveis superiores na hierarquia selecionando campos localizados na parte superior do menu. Por exemplo, selecionar Campos de incidente retorna para a lista de campos de incidentes.
Construtores de condição
Você pode fazer uma consulta detalhada em uma tabela fazendo 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 referência com pontos aos campos 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 até e, em seguida, abre o Construtor de condições. 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 de 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ócio, é necessário adicionar o 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 a 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 aos campos no registro original de qualquer campo de referência. É possível fazer referência com pontos até 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) 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 seletor de árvore para atribuir um registro de incidente a um usuário no grupo Banco de dados.
Você primeiro navegaria até qualquer registro de incidente e, em seguida, inseriria Banco de dados no campo Grupo de atribuição.
Neste exemplo, o grupo 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, a expansão dos 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.
