O autocomplete é um importante recurso que aumenta a usabilidade dos sistemas gerados. O Telescope gera este recurso automaticamente conforme o detalhamento do modelo do bloco em uso. Cada campo editável que participa de uma lookup é candidato a ter um autocomplete.
A sugestão de registros é realizada com base na entidade de lookup e obedece a alguns critérios citados abaixo:
Filtros da lookup
Número mínimo de caracteres para iniciar a pesquisa
Uso de espaços dentro do texto digitado
Como desabilitar o autocomplete de um campo?
Para desabilitar/desativar o autocomplete de um campo, basta incluir a propriedade AUTOCOMPLETE=N no respectivo item, atributo ou domínio.
Em alguns domínios o autocomplete está desativado por natureza. Exemplo: CMC7;
Propriedades de desenvolvimento (item ou atributo)
AUTOCOMPLETE: Define se deve ou não incluir um autocomplete para o campo (S ou N).
AUTOCOMPLETE_LENGTH: Número de caracteres para iniciar a sugestão de valores. Padrão = 2.
LOOKUP_SQL: SQL a ser usado para pesquisar e apresentar o autocomplete. Este SQL deve ter 3 colunas:
valor: Valor que será preenchido no campo.
descricao: O que é apresentado para o usuário escolher
pesquisar: O que é uilizado para fazer a pesquisa.
Preferências de uso geral
RT.AUTOCOMPLETE.LIMIT: Número de registros que são sugeridos
Preferências de escopo de item
SISTEMA.BLOCO.ITEM.AUTOCOMPLETE_FULL: Define como a pesquisa é realizada - Se informar "S", a pesquisa é realizada em qualquer parte do campo. Se informar "N" (padrão) a pesquisa deve iniciar com o que foi informado (a não ser que o usuário comece com espaço para pesquisar em qualquer lugar).
SISTEMA.BLOCO.ITEM.AUTOCOMPLETE_LIMIT: Define o número de registros que serão apresentados no resultado. Por padrão, assume 20 registros.
Validate opções do autocomplete
Para validar as opções do autocomplete em um campo deve-se adicionar a propriedade (format) validate-options:true, caso informar um valor que não esteja no autocomplete, o sistema não executará nenhuma regra de ajax ou lookup sql.
Atenção
As preferências abaixo ainda são suportadas mas seu uso está DEPRECIADO:
Além da função de autocompletar controlada pelo sistema, existe uma opção de autocompletar do próprio navegador.
Esta opção é desabilitada por padrão, mas pode ser reativada pela preferencia RT.UI.BROWSER_FORM_AUTOCOMPLETE.