---
sourceDocument: Yokohama Administração da Now Platform
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-administration
Release :
- yokohama
ft:locale :
- pt-BR
ft:publication_title :
- Yokohama Administração da Now Platform
ft:clusterId :
- platadm
bundleId :
- platadm
workflow :
- Platform
---
# Preenchimento automático para campos de referência
# Preenchimento automático para campos de referência {#ariaid-title1}
* Versão de lançamento: Yokohama
*
* Atualizado 30 de jan. de 2025
*
*  8 min. de leitura
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 que o preenchimento automático exiba todas as opções. Figura 1. Preenchimento automático
## Atributos de dicionário para preenchimento automático de campos de referência {#c_AutoCompleteForReferenceFields__section_ckv_yxt_w1b}
Há atributos de dicionário que são específicos para campos de referência e que determinam o comportamento de preenchimento automático.
{#c_AutoCompleteForReferenceFields__table_r5y_s13_rt__entry__2}
| Atributo | Descrição |
|-|-|
| ref_auto_completer | Especifica o nome da classe JavaScript do lado do cliente que cria as opções de conclusão automática suspensas. Os valores de classe válidos são: * AJAXReferenceCompleter: Exibe as 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 usarão esta classe automaticamente 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 em ref_ac_columnsatributo. * AJAXReferenceChoice: Exibe as opções de preenchimento automático correspondentes como uma lista de opções suspensa. A lista exibe somente a coluna de valor de exibição da tabela de referência. Além disso, a lista exibe apenas 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. {#c_AutoCompleteForReferenceFields__ul_nqh_zyl_44} |
| 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_onpermite que o preenchimento automático corresponda ao texto das colunas user_name, email e sys_created_on. |
| ref_ac_order_by | Especifica a coluna da tabela de referência que classifica as opções de conclusão automática. Por exemplo, ref_ac_order_by=nameclassifica as opções de conclusão automática em ordem alfabética por nome. |
[Tabela 1. Atributos do dicionário de preenchimento automático do campo de referência]
{#c_AutoCompleteForReferenceFields__table_r5y_s13_rt}
## Recursos de IU de preenchimento automático {#c_AutoCompleteForReferenceFields__section_qwm_byt_w1b}
A classe de completador de tabela AJAX tem várias melhorias de IU.
* O concluidor de tabela sempre exibe o número de registros encontrados pela consulta de preenchimento automático.
* O concluidor da tabela destaca toda a linha selecionada alterando a cor do plano de fundo e do texto.
* O concluidor de tabela lista um valor para cada coluna.
* Na primeira vez que um valor aparece em uma coluna, o concluidor da tabela o exibe em texto preto.
* O concluidor da tabela exibe valores duplicados subsequentes em texto cinza. Anteriormente, o concluidor da tabela exibia uma célula vazia em uma coluna que contém um valor duplicado.
{#c_AutoCompleteForReferenceFields__ul_xqv_d1m_44}
{#c_AutoCompleteForReferenceFields__ul_and_11m_44} Figura 2. Destaque da linha selecionada
Defina o. ref_auto_completer=AJAXTableCompleteratributo de dicionário para usar essas melhorias.
## Defina atributos de preenchimento automático para todas as referências a uma tabela {#ariaid-title2}
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á ambos os conjuntos de atributos.
Use estas 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 de atributo de preenchimento automático de um campo substitui o valor de 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 TudoAdministração de usuáriosUsuá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 ConfigurarDicionário. |
| Lista v3 | Abra o menu de título da lista e clique em Configurar e clique em Dicionário . |
|-|-|
{#t_DefAutoComplAttribsAllRefsToATbl__choicetable_vrh_trd_sv}
3. Selecione a linha que não lista um nome de coluna.
Normalmente, esta linha é a primeira linha da lista. Por exemplo, selecione o primeiro sys_user link.
4. Em Links relacionados , clique em Exibição avançada .
5. Em Atributos , insira uma lista separada por vírgulas de atributos de preenchimento automático que você deseja aplicar a todos os campos na 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 Atribuído a. campo. As opções de preenchimento automático agora incluem o nome de usuário e o departamento.
## Remova a coluna de valor de exibição {#ariaid-title3}
Você pode remover a coluna de valor de exibição de um campo de referência definindo ref_ac_display_valueatributo 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 em ref_ac_columnsatributo. Este recurso requer o uso de AJAXTableCompleter e o. ref_ac_columns, ref_ac_columns_searche. ref_ac_display_valueatributos.
Nota:
O preenchimento automático não pode corresponder ao texto de colunas adicionais quando o campo de referência é um produto do ui_referenceMacro de IU. Isso significa que qualquer ação de conclusão automática em relação a um seletor, como a lista Representar usuário, só pode corresponder o 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 TudoAdministração de usuáriosUsuá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 ConfigurarDicionário. |
| Lista v3 | Abra o menu de título da lista e clique em Configurar e clique em Dicionário . |
|-|-|
{#t_RemoveTheDisplayValueColumn__choicetable_vrh_trd_sv}
3. Selecione a linha que não lista um nome de coluna.
Normalmente, esta linha é a primeira linha da lista. Por exemplo, selecione o primeiro sys_user link.
4. Em Links relacionados , clique em Exibição avançada .
5. Em Atributos , adicione o. ref_auto_completer, ref_ac_columns, ref_ac_columns_search e. ref_ac_display_valueatributos.
Por exemplo, para ocultar a coluna de valor de exibição e exibir somente o nome e 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 Atribuído a. campo. 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.
## Melhore as consultas de preenchimento automático {#ariaid-title4}
Por padrão, todos os campos de referência usam um começa com consulta para pesquisar texto correspondente na tabela de referência. Isso impede que o preenchimento automático seja executado de forma ineficiente contém consulta sempre que um usuário pesquisa um campo de referência. Você pode exigir que todos os campos de referência usem um começa com consulta.
### Antes de Iniciar
Função necessária: administrador
### Por Que e Quando Desempenhar Esta Tarefa
O exemplo a seguir ilustra um contém consulta. Observe que a letra "d" aparece em qualquer lugar no nome ou sobrenome do usuário.
Este procedimento descreve como mudar o. glide.ui.ref_ac.startswithpropriedade do sistema para sempre usar um starts withconsulta.
### 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 *inicia com em Vá para filtro de pesquisa para Nome coluna.
3. Em Valor campo, substituir falso com verdadeiro .
Nota:
Definindo o. glide.ui.ref_ac.startswithpropriedade do sistema para verdadeiro substitui qualquer existente autocomplete.containsconfigurações 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.
{#t_ImproveAutoCompleteQueries__steps_vsx_wtx_rt}
## Configure o preenchimento automático para corresponder ao texto de qualquer campo de referência {#ariaid-title5}
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 exibida pelo campo de referência.
### Antes de Iniciar
Função necessária: Personalize_dictionary
### Por Que e Quando Desempenhar Esta Tarefa
Você pode adicionar ref_ac_columns_searchatributo para habilitar o preenchimento automático para corresponder ao texto em qualquer coluna listada em ref_ac_columnsatributo. Defina o. ref_ac_columns_searchatributo para verdadeiro para corresponder o 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 Configure o Dicionário da lista de seleção.
3. Em Links relacionados , clique em Exibição avançada .
4. Em Atributos adicione os atributos de preenchimento automático desejados.
Por exemplo, estes atributos adicionam o campo de departamento à lista de chamadores e classificam os chamadores 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. Item de configuração O campo exibe os nomes da classe de IC das opções de preenchimento automático para a tabela de 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:
. ref_contributionso atributo controla os ícones que aparecem ao lado do campo de referência.
## A ativação contém pesquisas de preenchimento automático {#ariaid-title6}
Por padrão, o preenchimento automático de referência usa um começa com pesquisa. Uma preferência do usuário pode ser criada para implementar um contém pesquisa.
### Antes de Iniciar
Função necessária: administrador
### Procedimento
1. Desabilite o. glide.ui.ref_ac.startswithpropriedade do sistema.
Para obter mais informações, consulte [Melhore as consultas de preenchimento automático](https://servicenow-prod.fluidtopics.net/wT42hMm94RvClVdq8h5VKw#t_ImproveAutoCompleteQueries "Por padrão, todos os campos de referência usam um começa com consulta para pesquisar texto correspondente na tabela de referência. Isso impede que o preenchimento automático seja executado de forma ineficiente contém consulta sempre que um usuário pesquisa um campo de referência. Você pode exigir que todos os campos de referência usem um começa com consulta.").
Nota:
Definindo o. glide.ui.ref_ac.startswithpropriedade do sistema para verdadeiro substitui todas as configurações existentes de "autocomplete.contains" 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áriosPreferências do usuário.
3. Selecione a preferência "\.autocomplete.contains"' .
4. Defina o. valor campo para verdadeiro .
5. Clique em Atualizar.
{#t_ContainsAutoCompleteSearch__steps_ihx_2lm_44}
### O que Fazer Depois
Faça logout e login novamente para exibir a pesquisa atualizada.
## Caracteres curinga nos preenchimentos automáticos de referência {#ariaid-title7}
As pesquisas com curinga usam a funcionalidade de preenchimento automático.
Use um asterisco no campo de referência para pesquisas com curinga.
Figura 4. Pesquisa com curinga com um asterisco ![]()
Se dois asteriscos forem inseridos, uma lista de registros disponíveis será exibida nas sugestões de preenchimento automático.
Figura 5. Pesquisa com curinga com dois asterisco
**Conceitos relacionados**
* [Caracteres curinga permitem pesquisar padrões e variações](https://servicenow-prod.fluidtopics.net/clFldbPeElv03CjIygLSbQ "Expanda os resultados da pesquisa para corresponder a qualquer caractere que não seja de espaço. O Zing oferece suporte a caracteres curinga de caractere único e múltiplo.")