Preenchimento automático para campos de referência

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. 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 o preenchimento automático exibir as opções.
    Figura 1. Preenchimento automático
    Um usuário digita joe e o preenchimento automático sugere Joe Employee para o campo.

    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.

    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 no nível de campo substitui um atributo no 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 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 Tudo > Administração de Usuários > Usuários.
    2. Execute a ação apropriada para a versão da sua lista.
      VersãoAçã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, essa 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 em Atribuído a. campo. As opções de preenchimento automático agora incluem o nome de usuário e o departamento.
    Lista de preenchimento automático

    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 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 do AJAXTableCompleter e ref_ac_columns, ref_ac_columns_search. 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 preenchimento automático em relação a um seletor, como a lista Representar usuário, só pode corresponder o texto ao 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ãoAçã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, essa 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 ref_auto_completer, ref_ac_columns, ref_ac_columns_search . 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 em 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.

    Valor de exibição sem preenchimento automático

    Melhorar 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 evita 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.
    O preenchimento automático contém consulta

    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.
      O preenchimento automático começa com a consulta

    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 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 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 Configurar Dicionário na 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, 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
      Lista de solicitantes com nome e departamento
    5. Clique em Atualizar.

    Exemplo

    O exemplo a seguir descreve como definir o. Item de configuração O campo exibe os nomes das classes 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:
    . ref_contributionso atributo controla os ícones que aparecem ao lado do campo de referência.

    Atributos de IC adicionais

    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. . glide.ui.ref_ac.startswithpropriedade do sistema.
      Para obter mais informações, consulte Melhorar consultas de preenchimento automático.
      Nota:
      Definindo o. glide.ui.ref_ac.startswithpropriedade do sistema para 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 "autocomplete.<referenced table>.contains"' .
    4. Defina valor campo para verdadeiro .
      Preferência do usuário Preenchimento automático definida como verdadeira
    5. Clique em 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 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