Manual do Desenvolvedor

Transcrição

1 Manual do Desenvolvedor

2 Requisitos do Sistema... 4 Fontes TTF (True Type Font)... 4 LinhaBase Developing Tools... 4 Requisitos Gerais... 4 Restrições... 4 O Código de Barras... 5 Padrão EAN e UPC... 5 Instalando o Pacote de Fontes de Código de Barras... 6 Instalação... 6 Licenças... 7 Autenticação... 7 As fontes de Código de Barras... 8 Dados Técnicos das Fontes de Código de Barras... 8 Criando o Código de Barras... 9 Dígito verificador para EAN Dígito verificador para EAN Montando um Código de Barras EAN Dado da esquerda Tabela de paridades Dado da direita Montado a seqüência de dados Montando um Código de Barras EAN Dado da esquerda Dado da direita Montado a seqüência de dados Montando o Mapeamento EAN Dígito principal (primeiro dígito) Dígitos da esquerda Paridade ímpar Dígitos da esquerda Paridade par Dígitos da direita e dígito verificador Guardas Exemplo EAN Montando o Mapeamento EAN Dígitos da esquerda Dígitos da direita e dígito verificador Guardas Exemplo EAN LinhaBase Developing Tools Criando Código de Barras em.net (Windows Application) NameSpace Funções Exemplo em Visual Basic.Net Criando Código de Barras com Crystal Reports para Visual Studio.Net Criando Código de Barras com Crystal Reports para Visual Studio.Net com Dataset executando um query com valor variável em modo de execução Criando Código de Barras com Report Viewer para Visual Studio.Net Criando Código de Barras com Report Viewer para Visual Studio.Net com Dataset executando um query com valor variável em modo de execução Ajuste do Tamanho do Campo do Código de Barras em Relatórios Criando Código de Barras no Visual Basic Funções Criando o objeto Encaminhado e recuperando o dado para codificação Exemplo em Visual Basic Criando Código de Barras no Crystal Reports Criando uma fórmula LinhaBase Software 2

3 Nome das funções UFL Apêndices Versão de Demonstração x Versão Comercial Erros Informações Suporte LinhaBase Software 3

4 Requisitos do Sistema Fontes TTF (True Type Font) - As fontes de código de barras são padrão TTF (True Type Font) e podem ser utilizadas em qualquer linguagem de desenvolvimento que aceite o padrão TTF. LinhaBase Developing Tools - Crystal Reports 10 ou superior, Visual Basic 6.0, Microsoft Framework.Net (Windows Application) 3.5 ou superior. Requisitos Gerais - Sistema operacional: Windows XP, Windows Vista, Windows 7 com Microsoft Internet Explorer 5.5 ou superior, Windows 8, Windows 8.1, Windows Microsoft.Net Framework 3.5 ou superior. - Computador: Pentium ou superior. - Impressora: Para impressão do código de barras. - Espaço em disco: 10MB disponíveis. - Memória: 128 MB de memória RAM. - Internet para realização da autenticação de uso. Restrições - Fontes de Código de Barras não são indicadas para uso Web ou similares, onde em alguns casos as fontes TTF também devem ser instaladas nos computadores clientes para seu funcionamento. - As dimensões do código de barras tendem a reduzir ao transformar a impressão em PDF, o que faz com que o código de barras original deva ser maior para uma boa impressão. LinhaBase Software 4

5 O Código de Barras Padrão EAN e UPC O sistema European Article Numbering também conhecido como World Product Code (WPC), e a International Article Numbering Association (IAN ou EAN), desenvolveram esta simbologia para negócios internacionais. Os códigos EAN mais utilizados são o EAN 8 e EAN 13, que são variações do sistema original de codificação UPC desenvolvido nos Estados Unidos. Ambas as versões são códigos de comprimento fixo, discreto e de representação numérica. Os primeiros dois dígitos de um código de barras EAN são o código de país. Os códigos de país 00, 01, 03, 04, e são atribuídos aos Estados Unidos para a compatibilidade com UPC. Tanto o código EAN como o código UPC tem dígitos verificadores, sendo colocado ao final do código. Com isso o código EAN 13 é formado por 12 dígitos + 1 como dígito verificador. O mesmo vale para os outros códigos. Nossas fontes EAN / UPC possibilitam a impressão de códigos de barras em diversos tamanhos e densidades. Garantindo assim o atendimento das necessidades de codificação de mercado. LinhaBase Software 5

