Home

TOTVS Technology

Child pages
  • TOTVS Printer Agent

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

A TOTVS Printer é um arquivo binário (printer.exe ou totvsprinter.exe dependendo do ERP) utilizado como agente de impressão. Sua execução é feita por linha de comando onde os argumentos orientam a impressão.

Warning

Não recomendamos que sejam feitas chamadas diretas ao binário TOTVS Printer, normalmente ele é chamado internamente pelo sistema ERP na impressão de certos tipos de relatórios gerados através da classe FWMSPrinter, TReport e da função file2printer(). Desta forma é necessário que o binário TOTVS Printer esteja localizado no diretório de instalação do TOTVS | Application Server e TOTVS | SmartClient.

Warning

Este agente de impressão requer um Sistema Operacional com interface gráfica

Info
titleObter a versão

Para obter a versão da TOTVS Printer execute a linha de comando printer.exe -v

Argumentos de linha para impressão de arquivo gerado .rel

...

Code Block
titleSintaxe da linha de comando para impressão de relatórios
printer.exe <cArquivo> <cFila> [-rfs] [cUserPwd] [cOwnerPwd] [-pdfversion]

...

Nome

...

Tipo

...

Descrição

...

Obrigatório

...

Referência

...

cArquivo

...

caractere

...

Indica o nome do arquivo com extensão .rel que possui os comandos pré-definidos para criação de documentos.

...

X

...

cFila

...

caractere

...

X

...

Argumentos de linha para impressão direta de código de barras 2D

...

Code Block
titleSintaxe da linha de comando para impressão de código de barras 2D
printer.exe <cArquivo> <cBarcodeFormat> <cBarcodeText> <nBarcodeSize> [nBarcodeHeight]

...

Nome

...

Tipo

...

Descrição

...

Obrigatório

...

Referência

...

cArquivo

...

caractere

...

Nome do arquivo de saída para geração do código de barras no padrão QRCode ou DataMatrix. As extensões de arquivos de imagem aceitas são: bmp, png e jpg. Mais informações consulte a área "Observações". 

...

X

...

cBarcodeFormat

...

caractere

...

X

...

Observações

  • Argumento <cFila> - Formato do documento ou fila de impressão:

...

Formato

...

Descrição

...

PDF_WITH_PASSWORD

...

* As possíveis fontes são: Arial, Arial Black, Times New Roman, Courier, Andale Mono.

  • Argumento <cBarcodeFormat> - Formato do código de barras 2D:

...

Formato

...

Descrição

...

DATAMATRIX

...

  • É importante atentar-se ao fato de que as imagens de código de barras 2D geradas possuem um tamanho mínimo (altura e largura) que depende do tamanho do texto codificado e tem como função garantir que um leitor conseguirá interpretar o código corretamente. Portanto se o tamanho especificado no parâmetro nBarcodeSize para QRCode e DataMatrix for inferior ao tamanho mínimo necessário (calculado pelo motor de geração de código de barras), o tamanho informado será ignorado e a imagem assumirá um tamanho maior.
  • Para gerar imagens de QRCode e DataMatrix com o tamanho mínimo necessário e legível, basta informar o valor 1 no parâmetro nBarcodeSize.
  • A geração de arquivos PDF possui uma limitação na quantidade de páginas geradas para um documento. Até a versão 1.6.6 da TOTVS Printer, o limite máximo é de 8.191 páginas. A partir da versão 1.6.7 esse limite foi expandido para 32.767 páginas.
  • A partir da versão 1.4.4 da TOTVS Printer, ao ser excedido o limite de páginas PDF, o processo de geração é interrompido para evitar erros na execução.

Exemplos

Code Block
languagebash
themeEclipse
titleExemplos de impressão de relatórios (arquivos .rel)
linenumberstrue
printer.exe meuexemplo.rel PDF
printer.exe meuexemplo.rel PDF -rfs
printer.exe meuexemplo.rel PDF_WITH_PASSWORD senhauser senhaowner 
printer.exe meuexemplo.rel PDF_WITH_PASSWORD -rfs senhauser senhaowner 
printer.exe meuexemplo.rel PDF_WITH_PASSWORD senhauser -pdfversion=1.7
printer.exe meuexemplo.rel minhaImpressora -rfs
printer.exe meuexemplo.rel "Lexmark MX510"
Code Block
languagebash
themeEclipse
titleExemplos com impressão direta de código de barras 2D
linenumberstrue
printer.exe imagemqr.png qrcode "Texto codificado em QR Code." 90
printer.exe imagemdm.jpg datamatrix "Texto codificado em DataMatrix." 200
printer.exe imagemPDF417.bmp pdf417 "Texto codificado em PDF417." 300 100