DS_LEITOR — Descrição do Leitor de Código de Barras

Tela de configuração: ADM017 — Parâmetros de Código de Barras Serial Campo na tela: Descrição (edtDS_LEITOR) Tabela: PARMCODBARRASERIAL.DS_LEITOR Tipo: VARCHAR(60) NOT NULL Valor padrão: Nenhum (obrigatório)

Descrição

Campo texto que armazena o nome/descrição do leitor de código de barras serial. Serve como identificação amigável do dispositivo cadastrado na tabela PARMCODBARRASERIAL.

Telas impactadas

Tela	Uso
ADM017	Cadastro de leitores — campo editável, obrigatório
ADM012	Parâmetros de Usuário — exibido na pesquisa de leitores e gravado no cadastro do usuário ao associar um leitor

Campos envolvidos

Campo	Tabela	Tipo	Obrigatoriedade
DS_LEITOR	PARMCODBARRASERIAL	VARCHAR(60)	Obrigatório (NOT NULL)
CD_LEITOR	PARMCODBARRASERIAL	INTEGER	Obrigatório (chave primária)

Opções disponíveis

Este é um campo de texto livre — não possui opções pré-definidas.

Preenchimento obrigatório

O que faz	Detalhe
Campo obrigatório na gravação	O BeforePost do dataset valida se DS_LEITOR está preenchido; se vazio, exibe erro W-0573 e retorna o foco para o campo

Simulação passo a passo

1. Acesse a tela ADM017 — Parâmetros de Código de Barras Serial.
2. Clique em Inserir para criar um novo leitor.
3. Preencha o Código do Leitor com um valor, por exemplo 1.
4. Deixe o campo Descrição (DS_LEITOR) em branco.
5. Salve o registro (<F9>).
6. O sistema exibe a mensagem de erro W-0573 e posiciona o cursor no campo Descrição.

Resultado esperado: O registro não é gravado enquanto a descrição não for informada.

Exceção / Importante: A validação ocorre no BeforePost do dataset, portanto aplica-se tanto na inserção quanto na alteração de um leitor existente.

Uso na pesquisa de leitores (ADM012)

O que faz	Detalhe
Coluna de exibição na pesquisa	Ao abrir a janela de pesquisa de leitores na tela ADM012, a coluna DS_LEITOR é exibida ao lado de CD_LEITOR para identificação visual
Preenchimento automático	Após selecionar um leitor na pesquisa, o campo DS_LEITOR é copiado automaticamente para o registro do usuário

Simulação passo a passo

1. Abra a tela ADM012 — Parâmetros de Usuário.
2. Posicione o cursor no campo Código do Leitor.
3. Pressione qualquer tecla de atalho de pesquisa (ex.: <F3> ou duplo-clique).
4. A janela "Selecione o Leitor" é exibida com as colunas Descrição e Código.
5. Selecione o leitor desejado, por exemplo "Leitor Portátil".
6. O campo Descrição do Leitor é preenchido automaticamente no cadastro do usuário.

Resultado esperado: O leitor fica associado ao usuário com sua descrição visível.

Exceção / Importante: Se o código do leitor informado não existir na tabela PARMCODBARRASERIAL, o campo DS_LEITOR no cadastro do usuário é limpo (vazio).

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Linha	Evidencia
TdmADM017.tabLEITORBeforePost	source/ADM017/UdmADM017.pas	55	Valida preenchimento obrigatório de DS_LEITOR antes de gravar
TfrmADM012.edtCD_LEITORKeyDown	source/ADM012/UADM012.pas	786	Usa DS_LEITOR como primeiro parâmetro de exibição na pesquisa de leitores
TdmADM012.tabPARMUSUARIOCD_LEITORValidate	source/ADM012/UdmADM012.pas	473	Consulta SELECT DS_LEITOR FROM PARMCODBARRASERIAL para preencher a descrição no cadastro do usuário

Scripts SQL

Não foi encontrada referência direta ao campo DS_LEITOR em scripts SQL (Scripts/).