6 Instalando o Pacote de Fontes de Código de Barras Instalação O Pacote de Fontes de Código de Barras LinhaBase precisa ser autenticado para ter a sua instalação concluída. Para instalar o Pacote de Fontes faça o seguinte: 1 Execute a instalação do LinhaBase Installer. 2 Execute o LinhaBase Installer de seu produto (cada produto LinhaBase tem seu Installer próprio, certifique que está executando o Installer correto). 3 No LinhaBase Installer verifique o nome do produto e forneça o Número de Série e clique no botão Autenticar. 4 Tendo autenticado o produto clique no botão Ok para iniciar a etapa final da instalação do produto. LinhaBase Software 6

7 5 Siga as instruções para concluir o processo de instalação. 6 Após ter terminado o processo de instalação clique no botão Sair no LinhaBase Installer. Licenças Licença corresponde ao número de computadores que irão utilizar um produto LinhaBase. Este produto é fornecido com as seguintes formas de licenciamento: - 1 Licença de Uso; - 5 Licenças de Uso; - Licenciamento Ilimitado. O licenciamento de 1 computador (1 licença) e de 5 computadores (5 licenças) é chamado de licenciamento de uso interno e este tipo de licenciamento utiliza a tecnologia de autenticação de licenças LinhaBase Passport. O licenciamento ilimitado permite utilizar o produto LinhaBase em qualquer quantidade de computadores. Autenticação Os licenciamentos do tipo 1 licença e 5 licenças de uso utilizam o processo de autenticação de licenças, que visa garantir sua autenticidade e se baseia na construção de chaves digitais. A autenticação é extremamente fácil de realizar e deve ser feita toda vez que ocorrer a instalação do produto. LinhaBase Software 7

8 As fontes de Código de Barras O Pacote de Fontes de Código de Barras é fornecido modelos de fontes que produzem códigos de barras com tamanhos diferentes e que podem ser escolhidos de forma que melhor atender as necessidades de produção do código de barras. Exemplos: Fonte L Tamanho 12 Fonte M Tamanho 8 Dados Técnicos das Fontes de Código de Barras Para este produto são disponibilizados os seguintes arquivos de fontes TTF (True Type Font). Fontes versão comercial: Nome do Arquivo LBPremiumEanL.ttf LBPremiumEanM.ttf LBPremiumEanS.ttf Nome Interno LBPremiumEanL LBPremiumEanM LBPremiumEanS Fontes versão de demonstração: Nome do Arquivo LBPremiumEanLDemo.ttf LBPremiumEanMDemo.ttf LBPremiumEanSDemo.ttf Nome Interno LBPremiumEanLDemo LBPremiumEanMDemo LBPremiumEanSDemo LinhaBase Software 8

9 Criando o Código de Barras Para criar um código de barras EAN 8 e 13 é necessário informar toda a seqüência de caracteres que será codificado. Esta seqüência de caracteres deve ser como se segue: Caractere de Start + Seqüência de Dados + Dígito Verificador + Caractere de Stop Dígito verificador para EAN 13 Número EAN 13: º Passo Multiplicar a seqüência pelos pesos 3 e 1 da direita para a esquerda. 2º Passo Somar os valores da multiplicação do passo = 139 3º Passo Subtrair o resultado da soma anterior pelo múltiplo de 10 superior mais próximo = 1 Dígito verificador = 1 Obs.: Se o valor da soma do passo 2 for múltiplo de 10 então o dígito verificador será 0. Dígito verificador para EAN 8 Número EAN 8: º Passo Multiplicar a seqüência pelos pesos 3 e 1 da direita para a esquerda. 2º Passo Somar os valores da multiplicação do passo = 96 3º Passo Subtrair o resultado da soma anterior pelo múltiplo de 10 superior mais próximo. LinhaBase Software 9

