SC Importacao Imagens Produtos

1957 — Iniciar Smart Component (Importação de Imagens de Produtos)

Recurso utilizado para executar o Smart de importação de imagens de produtos, automatizando o cadastro de fotos no sistema. Seu objetivo é reduzir o trabalho manual no recurso 831 - Informações adicionais Produto, permitindo importar imagens em lote a partir de uma pasta no servidor ou de um arquivo compactado. Com isso, o usuário consegue manter os produtos com imagens atualizadas de forma mais rápida, padronizada e com menos risco de duplicidade ou cadastro incorreto.

Objetivo

Esta tela serve para iniciar o processo de importação automática de imagens dos produtos. Ela é útil para equipes operacionais que precisam cadastrar muitas fotos, para analistas que acompanham a integridade do cadastro e para gestores que desejam manter o catálogo visual de produtos sempre atualizado.

Ao centralizar a importação em um Smart Component, o processo ganha velocidade, reduz falhas humanas e evita retrabalho. Além disso, a funcionalidade ajuda a manter consistência entre o cadastro do produto e suas imagens, o que melhora a consulta, a análise e o uso das informações em outras rotinas do ERP.

Pré-requisitos

• Ter permissão para acessar o recurso 1957 - Iniciar Smart Component.
• Ter o Smart de importação previamente disponibilizado para uso no recurso 1947 - Smart Component.
• Ter produtos já cadastrados no recurso 65 - Produtos e Serviços.
• Ter acesso ao recurso 831 - Informações adicionais Produto, onde as imagens serão efetivamente vinculadas.
• Se a importação for por pasta no servidor, o caminho informado deve existir e estar acessível.
• Se a importação for por arquivo, é necessário enviar um arquivo compactado válido nos formatos .zip, .rar, .7z, .gz ou .tar.
• As imagens devem estar organizadas em subpastas, sendo que cada subpasta representa um produto.
• O nome de cada subpasta deve corresponder ao tipo de identificação escolhido na execução: Identificador, Código Auxiliar ou Código Referência.
• As imagens aceitas devem seguir os formatos permitidos pelo processo já utilizado no recurso 831, como JPG, JPEG e PNG.
• Para que a imagem seja vinculada corretamente, o produto correspondente à pasta precisa existir no sistema.

Fluxo Principal

Passo a passo para utilizar o recurso:

1. Acesse o recurso 1957 - Iniciar Smart Component.
2. Selecione o Smart de importação de imagens de produtos.
3. Escolha como a importação será feita no campo Importar por.
4. Se optar por Pasta no Servidor, informe o caminho da pasta onde estão as subpastas com as imagens.
5. Se optar por Arquivo, envie o arquivo compactado contendo a pasta principal e suas subpastas internas.
6. Defina no campo Buscar Imagens Produto Por como o sistema deve localizar cada produto: por Identificador, Código Auxiliar ou Código Referência.
7. Se desejar que o sistema reconheça automaticamente a imagem principal, informe um valor no campo Aliases Imagem Principal Produto.
8. Defina no campo Alterar/Remover Imagens Existentes Não Encontradas na Pasta se o sistema deve apenas acrescentar imagens ou também atualizar/remover imagens já cadastradas.
9. Execute o Smart Component.
10. O sistema irá acessar a pasta informada ou extrair o arquivo enviado.
11. Em seguida, o sistema analisará cada subpasta, localizará o produto correspondente e fará o vínculo das imagens no cadastro de informações adicionais do produto.
12. Caso o produto ainda não tenha registro em Informações Adicionais do Produto, o sistema criará esse vínculo automaticamente.
13. Ao final, as imagens ficarão disponíveis no cadastro do produto conforme as regras definidas na execução.

Orientação para preenchimento de campos

Nome do campo	Objetivo	Orientação de preenchimento
Importar por	Define a origem das imagens que serão processadas	Escolha Pasta no Servidor quando as imagens já estiverem disponíveis em um caminho do servidor. Escolha Arquivo (.zip, .rar, .7z, .gz ou .tar) quando for enviar um pacote compactado para extração e leitura.
Path Pasta Imagens - Servidor	Informa o local onde o sistema deve procurar as subpastas com as imagens	Preencha somente quando Importar por estiver como Pasta no Servidor. Informe o caminho completo da pasta principal. Sem esse dado, a execução não deve prosseguir.
Arquivo compactado	Permite enviar um pacote contendo as subpastas e imagens dos produtos	Utilize somente quando Importar por estiver como Arquivo. O arquivo deve conter uma pasta principal e, dentro dela, as subpastas dos produtos com suas respectivas imagens.
Buscar Imagens Produto Por	Define qual informação do produto será usada para localizar cada pasta importada	Escolha Identificador quando o nome da pasta for o ID do produto. Escolha Código Auxiliar ou Código Referência quando a nomenclatura da pasta seguir um desses campos do cadastro do produto.
Aliases Imagem Principal Produto	Indica como o sistema deve reconhecer qual foto será a principal do produto	Informe um trecho do nome do arquivo que identifique a imagem principal, como por exemplo P_. O sistema procurará entre os arquivos da pasta aquele que contenha esse padrão no nome.
Alterar/Remover Imagens Existentes Não Encontradas na Pasta	Define se a importação irá apenas complementar o cadastro ou também atualizar/remover imagens antigas	Use Não quando quiser preservar as imagens já cadastradas e apenas acrescentar novas. Use Sim quando desejar que o sistema compare o conteúdo da pasta atual com o cadastro existente e remova o que não estiver mais presente.

