Como Criar Etiquetas a Partir de Ficheiros de Dados Excel e Tabelas de Consulta

As suas encomendas estão em Excel. Os nomes dos seus produtos estão em Excel. As suas moradas estão em Excel. E, no entanto, sempre que precisa de etiquetas, alguém abre a folha de cálculo, copia uma linha, cola-a num modelo, guarda um PDF e repete — quarenta vezes. Ou pior, alguém escreveu um script frágil há dois anos que se avaria sempre que uma coluna é renomeada.

Este artigo explora a alternativa: usar um ficheiro Excel como fonte de dados e um segundo ficheiro Excel (ou uma segunda folha) como tabela de consulta, produzindo depois etiquetas finalizadas como PDF de várias páginas, PNGs individuais ou saída direta para impressora — sem copiar e colar e sem manter um parser.

O que terá no final:

• Um ficheiro de dados com uma linha por etiqueta e uma linha de cabeçalho que se torna nos nomes dos seus campos.
• Uma tabela de consulta que resolve chaves como SKU em nomes completos de produtos ou categorias.
• Um layout de etiqueta no estúdio de etiquetas LPSNG com campos mapeados para colunas da folha de cálculo.
• Uma tarefa repetível: altere a folha de cálculo, volte a executar, obtenha novas etiquetas.

O Next Generation Label Printing System trata da renderização, da fila de tarefas e da saída por si. Se quiser transformar valores de campos individuais com Python em vez de mapeamento simples, isso é abordado separadamente em Label Printing API for Python Developers: Field Scripting — este artigo mantém-se no percurso da folha de cálculo.

Pré-requisitos: O Que Precisa Antes de Começar

• Uma edição do RSJ LPSNG com acesso ao estúdio de etiquetas e à fila de tarefas. A Cloud Solution, a Embedded Edition (um computador de placa única como um Raspberry Pi) e as Enterprise Features expõem todas a mesma funcionalidade base.
• O seu ficheiro de dados Excel, uma linha por etiqueta — por exemplo, número de artigo, descrição, preço.
• Opcionalmente um ficheiro de consulta separado (ou uma folha separada) que mapeia uma chave — por exemplo, número de artigo — para o texto que realmente quer na etiqueta, como o nome completo do produto ou a categoria.
• Um layout de etiqueta. Ou um que construiu no estúdio de etiquetas LPSNG, ou um layout existente que quer alimentar com dados da folha de cálculo.
• Uma ideia clara de qual coluna pertence a qual campo. Esboce-o no papel se for preciso; cinco minutos aqui poupam uma hora de remapeamento.

A interface Excel está documentada em lpsng.rsj.de/en/excel. Não é necessária qualquer instalação local além do seu navegador; a configuração da impressora é a única peça local.

Passo 1: Prepare o Seu Ficheiro de Dados Excel e a Tabela de Consulta

Estruture o ficheiro de dados com uma linha de cabeçalho, porque cada cabeçalho de coluna se torna num campo nomeado que pode mapear mais tarde.

SKU,Description,Price,Quantity
A-1001,Steel bracket 40mm,4.90,1
A-1002,Steel bracket 60mm,5.40,2
A-1003,Aluminium bracket 40mm,6.10,1

Depois construa a consulta como uma folha ou ficheiro separado com uma coluna de chave e os valores a juntar:

[
  { "SKU": "A-1001", "ProductName": "Steel Bracket, 40 mm, galvanised", "Category": "Hardware" },
  { "SKU": "A-1002", "ProductName": "Steel Bracket, 60 mm, galvanised", "Category": "Hardware" },
  { "SKU": "A-1003", "ProductName": "Aluminium Bracket, 40 mm",        "Category": "Hardware" }
]

Algumas regras que evitam a maioria dos problemas a jusante:

• Mantenha as chaves consistentes. A mesma grafia, o mesmo formato, as mesmas maiúsculas em ambos os lados.
• Remova células fundidas e linhas em branco. Quebram o mapeamento de colunas e podem deslocar a linha de cabeçalho detetada.
• Atenção aos zeros à esquerda. Se SKU for 0042, force a coluna a texto no Excel — caso contrário, a chave chega como 42 e a consulta falha silenciosamente.
• Um ficheiro é suficiente. Pode usar o mesmo livro para dados e consulta, colocando-os em folhas separadas.

Antes de carregar, uma verificação rápida no pandas deteta incompatibilidades de chaves antecipadamente:

import pandas as pd

data   = pd.read_excel("orders-october.xlsx", sheet_name="Data",     dtype=str)
lookup = pd.read_excel("orders-october.xlsx", sheet_name="Products", dtype=str)