10 = 4 Dígito verificador = 4 Obs.: Se o valor da soma do passo 2 for múltiplo de 10 então o dígito verificador será 0. LinhaBase Software 10

11 Montando um Código de Barras EAN 13 Um código EAN 13 é dividido em duas partes: dados da esquerda e dados da direita. Dado da esquerda O dado da esquerda é formado pelos 6 dígitos que seguem o primeiro dígito. O primeiro dígito determina que paridade tenha os 6 primeiros dígitos do código EAN 13. A paridade determina que caracteres sejam utilizados para a codificação dos 6 dígitos. A paridade é determinada por: paridade par e paridade ímpar. Tabela de paridades Para determinar que conjunto de paridade que será usada deve-se analisar o valor do primeiro dígito conforme a tabela que se segue: I Impar P Par Primeiro dígito Paridades Primeiro dígito Paridades 0 IIIIII 5 IPPIIP 1 IIPIPP 6 IPPPII 2 IIPPIP 7 IPIPIP 3 IIPPPI 8 IPIPPI 4 IPIIPP 9 IPPIPI Dado da direita O dado da direita é formado pelos 5 últimos dígitos do código EAN 13, excluindo o dígito verificador. Montado a seqüência de dados Um código EAN 13 será montado com a seguinte seqüência: Primeiro dígito + Guarda inicial + Dígitos da esquerda (segundo a tabela de paridades) + Guarda central + Dígitos da direita + Dígito verificador + Guarda final LinhaBase Software 11

12 Montando um Código de Barras EAN 8 Um código EAN 8 é dividido em duas partes: dados da esquerda e dados da direita. Dado da esquerda O dado da esquerda é formado pelos 4 dígitos que seguem o primeiro dígito. A paridade para os 4 dígitos será sempre a paridade ímpar Dado da direita O dado da direita é formado pelos 3 últimos dígitos do código EAN 8, excluindo o dígito verificador. Montado a seqüência de dados Um código EAN 8 será montado com a seguinte seqüência: Guarda inicial + Dígitos da esquerda (paridade ímpar) + Guarda central + Dígitos da direita + Dígito verificador + Guarda final LinhaBase Software 12

13 Montando o Mapeamento EAN 13 Os símbolos dos caracteres têm seu valor como à tabela abaixo Dígito principal (primeiro dígito) Valor Valor ASCII Caractere 0 85 U 1 86 V 2 87 W 3 88 X 4 89 Y 5 90 Z v w x y Dígitos da esquerda Paridade ímpar Valor Valor ASCII Caractere LinhaBase Software 13

