BIIMAGEMFUNDOCRC005 — Imagem de Fundo do CRC005

Tela de configuração: REC001 — Parâmetros da Recapadora Tabela: PARAMRECAP.BIIMAGEMFUNDOCRC005 Tipo: DOM_BLOBBINARIO (BLOB) Valor padrão: NULL (sem imagem)

Armazena a imagem de fundo exibida no formulário de consulta CRC005 (Recapadora — Consulta). A imagem é gravada como conteúdo binário (BLOB) e seu formato é acompanhado pelo campo DSIMAGEMFUNDOEXTENSAOCRC005 (VARCHAR(5)), que registra a extensão do arquivo.

O armazenamento é por empresa (IDEMPRESA), ou seja, cada empresa pode ter sua própria imagem de fundo.

---

Telas impactadas

Tela	Efeito
CRC005 (Consulta de Recapadora)	Exibe a imagem de fundo como plano de fundo do formulário de consulta (imgFundo). Permite alterar e remover a imagem.

---

Campos envolvidos

Campo	Tipo	Descrição
BIIMAGEMFUNDOCRC005	DOM_BLOBBINARIO	Conteúdo binário da imagem (BLOB).
DSIMAGEMFUNDOEXTENSAOCRC005	DOM_VARCHAR5	Extensão do arquivo (ex.: .JPG, .JPEG, .GIF).

---

Opções disponíveis

Este parâmetro não possui múltiplos valores discretos (não é um campo CHAR1 com lista de opções). Funciona como um armazenamento de arquivo binário: ou há uma imagem configurada ou não.

O que faz	Detalhe
Gravar imagem	O usuário seleciona um arquivo de imagem via diálogo de arquivo. A imagem é salva no BLOB e a extensão no campo DSIMAGEMFUNDOEXTENSAOCRC005.
Exibir imagem	Ao abrir a tela CRC005, o sistema lê o BLOB e exibe no componente imgFundo se a extensão for .JPG, .JPEG ou .GIF.
Remover imagem	Os campos BLOB e extensão são limpos; a visualização fica em branco.
Extensões bloqueadas	.BMP e .PNG geram exceção e não são permitidos.
Tamanho máximo	2 MB. Arquivos maiores geram exceção.
Editável	Sim, via botão "Alterar Imagem de Fundo" e "Remover Imagem de Fundo" na tela CRC005.

---

Gravar e exibir imagem de fundo

Simulação passo a passo

1. Acesse a tela CRC005 (Consulta de Recapadora) no módulo Recapadora.
2. Clique no botão Alterar Imagem de Fundo (menu ou toolbar da tela).
3. No diálogo de arquivo que se abre, selecione uma imagem com extensão .JPG, .JPEG ou .GIF com tamanho inferior a 2 MB.
4. Confirme a seleção.
5. O sistema grava o conteúdo binário no campo BIIMAGEMFUNDOCRC005 e a extensão em DSIMAGEMFUNDOEXTENSAOCRC005.
6. A imagem é exibida como plano de fundo no componente imgFundo da tela CRC005.

Resultado esperado: A imagem selecionada aparece como fundo do formulário de consulta na tela CRC005. Ao reabrir a tela, a imagem é carregada automaticamente.

Exceção / Importante:

• Se o arquivo tiver extensão .BMP ou .PNG, o sistema exibe a mensagem "A imagem possui extensão .BMP/.PNG e não é permitida. Adicione uma imagem com outra extensão! Verifique." e a imagem não é gravada.
• Se o arquivo exceder 2 MB, o sistema exibe "A Imagem possui tamanho superior à 2 MB. Verifique!" e a operação é cancelada.
• Se a extensão armazenada não corresponder a .JPEG, .JPG ou .GIF, a imagem não é renderizada (o componente fica em branco, mas os dados permanecem no BLOB).

---

Remover imagem de fundo

Simulação passo a passo

1. Acesse a tela CRC005 com uma imagem de fundo já configurada.
2. Clique no botão Remover Imagem de Fundo.
3. O sistema limpa tanto o campo BIIMAGEMFUNDOCRC005 quanto DSIMAGEMFUNDOEXTENSAOCRC005.
4. O componente imgFundo fica sem imagem (branco).

Resultado esperado: A imagem de fundo desaparece da tela CRC005. Na próxima abertura, nenhuma imagem será exibida.

---

Regras de negócio

Regra	Descrição
Um registro por empresa	A query tabIMAGEM filtra por IDEMPRESA, logo cada empresa possui no máximo uma imagem de fundo configurada.
Extensões aceitas para exibição	.JPG, .JPEG, .GIF.
Extensões bloqueadas	.BMP e .PNG — geram exceção na gravação.
Limite de tamanho	2 MB. Verificação feita via TamanhoArquivo antes de gravar.
Persistência do BLOB	Os dados são gravados via LoadFromFile e atualizados com FDUpdateSQL (InsertSQL / ModifySQL) na tabela PARAMRECAP.

---

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Evidência
TfrmCRC005.AlterarImagemFundoClick	source/CRC005/UCRC005.pas:640	tabIMAGEMBIIMAGEMFUNDOCRC005.LoadFromFile(Arquivo) — carrega imagem do disco para o BLOB.
TfrmCRC005.loadImagem	source/CRC005/UCRC005.pas:675	CreateBlobStream(tabIMAGEMBIIMAGEMFUNDOCRC005, bmRead) — lê o BLOB para exibir na tela.
TfrmCRC005.RemoverImagemFundoClick	source/CRC005/UCRC005.pas:724	tabIMAGEMBIIMAGEMFUNDOCRC005.AsString := '' — limpa o BLOB.

Referências SQL diretas ao campo

Não foram encontradas referências diretas a BIIMAGEMFUNDOCRC005 em procedures SQL em Scripts/. O campo é manipulado exclusivamente pelo componente Delphi (TBlobField) via FDUpdateSQL embutido no datamodule (UdmCRC005.dfm).

Candidatas por uso da tabela

As procedures abaixo citam PARAMRECAP mas não referenciam o campo BIIMAGEMFUNDOCRC005 diretamente. Não há impacto funcional direto sobre este campo.

Procedure/View	Arquivo
ATUALIZA_PEDIDONOTA	Scripts/ATUALIZA_PEDIDONOTA.sql
ATUALIZA_PREVISAOORDEMPROD	Scripts/ATUALIZA_PREVISAOORDEMPROD.sql
GERA_NOTAPEDIDO	Scripts/GERA_NOTAPEDIDO.sql
GERA_ORDEMPRODUCAORECAP	Scripts/GERA_ORDEMPRODUCAORECAP.sql
FECHA_ORDEMPRODUCAORECAP	Scripts/FECHA_ORDEMPRODUCAORECAP.sql
(entre outras — ver inventário completo)

---

Tabela Comparativa Resumida

Aspecto	Valor
Campo	BIIMAGEMFUNDOCRC005
Tipo	DOM_BLOBBINARIO (BLOB)
Tabela	PARAMRECAP
Companion	DSIMAGEMFUNDOEXTENSAOCRC005 (VARCHAR(5))
Escopo	Por empresa (IDEMPRESA)
Editável	Sim — via CRC005
Extensões aceitas	.JPG, .JPEG, .GIF
Extensões bloqueadas	.BMP, .PNG
Tamanho máximo	2 MB
Valor padrão	NULL (sem imagem)