Exemplos de referência com pontos
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.
Campos de lista
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 , 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, selecione 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. Por exemplo, quando você seleciona Empresa em Campos de solicitante → Usuário , o campo se torna Caller.Company 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.
A imagem de exemplo a seguir 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
Você pode fazer uma consulta detalhada em uma tabela colocando pontos no construtor de condições.
Para fazer uma visita 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.
Por exemplo, você pode inserir 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.Para fazer isso, navegue até e, em seguida, abra o construtor de condições. No menu de campos, seleciona Mostrar campos relacionados e, em seguida, abra o menu de campos novamente para selecionar Campos Atribuído a → Usuário . Abre o menu de campos novamente para selecionar Sobrenome . Em seguida, crie a seguinte condição: [Sobrenome] [É] [Anglin]. Por fim, selecione Executar . A lista Incidentes exibe somente os registros atribuídos a Beth Anglin.
Coletores de lista
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.
Quando um campo de referência é realçado, o ícone Expandir ( 
) aparece acima do ícone de adicionar.
Quando o campo for adicionado ao Selecionado , ele aparece com sua sintaxe completa com pontos. (Por exemplo, Atribuído a.Ativo ).
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
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 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, (assigned_to.manager) .
Quando você faz um ponto-walk, você pode ter uma cadeia mais longa se precisar, como neste exemplo: (assigned_to.department.manager.mobile_phone} .
Às vezes, você pode selecionar esta variável em um seletor de árvore.
Seletores 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 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.