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 da 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

Há atributos de dicionário que são específicos para campos de referência e que determinam o comportamento de 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 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 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.
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.

Defina 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á 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 Tudo > 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 de título da lista e clique em Configurar e clique em Dicionário .

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 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 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

Você pode remover a coluna de valor de exibição de um campo de referência definindo o. 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 Tudo > 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 de título da lista e clique em Configurar e clique em Dicionário .

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

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.

   

Configure 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 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. Selecione e mantenha pressionado (ou clique com o botão direito do mouse) o rótulo de um campo de referência.
2. Selecione Configure o Dicionário da lista.
3. Em Links relacionados , clique em Exibição avançada .
4. Em Atributos adicione os atributos de preenchimento automático desejados.
   Por exemplo, esses 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 

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

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.

   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ários > Preferências do usuário.
3. Selecione a preferência "<referenced table>.autocomplete.contains"' .
4. Defina o. valor campo para verdadeiro .
5. Selecione Atualizar.

O que Fazer Depois

Faça logout e login novamente para exibir a pesquisa atualizada.

Caracteres curinga nos preenchimentos automáticos de referência

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

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

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