14 Dígitos da esquerda Paridade par Valor Valor ASCII Caractere 0 65 A 1 66 B 2 67 C 3 68 D 4 69 E 5 70 F 6 71 G 7 72 H 8 73 I 9 74 J Dígitos da direita e dígito verificador Valor Valor ASCII Caractere 0 75 K 1 76 L 2 77 M 3 78 N 4 79 O 5 80 P 6 81 Q 7 82 R 8 83 S 9 84 T Guardas Valor Valor ASCII Caractere Inicial e Final 40 ( Central 42 * LinhaBase Software 14

15 Exemplo EAN 13 Valor: Valor ASCII Caractere 1 (primeiro dígito) 86 V Guarda inicial 40 ( 0 (paridade ímpar) (paridade ímpar) (paridade par) 65 A 0 (paridade ímpar) (paridade par) 65 A 0 (paridade par) 65 A Guarda central 42 * 0 75 K 0 75 K 0 75 K 0 75 K 0 75 K 9 84 T Guarda final 40 ( A seqüência então será: V(00A0AA*KKKKKT( LinhaBase Software 15

16 Montando o Mapeamento EAN 8 Os símbolos dos caracteres têm seu valor como à tabela abaixo Dígitos da esquerda Valor Valor ASCII Caractere Dígitos da direita e dígito verificador Valor Valor ASCII Caractere 0 75 K 1 76 L 2 77 M 3 78 N 4 79 O 5 80 P 6 81 Q 7 82 R 8 83 S 9 84 T Guardas Valor Valor ASCII Caractere Inicial e Final 40 ( Central 42 * LinhaBase Software 16

17 Exemplo EAN 8 Valor: Valor ASCII Caractere Guarda inicial 40 ( Guarda central 42 * 0 75 K 0 75 K 0 75 K 7 82 R Guarda final 40 ( A seqüência então será: (1000*KKKR( LinhaBase Software 17

18 LinhaBase Developing Tools Para Facilitar o processo de criação de código de barras a LinhBase fornece com exclusividade nos Pacotes de Fontes de Código de Barras Premium os Developing Tools. Os Developing Tools são arquivos DLL que realizam a tarefa de formatação do dado a ser codificado como cálculo de dígito verificador, análise de paridade, inclusão de caracteres de Start e Stop e mapeamento de caracteres de forma automática. Os Developing Tools são compatíveis com: - Visual Basic Net (Windows Application) - Crystal Reports 10 ou superior. LinhaBase Software 18

19 Criando Código de Barras em.net (Windows Application) O arquivo Assembly responsável pela codificação do mapeamento do código de barras é do tipo Global e instalado automaticamente no GAC Global Assemby Cache do.net Framework quando é executado o arquivo de instalação do Pacote de Fontes de Código de Barras, sendo assim não é necessário copiar o arquivo para o diretório da aplicação. Abaixo são apresentadas suas características. NameSpace LinhaBaseEan.Map Funções Ean13 Cria a formatação para o código de barras EAN 13. EAN 8 Cria a formatação para o código de barras EAN 8. Exemplo em Visual Basic.Net Abaixo fornecemos um exemplo de impressão de código de barras no Visual Basic.Net. 1 Abra o Visual Studio.Net e crie uma nova aplicação Windows. LinhaBase Software 19

20 2 Clique em Project Add Reference para adicionar referência ao arquivo Assembly. 3 Localize o Componente LinhaBaseEan. LinhaBase Software 20

21 4 Crie um Form como na figura abaixo. 5 Ajuste a propriedade Multiline para True na caixa de texto txtbarcode. 6 Insira o código: Imports LinhaBaseEan.Map Public Class Form1 Private Sub printpage_handler(byval sender As Object, ByVal ev As System.Drawing.Printing.PrintPageEventArgs) Dim ValorImprimir As String Dim Cod As New LinhaBaseEan.Map ValorImprimir = Cod.Ean(txtValue.Text) ev.graphics.pageunit = GraphicsUnit.Millimeter 'Imprime o ValorDoDado ev.graphics.drawstring(s:=valorimprimir, font:=new Font("LBPremiumEanM", 12), brush:=brushes.black, x:=10, y:=10) End Sub Private Sub Form1_Load(sender As System.Object, e As System.EventArgs) Handles MyBase.Load txtvalue.text = " " End Sub Private Sub Button1_Click(sender As System.Object, e As System.EventArgs) Handles Button1.Click Dim fnt As New Font("LBPremiumEanM", 12) End Sub Dim Cod As New LinhaBaseEan.Map txtbarcode.font = fnt txtbarcode.text = Cod.Ean(txtValue.Text) LinhaBase Software 21

22 Private Sub Button2_Click(sender As System.Object, e As System.EventArgs) Handles Button2.Click Dim printdocument As New System.Drawing.Printing.PrintDocument End Sub End Class 'Define o nome da impressora printdocument.printersettings.printername = "Sua Impressora" 'Chama o evento de impressao AddHandler printdocument.printpage, AddressOf Me.printPage_handler printdocument.print() LinhaBase Software 22

23 Criando Código de Barras com Crystal Reports para Visual Studio.Net 1 Abra o Visual Studio.Net e crie uma nova aplicação Windows. 2 Clique em Project Add Reference para adicionar referência ao arquivo Assembly. LinhaBase Software 23

24 3 Localize o Componente LinhaBaseITF25. 4 Em Solution Explores clique com o botão direito selecione Add New Item. LinhaBase Software 24

25 5 Adicione um Dataset ao projeto. 6 Clique com o botão direito na área do Dataset e escolha Add Table Adapter. 7 Escolha a conexão com sua base de dados. LinhaBase Software 25

26 8 Clique no botão New Connection e selecione o Data Source. 9 Após ter configurado a conexão com a base de dados clique no botão Next. 10 Salve a conexão com a base de dados e clique no botão Next. LinhaBase Software 26

27 11 Selecione o tipo de Comando a ser utilizado no TableAdapter. 12 Digite o comando SQL para execução do query. LinhaBase Software 27

28 13 Escolha os métodos que serão utilizados junto ao TableAdapter. 14 Finalize o Wizard. 15 O DataSet está pronto e configurado no projeto. LinhaBase Software 28

29 16 Clique com o botão direito no DataSet e escolha Add Column. 17 Adicione uma coluna tipo String que será utilizada para armazenar o mapeamento do código de barras. 18 Adicione ao projeto um relatório Crystal Reports. LinhaBase Software 29

30 19 Crie um relatório em branco. 20 Selecione o menu Crystal Reports Database Database Expert. 21 Selecione o Dataset adicionado no projeto como a fonte de dados do relatório. LinhaBase Software 30

31 22 Adicione ao relatório os campos desejados e configure o tamanho dos campos. 23 Clique no campo do código de barras e selecione a fonte de código de barras e ajuste seu tamanho. Figura Ilustrativa OBS: O tamanho do campo do código de barras deve ser ajustado de modo que todo o código de barras seja reproduzido de forma correta com o relatório em modo de execução. Veja em Ajuste do Tamanho do Campo do Código de Barras abaixo. 24 Adicione ao Form do projeto o controle CrystalReportViewer. LinhaBase Software 31

32 25 Adicione o código de seu projeto. Imports LinhaBaseEan.Map Public Class Form1 Private Sub Form1_Load(sender As System.Object, e As System.EventArgs) Handles MyBase.Load Dim ta As New dtdatasettableadapters.tabela1tableadapter() Dim dt As New dtdataset.tabela1datatable() ta.fill(dt) Dim row As dtdataset.tabela1row Dim Cod As New LinhaBaseEan.Map Dim Mapeamento As String For Each row In dt.rows Mapeamento = Cod.Ean13(row.CodData) row.barcode = Mapeamento Next Dim report As New report() report.setdatasource(ctype(dt, DataTable)) CrystalReportViewer1.ReportSource = report End Sub LinhaBase Software 32

33 Criando Código de Barras com Crystal Reports para Visual Studio.Net com Dataset executando um query com valor variável em modo de execução No exemplo anterior o Dataset foi preenchido com um comando SQL do tipo Select realizando um fill completo da base de dados. Mas também é possível preencher o Dataset com um valor qualquer definido em modo de execução. Para isso basta criar um Query com parâmetro. Suponhamos a existência de uma base de dados qualquer. 1 Clique com o botão direito sobre o TableAdapter e escolha Add Query. 2 Selecione o tipo de Comando a ser utilizado no TableAdapter. LinhaBase Software 33

34 3 Selecione o tipo de query a ser utilizado. 4 Digite o comando do query e clique no botão Next. Foi acrescentado a clausula Where onde foi definido que a pesquisa será realizada com base no valor a ser fornecido para a coluna Person. Select Person, NCode From tbltest Where (Person LinhaBase Software 34

35 5 Selecione os métodos a serem utilizados no TableAdapter e clique no botão Finish. 6 Clique no botão Ok para ignorar qualquer mensagem de erro junto ao query. 7 Clique com o botão direito na linha que contêm os métodos do query e selecione Properties. LinhaBase Software 35

36 8 Selecione Parameters. 9 Clique no botão Add. 10 Em DBType escolha String e em ParameterName digite o nome para o parâmetro do query e clique no botão Ok. LinhaBase Software 36

37 11 O código ficará como apresentado abaixo: Imports LinhaBaseEan.Map Public Class Form1 Private Sub Form1_Load(sender As System.Object, e As System.EventArgs) Handles MyBase.Load Dim ta As New dtdatasettableadapters.tbltesttableadapter() Dim dt As New dtdataset.tbltestdatatable() ta.fillby(dt, "Mary") Dim row As dtdataset.tbltestrow Dim Cod As New LinhaBaseEan.Map Dim Mapeamento As String For Each row In dt.rows Mapeamento = Cod.Ean13(row.CodData) row.barcode = Mapeamento Next Dim report As New report() report.setdatasource(ctype(dt, DataTable)) CrystalReportViewer1.ReportSource = report End Sub End Class LinhaBase Software 37

38 Criando Código de Barras com Report Viewer para Visual Studio.Net 1 Abra o Visual Studio.Net e crie uma nova aplicação Windows. 2 Clique em Project Add Reference para adicionar referência ao arquivo Assembly. LinhaBase Software 38

39 3 Localize o Componente LinhaBaseEan. 4 Em Solution Explorer clique com o botão direito selecione Add New Item. LinhaBase Software 39

40 5 Adicione um Dataset ao projeto. 6 Clique com o botão direito na área do Dataset e escolha Add Table Adapter. 7 Escolha a conexão com sua base de dados. LinhaBase Software 40

41 8 Clique no botão New Connection e selecione o Data Source. 9 Após ter configurado a conexão com a base de dados clique no botão Next. 10 Salve a conexão com a base de dados e clique no botão Next. LinhaBase Software 41

42 11 Selecione o tipo de Comando a ser utilizado no TableAdapter. 12 Digite o comando SQL para execução do query. LinhaBase Software 42

43 13 Escolha os métodos que serão utilizados junto ao TableAdapter. 14 Finalize o Wizard. 15 O DataSet está pronto e configurado no projeto. LinhaBase Software 43

44 16 Clique com o botão direito no DataSet e escolha Add Column. 17 Adicione uma coluna tipo String que será utilizada para armazenar o mapeamento do código de barras. 18 Adicione ao projeto um relatório tipo Report. LinhaBase Software 44

45 19 Selecione o menu Data Add New Data Source. 20 Selecione Object e clique no botão Next. 21 Selecione o objeto que representa o DataTable do Dataset adicionado ao projeto e clique no botão Finish. LinhaBase Software 45

46 22 no Toolbox do Report selecione Table e insira no relatório. 23 Na tela Dataset Properties selecione o Data Source que foi criado no projeto e clique no botão Ok. 24 Adicione a tabela os campos que deseja incluir no relatório. LinhaBase Software 46

47 25 Na coluna do código de barras clique com o botão direito e escolha Placeholder Properties. 26 Escolha a fonte de código de barras apropriada e ajuste seu tamanho. Figura Ilustrativa OBS: O tamanho do campo do código de barras deve ser ajustado de modo que todo o código de barras seja reproduzido de forma correta com o relatório em modo de execução. Veja em Ajuste do Tamanho do Campo do Código de Barras abaixo. LinhaBase Software 47

48 27 Adicione ao Form o controle ReportViewer, selecione o report do projeto e ajuste a propriedade Dock para Fill. 28 Ajuste o código do Form. Imports LinhaBaseEan.Map Public Class Form1 Private Sub Form1_Load(sender As System.Object, e As System.EventArgs) Handles MyBase.Load 'TODO: This line of code loads data into the 'dtdataset.tbltest' table. You can move, or remove it, as needed. tbltesttableadapter.fill(dtdataset.tbltest) End Sub End Class Dim row As dtdataset.tbltestrow Dim Cod As New LinhaBaseEan.Map Dim Mapeamento As String For Each row In dtdataset.tbltest.rows Mapeamento = Cod.Ean13(row.NCode) row.barcode = Mapeamento Next Me.ReportViewer1.RefreshReport() LinhaBase Software 48

49 Criando Código de Barras com Report Viewer para Visual Studio.Net com Dataset executando um query com valor variável em modo de execução No exemplo anterior o Dataset foi preenchido com um comando SQL do tipo Select realizando um fill completo da base de dados. Mas também é possível preencher o Dataset com um valor qualquer definido em modo de execução. Para isso basta criar um Query com parâmetro. 1 Clique com o botão direito sobre o TableAdapter e escolha Add Query. 2 Selecione o tipo de Comando a ser utilizado no TableAdapter. LinhaBase Software 49

50 3 Selecione o tipo de query a ser utilizado. 4 Digite o comando do query e clique no botão Next. Foi acrescentado a clausula Where onde foi definido que a pesquisa será realizada com base no valor a ser fornecido para a coluna Person. Select Person, NCode From tbltest Where (Person LinhaBase Software 50

51 5 Selecione os métodos a serem utilizados no TableAdapter e clique no botão Finish. 6 Clique no botão Ok para ignorar qualquer mensagem de erro junto ao query. 7 Clique com o botão direito na linha que contêm os métodos do query e selecione Properties. LinhaBase Software 51

52 8 Selecione Parameters. 9 Clique no botão Add. 10 Em DBType escolha String e em ParameterName digite o nome para o parâmetro do query e clique no botão Ok. LinhaBase Software 52

53 11 O código ficará como apresentado abaixo: Imports LinhaBaseEan.Map Public Class Form1 Private Sub Form1_Load(sender As System.Object, e As System.EventArgs) Handles MyBase.Load tbltesttableadapter.fillby(dtdataset.tbltest, "Mary") Dim row As dtdataset.tbltestrow Dim Cod As New LinhaBaseEan.Map Dim Mapeamento As String For Each row In dtdataset.tbltest.rows Mapeamento = Cod.Ean13(row.NCode) row.barcode = Mapeamento Next Me.ReportViewer1.RefreshReport() End Sub End Class LinhaBase Software 53

54 Ajuste do Tamanho do Campo do Código de Barras em Relatórios O campo onde será reproduzido o código de barras deve ter seu tamanho ajustado corretamente para que todo o código de barras seja reproduzido no relatório em modo de execução. Campo do código de barras ajustado corretamente para o tamanho da fonte de código de barras escolhida. Campo do código de barras ajustado de maneira incorreta para o tamanho da fonte de código de barras escolhida. Código de barras reproduzido com corte. LinhaBase Software 54

55 Criando Código de Barras no Visual Basic Antes de usar o arquivo DLL é preciso primeiro referenciá-lo. No Visual Basic 6.0 clique no menu Project e depois em References. Na janela Referencies procure o nome do arquivo DLL (StrEanUpc), marque-o e clique em OK. Figura ilustrativa LinhaBase Software 55

56 Funções CodEan8 Responsável pela codificação da string EAN 8. CodEan13 Responsável pela codificação da string EAN 13. StringEanUpc Responsável pelo fornecimento da string formatada para o programa. OBS: Certifique-se de fornecer os dados com as seguintes características para o arquivo DLL: EAN 8: Apenas dados numéricos e com 7 dígitos. EAN 13: Apenas dados numéricos e com 12 dígitos. Criando o objeto Para utilizar o arquivo DLL em programas Visual Basic é preciso criar um objeto que irá manipular o dado a ser codificado para isso cria uma declaração como a que se segue: Dim COD As New CString2de5 Encaminhado e recuperando o dado para codificação O dado a ser codificado deve ser encaminhado para o arquivo DLL por meio de uma linha de comando contendo a seguinte característica: NomeDaVariavel = NomeDoObjeto.NomeDaFuncao(Valor_a_Ser_Codificado) OBS: O Valor a ser codificado e o NomeDaVariavel devem ser do tipo String. Exemplo em Visual Basic Crie um projeto no Visual Basic com um formulário e um botão. Em General Declarations (tendo criado a referência ao arquivo DLL, veja tópico acima) digite: Dim COD As New CStrEanUpc Na função do botão digite: Dim ValorDoDado as String Dim ValorImprimir as String ValorDoDado = ValorImprimir = COD.CodEan13(ValorDoDado) Printer.FontName = "LBPremiumEanM" Printer.FontSize = "14" Printer.Print ValorImprimir Printer.EndDoc LinhaBase Software 56

57 Criando Código de Barras no Crystal Reports Tendo já feito a estrutura do relatório e todas as referências às tabelas que serão usadas pelo Crystal Reports, deve-se então criar uma fórmula para conter a função de formatação para criação do código de barras. OBS: O exemplo contido neste manual foi feito tomando-se como base o Crystal Reports 10. Criando uma fórmula Com o relatório na tela de Design clique com o botão direito no item Formula e em seguida em New na janela Field Explorer. Digite o nome da fórmula de formatação do código de barras e clique no botão Use Editor. Na janela Functions clique em Additional Functions e em seguida em Visual Basic UFLs (u2lcom.dll). OBS: Em versões mais antigas do Crystal Reports as funções ficam contidas em Additional Functions LinhaBase Software 57

58 Figura Ilustrativa Irão aparecer nesta lista todas as funções UFL criadas e reconhecidas pelo Crystal Reports. Selecione a função desejada na lista por meio de um clique duplo. Figura Ilustrativa Dentro dos parênteses da função escolhida digite a referência ao campo da tabela como se segue: {NomeDaTabela.NomeDoCampo}. Esse tipo de sintaxe pode variar conforme sua base de dados. Figura Ilustrativa Salve a referência da formula e retorne a tela de Design. Na tela de Design arraste para o relatório o campo da fórmula criado e presente no Field Explorer. LinhaBase Software 58

59 Clique no campo da fórmula que foi arrastado para o relatório e selecione a fonte de código de barras na listagem de fontes do Crystal Reports e ajuste o tamanho da fonte. Figura Ilustrativa OBS: O tamanho do campo do código de barras deve ser ajustado de modo que todo o código de barras seja reproduzido de forma correta com o relatório em modo de execução. Veja em Ajuste do Tamanho do Campo do Código de Barras abaixo. Gere o relatório e verifique a construção do código de barras. Figura Ilustrativa LinhaBase Software 59

60 Nome das funções UFL As funções UFL são nomeadas como se segue: LBEANStringLBEanLBStringEan13 Cria a formatação EAN 13. LBEANStringLBEanLBStringEan8 Cria a formatação EAN 8. LinhaBase Software 60

61 Apêndices Versão de Demonstração x Versão Comercial Com a fonte de demonstração é possível criar um código de barras EAN 13 com o seguinte número: e um código EAN 8 com o número: Erros O código de barras não pode ser lido pelo equipamento decodificador Resposta: 1 Verifique se o tamanho do código de barras não é muito pequeno ou grande de mais para o equipamento leitor. Os leitores de código de barras trabalham dentro de características de sensibilidade dado por cada fabricante. 2 Verifique se as cores escolhidas para o fundo e as barras não são próximas. É necessário que sejam escolhidas cores onde existam diferenças significativas entre as barras e o fundo, como barras pretas e fundo branco. 4 Verifique se o tipo de código de barras escolhido pode ser lido pela leitora. Nem todos os códigos de barras são compatíveis com o modelo de leitora utilizado. 5 Verifique se a impressora utilizada está imprimindo um código de barras de boa qualidade. 6 Verifique se a quantidade de caracteres contidos no código de barras ultrapassa a quantidade máxima de caracteres permitidos pelo modelo da leitora. A maioria das leitoras de código de barras trabalha com um buffer interno que limita a quantidade máxima de caracteres por código de barras. 7 Verifique se o Word ou outro editor de texto realizou alguma alteração nos caracteres ou correção ortográfica automática. Informações Figuras Ilustrativas As figuras ilustrativas foram tiradas de uma determinada versão do Pacote de Fontes de Código de Barras, podendo ser ligeiramente diferentes em outras versões do pacote. Suporte O suporte a este produto se restringe apenas as fontes fornecidas no pacote. A criação, modificação, implantação e/ou programação do código fonte ou de outros que possam se originar dos exemplos contidos neste manual para qualquer linguagem de programação e ou sistema é de total responsabilidade do usuário. O conteúdo deste pacote é protegido pelas leis federais de 19 de fevereiro de 1998 e de 19 de fevereiro de 1998 e por tratados internacionais. A reprodução ou a distribuição não autorizada deste pacote de programas e ou arquivos, ou de qualquer porção deste, pode gerar penalidades civis e criminais. LinhaBase Software 61

62