Funcionalidades

• Importação por pasta no servidor — Permite executar a carga diretamente de um caminho informado no servidor, ideal para processos internos já organizados por diretório.
• Importação por arquivo compactado — Permite enviar um pacote compactado para o sistema extrair e processar, útil quando as imagens são recebidas de terceiros ou preparadas fora do servidor.
• Busca do produto por diferentes critérios — O sistema pode localizar o produto usando Identificador, Código Auxiliar ou Código Referência. Isso dá flexibilidade para diferentes padrões de organização das pastas.
• Leitura por subpastas — Cada subpasta representa um produto. Essa estrutura ajuda a separar visualmente os arquivos e evita mistura de imagens entre produtos.
• Criação automática de Informações Adicionais do Produto — Quando o produto existe, mas ainda não possui registro em Informações Adicionais, o sistema cria esse vínculo automaticamente para permitir o cadastro das imagens.
• Definição automática da imagem principal por alias — Quando o alias é informado, o sistema procura a imagem cujo nome contenha esse padrão e a define como principal.
• Definição automática da imagem principal quando houver apenas uma imagem — Se nenhum alias for informado e a pasta tiver somente uma imagem, essa imagem passa a ser a principal.
• Importação sem imagem principal definida — Se nenhum alias for informado e a pasta tiver mais de uma imagem, todas serão vinculadas como imagens normais.
• Preservação da imagem principal existente — Quando a opção de alterar/remover estiver como Não, a imagem principal atual do produto é mantida, mesmo que exista um novo arquivo com alias na pasta.
• Substituição da imagem principal — Quando a opção de alterar/remover estiver como Sim, a imagem principal antiga pode ser removida se não for encontrada no conteúdo atual da pasta, dando lugar à nova imagem principal identificada.
• Remoção de imagens não encontradas — Com a opção Sim, o sistema remove imagens antigas que não estejam mais presentes na pasta atual, ajudando a manter o cadastro alinhado ao material mais recente.
• Importação incremental — Ao executar novamente o processo com novas imagens, o sistema acrescenta apenas os arquivos ainda não cadastrados.
• Prevenção de duplicidade — O sistema não deve duplicar imagens já importadas anteriormente quando os arquivos permanecem iguais, evitando excesso de dados e poluição do cadastro.
• Validação de formatos permitidos — O processo considera os formatos de imagem aceitos pela rotina de cadastro de imagens do recurso 831, mantendo o padrão já utilizado pelo sistema.
• Tratamento de pasta sem produto correspondente — Se uma pasta não corresponder a nenhum produto existente, ela é ignorada sem interromper toda a execução.

Problemas e Soluções

Problema	Solução
O processo não executa ao escolher Pasta no Servidor	Verifique se o campo Path Pasta Imagens - Servidor foi preenchido corretamente e se o caminho existe e está acessível.
O processo não executa ao escolher Arquivo	Confirme se um arquivo compactado foi enviado e se ele está em um formato aceito pelo recurso.
As imagens não foram vinculadas ao produto	Verifique se o nome da subpasta corresponde exatamente ao critério escolhido em Buscar Imagens Produto Por.
A imagem principal não foi definida	Confirme se o alias informado realmente aparece no nome do arquivo. Se o alias estiver vazio e houver mais de uma imagem na pasta, nenhuma será marcada como principal.
A imagem principal antiga permaneceu mesmo após nova importação	Isso pode ocorrer quando a opção Alterar/Remover Imagens Existentes Não Encontradas na Pasta está como Não. Nesse modo, o sistema preserva a principal já cadastrada.
Imagens antigas não foram removidas	Revise se a opção de alteração/remoção foi marcada como Sim. Se estiver Não, o sistema mantém as imagens anteriores.
Algumas pastas foram ignoradas	Isso normalmente acontece quando não existe produto correspondente à nomenclatura da pasta no sistema.
Há receio de duplicar imagens em novas execuções	O Smart foi projetado para evitar duplicidade. Mesmo assim, mantenha os arquivos padronizados e não renomeie imagens sem necessidade entre as execuções.
Uma nova imagem foi adicionada, mas as antigas continuam corretas	Esse é o comportamento esperado quando o objetivo é importação incremental, acrescentando somente o que ainda não existe.
O arquivo de imagem não foi aceito	Verifique se a extensão está entre os formatos válidos e se a imagem segue as regras já aplicadas no recurso 831.

