Introdução Descrição
Download Registro
Histórico Instalação
Exemplo 1 Exemplo 2
Perguntas freqüêntes E-Mail

Descrição

Logotipo WEBCODE

Todos os detalhes e parâmetros sobre a forma física do código de barras a ser gerado, são obtidos dos arquivos de configuração. Trata-se de arquivos tipo texto, presentes no mesmo diretório do CGI WEBCODE. Estes aqruivos possuem o seguinte formato:

;linhas de comentário (iniciadas por ponto-e-virgula);
[barcode]
var1=val1
var2=val2
.
.
[ hosts]
1=host1.name.com
2=host2.mane.com.uk
3=IP#1
4=IP#2
5=wild card format for IPs*.*
.
.

Pode-se ter até 999 diferentes arquivos de configuração. O file name de todos eles deve seguir o formato WEBCnnn.INI com nnn variando de 001 a 999. Quando o CGI WEBCODE é chamado, o número do arquivo de configuração a ser utilizado é informado como parâmetro: G=nnn. Se este parâmetro não for informado, 001 é assumido.

Os arquivos de configuração possuem uma estrutura bastante simples: Duas seções distintas denominadas [barcode] e [hosts].

A seção [barcode] é usada para informar os parâmetros e variáveis que definem todos os detalhes dos códigos de barras a serem gerados. A seção [hosts] informa os nomes e/ou IPs dos hosts autorizados a chamar o CGI WEBCODE.

Os parâmetros e variáveis possíveis nos arquivos de configuração são as seguintes:

Parâmetro

Descrição

Z=xxxxxxxx Informa a unidade métrica a ser usada, podendo ser igual a "Centímetros"  ou "Polegadas". Se omitido, "Centímetros" é assumido. As medidas serão sempre informadas em milésimos de centímetros ou polegadas. Na descrição dos parâmetros que segue, supõe-se que tenha sido adotado o padrão "Centímetros". Pode-se também utilizar a unidade métrica “Pontos” através do parâmetro R=2540 (não importando neste caso o valor do parâmetro Z)
F=xxxxxxxx Se informado, gera o arquivo xxxxxx.GIF contendo a imagem do código de barras gerado, no mesmo diretório em que se encontra o CGI WEBCODE
R=nnn Resolução do código a ser gerado, em DPI. Os seguintes valores podem ser utilizados: 75, 150, 300, 360, 600 ou 720. Se omitido, 75 é assumido. A resolução especial 2540 tambem poderá ser utilizada, para indicar que a unidade métrica a ser utilizada será “pontos” e não centímetros ou polegadas
T=xxxxxxxx Padrão do código de barras a ser gerado. A presente versão aceita os seguintes valores para esta esta variável: int2of5 (para o padrão 2 de 5 intercalado), codabar, code39, code128, ean-8, ean-13, upc-a e upc-e. Se omitido, int2of5 é assumido
L=xxxxxxx Nome do arquivo do fonte a ser utilizado na geração da legenda dos códigos. Os arquivos possíveis (somente tipo TTF) deverão estar presentes no mesmo diretório em que se encontra o CGI WEBCODE. Se omitido, ARIAL.TTF é assumido
B=nnnnn Largura das barras estreitas (em 0,01 mm). Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante)
E=nnnnn Largura dos espaços estreitos (em 0,01 mm). Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante)
A=nnnnn Altura das barras (em 0,01 mm). Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante)
M=nnnnn Altura do prolongamento UPC/EAN (em 0,01 mm). Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante)
D=nnnnn Altura dos caracteres na legenda (em 0,01 mm). Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante)
U=nnnnn Largura dos caracteres da legenda (em 0,01 mm). Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante)
P=nn Proporção largo / estreito x 10 dos elementos do código. Pode-se utilizar 20, 25 ou 30, correspondendo a proporções 2.0 : 1, 2,5 : 1 ou 3,0 : 1. Pode-se utilizar ainda o valor 0 para os padrões cuja proporção seja automática. Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante)
K=0 ou 1 Se = 1, gera o digit-check explícito do código. Se = 0, não gera. Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante)
H=0 ou 1 Se = 1, gera barras horizontais de proteção do código. Se = 0, não gera. Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante)
N=0 ou 1 Se = 1, gera as legendas do código. Se = 0, não gera. Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante)
S=xy Caracteres de start/stop para o Codabar (x=start, y=stop) ou start do Code 128 (x=start). Para o padrão Codabar pode-se utilizar os caracteres de start/stop: a, b, c, d, A, B, C, D. Para o padrão Code 128 pode-se utilizar os seguintes caracters de start: A, B ou C. Se omitido, será assumido S=ab para o Codabar e S=B para o Code 128
I=xyz Caracteres de shift A, B e C para o Code 128. Se omitido, serão asumidos os caracteres ( [ { para shift A, B e C respectivamente
C=xxxxx.. Código a ser gerado. O comprimento e o tipo de dado permitido na seqüência xxxxx... dependerá do padrão do código de barras a ser gerado (vide tabela adiante)

Todos estes parâmetros poderão ser informados também durante a chamada do CGI WEBCODE, sendo que nestes casos, o parâmetro informado terá prioridade sobre o seu correspondente contido no arquivo de configuração.

Assím, a ordem de prioridade para obtenção de cada um dos parâmetros será a seguinte:

1) Informado na chamada. Se não for informado, o CGI WEBCODE tentará encontrá-lo no
2) Arquivo de configuração. Se não for encontrado, o CGI WEBCODE utilizará o
3) Valor default