# Normalise the join key identically on both sides.
for df in (data, lookup):
    df["SKU"] = df["SKU"].str.strip().str.upper()

orphans = sorted(set(data["SKU"]) - set(lookup["SKU"]))
print(f"{len(data)} data rows, {len(orphans)} keys without a lookup entry")
print(orphans)

Se orphans estiver vazio, a sua consulta será resolvida para todas as linhas.

Passo 2: Conceba ou Abra o Seu Layout de Etiqueta no LPSNG

Abra o estúdio de etiquetas LPSNG e crie um novo layout ou abra um existente.

• Adicione campos de texto para descrições e preços, campos de código de barras para o número de artigo e campos de imagem se quiser um logótipo ou fotografia do produto.
• Nomeie cada campo de forma significativa — field_product_name, field_price, field_sku — para que o mapeamento da coluna da folha de cálculo para o campo da etiqueta seja óbvio daqui a seis meses. Para o lado dos códigos de barras, os formatos 1D e 2D suportados estão listados em lpsng.rsj.de/en/barcode.
• Reserve espaço suficiente. Os valores da folha de cálculo não são uniformes: a primeira linha pode ser uma descrição curta, a quinquagésima pode ocupar três linhas. Deixe espaço em vez de reduzir o tipo de letra mais tarde.
• Transforme valores apenas se precisar. Formatar um preço, concatenar duas colunas ou calcular um dígito de controlo é trabalho para um bloco de script Python associado ao campo, documentado na referência da API Python em lpsng.rsj.de/api.

Guarde o layout. Torna-se no modelo para cada linha do seu ficheiro Excel — o trabalho de design acontece uma vez.

Passo 3: Mapeie as Colunas do Excel para os Campos da Etiqueta

Na interface Excel do LPSNG, carregue ou selecione o seu livro como fonte de dados e depois atribua cada coluna a um campo. Para valores de consulta, especifique a folha ou ficheiro de consulta e a coluna de chave; o LPSNG resolve a consulta por linha antes da renderização, pelo que o campo da etiqueta recebe o valor combinado, não a chave em bruto.

A interface de mapeamento expressa algo como isto — a interface escreve a configuração por si:

# Illustrative shape of the mapping you configure in the Excel interface.
layout: product-label
data_source:
  file: orders-october.xlsx
  sheet: Data
fields:
  field_sku:         SKU
  field_description: Description
  field_price:       Price
lookup:
  file: orders-october.xlsx
  sheet: Products
  key: SKU
  merge:
    field_product_name: ProductName
    field_category:     Category
output:
  format: pdf

Depois pré-visualize o mapeamento com as primeiras linhas. A pré-visualização é onde deteta uma coluna desviada por um ou um preço a aterrar no campo da descrição — antes de gastar um rolo de etiquetas.

Esta é a alternativa gerida a escrever um parser personalizado ou a montar um pipeline de linha de comandos: o mapeamento em si não precisa de código.

Passo 4: Renderize Etiquetas como PDF, PNG ou Envie para Impressão

Escolha a sua saída:

• PDF de várias páginas — ideal para arquivar, enviar por email ou entregar a uma gráfica.
• Imagens PNG individuais — para incorporar noutro sistema ou num front end web.
• Impressão direta — selecione a impressora e a fila de tarefas processa cada linha como uma etiqueta separada.
• JSON — quando um sistema a jusante precisa do resultado renderizado ou dos dados resolvidos em vez de papel.

Para automatização, controle a mesma tarefa a partir de código. A API do serviço web submete tarefas de impressão, renderiza etiquetas individuais como PDF ou PNG e suporta impressão direta; a autenticação usa OAuth2, documentado em lpsng.rsj.de/en/webservice. O LPSNG Player autónomo recebe um pacote mais dados e escreve PDF, PNG, JSON ou envia para uma impressora:

# Endpoint paths, flags and payload fields are documented on the web service
# and Player pages — the shape below is illustrative only.
curl -X POST "https://<your-lpsng-host>/…"   -H "Authorization: Bearer $LPSNG_TOKEN"   -d '{ "layout": "product-label", "data": "orders-october.xlsx", "output": "pdf" }'

lpsng-player   --package product-label   --data orders-october.xlsx   --output pdf

Se a sua equipa vive no Google Sheets em vez do Excel, o Google Sheets Add-on oferece o mesmo fluxo de trabalho de criar e imprimir no navegador. E toda a renderização acontece no lado do servidor — não instala tipos de letra nem controladores localmente além da configuração da impressora.