Exemplos de Uso

• Operador de cadastro — Recebe um pacote com fotos de 50 produtos. Em vez de abrir produto por produto no recurso 831, organiza as imagens em subpastas com o Código Referência de cada item, envia o arquivo compactado e executa o Smart. Isso reduz o tempo de cadastro e evita esquecer imagens em produtos diferentes.
• Analista de dados cadastrais — Precisa atualizar o catálogo visual de produtos da linha LINHA-2026. Utiliza a busca por Código Auxiliar, informa o alias P_ para imagem principal e marca a opção de alteração/remoção como Sim. Dessa forma, o cadastro fica alinhado ao material mais recente e sem fotos antigas desnecessárias.
• Gestor comercial — Solicita que o portfólio esteja visualmente atualizado para consulta da equipe de vendas. A equipe prepara uma pasta no servidor com subpastas nomeadas pelo identificador do produto e executa o Smart. O ganho está em atualizar vários itens de uma vez, com mais controle e menos dependência de operação manual.
• Exemplo prático fictício — A pasta 1598 contém os arquivos P_frente.jpg e lateral.png. Se o alias informado for P_, o sistema entende que P_frente.jpg será a imagem principal e lateral.png será uma imagem complementar.
• Exemplo prático sem alias — A pasta 2001 contém apenas produto2001.jpg. Mesmo sem preencher o alias, o sistema define essa foto como principal por ser a única imagem disponível.
• Exemplo prático com mais de uma imagem e sem alias — A pasta 3005 contém frente.jpg e costas.jpg. Como não há alias e existem duas imagens, ambas serão importadas como imagens normais, sem principal definida automaticamente.

Observações Gerais

• Organize as imagens sempre em subpastas separadas por produto.
• Antes da execução, confirme qual informação será usada para localizar o produto: Identificador, Código Auxiliar ou Código Referência.
• Use alias somente quando houver um padrão real e consistente no nome das imagens.
• Se houver dúvida sobre remover ou não imagens antigas, prefira executar primeiro com a opção Não para evitar exclusões indesejadas.
• A opção Sim é mais indicada quando a pasta enviada representa exatamente a situação final desejada para o produto.
• Padronizar nomes de arquivos e pastas ajuda a diminuir falhas na importação.
• Se um produto ainda não tiver Informações Adicionais cadastradas, isso não impede a importação; o sistema cria o vínculo automaticamente.
• O processo foi pensado para evitar duplicação de imagens, mas o melhor resultado depende de uma organização consistente dos arquivos.
• Quando uma pasta não encontra um produto correspondente, ela é ignorada. Por isso, revisar a nomenclatura antes da execução é uma boa prática.
• Sempre que possível, valide o resultado no recurso 831 após a importação, principalmente em cargas maiores.

Benefícios do Recurso

• Reduz o trabalho manual no cadastro de imagens de produtos.
• Acelera a atualização em lote do catálogo visual.
• Diminui risco de erro operacional ao evitar vinculação manual imagem por imagem.
• Mantém maior consistência entre o cadastro do produto e suas fotos.
• Evita duplicidade desnecessária de arquivos no banco de dados.
• Permite atualizar imagens novas sem perder controle sobre as antigas.
• Dá flexibilidade para diferentes padrões de identificação do produto.
• Facilita a manutenção do cadastro por equipes operacionais, analistas e gestores.
• Contribui para consultas mais confiáveis e para melhor apresentação dos produtos em processos internos.

Glossário de Termos

• Smart Component — Recurso configurado para executar uma rotina automatizada dentro do ERP.
• Importação por pasta — Processo em que o sistema busca imagens em um caminho já existente no servidor.
• Importação por arquivo — Processo em que o usuário envia um arquivo compactado para extração e leitura das imagens.
• Alias — Trecho do nome do arquivo usado como referência para identificar a imagem principal.
• Imagem principal — Foto de destaque do produto.
• Imagem normal — Foto complementar do produto, sem função de destaque principal.
• Código Auxiliar — Campo alternativo usado para identificar um produto no cadastro.
• Código Referência — Código de referência comercial ou operacional do produto.
• Informações Adicionais do Produto — Cadastro complementar do produto onde as imagens são vinculadas.
• Importação incremental — Inclusão apenas de novas imagens sem duplicar o que já foi importado.

Links Relacionados

• 1947 - Smart Component
• 1957 - Iniciar Smart Component
• 65 - Produtos e Serviços
• 831 - Informações adicionais Produto
• Cadastro e manutenção de imagens de produto
• Documentação interna