Quando qualquer parâmetro for informado durante a chamada do CGI WEBCODE, este deverá seguir a mesma sintaxe descrita para o arquivo de configuração, usando o caracter & como separador. Exemplos:

<IMG SRC="http://www.seudomínio.com.br/cgi-bin/webcode.exe?C=982&P=30&H=1">
<IMG SRC="http://www.seudomínio.com.br/cgi-bin/webcode.exe?C=9378&G=003">

As tabelas a seguir mostram para cada um dos padrões suportados pelo CGI WEBCODE, os valores mínimos, máximos, opções e default de cada uma dos parâmetros:

PARÂMETROS

Valores possíveis para os parâmetros

2 de 5
intercalado
Code 39 Code 128 CODABAR

B = Largura das barras estreitas
mínimo:
máximo:
default:


1 (0,01 mm)
500 (5 mm)
48 (0,48 mm)

1 (0,01 mm)
500 (5 mm)
48 (0,48 mm)

1 (0,01 mm)
500 (5 mm)
48 (0,48 mm)

1 (0,01 mm)
500 (5 mm)
48 (0,48 mm)

E = Largura dos espaços estreitos
mínimo:
máximo:
default:


B
B + 20
B + 2

B
B + 20
B + 2

B
B + 20
B + 2

B
B + 20
B + 2
A = Altura das barras
mínimo:
máximo:
default:

10 (0,1 mm)
15000 (150 mm)
1600 (16 mm)

10 (0,1 mm)
15000 (150 mm)
1600 (16 mm)

10 (0,1 mm)
15000 (150 mm)
1600 (16 mm)

10 (0,1 mm)
15000 (150 mm)
1600 (16 mm)
M= Altura do prolong. UPC/EAN não considerado não considerado não considerado não considerado
D = Altura dos carac. da legenda
mínimo:
máximo:
default:

A / 12
A / 3
A / 5

A / 12
A / 3
A / 5

A / 12
A / 3
A / 5

A / 12
A / 3
A / 5
U = Largura dos carac. da legenda
mínimo:
máximo:
default:

D / 4
D * 4
2 / 3 * D

D / 4
D * 4
2 / 3 * D

D / 4
D * 4
2 / 3 * D

D / 4
D * 4
2 / 3 * D
P = Proporção largo/estreito
opções:
default:

20, 25 ou 30
20

20, 25 ou 30
20

automática
---

20, 25 ou 30
20
H = Barras horizontais
opções:
default:

0 (não), 1 (sim)
0 (não)

0 (não), 1 (sim)
0 (não)

0 (não), 1 (sim)
0 (não)

0 (não), 1 (sim)
0 (não)
N = Geração de legenda
opções:
default:

0 (não), 1 (sim)
1 (sim)

0 (não), 1 (sim)
1 (sim)

0 (não), 1 (sim)
1 (sim)

0 (não), 1 (sim)
1 (sim)
K = Check-digit explícito
opções:
default:

0 (não), 1 (sim)
0 (não)

0 (não), 1 (sim)
0 (não)

automático
---

0 (não), 1 (sim)
0 (não)
S = Caracteres de start/stop
opções:
default:

não considerado
---

não considerado
---

A, B ou C
B

a b c d A B C D
a b
I = Caracteres de Shift ABC
opções:
default:

não considerado
---

não considerado
---

quaisquer
( [ {

não considerado
---
C = Código a ser gerado
mínimo:
máximo:
tipo:

1 dígito + dck
63 dígitos + dck
numéricos 0-9

1 dígito + dck
63 dígitos + dck
0-9 A-Z $/+-:.

1 caracter + dck
63 caracteres + dck
quaisquer

1 dígito + dck
63 dígitos + dck
0-9 $:/.+-

 

PARÂMETROS

Valores possíveis para os parâmetros

UPC-E UPC-A EAN-8 EAN-13

B = Largura das barras estreitas
mínimo:
máximo:
default:


1 (0,01 mm)
500 (5 mm)
29 (0,29 mm)

1 (0,01 mm)
500 (5 mm)
39 (0,39 mm)

1 (0,01 mm)
500 (5 mm)
29 (0,29 mm)

1 (0,01 mm)
500 (5 mm)
39 (0,39 mm)

E = Largura dos espaços estreitos
mínimo:
máximo:
default:


B
B + 20
B + 1

B
B + 20
B + 1

B
B + 20
B + 1

B
B + 20
B + 1
A = Altura das barras
mínimo:
máximo:
default:

10 (0,1 mm)
15000 (150 mm)
800 (8 mm)

10 (0,1 mm)
15000 (150 mm)
2100 (21 mm)

10 (0,1 mm)
15000 (150 mm)
800 (8 mm)

10 (0,1 mm)
15000 (150 mm)
2100 (21 mm)
M= Altura do prolong. UPC/EAN
mínimo:
máximo:
default:

A / 16
A / 4
A / 14

A / 16
A / 4
A / 8

A / 16
A / 4
A / 14

A / 16
A / 4
A / 8
D = Altura dos carac. da legenda
mínimo:
máximo:
default:

A / 12
A / 3
A / 7

A / 12
A / 3
A / 4

A / 12
A / 3
A / 7

A / 12
A / 3
A / 4
U = Largura dos carac. da legenda
mínimo:
máximo:
default:

D / 4
D * 4
2 / 3 * D

D / 4
D * 4
2 / 3 * D

D / 4
D * 4
2 / 3 * D

D / 4
D * 4
2 / 3 * D
P = Proporção largo/estreito automática automática automática automática
H = Barras horizontais nunca gera nunca gera nunca gera nunca gera
N = Geração de legenda sempre gera sempre gera sempre gera sempre gera
K = Check-digit explícito automático automático automático automático
S = Caracteres de start/stop não considerado não considerado não considerado não considerado
I = Caracteres de Shift ABC não considerado não considerado não considerado não considerado
C = Código a ser gerado
mínimo:
máximo:
tipo:

5 dígitos + dck
5 dígitos + dck
numéricos 0-9

11 dígitos + dck
11 dígitos + dck
numéricos 0-9

7 dígitos + dck
7 dígitos + dck
numéricos 0-9

12 dígitos + dck
12 dígitos + dck
numéricos 0-9

Observações sobre as tabelas acima:

1) O código a ser gerado deve ser sempre informado SEM o digit-check. Quando for o caso, o CGI WEBCODE irá gerá-lo automáticamente
2) Se houver inconsistência dos dados informados, o CGI WEBCODE irá gerar uma mensagem de erro que será enviada ao browser cliente em substituição ao código de barras solicitado

Todas as informações desta página e ainda alguns detalhes adicionais constam do módulo WEBCODE.DOC  integrante do download (cópia de demonstração e testes).