Preenchimento automático para campos de referência

Por padrão, um campo de referência é preenchido automaticamente conforme o usuário digita no campo.

Os administradores podem configurar opções adicionais de preenchimento automático. Um usuário deve ter permissão de leitura no nível de tabela na tabela referenciada para o preenchimento automático exibir as opções.

Figura 1. Preenchimento automático

Atributos de dicionário para preenchimento automático de campos de referência

Existem atributos de dicionário específicos para campos de referência e que determinam o comportamento do preenchimento automático.

Tabela 1. Atributos do dicionário de preenchimento automático do campo de referência

Atributo	Descrição
ref_auto_completer	Especifica o nome de uma classe JavaScript do lado do cliente que cria a lista suspensa de opções de preenchimento automático. Os valores de classe válidos são: AJAXReferenceCompleter: exibe opções de preenchimento automático correspondentes como uma lista de seleção suspensa. A lista exibe somente a coluna de valor de exibição da tabela de referência. Os campos de referência usam automaticamente essa classe se não houver outra classe de preenchimento automático especificada. AJAXTableCompleter: exibe as opções de preenchimento automático correspondentes como linhas em uma tabela. A tabela exibe a coluna de valor de exibição da tabela de referência e todas as colunas listadas no atributo ref_ac_columns. AJAXReferenceChoice: exibe opções de preenchimento automático correspondentes como uma lista de seleção suspensa. A lista exibe somente a coluna de valor de exibição da tabela de referência. Além disso, a lista exibe somente até 25 opções correspondentes. Se houver mais de 25 opções de preenchimento automático, o campo de referência exibirá as opções com a classe AJAXTableCompleter.
ref_ac_columns	Especifica a lista de colunas da tabela de referência a serem exibidas. Separe os nomes das colunas com ponto e vírgula. Por exemplo, ref_ac_columns=user_name;email;sys_created_on permite que o preenchimento automático corresponda ao texto das colunas user_name, e-mail e sys_created_on.
ref_ac_order_by	Especifica a coluna da tabela de referência que classifica as opções de preenchimento automático. Por exemplo, ref_ac_order_by=name classifica as opções de preenchimento automático em ordem alfabética por nome.

Recursos de IU de preenchimento automático

A classe do completador de tabela AJAX tem várias melhorias na IU.

• O completador de tabela sempre exibe o número de registros que a consulta de preenchimento automático encontra.
• O completador de tabela realça toda a linha selecionada, mudando a cor do plano de fundo e do texto.
• O completador de tabela lista um valor para cada coluna.
  • Na primeira vez em que um valor aparece em uma coluna, o completador de tabela o exibe em texto preto.
  • O completador de tabela exibe os valores duplicados subsequentes em texto cinza. Anteriormente, o completador de tabela exibia uma célula vazia em uma coluna que continha um valor duplicado.

Figura 2. Destaque da linha selecionada

Defina o atributo de dicionário ref_auto_completer=AJAXTableCompleter para usar essas melhorias.

Definir atributos de preenchimento automático para todas as referências a uma tabela

Um campo herda e usa os atributos de preenchimento automático da tabela de referência, a menos que o campo tenha seu próprio valor para os mesmos atributos. Você pode definir os atributos para referências a uma tabela e isso afeta todos os formulários que fazem referência a essa tabela.

Antes de Iniciar

Função necessária: personalize_dictionary

Por Que e Quando Desempenhar Esta Tarefa

Um atributo de nível de campo substitui um atributo de nível de tabela com o mesmo nome. Se um campo usar atributos de referência diferentes daqueles definidos para a tabela de referência, o campo usará os dois conjuntos de atributos.

Use essas etapas para definir atributos de preenchimento automático para todos os campos em uma tabela que ainda não tenham seus próprios atributos de preenchimento automático. Este exemplo descreve como definir atributos de preenchimento automático para todas as referências à tabela Usuário [sys_user].

Nota:

O valor do atributo de preenchimento automático de um campo substitui o valor do atributo de preenchimento automático de uma tabela. Isso significa que qualquer valor de nível de campo existente para um atributo de preenchimento automático substitui qualquer valor que o administrador aplique ao atributo de preenchimento automático da tabela de referência.

Procedimento

