Histórico da Página

Sintaxe

DbOrderNickName(<apelido>)

Propósito

Define o índice criado pelo usuário que será utilizado para a pesquisa de um registro no arquivo de dados.

Argumentos

<apelido>

É o nome dado ao novo índice e que será referenciado dentro da função.

Utilização

No Protheus, o usuário tem a possibilidade de criar novos índices para tabelas do próprio padrão do sistema ou para tabelas específicas. Nestes casos, para evitar conflito com os índices já existentes e facilitar a programação, o AdvPL disponibiliza o recurso de se criar um apelido para os índices.

Esses apelidos são informados na tabela SX1 do dicionário de dados (veja o item sobre Metadados). Posteriormente, eles são referenciados dentro das funções, através da função DbOrderNickName(), para serem utilizados.

Exemplo

dbSelectArea(“SA1”)

// De acordo com o arquivo SIX, o apelido (nickname) desse índice é Tipo e a chave de pesquisa é

// A1_FILIAL + A1_TIPO

DbOrderNickName(“Tipo”)