VisRel 4.0 O que é?

O VisRel é um visualizador de relatórios, e tem como objetivo facilitar a montagem , gerenciamento, e impressão de relatórios através de uma interface amigável e de fácil utilização.

Como imprimir em modo matricial? Envia os relatórios diretamente para a impressora matricial (pelo hardware da impressora), utilizando caracteres de controle e de compactação. Para isso utilize a linha de comando abaixo: VisRel.exe /M C:\Nome.rel /CP 16 /LP 8 /IN HP 610C /IM 3 /T Título /C 2 /I /M (Modo matricial. Envia o relatório diretamente para a impressora)/T (Título do relatório)/C (Quantidade de cópias do mesmo relatório a ser impresso. Ex.: “/C 2”)/CP (Caracteres por polegada)/LP (Linhas por polegada)/IN (Nome da impressora. Ex.: “/IN HP 610C” ou “/IN ?” para escolher) (Nome do BAT ou EXE. Ex.: “/IN Arquivo.bat” ou “/IN Arquivo.exe”)/NSI (Complemento do recurso acima. Não permite selecionar outra impressora e cancela)/IM (Modelo da impressora, conforme tabela abaixo)/CC (Caracteres de compactação. Para usar sem o “/IM”. Ex.: “/CC @M”)/CH (Caracteres de compactação em hexadecimal. Ex.: “/CH 1b4d”)/ET (Salvar ou enviar por e-mail no formato TXT. Este é o padrão)/EL (Salvar ou enviar por e-mail no formato LOG. Todas as páginas em apenas um arquivo)/EJ (Salvar ou enviar por e-mail no formato JPG)/EE (Salvar ou enviar por e-mail no formato EMF)/EG (Salvar ou enviar por e-mail no formato GIF)/EH (Salvar ou enviar por e-mail no formato HTML)/ER (Salvar ou enviar por e-mail no formato RTF)/EP (Salvar ou enviar por e-mail no formato PDF)/EW (Salvar ou enviar por e-mail no formato DOC. O Word deve estar instalado)/SW (Senha do Word. Protege o DOC enviado de alterações. Ex.: “/SW 1234”)/QC (Qualidade da compactação do e-mail para JPG ou PDF. Ex.: “/QC 92”)/SE (O usuário pode selecionar o tipo antes de salvar ou enviar por e-mail)/ED (Destinatário do e-mail. Ex.: “/ED fredig@terra.com.br”)/EM (Mensagem do e-mail. Ex.: “/EM Relatório em anexo!” ou “/EM C:\Mensagem.txt”)/EA (Envia algum arquivo seu em anexo. Ex.: “/EA C:\*.xml;C:\Leia-me.txt”)/E (Envia por e-mail sem visualizar)/ZIP (Envia os anexos do e-mail compactados)/E2 (Adicione este parâmetro quando o modo MAPI não enviar normalmente)/OO (Adicione este parâmetro para enviar pelo Outlook do Office)/OE (Adicione este parâmetro para enviar pelo Outlook Express ou Live Mail)/L (Número de linhas do relatório. Ex.: “/L 66”)/Z (Zoom inicial. Pode ser 25, 50, 75, 100, 125, 150, 200. Ex.: “/Z 125”)/I (Imprime sem visualizar)/SV (Força a tela do VisRel a ficar visível. Necessário em alguns casos)/NC (Não centraliza a página quando for maior do que a tela)/NE (Não permite enviar por e-mail, salvar e nem copiar o relatório)/IS (Somente permite Imprimir e Salvar)/SL (Somente Leitura. Não permite imprimir, salvar, copiar ou enviar por e-mail)/EPS (Visualizar o Padrão Epson. Remove comandos ESC e adapta bordas feitas no DOS.)/X (Exclui o arquivo ao fechar o VisRel)/A (Salva sem visualizar. “/A C:\Arquivos\Relatorio.DOC”)/CF (Cor do papel para a visualização. Exemplo: “/CF 80FFFF” ou “/CF #FFFF80” para amarelo)/CS (Cor da linha selecionada na visualização. Exemplo: “/CS 80FFFF” para amarelo)/PB (Exibe uma barra de progressão enquanto carrega o relatório)/IL (Exibe apenas impressoras locais)/SMTP (Envia o e-mail no modo oculto. Deve-se informar as configurações de SMTP e login)/Q (Quando usado com o /SMTP não mostra mensagens de erro retornados pelo servidor)/SC (Quando usado com o /SMTP evita que você receba uma cópia do e-mail enviado)/CF (Cor do papel para a visualização. Exemplo: “/CF 80FFFF” ou “/CF #FFFF80” para amarelo)/CS (Cor da linha selecionada na visualização. Exemplo: “/CS 80FFFF” para amarelo)/CL (Cor da linha de detalhe alternada na visualização. Exemplo: “/CL F0F0F0” para cinza)/CI (Permite ao usuário escolher outra impressora dentro da visualização)/V (Força a visualização mesmo que tenha os parâmetros /I, /E ou /A)

Obs.: Omitindo o parâmetro “/IN” o relatório será impresso na impressora padrão.

Página 1 de 17

Modelos de impressora suportados pela linha de comando:

0 = Epson – Padrão (10, 12, 15, 17 ou 20; 6 ou 8 lpp)1 = Epson Jet (10, 12, 17 ou 20 cpp; 6 ou 8 lpp)2 = Elebra (10, 17 ou 20 cpp)3 = HP (10, 16 ou 20 cpp; 6, 8 ou 12 lpp)4 = XEROX (10 ou 20 cpp)5 = PANASONIC (10 ou 17 cpp)

Obs.: Você pode omitir o parâmetro “/IM” (Modelo da Impressora), e gravar os comandos de compactação de cpp e lpp dentro do seu relatório ou utilizar o parâmetro “/CC” (Veja abaixo a linha de comando correspondente). Se desejar, envie-nos o modelo da impressora e os comandos de compactação, assim podemos adaptar o software as suas necessidades. Ao informar zero no número de cópias “/C 0” o botão imprimir fica desabilitado.

VisRel.exe /M C:\Nome.rel /IN HP 610C /CP 12 /LP 6 /CC @M /T Título /I

Página 2 de 17

Como imprimir no modo texto?

O VisRel também pode ser utilizado para imprimir arquivos texto (utilizando o driver da impressora). Neste caso os caracteres de compactação não funcionam, mas pode-se alterar o nome e tamanho da fonte de visualização e impressão, como no exemplo abaixo:

VisRel.exe /R C:\Relatórios\MeuRelatório.rel /T Título da janela /FS 7 /ER

/R (Modo texto e permite apenas uma fonte)/T (Título da janela)/C (Quantidade de cópias do mesmo relatório a ser impresso. Ex.: “/C 2”)/IN (Nome da impressora. Ex.: “/IN HP 610C” ou “/IN” configura ou “/IN ?” apenas escolhe) (Nome do BAT ou EXE. Ex.: “/IN Arquivo.bat” ou “/IN Arquivo.exe”)/NSI (Complemento do recurso acima. Não permite selecionar outra impressora e cancela)/FP (Ao selecionar a impressora, ela torna-se a impressora padrão do usuário)/P (Modo paisagem)/FN (Nome da fonte a ser usada. O padrão é “/FN Courier New”)/FS (Tamanho da fonte a ser usada. O padrão é “/FS 10”)/FB (A fonte ficará em negrito em todo o relatório)/ET (Salvar ou enviar por e-mail no formato TXT. Este é o padrão)/EL (Salvar ou enviar por e-mail no formato LOG. Todas as páginas em apenas um arquivo)/EJ (Salvar ou enviar por e-mail no formato JPG)/EE (Salvar ou enviar por e-mail no formato EMF)/EG (Salvar ou enviar por e-mail no formato GIF)/EH (Salvar ou enviar por e-mail no formato HTML)/ER (Salvar ou enviar por e-mail no formato RTF)/EP (Salvar ou enviar por e-mail no formato PDF)/EW (Salvar ou enviar por e-mail no formato DOC. O Word deve estar instalado)/SW (Senha do Word. Protege o DOC enviado de alterações. Ex.: “/SW 1234”)/QC (Qualidade da compactação do e-mail para JPG ou PDF. Ex.: “/QC 92”)/QPS (PDF Sólido. Compactado internamente como JPG gerado diretamente pelo VisRel.exe)/QPN (PDF Normal. Exige componente externo e não funciona em certos servidores com restrições)/SE (O usuário pode selecionar o tipo antes de salvar ou enviar por e-mail)/ED (Destinatário do e-mail. Ex.: “/ED fredig@terra.com.br”)/EM (Mensagem do e-mail. Ex.: “/EM Relatório em anexo!” ou “/EM C:\Mensagem.txt”)/EA (Envia algum arquivo seu em anexo. Ex.: “/EA C:\*.xml;C:\Leia-me.txt”)/E (Envia por e-mail sem visualizar)/ZIP (Envia os anexos do e-mail compactados)/E2 (Adicione este parâmetro quando o modo MAPI não enviar normalmente)/OO (Adicione este parâmetro para enviar pelo Outlook do Office)/OE (Adicione este parâmetro para enviar pelo Outlook Express ou Live Mail)/L (Número de linhas do relatório. Ex.: “/L 66”)/Z (Zoom inicial. Pode ser 25, 50, 75, 100, 125, 150, 200. Ex.: “/Z 125”)/I (Imprime sem visualizar)/S (O relatório será impresso ao selecionar a impressora na visualização)/FM (Força a impressão do relatório no modo matricial. Ignorando o driver)/CC (Caracteres de compactação. Para usar com o “/FM”. Ex.: “/CC @M”)/CH (Caracteres de compactação em hexadecimal. Ex.: “/CH 1b4d”)/SS (Sem Salto de página. Para usar com o “/FM” em formulário contínuo)/SV (Força a tela do VisRel a ficar visível. Necessário em alguns casos)/FA (Reduz o tamanho da fonte se a linha ultrapassar o tamanho do papel)/NC (Não centraliza a página quando for maior do que a tela)/CI (Configura apenas o nome da impressora dentro da visualização)/DC (Não permite configurar a impressora dentro da visualização)/NE (Não permite enviar por e-mail, salvar e nem copiar o relatório)/SL (Somente Leitura. Não permite imprimir, salvar, copiar ou enviar por e-mail)/IS (Somente permite Imprimir e Salvar)/PAG (Determina a paginação nas macros (%_pag_%). Exemplo: “/PAG 3;5;7-80 /PGS 80”)/PGS (Complemento do recurso acima. Indica qual será o total de páginas exibido.)/EPS (Visualizar o Padrão Epson. Remove comandos ESC e adapta bordas feitas no DOS.)/ME (Margem adicional esquerda em milímetros. Exemplo: “/ME 10”)/MS (Margem adicional superior em milímetros. Exemplo: “/MS 10”)/MI (Margem adicional inferior em milímetros. Exemplo: “/MI 10”)/MZ (Ignora a margem física da impressora assim a margem acima começa no inicio do papel)/X (Exclui o arquivo ao fechar o VisRel)/A (Salva sem visualizar. Exemplo: “/A C:\Arquivos\Relatorio.DOC”)/CP (Caracteres por polegada. Não deve ser utilizado em conjunto com /FA. Exemplo: “/CP 10”)/LP (Linhas por polegada. Não deve ser utilizado em conjunto com /FA. Exemplo: “/LP 8”)/DRAFT (Verifica automaticamente se a impressora suporta impressão matricial. Ignora o “/FM”)/DM (Evita que o usuário altere a opção “Imprimir no modo matricial”)/PS (Permite informar o tamanho do papel. Exemplo: “/PS 9” para A4. Veja a tabela abaixo)/TTF (Instala no computador do usuário as fontes TTF que estejam na mesma pasta do VisRel.exe)/CF (Cor do papel para a visualização. Exemplo: “/CF 80FFFF” ou “/CF #FFFF80” para amarelo)/CS (Cor da linha selecionada na visualização. Exemplo: “/CS 80FFFF” para amarelo)/CL (Cor da linha de detalhe alternada na visualização. Exemplo: “/CL F0F0F0” para cinza)/PB (Exibe uma barra de progressão enquanto carrega o relatório)/IL (Exibe apenas impressoras locais)

Página 3 de 17

/SMTP (Envia o e-mail no modo oculto. Deve-se informar as configurações de SMTP e login)

/Q (Quando usado com o /SMTP não mostra mensagens de erro retornados pelo servidor)/SC (Quando usado com o /SMTP evita que você receba uma cópia do e-mail enviado)/PC (Para o carro de impressão na última linha na impressão matricial)/FV (Configura a impressora para imprimir frente e verso quando o hardware permite)/MD (Insere uma Marca D'agua nas páginas. Exemplo: “/MD C:\Imagens\Logomarca.jpg”)/MP (Percentual da transparência da D'agua acima de 0% a 200%. Exemplo: “/MP 120”)/V (Força a visualização mesmo que tenha os parâmetros /I, /E ou /A)

A tabela abaixo contém os códigos correspondentes para utilização com o parâmetro /PS:

Código Descrição1 Letter, 8 1/2 x 11 in.2 Letter Small, 8 1/2 x 11 in.3 Tabloid, 11 x 17 in.4 Ledger, 17 x 11 in.5 Legal, 8 1/2 x 14 in.6 Statement, 5 1/2 x 8 1/2 in.7 Executive, 7 1/2 x 10 1/2 in.8 A3, 297 x 420 mm9 A4, 210 x 297 mm

10 A4 Small, 210 x 297 mm11 A5, 148 x 210 mm12 B4, 250 x 354 mm13 B5, 182 x 257 mm14 Folio, 8 1/2 x 13 in.15 Quarto, 215 x 275 mm16 10 x 14 in.17 11 x 17 in.18 Note, 8 1/2 x 11 in.19 Envelope #9, 3 7/8 x 8 7/8 in.20 Envelope #10, 4 1/8 x 9 1/2 in.21 Envelope #11, 4 1/2 x 10 3/8 in.22 Envelope #12, 4 1/2 x 11 in.23 Envelope #14, 5 x 11 1/2 in.24 C size sheet25 D size sheet26 E size sheet27 Envelope DL, 110 x 220 mm29 Envelope C3, 324 x 458 mm30 Envelope C4, 229 x 324 mm28 Envelope C5, 162 x 229 mm31 Envelope C6, 114 x 162 mm32 Envelope C65, 114 x 229 mm33 Envelope B4, 250 x 353 mm34 Envelope B5, 176 x 250 mm35 Envelope B6, 176 x 125 mm36 Envelope, 110 x 230 mm37 Envelope Monarch, 3 7/8 x 7 1/2 in.38 Envelope, 3 5/8 x 6 1/2 in.39 U.S. Standard Fanfold, 14 7/8 x 11 in.40 German Standard Fanfold, 8 1/2 x 12 in.41 German Legal Fanfold, 8 1/2 x 13 in.

Página 4 de 17

Os carateres identificados como comandos dentro do arquivo texto são:

Hexadecimal 0C (CTRL+L) = Salto de página (É ignorado na impressão com o “/SS”).Hexadecimal 0A (CTRL+J) = Salto de linha (Também pode ser usada a combinação 0D0A).Hexadecimal DD (ALT+0221) = Final do cabeçalho (Adicione-o na última linha do cabeçalho).Hexadecimal DD (ALT+0221) = O segundo “Ý” identifica a primeira linha do rodapé.Hexadecimal 0D (CTRL+M) = Retorno de carro (Este é usado para negritar a linha no relatório. Ex.: Total R$ 100,000DTotal R$ 100,000A imprime Total R$ 100,00) .

Obs.: Omitindo o parâmetro “/IN” o relatório será impresso na impressora padrão. Ao informar zero no número de cópias “/C 0” o botão imprimir fica desabilitado. Também é possível inserir macros no modo texto, conforme a tabela abaixo:

Quais são as macros?

Macros são comandos que serão substituídos dentro do relatório por texto. As macros suportadas pelo VisRel são:

(%_pag_%) – Exibe a página atual;(%_pgs_%) – Exibe o número de páginas;(%_zpg_%) – Exibe a página atual (Formatado. Ex.: 00001);(%_zps_%) – Exibe o número de páginas (Formatado. Ex.: 00010);(%_sem_%) – Exibe o dia da semana (Ex.: Segunda-feira);(%_msn_%) – Exibe o nome do mês (Ex.: janeiro);(%_dia_%) – Exibe o dia;(%_mes_%) – Exibe o mês;(%_ano_%) – Exibe o ano;(%_hor_%) – Exibe a hora;(%_min_%) – Exibe o minuto;(%_seg_%) – Exibe o segundo.

Ex.: (%_dia_%)/(%_mes_%)/(%_ano_%) exibe 27/10/2005 em tela.

VisRel permite criar até 100 variáveis (%_00_%) até (%_99_%) que podem ser utilizadas no cabeçalho e/ou rodapé, e são alteradas durante a geração do corpo do relatório.

Para altera-las grave no inicio da linha o caracter “Û” (Hexadecimal "DB" ou ALT+0219) e em seguida o número da variável, um espaço e o valor a ser substituído. Ex.: Û01 Valor

Obs.: Em modo matricial (linha de comando com o parâmetro “/M”) as macros não serão impressas, pois ao clicar em imprimir seu arquivo será enviado diretamente ao hardware da impressora.

Página 5 de 17

Como alterar o ícone do visualizador?

Basta criar um ícone com 32x32 pixels com o nome VisRel.ico e coloca-lo junto com o VisRel.exe (Por padrão na pasta C:\Windows).

Como adicionar outros tamanhos de papel no Windows?

Para adicionar novos tamanhos e tipos de papel utilize a linha de comando abaixo:

VisRel.exe /TP

Obs.: Dependendo do driver da impressora alguns tamanhos não serão suportados, nesse caso pode-se criar um tamanho um pouco menor, ou seja, se você deseja criar uma NF com (100mm x 200mm) e a impressora não exibir esse tamanho tente utilizar (95mm x 200mm).

Como manipular dados do Excel usando o VisRel?

Você também pode utilizar o VisRel para adicionar ou alterar dados em planilhas do Excel já existentes ou criar um arquivo XLS do zero usando a linha de comando abaixo:

VisRel.exe /XLS Dados.rel /V

/XLS (Nome do arquivo que contém os dados no formato detalhado abaixo)/V (Informa ao VisRel que a planilha deve ser exibida depois de salva-la)/DEL (Apaga o arquivo XLS se o mesmo já existir)/Range (Junta todos os comandos VAL em um Range. Acelera o processamento)/Q (Não exibe a barra de progressão)

Dentro de Dados.rel tem uma estrutura especifica, onde os três primeiros bytes identificam o que se deseja fazer: XLS (Nome do arquivo do Excel. Se não existir será salvo com esse nome)PLA (Nome de uma planilha já existente ou uma nova que será criada pelo VisRel. Ex.: Plan1)VAL (Linha, coluna e valor que será atribuído à célula)PIC (Opcional. Formato dos dados no Excel. Ex.: dd/mm/yy)FOR (Opcional. No lugar de um valor pode ser colocada uma fórmula. Ex.: C3+C4 ou SUM(A1:A10))FON (Opcional. Alteração da fonte e tamanho separado por ponto-e-vírgula)LAR (Opcional. Largura da coluna em caracteres, no mesmo padrão do Excel)LAA (Opcional. Largura automática da coluna. Deve ficar depois de ter adicionado os dados)ALT (Opcional. Altura da linha em Pontos, no mesmo padrão do Excel (72 por polegada))ALA (Opcional. Altura automática da linha. Deve ficar depois de ter adicionado os dados)COR (Opcional. Cor do texto e fundo da célula separados por ponto-e-vírgula, em hexadecimal ou cores numeradas da WEB)PDF (Opcional. Exporta como PDF a planilha atual. Suportado apenas pelo Excel 2007 ou mais recente)PRO (Opcional. Protege a planilha atual com senha. Veja o exemplo abaixo) LIB (Opcional. Desprotege a planilha atual com senha. Veja o exemplo abaixo) BLO (Opcional. Desbloqueia para edição uma célula de uma planilha protegida. Veja o exemplo abaixo)ALI (Opcional. Alinhamento separado por ponto-e-vírgula. ‘E’ (Esquerda), ‘C’ (Centro) ou ‘D’ (Direita) e ‘T’ (Topo), ‘C’ (Centro) ou ‘B’ (Base)). Ex.: D;B para alinhar a direita na base.BOR (Opcional. Bordas das células com a combinação das letras: ‘E’ (Esquerda), ‘D’ (Direita) e ‘T’ (Topo), e ‘B’ (Base)). Ex.: EDTB para todas as bordas.MES (Opcional. Mescla as células do RANGE informado). Ex.: MES A1:B1 ou MES 1,1:1,2. EST (Opcional. Estilo da fonte das células com a combinação das letras: ‘N’ (Negrito), ‘I’ (Itálico) e ‘S’ (Sublinhado), e ‘R’ (Riscado)). Ex.: NISR para todas os estilos.

Página 6 de 17

Exemplo do conteúdo do arquivo: XLS C:\Arquivo.xlsPLA Plan1LIB SenhaLAR (001)=20ALI (00001,001)=c;cBOR (00001,001)=edbtEST (00001,001)=NIVAL (00001,001)=Aqui é a linha 1 e coluna 1VAL (00002,001)=Aqui é a linha 2 e coluna 1VAL (00003,001)=Aqui é a linha 3 e coluna 1PIC (00004,001)=#,##0.000VAL (00004,001)=1234.5FON (00004,001)=Courier New;10COR (00004,001)=#FF0000;#EEEEEEBLO (00004,001)=NALA (001)=1PRO SenhaPDF C:\Arquivo.pdf

Obs.: Em dados numéricos deve ser usado apenas o ponto (.) como separador decimal e as datas devem ser informadas no formato americano (mês/dia/ano). Caso utilize códigos de produtos com pontos ou barras de datas formate a célula como texto (PIC (linha,coluna)=@) antes de enviar o valor, assim o Excel não tenta converter o código em número ou data.

Como executar outro programa usando o VisRel?

Você pode abrir outros programas, bat, doc (Word), xls (Excel), sites, etc... usando a linha de comando abaixo:

VisRel.exe /O /EX Arquivo.BAT

/EX (Nome do arquivo, programa, ou site. Ex.: “/EX www.visrel.rg3.net”)/O (Executa o arquivo em modo oculto, sem aquelas telas pretas do DOS)

Como imprimir arquivos HTML?

O VisRel também pode ser utilizado para imprimir arquivos HTML. Isso é útil quando o desenvolvedor tem um bom conhecimento de geração de HTML e/ou necessita a impressão desses arquivos já existentes em seus sistemas sem que apareça a tela do Internet Explorer. Veja o exemplo abaixo:

VisRel.exe /HTM C:\Relatórios\Arquivo.htm /I /IN /Config

/HTM (Nome do arquivo HTML)/Config (Permite configurar a página antes da impressão)/IN (Permite selecionar a impressora)/I (Imprime sem visualizar. Ao remover esse parâmetro será exibido no navegador padrão)

IMPORTANTE: Este recurso foi descontinuado na versão 7 e mais recentes do Internet Explorer.

Como o usuário pode editar textos do VisRel com formatação?

O VisRel também permite que o usuário digite ou altere textos com macros de formatação, se o seu sistema tiver necessidade de alterar o conteúdo de alguns itens do relatório, como por exemplo clausulas de contratos. Veja o exemplo abaixo:

Página 7 de 17

VisRel.exe /Editar C:\Entrada.txt /A C:\Saida.txt /T Título da tela

/Editar (Nome do arquivo de entrada com as macros de negrito, itálico, etc.)/A (Nome do arquivo salvo pelo usuário com as macros das formatações acima)/T (Titulo da tela de edição)

Assim você gravaria no Entrada.txt o conteúdo atual do item que deseja alterar, aguardaria a geração do arquivo Saida.txt e leria o conteúdo do mesmo para posterior utilização durante a geração do relatório.

Como enviar e-mail com anexos?

O VisRel também pode ser utilizado enviar e-mail. Isso é útil quando o desenvolvedor precisa enviar automaticamente algum arquivo anexado. Veja o exemplo abaixo:

VisRel.exe /Enviar C:\Arquivo.doc;*.txt /ED Fredi<visrel@visrel.com.br> /T Assunto! /ZIP

/Enviar (Arquivos que serão anexados separados por ponto e virgula ";" quando mais de um)/ED (Destinatários separados por ponto e virgula ";" quando mais de um)/T (Assunto do e-mail e/ou nome do ZIP)/EM (Mensagem do e-mail. Ex.: “/EM Linha 1{e}Linha 2” ou “/EM C:\Mensagem.txt”

ou “/EM c:\arquigo.jpg” ou “/EM Para detalhes acesse www.visrel.com.br;c:\arquivo.gif” ou “/EM c:\arquivo.htm”, neste caso anexe as figuras do HTML no /Enviar para incorpora-las.)

/ZIP (Compacta o(s) anexo(s) no formato ZIP e com o nome do assunto)/OO (Adicione este parâmetro para enviar pelo Outlook do Office)/OE (Adicione este parâmetro para enviar pelo Outlook Express ou Live Mail)/SMTP (Envia o e-mail no modo oculto. Deve-se informar as configurações de SMTP e login)/SC (Quando usado com o /SMTP evita que você receba uma cópia do e-mail enviado)/CC (Quando usado com o /SMTP envia com cópia. Ex.: “/CC fredi@visrel.com.br”)/CCO (Quando usado com o /SMTP envia com cópia oculta. Ex.: “/CCO fredi@visrel.com.br”)/PB (Quando usado com o /SMTP exibe uma barra de progressão do envio do e-mail)/Q (Quando usado com o /SMTP não mostra mensagens de erro retornados pelo servidor)

As configurações do SMTP são solicitadas na primeira execução, ou podem ser informadas conforme a linha de comando abaixo:

/SMTP email@dominio.com.br;smtp.dominio.com.br;25;S;email@dominio.com.br;senha;N

ou

/SMTP email@gmail.com;smtp.gmail.com;465;S;email@gmail.com;senha;S

ou

/SMTP email@dominio.com.br(Nome Completo)responder@email.com;smtp.dominio.com.br;25;N;;;

Onde 25 é a porta remota do servidor SMTP e o primeiro “S” é o indicador (S/N) que o servidor requer autenticação, os próximos dois campos são o usuário e a senha do login, e o último indica se o servidor requer criptografia SSL/TSL, ou se será enviado usando tecnologia CDO (S/N/C).

Página 8 de 17

Como compactar pastas e arquivos como ZIP?

O VisRel também pode ser utilizado para compactar arquivo ou pastas e seus sub diretórios. Veja os exemplos abaixo:

VisRel.exe /Compactar C:\Arquivo.doc;C:\arq*.dat /T Arquivo.zip

/Compactar (Arquivos que serão anexados separados por ponto e virgula ";" quando mais de um)/T (Nome do ZIP)/PB (Exibe uma barra de progressão enquanto compacta)/Q (Gera o ZIP mesmo que algum arquivo separado por ponto e virgula não exista)

Para compactar todo o conteúdo de uma pasta coloque o nome da pasta terminado com contra barra “\”:

VisRel.exe /Compactar C:\Pasta\ /T Arquivo.zip

Como converter um arquivo ANSI em UTF-8?

O VisRel também pode ser utilizado para converter um arquivo ANSI em UTF-8. Isso é útil quando são gerados XMLs com palavras acentuadas, e a codificação do XML for UTF-8. Veja o exemplo abaixo:

VisRel.exe /ANSI C:\Arquivo ANSI.xml /UTF-8 C:\Arquivo UTF-8.xml

Para converter UTF-8 em ANSI utilize o parâmetro /RET:

VisRel.exe /ANSI C:\Arquivo ANSI.xml /UTF-8 C:\Arquivo UTF-8.xml /RET

Como enviar e receber arquivos por FTP?

O VisRel também pode ser utilizado para enviar, receber e apagar arquivos por FTP. Veja o exemplo abaixo:

VisRel.exe /FTP C:\Arquivo.doc;C:\arq*.* /S ftp.site.com.br;login;senha /D .\

/FTP (Arquivos que serão enviados separados por ponto e virgula ";" quando mais de um)/S (Servidor e Autenticação separado por ponto e virgula ";")/D (Pasta de destino no servidor. Se a pasta não existir será criada)/PB (Exibe uma barra de progressão enquanto envia)

VisRel.exe /DOWN .\Pasta\Arquivo.doc /S ftp.site.com.br;login;senha /D C:\Pasta

/DOWN (Arquivos que serão baixados separados por ponto e virgula ";" quando mais de um)/S (Servidor e Autenticação separado por ponto e virgula ";")/D (Pasta de destino no computador. Se a pasta não existir será criada)/PB (Exibe uma barra de progressão enquanto envia)

VisRel.exe /DEL .\Pasta\Arquivo.doc /S ftp.site.com.br;login;senha

/DEL (Arquivos que serão apagados separados por ponto e virgula ";" quando mais de um)/S (Servidor e Autenticação separado por ponto e virgula ";")/PB (Exibe uma barra de progressão enquanto apaga)

VisRel.exe /LIST .\Pasta\*.doc /S ftp.site.com.br;login;senha /D C:\Lista.txt

/LIST (Baixa uma lista com os arquivos do servidor)/S (Servidor e Autenticação separado por ponto e virgula ";")/D (Arquivo TXT onde a lista de arquivos será salva)/PB (Exibe uma barra de progressão enquanto envia)/DIR (Inclui também os nomes das pastas existentes)

Página 9 de 17

Como funciona o modo gráfico?

O seu programa grava uma série de comandos (o relatório) em um arquivo no formato line-sequential (Texto), e chama o VisRel informando o nome do arquivo e um título, conforme o exemplo abaixo:

VisRel.exe /G C:\Relatórios\MeuRelatório.rel /T Título da janela

/G (Modo gráfico e permite usar diversas fontes e figuras)/T (Título da janela)/S (O relatório será impresso ao selecionar a impressora na visualização)/C (Quantidade de cópias do mesmo relatório a ser impresso. Ex.: “/C 2”)/Z (Zoom inicial. Pode ser 25, 50, 75, 100, 125, 150, 200. Ex.: “/Z 125”)/TR (Remove os espaços à direita dos registros. Para o PowerCobol)/SE (O usuário pode selecionar o tipo antes de salvar ou enviar por e-mail)/SW (Senha do Word. Protege o DOC enviado de alterações. Ex.: “/SW 1234”)/E2 (Adicione este parâmetro quando o modo MAPI não enviar normalmente)/OO (Adicione este parâmetro para enviar pelo Outlook do Office)/OE (Adicione este parâmetro para enviar pelo Outlook Express ou Live Mail)/ED (Destinatário do e-mail. Ex.: “/ED fredig@terra.com.br”)/EA (Envia algum arquivo seu em anexo. Ex.: “/EA C:\Arquivo.xml;C:\Leia-me.txt”)/ZIP (Envia os anexos do e-mail compactados)/CI (Configura apenas o nome da impressora dentro da visualização)/DC (Não permite configurar a impressora dentro da visualização)/NC (Não centraliza a página quando for maior do que a tela)/NE (Não permite enviar por e-mail nem copiar o relatório)/SL (Somente Leitura. Não permite imprimir, copiar ou enviar por e-mail)/PAG (Determina a paginação nas macros (%_pag_%). Exemplo: “/PAG 3;5;7-80 /PGS 80”)/PGS (Complemento do recurso acima. Indica qual será o total de páginas exibido.)/X (Exclui o arquivo ao fechar o VisRel)/A (Salva sem visualizar. “/A C:\Arquivos\Relatorio.DOC”)/PS (Permite informar o tamanho do papel. Exemplo: “/PS 9” para A4)/TTF (Instala no computador do usuário as fontes TTF que estejam na mesma pasta do VisRel.exe)/PB (Exibe uma barra de progressão enquanto carrega o relatório)/IL (Exibe apenas impressoras locais)/SMTP (Envia o e-mail no modo oculto. Deve-se informar as configurações de SMTP e login)/SC (Quando usado com o /SMTP evita que você receba uma cópia do e-mail enviado)/P (Modo paisagem)/E (Envia por e-mail sem visualizar)/I (Imprime sem visualizar)/ME (Margem adicional esquerda em milímetros. Exemplo: “/ME 10”)/MS (Margem adicional superior em milímetros. Exemplo: “/MS 10”)/MI (Margem adicional inferior em milímetros. Exemplo: “/MI 10”)/MZ (Ignora a margem física da impressora assim a margem acima começa no inicio do papel)/MA (Reduz o tamanho do último item a direita se não couber na página)/EJ (Salvar ou enviar por e-mail no formato JPG)/EE (Salvar ou enviar por e-mail no formato EMF)/EG (Salvar ou enviar por e-mail no formato GIF)/EP (Salvar ou enviar por e-mail no formato PDF)/EW (Salvar ou enviar por e-mail no formato DOC. O Word deve estar instalado)/ER (Salvar ou enviar por e-mail no formato RTF. O Word deve estar instalado)/ES (Salvar ou enviar por e-mail no formato XLS. O Excel deve estar instalado)/EC (Salvar ou enviar por e-mail no formato CSV. Separado por ponto-e-vírgula)/EM (Mensagem do e-mail. Ex.: “/EM Relatório em anexo!” ou “/EM C:\Mensagem.txt” ou “/EM c:\arquigo.jpg” ou “/EM Para detalhes acesse www.visrel.com.br; c:\arquivo.gif”

ou “/EM c:\arquivo.htm”, neste caso anexe as figuras do HTML no /Enviar para incorpora-las.ou “/EM .gif”, neste caso a primeira página do relatório será incorporado como GIF.)

/QC (Qualidade da compactação do e-mail para JPG ou PDF. Ex.: “/QC 92”)/QPS (PDF Sólido. Compactado internamente como JPG gerado diretamente pelo VisRel.exe)/QPN (PDF Normal. Exige componente externo e não funciona em certos servidores com restrições)/IN (Nome da impressora. Ex.: “/IN HP 610C” ou “/IN” configura ou “/IN ?” apenas escolhe)/FP (Ao selecionar a impressora, ela torna-se a impressora padrão do usuário)/FV (Configura a impressora para imprimir frente e verso quando o hardware permite)/MD (Insere uma Marca D'agua nas páginas. Exemplo: “/MD C:\Imagens\Logomarca.jpg”)/MP (Percentual da transparência da D'agua acima de 0% a 200%. Exemplo: “/MP 120”)/CL (Cor da linha de detalhe alternada na visualização. Exemplo: “/CS F0F0F0” para cinza)/CS (Cor da linha selecionada na visualização. Exemplo: “/CS 80FFFF” para amarelo)/WTS (Utiliza outro método de impressão para evitar BUG do Windows Terminal Service)/IF (Fecha o a Visualização depois de clicar em Imprimir)/V (Força a visualização mesmo que tenha os parâmetros /I, /E ou /A)

Página 10 de 17

As configurações do SMTP são solicitadas na primeira execução, ou podem ser informadas conforme a linha de comando abaixo:

/SMTP email@dominio.com.br;smtp.dominio.com.br;25;S;email@dominio.com.br;senha;N

ou

/SMTP email@gmail.com;smtp.gmail.com;465;S;email@gmail.com;senha;S

ou

/SMTP email@dominio.com.br(Nome Completo)responder@email.com;smtp.dominio.com.br;25;N;;;

Onde 25 é a porta remota do servidor SMTP e o primeiro “S” é o indicador (S/N) que o servidor requer autenticação, os próximos dois campos são o usuário e a senha do login, e o último indica se o servidor requer criptografia SSL/TSL, ou se será enviado usando tecnologia CDO (S/N/C).

Quais são os comandos do modo gráfico?

Os primeiros dois caracteres da linha identificam o tipo de comando usado:

F Altera a FonteT Imprime texto na posição especificadaL Imprime uma linha (ou retângulo)G Imprime uma figura (pode ser bmp, gif ou jpg)RT Altera a posição inicial da banda atual (Row Top)RB Altera a posição final da banda atual (Row Bottom)RH Altera a espessura da banda atual (Row Height)LP Imprime uma linha com a data atual e número da página (Linha de Página)QL Finaliza a linha atual (Quebra de Linha)FC Todas as linhas anteriores a esse comando serão considerados cabeçalhoQP Inicia uma nova página na linha atual (Quebra de Página)IR Imprime o relatório sem visualiza-lo (Imprimir Relatório)E Envia o relatório por e-mail sem visualiza-loIP Imprime o relatório no modo paisagemSV Força o relatório a ficar visível nos primeiros 10 segundos (Sempre Visível)I Define o nome da impressora que será utilizada na impressãoQJ Qualidade do JPG no e-mail (1-100%)EE Envia e-mail no formato EMF (Metarquivo avançado do Windows)EG Envia e-mail no formato GIF (Com redução otimizada para 256 cores)EP Envia e-mail no formato PDF (Utiliza compactação JPG nas páginas)ET Texto que será exibido no corpo do e-mailEX Executa um programa e finaliza o VisRelBx Imprime um código de barras, onde “x” é o tipo de código de barrasME Margem esquerda em milímetrosMS Margem superior em milímetrosMI Margem inferior em milímetrosLG Barra de gráficoRO Todas as linhas posteriores a esse comando serão considerados rodapéTC Não imprime o cabeçalho e o rodapé na primeira página

Obs.: Se você não tiver como, ou não quiser alterar a linha de comando de /R para /G e vice-versa pode-se usar /RG e gravar a macro <%_G_%> na primeira linha do arquivo para identificá-lo como modo gráfico. E se não for encontrada essa macro na primeira linha o relatório será exibido no modo texto. Exemplo:

VisRel.exe /RG C:\Relatórios\MeuRelatório.rel /T Título da janela

Página 11 de 17

Como alterar a fonte?

Para alterar a fonte para “Times New Roman” com o tamanho 23 e itálico use:

F 230100Times New Roman

Bytes Significado

3 e 4 Tamanho da Fonte5 Negrito6 Itálico7 Sublinhado8 Riscado9 em diante Nome da fonte

Como imprimir texto?

Para imprimir o texto “Meu Relatório” centralizado na primeira linha use:

T 009900000999990000000010Meu RelatórioQL

Bytes Significado

3 e 4 Cor da fonte (de 0 até 15)5 e 6 Cor do fundo (de 0 até 15 ou 99 para Transparente)7 até 11 Posição esquerda do Item (em pixels)12 até 16 Comprimento do Item (99999 = comprimento da página)17 até 26 Alinhamento do texto (conforme a tabela de alinhamentos)27 em diante Texto que será impresso

Tabela de alinhamentos

Byte Alinhamento

17 Centraliza o texto na horizontal (Center)18 Alinha o texto a direita (Right )19 Centraliza o texto na Vertical (VCenter) 20 Alinha o texto na base da banda (Bottom)21 Linha simples, deve ser ligado (1) para usar VCenter e Bottom (SingleLine) 22 Cria uma caixa de texto dentro do Item (WordBreak) 23 Quando ligado (1) justifica o texto24 Quando ligado (1) não trunca o texto dentro do Item (NoClip)25 Quando ligado (1) permite usar o caracter & (NoPrefix)26 Quebra o texto da caixa de texto, e WordBreak deve ser ligado (EditControl)

Página 12 de 17

Como imprimir uma linha?

Para imprimir uma linha preta no centro da primeira linha use:

L 00990000099999100000000002QL

Bytes Significado

3 e 4 Cor da linha (de 0 até 15)5 e 6 Cor do fundo (de 0 até 15 ou 99 para Transparente)7 até 11 Posição esquerda do Item (em pixels)12 até 16 Comprimento do Item (99999 = comprimento da página)17 até 22 Posição da linha (conforme a tabela de linhas)23 até 26 Não são usados (grave sempre zeros)27 e 28 Espessura da linha (em pixels)

Tabela de linhas

Byte Alinhamento

17 Centralizada e na horizontal (1)18 Direita (2)19 Centralizada e na vertical (3)20 Base do Item (4)21 Topo do Item (5)22 Esquerda do Item (6)

Página 13 de 17

Como imprimir uma figura?

Para imprimir a figura “C:\Meus Documentos\Figura.jpg” centralizada na primeira linha use:

G 009900000999991000000000C:\Meus Documentos\Figura.jpgRH 100QL

Bytes Significado

3 e 4 Não são usados (grave sempre zeros)5 e 6 Cor do fundo (de 0 até 15 ou 99 para Transparente)7 até 11 Posição esquerda do Item (em pixels)12 até 16 Comprimento do Item (99999 = comprimento da página)17 até 20 Alinhamento da figura (conforme a tabela de alinhamentos)21 até 26 Não são usados (grave sempre zeros)27 em diante Nome e local da figura (pode ser bmp, gif ou jpg)

Obs.: Em “RH” informe a altura da figura em pixels, caso contrário as próximas linhas serão impressas em cima da figura.

Tabela de alinhamentos

Byte Alinhamento

17 Centraliza a figura na horizontal (Center)18 Alinha a figura a direita (Right )19 Centraliza a figura na Vertical (VCenter) 20 Alinha a figura na base da banda (Bottom)

Comando RT = Row Top

Usado para deslocar a banda (linha de texto) para cima ou para baixo.

Ex.: Para deslocar a banda 30 pixels para cima use (RT-30).Para deslocar a banda 80 pixels para baixo use (RT 80).

Obs.: O topo da banda atual não pode ser menor do que o topo da banda anterior.

Comando RB = Row Bottom

Usado para alterar a espessura da banda (linha de texto).

Ex.: Para aumentar a banda em 30 pixels use (RB 30).Para diminuir a banda em 80 pixels use (RB-80).

Comando RH = Row Height

Usado para alterar a espessura da banda (linha de texto). A banda ajusta seu tamanho automaticamente quando uma linha de texto é adicionada, mas se desejar aumentar ou diminuir este tamanho use o RH um pouco antes da quebra de linha (QL).

Página 14 de 17

Ex.: Para que a espessura da banda seja de 30 pixels use (RH 30). Para ajuste automático use (RH 0).

Comando LP = Linha com Página

Insere uma linha pré-formatada com data e número da página.

Comando QL = Quebra de Linha

Finaliza a linha atual (Inicia uma nova banda de texto).

Comando FC = Finalizar Cabeçalho

Finaliza a geração do cabeçalho. Não pode ser usado depois de uma quebra de página (QP), ou seja, se FC não for usado, o relatório não terá cabeçalho.

Comando QP = Quebra de Página

Força uma quebra de página na posição atual.

Comando IR = Imprimir Relatório

Imprime o relatório sem visualiza-lo.

Comando E = Enviar Relatório

Envia o relatório por e-mail sem visualiza-lo.

Comando IP = Imprimir no modo Paisagem

Imprime o relatório no modo paisagem (O padrão é o modo Retrato).

Comando SV = Sempre Visível

Força o relatório a ficar visível nos primeiros 10 segundos. Necessário quando utiliza-se o Dialog System do NetExpress.

Comando I = Nome da Impressora

Define qual impressora será utilizada na impressão. Se for omitido será usada a impressora padrão do Windows.

Página 15 de 17

Comando QJ = Qualidade do JPG no e-mail

Define a qualidade das figuras (JPG) anexadas no e-mail.

Ex.: Para que envie JPGs com a qualidade máxima use (QJ 100).

Comando EE = Enviar e-mail no formato EMF

Os e-mails serão enviados no formato EMF (Metarquivo avançado do Windows).

Comando EP = Enviar e-mail no formato PDF

Os e-mails serão enviados no formato PDF (Acrobat Reader 6.0).

Ex.: Para que envie PDFs com a qualidade máxima use (EP 100).

Comando EW = Enviar e-mail no formato DOC do Word

Os e-mails serão enviados no formato DOC (Microsoft Word).

Comando EX = Executar um programa

EX 1C:\Windows\Calc.exe (Chama a calculadora do Windows)EX 0C:\Windows\Calc.exe (Executa a calculadora no modo oculto)

Comando Bx = Código de Barras

Onde x pode ser:

a - Padrão EAN-13 - Utilizado na impressão de embalagens de produtos de varejo.b - Padrão EAN-8 - Idem ao EAN-13 para embalagens de tamanho reduzido.c - Padrão Code 39 (3 de 9), utilizado quando há necessidade de impressão de Letras e Números.d - Padrão Code 128, Tabela A (Letras maiúsculas/minusculas, símbolos e comandos).e - Padrão I25 (Interlaced), utilizado pela Febraban para impressão de boletos bancários.f- Padrão Code 39 sem checksum (digito verificador).g- Padrão I25 sem números.h- Padrão I25 com os números no topo do código.i - Padrão Code 128, Tabela B (Letras maiúsculas/minusculas, símbolos).

Para imprimir o número “12345678” no formato EAN-8:

Bb00990000099999100000000012345678RH 100QL

Obs.: Os dígitos serão calculados automaticamente pelo VisRel no caso do EAN-13 e EAN-8.

Página 16 de 17

Comando ME = Margem Esquerda

Usado para alterar a margem esquerda do relatório pelo seu programa durante a geração do mesmo. Dependendo da impressora a margem útil do papel (onde a impressora consegue imprimir) pode variar.

Ex.: Para que a margem esquerda seja aumentada em 10 milímetros use (ME 10).

Comando MS = Margem Superior

Usado para alterar a margem superior do relatório pelo seu programa durante a geração do mesmo. Dependendo da impressora a margem útil do papel (onde a impressora consegue imprimir) pode variar.

Ex.: Para que a margem superior seja aumentada em 10 milímetros use (MS 10).

Comando MI = Margem Inferior

Usado para alterar a margem inferior do relatório pelo seu programa durante a geração do mesmo. Dependendo da impressora a margem útil do papel (onde a impressora consegue imprimir) pode variar.

Ex.: Para que a margem inferior seja aumentada em 10 milímetros use (MI 10).

Comando LG = Barra de gráfico

Usado para desenhar barras de gráficos que podem ultrapassar a altura da banda (linha) na qual se encontram.

Ex.: Para desenhar uma barra de gráfico com 50 pixels de altura use (LG 50).

Comando TC = Tem Capa

Não imprime o cabeçalho e o rodapé na primeira página. Utilize-o para criar uma capa ou índice para o relatório.

Sobre o VisRel:

Desenvolvido em Visual Basic 6.0 por:

Fredi Giesbrechtfredi@visrel.com.brwww.visrel.com.brCampo Grande - MS

Página 17 de 17