Repositório de imagens: como levar fotos para dentro do Protheus

No Protheus, a foto de um produto não é escolhida direto do seu computador na hora do cadastro. Ela precisa entrar antes no Repositório de Imagens do Configurador. Só depois disso o cadastro consegue apontar para ela. A TOTVS diz isso com todas as letras para o cadastro de produtos: no padrão, não dá para incluir a imagem sem que ela esteja no repositório.

O repositório é a rotina CFGX012, em Ambiente > Cadastros > Repositório de Imagens.

Os limites antes de começar

Fotos tiradas com celular passam de 1 MB com facilidade. Reduza antes de incluir: é mais rápido do que descobrir, depois, que a imagem não entrou.

1. No Configurador, abra Ambiente > Cadastros > Repositório de Imagens.
2. Clique em Incluir, selecione a pasta em que a imagem está e selecione a imagem.
3. Confirme a inclusão.

Dê às imagens nomes que você reconheça depois, como o código do produto. É por esse nome que alguém vai procurar a foto na hora de vinculá-la.

Escolhendo a imagem no cadastro de produtos

Com a imagem no repositório, o vínculo é feito no próprio cadastro:

1. Abra o cadastro de produtos e entre em inclusão ou alteração.
2. Vá à aba Atendimento e use o botão Imagem.
3. Na janela do repositório, dê um duplo clique no nome da imagem e confirme.

O campo que guarda a escolha é o B1_BITMAP, com o título Foto e a descrição Foto do Produto no dicionário padrão. Ele fica na pasta Atendimento, e não na primeira aba. Quem procura o campo entre os dados cadastrais não o encontra.

Tabela customizada também pode ter foto. A documentação da rotina orienta criar o campo com a identificação do arquivo seguida da palavra BITMAP, como o B1_BITMAP. O artigo sobre campos reservados mostra a tabela ZA1, de motoristas, ganhando o ZA1_BITMAP.

Arquivo ou banco: quem decide

O repositório pode guardar as imagens em arquivo ou no banco de dados. Quem decide é uma chave do appserver.ini, na seção do ambiente:

[Ambiente]
RepositInDataBase=1

Com a chave, as imagens passam a ser tratadas no banco, na tabela PROTHEUS_REPOSIT. Sem ela, ficam nos arquivos SIGAADV:

A TOTVS recomenda o banco para quem usa muitas imagens: a localização fica mais rápida.

Para conferir o modo, olhe o appserver.ini, e não a existência da tabela: a PROTHEUS_REPOSIT pode estar criada no banco e vazia.

Conferindo o que já está no banco

No modo banco, a PROTHEUS_REPOSIT não leva sufixo de empresa no nome. O índice dela é BMPNAME + ALIAS + SEQ: um mesmo nome de imagem pode ocupar várias linhas, numeradas em SEQ. Por isso a consulta agrupa, para mostrar cada imagem uma vez:

SELECT BMPNAME, ALIAS, MODULO, COUNT(*) AS LINHAS
  FROM PROTHEUS_REPOSIT
 WHERE D_E_L_E_T_ = ' '
 GROUP BY BMPNAME, ALIAS, MODULO
 ORDER BY BMPNAME

A consulta é só para ler. A imagem fica na coluna MEMO, em formato binário, e inclusão ou exclusão se faz pela rotina, nunca por SQL.

O MV_REPOSIT separa as imagens por módulo

O dicionário descreve o MV_REPOSIT como o parâmetro que “indica o tipo de armazenamento do repositório”. O nome engana. Quem escolhe entre arquivo e banco é a chave do appserver.ini. O parâmetro, segundo a própria TOTVS, serve apenas para segmentar o uso das imagens por módulo:

No dicionário padrão, o conteúdo inicial é 1. Quando a queixa é “a foto aparece no estoque, mas não no faturamento”, este é o primeiro lugar a olhar:

SELECT X6_FIL, X6_VAR, X6_TIPO, X6_DESCRIC, X6_DESC1, X6_DESC2, X6_CONTEUD
  FROM SX6010
 WHERE X6_VAR = 'MV_REPOSIT'
   AND D_E_L_E_T_ = ' '

O 010 no nome da SX6 é o sufixo da empresa. Ele muda de ambiente para ambiente. Troque pelo seu.

Mudar o parâmetro não mexe nos arquivos SIGAADV. Eles permanecem como estão.

Se as fotos estão no repositório e mesmo assim não aparecem num cadastro, fale com a gente.