Ir para o conteúdo

FoccoEtiquetas

Conhecer o Processo

O que é?

O FoccoEtiquetas é o componente responsável pela manutenção de modelos de etiquetas e pela geração/impressão de arquivos de etiquetas a partir de dados do FoccoERP.

Para que serve?

Permite criar e gerenciar layouts de etiquetas térmicas em linguagens como ZPL (Zebra), DPL (Datamax) e EPL, possibilitando a impressão automatizada de etiquetas a partir de diferentes fontes de dados do sistema.

Principais Benefícios

  • Centraliza a manutenção de modelos de etiquetas em um único local
  • Permite reutilização de layouts entre diferentes processos e empresas
  • Suporta geração via relatórios Vision (fluxo moderno) e programas padrão (fluxo legado)
  • Utiliza sistema de atributos com tags <NOME_DO_CAMPO> para preenchimento automático
  • Possui console de conversão de imagens para etiquetas térmicas DPL

Programas Relacionados

  • FUTL0201 - Cadastro de Modelos de Etiquetas Térmicas
  • FUTL0274 - Geração de Etiquetas - FoccoVision
  • FUTL0275 - Console de Conversão de Imagens Para Etiquetas

Roteiro de Implantação

Habilitação

Para utilizar o FoccoEtiquetas é necessário:

1. Habilitar o parâmetro 3 - Indica Se O Cliente Utiliza O Foccoetiquetas no programa FUTL0125 ETIQ

2. Configurar o executável através do parâmetro 4 - Nome Do Executavel Para Impressão (especialmente em ambientes Cloud)

Em ambientes Cloud, é fundamental garantir que o executável FOCCOETIQUETAS.EXE esteja no diretório configurado e acessível pelo servidor.

Parâmetros

Os parâmetros para o FoccoEtiquetas encontram-se na seguinte pasta:

Parâmetros do Sistema >> Parâmetros Utilitários >> Parâmetros do FoccoEtiquetas (FUTL0125 ETIQ)

1 - Modelo Padrão de Etiqueta

Informar o modelo de etiqueta que será carregado como padrão no programa de impressão de etiquetas via FoccoVision (FUTL0274).

2 - Relatório Do Vision Padrão Utilizado Na Impressão De Etiquetas

Informar o relatório do Vision que será carregado como padrão no programa de impressão de etiquetas via FoccoVision. (FUTL0274).

3 - Indica Se O Cliente Utiliza O Foccoetiquetas

Parâmetro responsável por habilitar o FoccoEtiquetas.

4 - Nome Do Executável Para Impressão

Nome do executável utilizado para impressão das etiquetas.

5 - Indica Se A Última Impressora Utilizada Será Default

Informe se deve utilizar a última impressora utilizada, na última impressão, como default.

6 - Indica Se Deve Apagar Os Arquivos De Etiquetas No UTL_FILE_DIR E No C:\TMP

Indica se deve apagar os arquivos de etiquetas no UTL_FILE_DIR e no C:\TMP.

Cadastros Auxiliares

Antes de iniciar a geração de etiquetas, é necessário realizar os seguintes cadastros:

Cadastro de Modelos de Etiquetas Térmicas (FUTL0201)

Cadastro dos layouts de etiquetas, contendo:

  • Comandos iniciais (configuração da impressora)
  • Campos da etiqueta (corpo com atributos <...>)
  • Comandos finais
  • Formulários adicionais (quando necessário)

Atributos

Para cada modelo, definir os atributos que serão preenchidos dinamicamente:

  • Mapeamento para colunas de tabela (WG_ETIQUETAS ou WG_ETIQ_VISION)
  • SQL específico por atributo
  • Máscaras e formatações
  • Prompts para exibição

Relatórios Vision (para fluxo moderno)

Quando utilizar o fluxo com FoccoVision, é necessário:

  • Criar o relatório dinâmico (TCAB_DINAMICO)
  • Configurar pelo menos um campo de restrição marcado com "R"
  • Garantir que o campo de restrição não seja Master Detail

Console de Conversão de Imagens para Etiquetas

O que é?

O Console de Conversão de Imagens (FUTL0275) foi desenvolvido especificamente para o FoccoEtiquetas com o objetivo de facilitar a utilização de imagens específicas de cada item produzido nas etiquetas térmicas DPL.

Para que serve?

Permite converter imagens em formato compatível para impressão em etiquetas térmicas, gerando automaticamente o código HEXA necessário para inclusão nos modelos de etiquetas.

Parametrização

Parâmetros

Os parâmetros para o Conversor de Imagens encontram-se na seguinte pasta:

Parâmetros do Sistema >> Parâmetros Utilitários >> Parâmetros do FoccoEtiquetas (FUTL0125 ETIQ)

1 - Diretório De Busca De Imagens Convertidas Para Impressão

Informar o diretório de busca de imagens convertidas para impressão. Este será composto pelo caminho_da_aplicacao>\erpfiles\images\foccoetiquetas\conversaoimagem\destino.