1. Navegue até uma lista da tabela de destino, como Todos > Administração de usuários > Usuários.
2. Execute a ação apropriada para a versão da sua lista.

   Versão	Ação
   Lista v2	Clique com o botão direito do mouse no cabeçalho da coluna e clique em Configurar > Dicionário.
   Lista v3	Abra o menu do título da lista, clique em Configurare em Dicionário.

3. Selecione a linha que não lista um nome de coluna.
   Esta linha é normalmente a primeira linha na lista. Por exemplo, selecione o primeiro link sys_user.
4. Em Links relacionados, clique em Exibição avançada.
5. No campo Atributos, insira uma lista separada por vírgulas de atributos de preenchimento automático que você deseja aplicar a todos os campos da tabela.
   Por exemplo, para exibir o departamento do usuário com todas as referências à tabela sys_user, insira:

   ref_auto_completer=AJAXTableCompleter,ref_ac_columns=department,ref_ac_order_by=department

6. Clique em Atualizar.

O que Fazer Depois

Para testar os novos atributos de preenchimento automático, abra um formulário que faça referência à tabela Usuário [sys_user], como um incidente em aberto. Insira um único caractere no campo Atribuído a. As opções de preenchimento automático agora incluem o nome de usuário e o departamento.

Remover a coluna de valor de exibição

Você pode remover a coluna de valor de exibição de um campo de referência definindo o atributo ref_ac_display_value como falso.

Antes de Iniciar

Função necessária: personalize_dictionary

Por Que e Quando Desempenhar Esta Tarefa

Isso faz com que o campo de referência remova a coluna de valor de exibição e exiba somente as colunas listadas no atributo ref_ac_columns. Este recurso requer o uso da classe AJAXTableCompleter e os atributos ref_ac_columns, ref_ac_columns_searche ref_ac_display_value.

Nota:

O preenchimento automático não pode corresponder ao texto de colunas adicionais quando o campo de referência é um produto da macro de IU ui_reference. Isso significa que qualquer ação de preenchimento automático em um seletor, como a lista Representar usuário, só pode corresponder ao texto com o valor de exibição.

Este exemplo descreve como remover a coluna de valor de exibição das referências à tabela Usuário [sys_user] e substituí-la por referências às colunas first_name e last_name.

Procedimento

1. Navegue até uma lista da tabela de destino, como Todos > Administração de usuários > Usuários.
2. Execute a ação apropriada para a versão da sua lista.

   Versão	Ação
   Lista v2	Clique com o botão direito do mouse no cabeçalho da coluna e clique em Configurar > Dicionário.
   Lista v3	Abra o menu do título da lista, clique em Configurare em Dicionário.

3. Selecione a linha que não lista um nome de coluna.
   Esta linha é normalmente a primeira linha na lista. Por exemplo, selecione o primeiro link sys_user.
4. Em Links relacionados, clique em Exibição avançada.
5. No campo Atributos, adicione os atributos ref_auto_completer, ref_ac_columns,ref_ac_columns_search e ref_ac_display_value.
   Por exemplo, para ocultar a coluna de valor de exibição e exibir somente o nome e o sobrenome do usuário, insira o seguinte.

   ref_auto_completer=AJAXTableCompleter,ref_ac_columns=first_name;last_name,ref_ac_columns_search=true,ref_ac_display_value=false

6. Clique em Atualizar.

O que Fazer Depois

Para testar os novos atributos de preenchimento automático, abra um formulário que faça referência à tabela Usuário [sys_user], como um incidente em aberto. Insira um único caractere no campo Atribuído a. As opções de preenchimento automático agora ocultam a coluna de valor de exibição (user_name) e exibem somente as colunas first_name e last_name.

Melhorar consultas de preenchimento automático

Por padrão, todos os campos de referência usam uma consulta que começa com para pesquisar o texto correspondente na tabela de referência. Isso evita que o preenchimento automático execute consultas de conteúdo ineficientes sempre que um usuário pesquisar um campo de referência. Você pode exigir que todos os campos de referência usem uma consulta que começa com.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

O exemplo a seguir ilustra uma consulta " contém ". Observe que a letra "d" aparece em qualquer lugar no nome ou sobrenome do usuário.

Este procedimento descreve como mudar a propriedade do sistema glide.ui.ref_ac.startswith para sempre usar uma consulta starts with.

Procedimento

