Formatador de trilhas primárias

O formatador de trilhas primárias na tabela de tarefas fornece trilhas que mostram o primário ou primários da tarefa atual. Este formatador também pode ser usado em qualquer tabela que estenda Tarefa.

Antes de Iniciar

Função necessária: personalize_form

Por Que e Quando Desempenhar Esta Tarefa

Para adicionar o formatador de trilhas primárias a um formulário, configure o formulário e adicione as trilhas primárias ao local desejado. As trilhas mostram apenas seis níveis de primários. Se houver mais níveis, as trilhas exibirão reticências ('''...''').

O campo de referência primário também deve conter um valor para que as trilhas sejam exibidas. Pode ser necessário configurar o formulário para conter o campo Primário também.

Figura 1. Trilhas

Personalizar o formatador de trilhas primárias

Você pode personalizar o formatador de trilhas primárias para controlar quais trilhas aparecem.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Todos > IU do Sistema > Formatadores.
2. Selecione Trilhas primárias.
3. Clique em Exibir macro de IU para este formatador para exibir ou modificar o formatador subjacente.
   Por padrão, a trilha usa o campo de exibição padrão, gr.getDisplayValue(), como o link na trilha. Para personalizar isso, adicione a seguinte linha, substituindo o parâmetro fieldName pelo nome do campo desejado (não o rótulo do campo):

   pc.setLabelField("fieldName")

   Se um usuário apontar para uma trilha, a descrição resumida desse registro aparecerá como uma dica por padrão. Para exibir dicas alternativas para a trilha, adicione a seguinte linha, substituindo o parâmetro fieldName pelo nome do campo desejado (não pelo rótulo do campo):

   pc.setTitleField("fieldName")

   Certifique-se de adicionar essas linhas no local apropriado, conforme mostrado no exemplo a seguir:

   //parent crumb functions - script include 
   var pc = new ParentCrumbs(now_GR);
   pc.setLabelField("short_description");
   
   //override the default display field to be used for label
   pc.setTitleField("number");
   
   //override default short_description hover text 
   var crumbs = pc.getCrumbs();

   

Usar o formatador de trilhas primárias em tabelas que não sejam de tarefa

O formatador de trilhas primárias pode ser usado em tabelas que não sejam de tarefa, desde que a tabela tenha uma referência a si mesma por meio de um campo chamado parent.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Para disponibilizar o formatador para uma tabela diferente, duplique o formatador usado pela tabela Tarefa:

Procedimento

1. Navegar até Todos > IU do Sistema > Formatadores.
2. Selecione Trilhas primárias.
3. Defina o campo Tabela como a tabela apropriada.
4. Clique com o botão direito do mouse no cabeçalho do formulário e escolha Inserir.
5. Adicione o novo formatador ao formulário apropriado.