2 - Classificações Do Item Comercial

Informar as classificações da pasta estoque do item comercial separadas por vírgula.

3 - Altura Padrão Para O Item Comercial Em Pixels

Informar o valor padrão de altura da imagem do item comercial em pixels.

4 - Largura Padrão Para O Item Comercial Em Pixels

Informar o valor padrão de largura da imagem do item comercial em pixels.

5 - Rotação Padrão Para O Item Comercial Em Graus

Informar o valor padrão de rotação da imagem do item comercial em graus.

6 - Classificações Do Item Fábrica

Informar as classificações da pasta estoque do item fábrica separadas por vírgula.

7 - Altura Padrão Para O Item Fábrica Em Pixels

Informar o valor padrão de altura da imagem do item fábrica em pixels.

8 - Largura Padrão Para O Item Fábrica Em Pixels

Informar o valor padrão de largura da imagem do item fábrica em pixels.

9 - Rotação Padrão Para O Item Fábrica Em Graus

Informar o valor padrão de rotação da imagem do item fábrica em graus.

10 - Linguagem Da Etiqueta

Linguagem específica ou palavra AMBAS, para gerar arquivos para ambas em pasta específica ZPL ou DPL.

Permissões e Configuração de Diretórios

Requisitos de Acesso

Permissões de Rede

O usuário da rede deve ter acesso de leitura e escrita no diretório onde as imagens são salvas.

Pasta de Origem

Ao fazer o upload da imagem no conversor, a imagem original fica salva nesta pasta.

Pasta de Destino

Após a conversão, a imagem BMP e o arquivo HEXA gerado são salvos na pasta de destino.

Atenção

O usuário do computador conectado deve garantir que possui permissão de leitura e escrita para a pasta de destino, evitando falhas no processo de conversão e gravação dos arquivos.

Exemplo de Utilização de Imagem na Etiqueta

Após converter a imagem no programa FUTL0275, você pode utilizá-la nos modelos de etiquetas através de um SQL específico no cadastro de atributos do modelo (FUTL0201).

Exemplo de SQL para Busca de Imagem Convertida

Este SQL deve ser configurado no atributo do modelo de etiqueta para buscar a imagem convertida:

SELECT '<IMG>' 
    || FOCCO3I_UTIL.RETORNA_PARAMETRO('CONVERSAO_IMAGENS', 'DIR_IMG_DEST', itempr.empr_id, NULL) 
    || conv.cod_imagem 
    || '.txt'
    || '</IMG>'
  FROM tconversao_img_etq  conv
     , tordens             ord
     , tetiq_plc           etiq
     , titens_planejamento itpl
     , titens_empr         itempr
     , wg_etiquetas        wg
 WHERE ord.id                      = etiq.ordem_id
   AND ord.itpl_id                 = itpl.id
   AND itpl.itempr_id              = itempr.id
   AND conv.itempr_id              = itempr.id
   AND NVL(conv.tmasc_item_id, -1) = NVL(ord.tmasc_item_id, -1)
   AND etiq.ID                     = wg.tetiq_plc_id;

Como funciona:

  1. Busca o diretório de destino configurado no parâmetro DIR_IMG_DEST da categoria CONVERSAO_IMAGENS
  2. Localiza o código da imagem convertida na tabela TCONVERSAO_IMG_ETQ
  3. Monta o caminho completo do arquivo .txt (código HEXA) gerado pelo conversor
  4. Retorna o valor entre tags <IMG>...</IMG> para ser substituído no layout da etiqueta

Dica de Configuração

Configure este SQL em um atributo do modelo (ex.: <IMAGEM_ITEM>) no programa FUTL0201, na aba de atributos. Quando a etiqueta for gerada, o sistema substituirá automaticamente a tag pela imagem convertida correspondente ao item.

Fluxo de Utilização

Pré-requisitos

  • Parâmetro 3 - Indica Se O Cliente Utiliza O Foccoetiquetas habilitado.
  • Relatório Vision com pelo menos um campo de restrição (não Master Detail) marcado com "R".
  • Modelo de etiqueta configurado para utilizar a base WG_ETIQ_VISION.

Passos

  1. No programa Geração de Etiquetas - FoccoVision (FUTL0274), selecionar o relatório e aplicar os filtros desejados.
  2. Selecionar o modelo de etiqueta cadastrado no Cadastro de Modelos de Etiquetas Térmicas (FUTL0201) (layout com tags <...> mapeadas para TEXT1..N ou para SQLs de atributos).
  3. Imprimir as etiquetas.

Boas práticas para o modelo de etiqueta

  • Configure os atributos do layout sempre no formato <NOME_TAG>.
  • Utilize o recurso de "Carregar atributos" para popular automaticamente o grid de atributos a partir do layout.
  • Utilize a função de Teste de impressão para validar visualmente o layout antes de liberar para o usuário final.