1. No filtro de navegação, insira sys_properties.list e pressione a tecla Enter.
2. Selecione a propriedade glide.ui.ref_ac.startswith.
   Para pesquisar a propriedade, insira *startswith no filtro Ir para pesquisa da coluna Nome.
3. No campo Valor, substitua falso por verdadeiro.
   Nota:

   Definir a propriedade do sistema glide.ui.ref_ac.startswith como verdadeiro substitui todas as configurações autocomplete.contains existentes nas preferências de nível do usuário e do sistema. Esta propriedade muda o método de consulta de preenchimento automático para todos os usuários, independentemente das preferências.
4. Clique em Atualizar.
5. Teste a mudança abrindo um registro com um campo de referência e inserindo um caractere nele, conforme ilustrado no exemplo abaixo.

   

Configurar o preenchimento automático para corresponder ao texto de qualquer campo de referência

Por padrão, o preenchimento automático corresponde somente ao texto na coluna de valor de exibição. Você pode configurar um campo de referência para corresponder ao texto de qualquer coluna adicional que o campo de referência exibir.

Antes de Iniciar

Função necessária: personalize_dictionary

Por Que e Quando Desempenhar Esta Tarefa

Você pode adicionar o atributo ref_ac_columns_search para habilitar o preenchimento automático para corresponder ao texto em qualquer coluna listada no atributo ref_ac_columns. Defina o atributo ref_ac_columns_search como verdadeiro para corresponder ao texto de todas as colunas do campo de referência. Por padrão (ou quando este atributo é falso), o preenchimento automático corresponde somente ao texto na coluna de valor de exibição.

Procedimento

1. Clique com o botão direito do mouse no rótulo de um campo de referência.
2. Selecione Configurar dicionário na lista de seleção.
3. Em Links relacionados, clique em Exibição avançada.
4. No campo Atributos, adicione os atributos de preenchimento automático desejados.
   Por exemplo, esses atributos adicionam o campo de departamento à lista de solicitantes e classificam os solicitantes por departamento:

   ref_auto_completer=AJAXTableCompleter,ref_ac_columns=department,ref_ac_order_by=department,ref_ac_columns_search=true 

   Figura 3. Atributo de preenchimento automático

   

5. Clique em Atualizar.

Exemplo

O exemplo a seguir descreve como definir o campo Item de configuração para exibir os nomes de classe de IC das opções de preenchimento automático da tabela Item de configuração [cmdb_ci].

ref_auto_completer=AJAXTableCompleter ,ref_ac_columns =sys_class_name ,ref_ac_order_by =sys_class_name ,ref_contributions =task_show_ci_map ;ci_show_incidents

Nota:

O atributo ref_contributions controla os ícones que aparecem ao lado do campo de referência.

Habilitar contém pesquisas de preenchimento automático

Por padrão, o preenchimento automático de referência usa uma pesquisa que começa com. Uma preferência do usuário pode ser criada para implementar uma pesquisa de conteúdo.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Desabilite a propriedade do sistema glide.ui.ref_ac.startswith.
   Para obter mais informações, consulte Melhorar consultas de preenchimento automático.

   Nota:

   Definir a propriedade do sistema glide.ui.ref_ac.startswith como verdadeiro substitui todas as configurações "autocomplete.contains" existentes nas preferências de nível do usuário e do sistema. Esta propriedade muda o método de consulta de preenchimento automático para todos os usuários, independentemente das preferências.
2. Navegar até Administração de usuários > Preferências do usuário.
3. Selecione a preferência “”<referenced table> .autocomplete.contains"' .
4. Defina o campo de valor como verdadeiro.

   

5. Clique em Atualizar.

O que Fazer Depois

Saia e faça login novamente para exibir a pesquisa atualizada.

Caracteres curinga em preenchimentos automáticos de referência

As pesquisas com caracteres curinga usam a funcionalidade de preenchimento automático.

Use um asterisco no campo de referência para pesquisas com caracteres curinga.

Figura 4. Pesquisa de um caractere curinga de asterisco

Se dois asteriscos forem inseridos, uma lista de registros disponíveis será exibida nas sugestões de preenchimento automático.

Figura 5. Pesquisa de dois asteriscos curinga

Conceitos relacionados

• Os caracteres curinga permitem pesquisar padrões e variações