DS_PARMDLPA — Descrição do Parâmetro DLPA

Tela de configuração: TCB014 — Parâmetros do Modelo DLPA Campo na tela: edtDS_PARMDLPA (label "Ordem") Tabela: PARMDLPA.DS_PARMDLPA — VARCHAR(60) NOT NULL Valor padrão: Nenhum (campo obrigatório, preenchimento manual)

Telas impactadas

Tela	Forma de uso
TCB014 (Parâmetros DLPA)	Cadastro / edição da descrição do parâmetro
RCB009 (Relatório DLPA)	Impressão da descrição no relatório (edtDS_PARMDLPA — TppDBText)
RCB012 (Relatório DLPA — múltiplas visões)	Impressão da descrição em até 4 bandas de detalhe distintas

Campos envolvidos

Campo	Tipo	Obrigatório	Observação
DS_PARMDLPA	VARCHAR(60)	Sim	Descrição textual do parâmetro de DLPA. Preenchimento livre, sem máscara.

Comportamento

O que faz	Detalhe
Edição	Campo texto livre (TDBEdit), editável durante inclusão e alteração
Obrigatoriedade	Não pode ser gravado vazio — o sistema exibe o alerta W-0514 e foca o campo
Comprimento máximo	60 caracteres (definido pelo domínio DOM_VARCHAR60)
Impressão	Aparece nos relatórios RCB009 e RCB012 quando a regra de visibilidade do parâmetro é atendida

Simulação passo a passo

1. Acesse a tela TCB014 — Parâmetros do Modelo DLPA.
2. Posicione-se no modelo de plano desejado.
3. Clique em Incluir (ou selecione um registro existente e clique em Alterar).
4. Digite a descrição do parâmetro no campo Ordem (ex.: Receita Bruta de Vendas, (-) Deduções sobre Vendas, Lucro Líquido do Exercício).
5. Preencha os demais campos obrigatórios (Código, Modelo, Impressão, Tipo Valor, Saldo, Ordem).
6. Clique em Salvar (<F9>).

Resultado esperado: A descrição é gravada na tabela PARMDLPA e fica disponível para exibição nos relatórios de DLPA (RCB009 e RCB012).

Exceção / Importante:

• Se o campo for deixado em branco ao salvar, o sistema exibe a mensagem W-0514 ("Descrição não informada") e retorna o foco para o campo, impedindo a gravação.
• O campo não possui validação de unicidade — a descrição pode se repetir em parâmetros diferentes. A unicidade é garantida pela chave primária composta CD_MODELOPLANO + CD_PARMDLPA.

Regra de visibilidade nos relatórios (RCB009 / RCB012)

Nos relatórios de DLPA, a descrição (edtDS_PARMDLPA) é exibida ou ocultada conforme a seguinte lógica:

• Se TP_VALOR = 'T' (totalizador) → descrição visível.
• Se ST_IMPRESSAO = 'S' e VL_DLPA possui texto preenchido → descrição visível.
• Caso contrário → descrição oculta (edtDS_PARMDLPA.Visible := False).

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Linha	Tipo
TdmTCB014.tabPARMDLPABeforePost	UdmTCB014.pas	64	Validação (obrigatoriedade, W-0514)
TdmTCB014.tabPARMDLPACD_PARMDLPAValidate	UdmTCB014.pas	136	Consulta para verificar duplicidade de chave
TfrmRCB009.btnImprimirClick	URCB009.pas	247	SELECT para relatório
ConsultaDLPA	UdmRCB012.pas	4743	SELECT para relatório

Referências SQL diretas ao campo

As queries montadas em tempo de execução nos fontes Delphi listados acima selecionam PARMDLPA.DS_PARMDLPA para alimentar os relatórios e validações de chave.

Candidatas por uso da tabela

Não foi encontrada referência direta ao campo DS_PARMDLPA em scripts SQL (Scripts/). As referências estão exclusivamente no código Delphi das rotinas listadas acima.