Este documento detalha o funcionamento do binário TOTVS Printer via linha de comando e destina-se ao desenvolvedor na implantação/manutenção de soluções ou aos usuários em geral na busca de problemas relacionados a impressão. Reforçamos que na utilização normal do sistema não é recomendado a chamada direta ao binário TOTVS Printer, pois é esperado que o sistema ERP faça as chamadas na impressão de relatórios gerados através da classe FWMSPrinter, TReport e da função file2printer().
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 | Indica o formato do documento a ser criado ou o nome da fila de impressão que o arquivo será destinado. Para mais informações dos possíveis formatos, consulte a área "Observações". | X | |
-rfs | caractere | Também pode ser representado por --realfontsizes. Ativa a chave "Real Font Sizes" que diminui a divergência nos tamanhos de fonte encontrados entre impressões com saída PDF e Fila de Impressão (spool). Faz com que as fontes do texto sejam exibidas em seu tamanho natural sem redimensionamentos. Documentos gerados em PDF, Fila de Impressão, Preview, etc, exibirão textos com tamanhos de fonte muito próximos entre si. Entretanto ainda é importante prever uma pequena margem de erro para que textos não fiquem truncados ou excedam seus limites previstos, isto deve-se ao fato de que a origem do arquivo de fontes usado na impressão pode variar dependendo da plataforma. Se este parâmetro for omitido, o sistema considera a chave desativada por padrão. Disponível somente a partir da versão 1.4.3 da TOTVS Printer. | ||
cUserPwd | caractere | Proteção de senha User com permissões básicas. Este parâmetro torna-se obrigatório somente se a fila informada for PDF_WITH_PASSWORD ou PDF_WITHOUT_FONTS_WITH_PASSWORD. A senha deve conter entre 6 e 12 caracteres. Disponível a partir da versão 1.5.3 da TOTVS Printer. | ||
cOwnerPwd | caractere | Proteção de senha Mestre (owner) com permissões avançadas (Alteração de permissões). É um parâmetro opcional utilizado somente quando a fila informada for PDF_WITH_PASSWORD ou PDF_WITHOUT_FONTS_WITH_PASSWORD. A senha deve conter entre 6 e 12 caracteres. Disponível a partir da versão 1.5.3 da TOTVS Printer. | ||
-pdfversion | caractere | Permite especificar a versão do PDF a ser gerado. O padrão é "1.3". Este parâmetro é considerado somente para as filas de impressão em PDF. Os valores aceitos são: -pdfversion=1.3, -pdfversion=1.4, -pdfversion=1.5, -pdfversion=1.6 ou -pdfversion=1.7. Disponível a partir da versão 1.6.2 da TOTVS Printer. É importante salientar que documentos PDF gerados na versão 1.3 são compatíveis com todas as versões mais recentes dos leitores de PDF, enquanto documentos gerados em versões mais recentes podem não ser abertos em leitores mais antigos ou podem gerar uma mensagem de alerta sobre incompatibilidade de versão. O motor de geração de PDF da TOTVS Printer poderá alterar a versão por conta própria, se for necessário, dependendo de alguma funcionalidade aplicada ao documento que for suportada a partir de determinada versão. |
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 | Indica o formato do código de barras 2D a ser criado. Para mais informações dos possíveis formatos, consulte a área "Observações". | X | |
cBarcodeText | caractere | Indica o texto a ser codificado no padrão do código de barras 2D escolhido. | X | |
nBarcodeSize | numérico | Indica o valor a ser usado como largura e altura nos formatos QRCODE e DATAMATRIX, e somente como largura no formato PDF417. | X | |
nBarcodeHeight | numérico | Somente para o formato PDF417, onde é obrigatório e indica o valor a ser usado como altura. |
Formato | Descrição |
---|---|
Gera um documento em formato PDF. | |
PDF_WITH_PASSWORD | Gera um documento em formato PDF com senha de proteção. A senha deve conter entre 6 e 12 caracteres. |
PDF_WITHOUT_FONTS | Gera um documento em formato PDF, porém sem embarcar as fontes usadas*. |
PDF_WITHOUT_FONTS_WITH_PASSWORD | Gera um documento em formato PDF, porém sem embarcar as fontes usadas* e com senha de proteção. A senha deve conter entre 6 e 12 caracteres. |
PNG | Gera uma imagem em formato PNG. |
PREVIEW | Abre uma janela de vizualização da impressão do documento. |
XLS ou XLSX | Gera uma planilha em formato XLSX. Disponível a partir da versão 2.1.0 da TOTVS Printer. |
"nome da fila de impressão" | Se nenhum dos formatos acima for usado, então o documento será enviado para a fila de impressão com o nome dado, isto é, o nome da impressora de destino. |
* As possíveis fontes são: Arial, Arial Black, Times New Roman, Courier, Andale Mono.
Formato | Descrição |
---|---|
QRCODE | Gera um arquivo de imagem no padrão QRCode. |
DATAMATRIX | Gera um arquivo de imagem no padrão DataMatrix. |
PDF417 | Gera um arquivo de imagem no padrão PDF417. Disponível a partir da versão 1.5.7 da TOTVS Printer. |
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" printer.exe meuexemploparaxls.rel XLS |
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 |