Passo 5: Verifique a Saída e Confirme as Consultas

Renderizar com sucesso não é o mesmo que renderizar corretamente. Verifique os artefactos:

• Verifique por amostragem várias etiquetas contra as linhas de origem — primeira linha, última linha e qualquer coisa com formatação invulgar.
• Confirme que as consultas foram resolvidas. Se a etiqueta mostra A-1002 onde esperava “Steel Bracket, 60 mm, galvanised”, a chave não correspondeu.
• Leia alguns códigos de barras com um leitor e compare o valor descodificado com os dados pretendidos. How to Verify Barcodes Before Printing Labels tem uma lista de verificação mais completa.
• Leia a fila de tarefas. As linhas que falharam ou foram ignoradas aparecem lá, normalmente com o valor problemático ou o erro do script.
• Se associou scripts de campo, confirme que as transformações foram aplicadas — um formato de data mal aplicado é fácil de passar despercebido até alguém ler uma etiqueta numa prateleira.

Resolução de Problemas Comuns

As etiquetas imprimem com campos em branco. Verifique se os cabeçalhos das colunas correspondem exatamente aos nomes dos campos mapeados e se o ficheiro de dados não tem linhas em branco à frente do cabeçalho. Uma única linha vazia no topo desloca tudo.

Uma consulta não devolve nada. As colunas de chave têm de corresponder em maiúsculas, espaços em volta e zeros à esquerda. Normalize ambos os lados como mostrado no Passo 1.

Os códigos de barras são lidos incorretamente. Verifique se o campo do código de barras está mapeado para a coluna correta e se o formato escolhido consegue transportar o comprimento de dados que está a codificar.

A renderização falha apenas em algumas linhas. Inspecione a fila de tarefas para ver as mensagens de erro. As causas comuns são um valor em falta que o layout exige ou um erro de script dentro de um bloco de campo.

A impressora não recebe nada. Confirme que a impressora está online e selecionada nas definições de saída. Para cenários de Google Cloud Print, consulte a documentação de Cloud Printing.

FAQ

Posso usar o mesmo ficheiro Excel para dados e consulta? Sim. Coloque os seus dados numa folha e a sua tabela de consulta noutra folha dentro do mesmo livro. Ao mapear, selecione a folha apropriada para cada função. Apenas garanta que a coluna de chave usada para as consultas é consistente em ambas as folhas.

Preciso de escrever código para mapear colunas do Excel para campos de etiqueta? Não. A interface Excel do LPSNG fornece uma UI de mapeamento onde atribui colunas da folha de cálculo a campos de etiqueta. Só precisa de código se quiser transformar valores — por exemplo, formatar um preço ou concatenar campos — o que pode fazer com blocos de script Python associados aos campos (consulte a documentação da API Python).

Que formatos de saída posso gerar a partir de dados Excel? Pode gerar PDFs de várias páginas, imagens PNG individuais, enviar tarefas diretamente para uma impressora ou produzir JSON. A API do serviço web e o LPSNG Player suportam estas saídas, para que possa integrar a renderização nas suas próprias aplicações.

Como atualizo as etiquetas quando o ficheiro Excel muda? Basta voltar a carregar o ficheiro Excel atualizado ou voltar a executar a tarefa com os novos dados. O LPSNG aplica o mesmo layout de etiqueta e mapeamento, pelo que não precisa de redesenhar nada. A fila de tarefas processará as novas linhas e produzirá etiquetas atualizadas.

Conclusão: Da Folha de Cálculo a Etiquetas Prontas para a Prateleira

O fluxo de trabalho é curto: prepare os seus dados Excel e a tabela de consulta, conceba o layout uma vez, mapeie as colunas para os campos, renderize, verifique. Nada nessa lista exige que escreva um parser ou que tome conta de um script.

O Next Generation Label Printing System faz o trabalho pesado — renderização, fila de tarefas, resolução de consultas e saída — para que possa passar o seu tempo nos dados em vez da canalização. Funciona da mesma forma quer produza dez etiquetas ou dez mil, e a API do serviço web permite que outros sistemas acionem as mesmas tarefas programaticamente.

Experimente a interface Excel na sua edição LPSNG — cloud, embedded ou enterprise — e, se a sua equipa preferir folhas de cálculo no navegador, dê uma vista de olhos ao Google Sheets Add-on para o mesmo fluxo de trabalho no seu navegador.

Publicações relacionadas

• Zebra Designer Alternative for Developers: What to Compare
• How to Connect ESL Tags to Items via API
• What a Vendor-Neutral ESL Interface Means for Developers