1) O documento descreve o sistema de impressão Format e suas funcionalidades, incluindo instalação, configuração de documentos, campos, códigos de barras e outras ferramentas.
2) São detalhadas seções sobre arquivos de dados, campos de entrada e saída, configuração de formulários, variáveis, funções e editor de expressões.
3) Também são explicados recursos como desenhos, gráficos, logotipos, overlays e mensagens para o usuário.
3. Notas
Notas
As informações contidas neste documento estão sujeitas a modificações sem prévio
aviso. O software descrito neste manual é fornecido sob contrato de licenciamento de
uso. O software somente pode ser utilizado ou copiado desde que obedecidos os
termos do contrato.
Embora a SIRIUS tenha testado o software e revisado sua documentação, a SIRIUS
não dá garantia ou representação, implícita ou explícita, com relação a este software,
sua qualidade, desempenho, comercialização ou ajuste, para um propósito particular.
Conseqüentemente, este software é vendido “No Estado”, e você, o usuário, está
assumindo o risco total no que se refere à sua qualidade e desempenho.
A SIRIUS não se responsabilizará por qualquer dano, seja direto, indireto, especial ou
incidental, resultante de má utilização do software ou de sua documentação.
Este documento é de reprodução e distribuição proibidas, em todo ou em parte, em
qualquer forma, seja eletrônica ou mecânica, incluindo fotocópia ou gravação, para
qualquer propósito, sem prévia autorização por escrito de SIRIUS Sistemas Digitais.
Copyright SIRIUS, 1996. Todos os direitos reservados.
FORMAT Printing System é marca registrada de SIRIUS.
Outros produtos mencionados neste documento são marcas registradas de seus
proprietários.
SIRIUS SISTEMAS DIGITAIS LTDA.
Av. das Américas 7907 Bloco 3 Grupo 201/202
Barra da Tijuca - Rio de Janeiro - Brasil
Telefone: +55 (21) 3392-2013
E-mail: sirius@siriusnet.com.br
Site: www.siriusnet.com.br
3
4.
5. Índice
Índice
Notas .............................................................................................................................. 3
Introdução ................................................................................................................... 15
Instalação..................................................................................................................... 17
Instalação do Format................................................................................................ 17
Instalação do Driver do Conector de Segurança – Conector Local ......................... 17
Instalação do Driver do Conector de Segurança – Conector de Rede (Um conector
para vários usuários) ................................................................................................ 18
Instalação do Driver da Placa Barr em ambiente Windows NT .............................. 19
Instalação do FontConverter .................................................................................... 19
Área de Trabalho........................................................................................................ 21
Arquivo de Dados ....................................................................................................... 23
Informação do Header.............................................................................................. 24
Tamanho do registro ................................................................................................ 24
Arquivo .................................................................................................................... 25
Pedir Nome do Arquivo na Impressão..................................................................... 25
Nome........................................................................................................................ 26
Condição para Impressão do Registro ..................................................................... 26
Marcar Registros Processados ................................................................................. 26
Arquivo Gerado pelo PCS ....................................................................................... 27
Usa Função............................................................................................................... 27
Funções para interpretar comandos do Spool / LPM............................................. 27
Detalhes.................................................................................................................... 28
Tem Registro Detalhe .............................................................................................. 28
Usa Banco de Dados ODBC .................................................................................... 29
Campos de Entrada .................................................................................................... 33
Campo como chave de recuperação......................................................................... 37
Importação e Exportação de Campos de Entrada .................................................... 37
Configuração do Formulário ..................................................................................... 41
Configuração do Documento ..................................................................................... 43
Dimensões de Documentos...................................................................................... 43
Tamanho .................................................................................................................. 43
5
6. Índice
Superior.................................................................................................................... 43
Esquerda................................................................................................................... 43
Não utilizar as margens do Driver da impressora.................................................... 43
Número de Diferentes Talões na Mesma Página ................................................... 45
Numeração do Documento ...................................................................................... 48
Múltiplos Documentos............................................................................................. 49
Documento Principal ............................................................................................. 50
Documento Continuação........................................................................................ 50
Seleção de bandejas (Origem do papel)................................................................. 54
Documento Separador (Grampeamento e Deslocamento de bandeja)................... 55
Capa Inicial e Capa Final....................................................................................... 56
Campos de Saída......................................................................................................... 57
Conteúdo .................................................................................................................. 58
Mudança de fonte de caracteres dentro de um Campo de Saída............................ 58
Máscara .................................................................................................................... 59
Alinhamento............................................................................................................. 60
Orientação do Campo .............................................................................................. 60
Campo de Índice e Justificar com............................................................................ 60
Usar como Chave de Recuperação .......................................................................... 60
Campo MICR........................................................................................................... 60
Definição de Fontes Condicionais ........................................................................... 61
Campos de Texto ........................................................................................................ 63
Espaço Entre Linhas ................................................................................................ 64
Orientação do Campo .............................................................................................. 66
Editor do Campo de Texto....................................................................................... 67
Importar Texto ....................................................................................................... 67
LF Automático Antes do Campo de Saída ............................................................ 68
Logos dentro de Campo Texto................................................................................. 69
Logos - deslocamento vertical ............................................................................... 69
Campos de Detalhes.................................................................................................... 71
Borda........................................................................................................................ 72
Expressão para quebra ............................................................................................. 73
Condição para Impressão de Detalhe....................................................................... 74
Altura Detalhe.......................................................................................................... 74
6
7. Índice
Suporte a saltos de canal .......................................................................................... 74
Cabeçalho Visível .................................................................................................... 75
Rodapé Visível......................................................................................................... 75
Sumário Visível ....................................................................................................... 75
Documento de Continuação..................................................................................... 77
Bloco de Endereçamento............................................................................................ 79
Condição .................................................................................................................. 81
Campos .................................................................................................................... 82
Códigos de Barras....................................................................................................... 85
Conteúdo .................................................................................................................. 86
Largura..................................................................................................................... 87
Altura ....................................................................................................................... 87
Número de Caracteres.............................................................................................. 87
Usa Fonte TT ........................................................................................................... 87
Desenhando.............................................................................................................. 87
Usa Fonte BMP........................................................................................................ 87
Nome da Fonte......................................................................................................... 88
Tipo de Código ........................................................................................................ 88
Orientação do Campo .............................................................................................. 88
Impressoras IPDS, AFP e Metacode........................................................................ 88
HRI (Human Readable Interpretation)................................................................... 90
Usa CMC7 ............................................................................................................... 90
Sobre Códigos de Barras.......................................................................................... 91
Regras .................................................................................................................... 91
Fontes de Códigos de Barras True Type................................................................ 91
Códigos Bidimensionais ............................................................................................. 93
Logotipos ..................................................................................................................... 95
Ocorrência................................................................................................................ 96
Pos X........................................................................................................................ 96
Pos Y........................................................................................................................ 96
Unidade .................................................................................................................... 96
Ampliação ................................................................................................................ 96
Tipo de Compressão ................................................................................................ 97
Carregamento de Logos na memória da impressora................................................ 97
7
8. Índice
Ambiente AFP e IPDS ............................................................................................. 97
Ambiente PCL ......................................................................................................... 98
Ambiente Postscript ................................................................................................. 98
Ambiente Metacode ................................................................................................. 99
Tipo de ajuste do tamanho da imagem .................................................................... 99
Resolução................................................................................................................. 99
Desenho de Retângulos, Elipses e Linhas ............................................................... 101
Retângulos.............................................................................................................. 101
Elipses .................................................................................................................... 102
Linhas..................................................................................................................... 102
Gráficos de barras, pizza e linhas ........................................................................... 103
Escala no eixo vertical ........................................................................................... 105
Variáveis de Usuário ................................................................................................ 107
Nome...................................................................................................................... 107
Expressão de Atualização ...................................................................................... 107
Ordem de Atualização............................................................................................ 107
Funções do Usuário .................................................................................................. 109
Número de Parâmetros........................................................................................... 109
Definir DLL ........................................................................................................... 109
Conjunto básico de Funções do Usuário................................................................ 110
WMOD10 (parâmetro)......................................................................................... 110
WMOD11 (parâmetro)......................................................................................... 110
DVM11 (parâmetro) ............................................................................................ 110
ADDSTR (operando1, operando2, tamanho) ...................................................... 110
SUBSTR (operando1, operando2, tamanho) ....................................................... 111
GETSTR (cadeia, posição, tamanho)................................................................... 111
CHR (código ASCII) ........................................................................................... 111
ASC (caractere).................................................................................................... 111
LTRIMM (cadeia)................................................................................................ 111
RTRIMM (cadeia) ............................................................................................... 111
Conjunto de Funções do Usuário contidas na Biblioteca Sirius32.dll................... 111
ALINHA(cad, tipo).............................................................................................. 111
BAR128B(cad, sincr, fnct1) ................................................................................ 112
BARC128TT(cad, sincr, fnct1)............................................................................ 112
8
11. Índice
Ocorrência.............................................................................................................. 136
Criar Overlay ......................................................................................................... 136
Posição ................................................................................................................... 137
Adicionar................................................................................................................ 137
Resolução............................................................................................................... 138
Comentários sobre impressão de imagens ............................................................. 138
Mensagens do Usuário.............................................................................................. 141
Nome...................................................................................................................... 141
Tipo ........................................................................................................................ 141
Texto da Mensagem............................................................................................... 142
Ambiente de impressão ............................................................................................ 143
Sistema de Impressão............................................................................................. 143
Diretórios do Fwfonts.ini e Fontes....................................................................... 144
Configuração de Impressoras................................................................................. 145
Conceitos Tandem / Twin.................................................................................... 147
Carga de Recursos.................................................................................................. 148
Editor de Expressão.................................................................................................. 149
Expressão Condicional (Expr. Cond.) ................................................................... 150
Expressão Aritmética ( Expr. Arit.) ...................................................................... 151
Variáveis do Sistema.............................................................................................. 152
Exemplos de uso do Editor de Expressões ............................................................ 154
Operações de Edição ................................................................................................ 157
Selecionar Objetos ................................................................................................. 157
Alinhamento de campo .......................................................................................... 159
Alinhamento Vertical........................................................................................... 159
Alinhamento Horizontal....................................................................................... 159
Opções........................................................................................................................ 161
Zoom na Largura.................................................................................................... 161
Zoom na Página ..................................................................................................... 161
Sem Zoom.............................................................................................................. 161
Campos Preenchidos.............................................................................................. 161
Visualizar Formulário ............................................................................................ 161
Visualizar Documento ........................................................................................... 161
Mesclar Documento com Dados............................................................................ 161
11
12. Índice
Mesclar Página com Dados.................................................................................... 162
Réguas & Grade..................................................................................................... 163
Mostrar Imagem..................................................................................................... 163
Esconder Imagem................................................................................................... 164
Seleção de Documento........................................................................................... 164
Administração de Senhas ......................................................................................... 165
Alterar Senha do Usuário....................................................................................... 167
Excluir Usuário ...................................................................................................... 167
Operações com Arquivos ......................................................................................... 169
Novo, Abrir, Salvar, Salvar Como......................................................................... 169
Imprimir Prova....................................................................................................... 169
Imprime em Arquivo.............................................................................................. 170
Mostra na Página.................................................................................................... 170
Imprimir Aplicação................................................................................................ 170
Imprimir Relatório ................................................................................................. 170
Imprimir Spool IPDS ............................................................................................. 170
Fila de Impressão ................................................................................................... 170
Gerar Arquivo Imagem .......................................................................................... 171
Gerar Mensagens Internet ...................................................................................... 172
Impressão da Aplicação ........................................................................................... 173
Para Administrador, Programador e Supervisor .................................................... 173
Todo o Arquivo de Dados.................................................................................... 173
Páginas Selecionadas ........................................................................................... 173
Registros Selecionados ........................................................................................ 174
Arquivo com páginas selecionadas...................................................................... 174
Arquivo com registros selecionados .................................................................... 174
Truncamento de campos ...................................................................................... 174
Impressão AFP..................................................................................................... 174
Imprimir em Arquivo........................................................................................... 175
Inserir marca de caderno para o Impress ............................................................. 175
Interrupção de Impressão..................................................................................... 176
Para Operador ........................................................................................................ 176
Uso do FAX no Format.......................................................................................... 176
Arquivo de LOG. ................................................................................................... 177
12
13. Índice
Gerar Arquivo Imagem (GIF, JPG, PDF).............................................................. 179
Imprimindo a imagem............................................................................................ 179
Visualizando e imprimindo o arquivo PDF ........................................................... 182
Gerar Mensagem Internet ....................................................................................... 183
Mensagens de Erro e Advertência........................................................................... 185
Limites do Format.................................................................................................. 189
Tutorial ...................................................................................................................... 191
Font Converter.......................................................................................................... 201
Formatos de fontes gerados pelo Font Converter: ................................................. 201
Generate BMP........................................................................................................ 203
Cadastramento de fontes Xerox no FWFONTS.INI.............................................. 203
Cadastramento de fonte código de barras 39 e 2/5 ................................................ 204
Glossário .................................................................................................................... 207
Apêndice A - Sistemas de Impressão ...................................................................... 215
Impressoras Destino para o Format Printing System............................................. 215
Modelos dos produtos ............................................................................................ 215
Controle de execução............................................................................................. 216
Apêndice B - Sirius JSL para impressoras Xerox On Line .................................. 219
Apêndice C - Sirius JSL para impressoras Xerox Off Line ................................. 225
Apêndice D - Como executar o Format em “background”................................... 227
Lista de parâmetros ................................................................................................ 227
/a ou –a (Usuário e senha)...................................................................................... 227
/b ou –b (Operação em modo batch)...................................................................... 227
/c ou – c (Cancela impressão) ................................................................................ 227
/d ou –d (Nome do arquivo de dados).................................................................... 227
/e ou –e (Extensão do arquivo de saída) ................................................................ 227
/f ou –f (Carga de fontes) ....................................................................................... 228
/g ou –g (Gerar arquivos de imagens).................................................................... 228
/i ou –i (Intervalo de impressão) ............................................................................ 229
/j ou –j (Polegada).................................................................................................. 229
/k ou –k (Chave de pesquisa) ................................................................................. 229
/l ou -l (Lotes) ....................................................................................................... 230
/m ou –m (Arquivos Xerox para Mainframe) ........................................................ 230
/n ou –n (Nome da aplicação) ................................................................................ 230
13
14. Índice
/o ou –o (Carga de overlays).................................................................................. 230
/p ou –p (Nome da impressora).............................................................................. 230
/q ou –q (Caminho do Fwfonts.ini)........................................................................ 230
/r ou –r (Número da página a ser visualizada) ....................................................... 230
/s ou –s (Saída da impressão para arquivo)............................................................ 231
/t ou –t (Tag Logical Element)............................................................................... 231
/trace ou –trace (Registra no arquivo de Log) ....................................................... 231
/u ou –u (Envia mensagem para GerSpool) ........................................................... 231
/v ou –v (Geração de e-mails)................................................................................ 231
/x ou –x (Driver Windows - PCL5, Postscript e Outros)....................................... 231
/ypp ou –ypp (Contabilização de páginas geradas)................................................ 232
/z ou –z (Seleção de bandejas) ............................................................................... 232
Apêndice E - Format em ambiente UNIX .............................................................. 235
Apêndice F - Format para sistema Twin ............................................................... 237
14
15. Introdução
Introdução
O Format é uma ferramenta desenvolvida para simplificar a tarefa de formatação e
impressão de dados e imagens fixas ou variáveis. Ele possibilita que o usuário crie e
imprima documentos em impressoras pequenas ou grandes, de impacto ou não, em
configurações Single, Tandem ou Twin, utilizando Overlays, Códigos de Barras,
Impressão MICR, etc.
O Format permite ao usuário:
• Definir os dados de entrada;
• Configurar formulários;
• Configurar documentos, suas dimensões e posição no formulário;
• Compor o documento através da definição de Campos de Saída, Campos de Texto,
Logotipos, Códigos de Barras, Logotipos, Gráficos de Barra, de Linha e de Pizza,
Linhas, Retângulos e Imagens;
• Definir o Sistema de Impressão (impressora);
• Imprimir Provas e Relatórios dos documentos desenvolvidos;
• Imprimir a aplicação, sendo responsável pelo processamento dos dados de entrada,
sua leitura e formatação, de acordo com as definições feitas anteriormente pelo
usuário, e pelo controle da impressão de acordo com o sistema escolhido;
• Gerar Arquivo Imagem nos formatos GIF e PDF
• Gerar Mensagem Internet.
A capacidade de imprimir Logotipos e Overlays depende do Sistema de Impressão
onde a aplicação será impressa.
A interface gráfica e as opções de mesclar e visualizar a aplicação com os dados reais
permite que o usuário crie os documentos interativamente, de uma forma WYSIWYG,
ganhando tempo e evitando o uso de impressoras durante o desenvolvimento da
aplicação.
O Format é fornecido com o software Font Converter, que converte fontes de
caracteres para um formato de fontes compatível com o Format.
O Format permite imprimir documentos diretamente numa impressora, quando
15
16. Introdução
executado em ambiente Windows NT / 2000 e usando os drivers desenvolvidos pela
Sirius (IPDS e Metacode) em conjunto com interfaces Bus & Tag Canal IBM, assim
como pode ser usada em ambientes Windows 98 / XP / Me gerando saídas em disco
ou diretamente para impressoras cujos drivers foram instalados nesses ambientes.
Em caso de qualquer dúvida ou comentários sobre o manual, entre em contato com a
Sirius Sistemas Digitais Ltda.:
E-mail: sirius@siriusnet.com.br
Site: www.siriusnet.com.br
16
17. Instalação
Instalação
O Format é fornecido em CD.
São fornecidos, ainda, o Manual do Usuário e um Conector de Segurança para o
controle das cópias licenciadas.
O Conector deve ser instalado na porta paralela ou USB do PC. Se uma impressora for
conectada na porta paralela esta não sofrerá interferências por causa do conector.
Instalação do Format
- Insira o disco do Format na unidade de disquete ou CD.
- Na barra de tarefas selecione a opção Iniciar | Executar para executar o setup
Instalação do Driver do Conector de Segurança – Conector Local
Os produtos da Sirius são protegidos utilizando um conector de proteção que possui
informações relativas à cópia de software licenciada.
Mensagens de erro aparecem na tela conforme a inconsistência entre os dados
contidos no conector e as funções que o usuário deseja executar com o Format.
O Format atualiza no conector a data e hora da última execução sempre que a data da
última execução for menor que a data atual do sistema. Para a hora o Format tem uma
tolerância de 2 horas, ou seja, só atualiza o conector a cada 2 horas num mesmo dia.
Para o Format ser executado normalmente as seguintes situações tem que ser
verdadeiras:
- a data atual do sistema tem que ser menor que a data de vencimento (final) no
conector.
- a data e hora da última execução do Format têm que ser menor que a data e
hora atual do sistema (com uma tolerância de 2 horas)
Exemplos de funções protegidas são:
- Cópia licenciada para o desenvolvimento de aplicações para impressoras Xerox
Metacode. Esta cópia permite somente desenvolver aplicações e salva-las em disco
para impressoras Xerox Metacode.
17
18. Instalação
- Cópia licenciada para geração de arquivo spool de impressão para impressoras
AFP. Esta cópia permite que usuário possa executar uma aplicação e dar saída para
arquivo dos documentos formatados com comando AFP.
- Cópia licenciada para controlar o processo de impressão usando impressoras IPDS.
Esta cópia permite somente executar uma aplicação e dar saída para a impressora
IPDS configurada.
Em ambiente Windows 9X / Me
Nestes ambientes não é necessário instalar o driver do conector de segurança.
Em ambiente Windows NT / 2000 / XP
A instalação do sistema de proteção deve ser feita após a instalação do Format.
Para isso, instale o Driver do Conector de Segurança da seguinte forma:
- Na Barra de Tarefas selecione a opção Iniciar | Executar.
- No diálogo digite <pasta do Format >Sentinel<instalador Sentinel>.exe e
responda às perguntas que forem aparecendo.Instalação do Format em ambiente
de rede - Um conector para vários usuários.
Instalação do Driver do Conector de Segurança – Conector de Rede (Um conector para
vários usuários)
A máquina onde será instalado o conector de segurança deverá obrigatoriamente ter
uma das versões do Windows: NT, 2000, 2003 ou XP.
Os procedimentos descritos abaixo deverão ser feitos somente na máquina onde o
conector de rede for instalado.
1- Instalar o Driver do Conector de Segurança, como descrito acima no item
Instalação do Conector de Segurança – conector local.
2 - Instalar o serviço Sentinel Protection Server.
− Na Barra de Tarefas selecione a opção Iniciar | Executar.
− No diálogo digite <pasta do Format >Sentinelloadserv.exe
− Confirme se o caminho indicado em Executable Path corresponde ao
spnsrvnt.exe.
18
19. Instalação
− Clique em Install Service.
Em todas as instalações do Format que estiverem usando o conector de rede, o arquivo
Cw1109rede.dll deve ser copiado sobre o arquivo Cw1109.dll. Esses arquivos residem
na pasta <pasta do Format>Sys.
Instalação do Driver da Placa Barr em ambiente Windows NT
Após instalar a placa Barr no slot PCI, crie um diretório com o nome Barr.
Copie o conteúdo do disquete do driver da placa para este diretório.
Na Barra de Tarefas selecione a opção Iniciar | Executar.
No diálogo, digite o caminho do diretório criado, incluindo i386chanOcfg.exe. Por
exemplo: C:Barri386chanOcfg.exe
Escolha a opção Configuration e em Driver Image Path selecione Browse para
encontrar o arquivo Chanout.sys que está no sub-diretório i386. A seguir, selecione a
opção Install. Caso a instalação termine corretamente, a mensagem Service Installed
aparecerá em Status.
Para verificar se há comunicação com a impressora, coloque-a em linha (On Line ou
Ready) e selecione a opção Find Devices. No diálogo de instalação do driver da Barr,
clique em Find. Em Device será informado o endereço das impressoras detectadas e
em Status será mostrada a quantidade de impressoras detectadas.
Instalação do FontConverter
O FontConverter é instalado juntamente com o Format.
19
20.
21. Área de Trabalho
Área de Trabalho
Ao executar o Format, será exibida a área de trabalho. A área de trabalho representa a
configuração do documento. As linhas pontilhadas representam os limites (dimensões)
do documento.
Caso o usuário clique duas vezes em uma área vazia, um retângulo aparecerá,
representando um novo Campo de Saída. As dimensões e posição do retângulo
representam os parâmetros do campo, e são mostrados na linha de estado que fica na
parte inferior da tela.
O retângulo pode ser arrastado com o cursor, para mudar a posição. Se as laterais do
retângulo forem arrastadas para os lados, o tamanho do campo será alterado. A linha
de estado mostra os detalhes sobre a geometria do retângulo. Clicando duas vezes
sobre o retângulo será ativado o diálogo de definição do Campo de Saída.
Quando um objeto estiver selecionado, a cada <TAB> digitado, a seleção irá para o
próximo objeto do mesmo tipo no documento ou no detalhe.
Quando um objeto estiver selecionado e um <ENTER> ou <ESPAÇO> for digitado
será automaticamente aberto o diálogo de definição do objeto sem que seja necessário
um duplo clique.
A barra de ferramentas mostrada no topo da tela contém ícones que são atalhos para
alguns dos itens de menu mais utilizados.
21
22. Área de Trabalho
O FontConverter, utilitário de conversão de fontes para diversos formatos, pode ser
chamado de dentro do Format, especificando o seu caminho. A aplicação será
temporariamente fechada para permitir a atualização do FWFONTS.INI.
Se a opção de menu Opções | Campos Preenchidos for selecionada, a forma de
representação dos Campos de Saída muda de retângulo para uma cadeia de caracteres
utilizando a fonte de caractere definida pelo usuário.
A opção de menu Opções | Mostrar Imagem pode ser utilizada para visualizar um
arquivo de imagem na área de trabalho, sendo de grande valia para posicionar dados
variáveis (Campos de Saída) no documento. Para que a imagem não apareça use a
opção de menu Opções | Esconder Imagem.
Se a opção de menu Opções | Zoom na Página for selecionada, as imagens do
documento e seus objetos serão redimensionados para que todo o documento caiba na
tela.
Se a opção de menu Opções | Sem Zoom for selecionada, o documento será mostrado
em seu tamanho real.
Campos de Texto, Logotipos, Códigos de Barra, Linhas e Retângulos também são
representados na área de trabalho, e suas posição e dimensões podem ser modificadas
com o cursor como descrito para o Campo de Saída.
A opção de Zoom permite visualizar o documento no tamanho desejado através do
percentual definido pelo usuário assim como mostrar o documento encaixando a
largura do documento na tela ou o documento inteiro na tela.
22
23. Arquivo de Dados
Arquivo de Dados
Este diálogo é utilizado para descrever as características do arquivo de dados de
entrada para a aplicação. Ele é acessado através da opção de menu Layout | Arquivo
de Dados ou a partir do diálogo Definição | Campos de Entrada.
O Format roda em ambiente Windows ou Unix / Linux (vide Apêndice E) e como tal
pode acessar dados de outros sistemas ou plataformas de sistemas operacionais que
coloquem seus arquivos disponíveis para seu uso pela aplicação desenvolvida usando
o Format.
23
24. Arquivo de Dados
Código
Selecione ASCII ou EBCDIC, dependendo da codificação usada no arquivo de
entrada.
Informação do Header
Selecione a opção Usa Header caso o arquivo de dados possua um registro de header.
Nesse caso, o conteúdo desse registro será ignorado pelo sistema. Se a opção Usa
Header for selecionada, o tamanho do registro de header deve ser informado e não
pode exceder 65.500 bytes.
Tamanho do registro
O Format trabalha com registros de tamanho fixo ou variável com delimitador. Os
valores válidos são: de 1 a 65.500 bytes. Todos os registros do arquivo de dados
devem ter o mesmo tamanho quando o arquivo for de tamanho fixo (sem delimitador).
Quando o arquivo for de tamanho variável, obrigatoriamente os campos deverão ser
delimitados por caracteres especiais tais como <TAB> ou <;>.
Cada registro de tamanho variável deverá ser finalizado também por um delimitador
ou então, deve ser informada a quantidade de delimitadores necessários para
determinar o fim de um registro.
Considerando que o Format transforma registros de tamanho variável em registros de
tamanho fixo para uso interno, o tamanho do registro especificado pelo usuário,
representa o tamanho máximo alocado pelo Format para o registro formatado. Este
registro formatado será composto pela soma dos Campos de Entrada levando em
consideração o tamanho especificado para cada campo e a sua posição inicial.
Este mesmo conceito se aplica para o tamanho do registro Detalhe.
Cada registro de tamanho variável deverá ser finalizado também por um delimitador
ou então, deve ser informada a quantidade de delimitadores necessários para
determinar o fim de um registro.
24
25. Arquivo de Dados
O usuário poderá definir os caracteres especiais a serem usados como delimitadores
digitando diretamente o caractere ou escrevendo o seu código hexadecimal no formato
0xNN onde NN é o número hexadecimal correspondente ao caractere, por exemplo
0x0D para "Carriage Return".
Arquivo
Utilizando este diálogo, o usuário pode informar se o nome do arquivo de entrada será
definido durante a impressão ou durante o desenvolvimento da aplicação. Outra
característica implementada no Format é a possibilidade de evitar o processamento de
um arquivo de dados mais de uma vez por pessoas não autorizadas.. Esta característica
opcional é selecionada nesta tela de diálogo.
Pedir Nome do Arquivo na Impressão
Usado apenas para arquivos em disco. Esta opção permite que o Operador escolha o
nome do arquivo de dados no início da impressão da aplicação. Caso essa opção não
seja selecionada, o arquivo precisa ser fornecido na opção Nome.
25
26. Arquivo de Dados
Nome
Informa, para arquivos em disco, o nome do arquivo de dados. Este nome tem que ser
um nome de arquivo válido.
Procurar
Este botão permite procurar, nos diretórios do disco, o arquivo de dados. Selecionando
o botão OK desta caixa de diálogo, o nome do arquivo selecionado será copiado para
o campo Nome.
Condição para Impressão do Registro
Essa característica é oferecida ao usuário para evitar que certos registros da base de
dados sejam usados para formatar documentos. Somente os registros validados pela
expressão condicional serão usados para a composição dos documentos e sua
respectiva impressão.
Marcar Registros Processados
Essa característica é oferecida ao usuário para evitar que se processe novamente um
registro, seja por erro de operação, ou de sistema.
Durante a impressão, quando o Format detecta um registro como já processado, uma
mensagem de aviso é exibida e a impressão é interrompida, esperando por uma ação
do usuário. Através da senha do Administrador, o sistema permite que o registro
marcado seja novamente processado.
Observação: Um registro é considerado processado quando já foi lido pela aplicação,
utilizado para formatar os dados variáveis e imagens gráficas e o documento enviado
para a impressora.
As duas situações abaixo podem ocorrer:
Documento é impresso no papel.
Documento formatado eletronicamente é enviado para a impressora e por qualquer
razão não foi impresso (erro na impressora depois de ter recebido os dados, por
exemplo).
Devido a essas diferentes situações em que um registro processado pode ter sido
marcado, recomenda-se que o Administrador do sistema avalie cada situação para
26
27. Arquivo de Dados
autorizar ou não o reprocessamento de um registro marcado.
Arquivo Gerado pelo PCS
Quando a aplicação desenvolvida com o Format for usada em conjunto com o
software BICOS gerenciador do sistema Plastic Card System – PCS da Böwe, deverá
ser escolhida esta opção, pois, o tratamento dos dados é particular para esta
configuração.
Neste caso a diferença no tratamento dos arquivos baseia-se no fato de que o fim do
arquivo é indicado por um tipo especial de registro cujas primeiras 10 posições são
espaços e seu tamanho deve ser igual ao definido na aplicação. Enquanto não aparecer
esse registro de fim de arquivo, o Format fica aguardando dados.
Usa Função
Caso seja necessário fazer algum tipo de pré-processamento da base de dados antes do
início da execução da aplicação desenvolvida com o Format, deverá ser definida essa
função nesta seleção.
Essa função deve ser desenvolvida em linguagem C ou qualquer outra linguagem que
permita gerar uma DLL. A função receberá dois parâmetros que são:
- o nome do arquivo de entrada (arquivo a ser processado pela DLL) e
- o nome do arquivo de saída da função que será usado como entrada do Format.
Essa função será executada na visualização ou inicialização do processo de impressão.
Para o desenvolvimento da DLL deverá ser respeitado o seguinte padrão:
- Parâmetros do tipo ponteiro de CHAR (Point of Char)
- Deverá retornar um ponteiro de CHAR diferente de nulo
- O nome da função deverá sempre ser em letras maiúsculas
Funções para interpretar comandos do Spool / LPM
Um exemplo desta característica do Format é a possibilidade de utilizar funções para
interpretar comandos de controle de formatação de documentos do Spool / LPM
utilizado por software específico para sistemas Unisys e impressoras Xerox na
linguagem LCDS (Line Conditionned Data Stream).
27
28. Arquivo de Dados
Estas funções permitem que o Format processe de forma nativa, arquivos desse padrão
e assim converter, com opção de reformatação, documentos contidos em arquivos
destinados originariamente para sistemas que usam o Spool / LPM e poder ser
impressos em qualquer plataforma de impressão.
Detalhes
Para a utilização desta opção, a base de dados deverá respeitar as características
descritas abaixo:
• Deverão ser gerados dois tipos de Registros. O Registro Mestre e o(s) Registro(s)
de Detalhes
• Registro de Detalhes é aquele que contém as informações necessárias para a
composição de cada linha de Detalhes. Este registro poderá conter campos na
formatados ou a própria linha já formatada. O seu tamanho poderá ou não ser o
mesmo do Registro Mestre
• Todos os Registros Mestres e os Registros de Detalhes deverão ter o mesmo
tamanho entre si
O Registro Mestre contém todas as informações básicas como nome, endereço, etc. O
Registro Mestre poderá ou não conter Detalhes, informando que o Registro de
Detalhes deverá estar localizado após o Registro Mestre.
Tem Registro Detalhe
Se esta opção for marcada deverão ser definidos os seguintes campos:
Tamanho Registro Detalhe
Deverá ser definida a quantidade de bytes (caracteres) de cada Detalhe. Ao
serem definidos os Campos de Registro Detalhe, o Format tratará todos com o
mesmo tamanho e se os Registros Detalhes não possuírem o mesmo tamanho
resultará em erros na visualização e impressão da aplicação, exceto quando o
tipo do registro for variável com delimitadores.
Quantidade de Detalhes por Registro Mestre
Permite definir a quantidade de Registros de Detalhes correspondentes a cada Registro
Mestre . Esta quantidade pode ser um valor numérico constante ou um Campo de
28
29. Arquivo de Dados
Entrada do Registro Mestre que contenha essa informação.
É importante salientar que, caso tenha sido usada uma expressão para a definição desta
quantidade, o Format processará essa expressão apenas na opção de Mesclar Página
com Dados.
Para que estes campos sejam definidos com mais facilidade, recomendamos os
seguintes passos:
- Selecione o Arquivo de Dados
-Crie, na definição de Campos de Entrada, um campo que contenha a
quantidade de Detalhes
- Acesse novamente a janela de definição do Arquivo de Dados e defina o
“Tamanho do Registro de Detalhes”, e na definição da “Quantidade de
Detalhes por Registro Mestre”, utilize o Campo de Entrada gerado que contém
o número de Detalhes
Usa Banco de Dados ODBC
O Format a partir da versão 8.03 suporta o acesso a banco de dados usando os drivers
ODBC (Open Database Connectivity) que são instalados junto com o Windows. Caso
o usuário tenha um banco de dados diferente, por exemplo, MySQL, este banco
deverá instalar um driver ODBC no momento de sua implantação no ambiente
Windows, o que permitirá ao Format, ter acesso às suas bases de dados. Caso
contrário, fica inviável ao Format acessar esses dados pelo desconhecimento da
estrutura de armazenamento dos mesmos.
A interação entre o Format e o driver ODBC pode ser feita a partir da definição de um
DSN (Data Source Name) o que é feito através do painel de Controle | ODBC data
Source (32 bits). A partir desse DSN é possível definir o nome do arquivo que conterá
a tabela a ser acessada e o driver ODBC que saberá manipulá-la.
Cada aplicação desenvolvida usando o Format poderá acessar uma só tabela dentro
de um determinado banco de dados. Caso o usuário desejar acessar mais de uma
tabela, deverá criar uma "View" que faça o "Join" das tabelas a serem consultadas.
Usando o acesso a banco de dados, é possível criar Campos de Entrada novos e é
possível eliminar Campos de Entrada, como se estivesse eliminando a visualização de
certas colunas da tabela.
29
30. Arquivo de Dados
Existem os conceitos de tamanho de campo e posição. Ao importar os campos da base
de dados para a criação dos Campos de Entrada, o Format usará como padrão para o
tamanho de cada Campo o valor definido na tabela associada ao banco de dados.
Cabe ao usuário manter ou alterar esses valores dentro da aplicação se for do seu
interesse inclusive o valor total do registro.
Dependendo do DSN escolhido pode ser necessário especificar o arquivo de dados
como é o caso apresentado na figura acima.
Caso o banco de dados tenha proteção de acesso (Usuário / Senha), estas informações
poderão ser fornecidas através desta janela ou serem solicitadas no momento que o
Format abrir o banco de dados.
Notas:
1- Na atual versão do Format, só é possível acessar uma única tabela por vez. Desta
forma as facilidades do Format no que diz respeito das aplicações que usam Campo
de Detalhe não poderão ser desenvolvidas. Somente registros Mestres são suportados
usando ODBC.
Caso o usuário deseje usar os dois recursos, deverá pré-processar as duas tabelas e
gerar uma base de dados do tipo Mestre e Detalhes compatível com o Format.
2- Quando se usa o Format acessando um banco de dados através do driver ODBC
associado instalado no Windows e para o caso de importar dados de uma planilha
30
31. Arquivo de Dados
Excel, é importante observar que os valores associados a um campo, deverão ter
sempre a mesma categoria, isto é, se o valor de um campo for definido no primeiro
registro como numérico, nos demais registros ele deverá ser numérico, caso
contrário, o driver ODBC ignorará o conteúdo e retornará para o Format, um valor
vazio.
Com exemplo, podemos mencionar o caso de uma planilha que continha no primeiro
registro o valor "03", o qual era interpretado como cadeia de caracteres e mais a
frente este mesmo campo continha o valor "20", que era interpretado como numérico,
neste caso o driver não apresentava para o Format o valor "20".
Para evitar esse comportamento anômalo do driver, se recomenda:
- usar o caractere "plica" antes de cada campo para que o driver o trate como cadeia
de caracteres ou
- colocar um zero antes de cada campo para que o driver o trate como cadeia de
caracteres ou
- tirar o zero à esquerda dos campos, neste caso todos serão tratados como numéricos
ou
- exportar a planilha como texto separado por TAB e fazer a aplicação no Format
usando registros de tamanho variável.
31
32.
33. Campos de Entrada
Campos de Entrada
Este diálogo é utilizado para descrever os campos do registro de dados a serem
utilizados na aplicação, ele permite definir um nome para cada campo da base de
dados. Este diálogo pode ser acessado através da opção de menu Definição | Campos
de Entrada.
Esta janela permite:
Visualizar o conteúdo dos registros da base de dados,
Criar novos campos de entrada clicando no botão Novo
Alterar algumas das características de um campo previamente criado
Excluir um campo existente
Definir um Campo como Chave de Recuperação
Copiar campos para a área de trabalho do Windows e
33
34. Campos de Entrada
Colar os mesmos, por exemplo, numa outra aplicação.
Mudar de base de dados clicando sobre a área sensível onde aparece o nome da
base de dados
Alterar o tamanho do registro da base de dados
Importar / Exportar Campos a partir de um arquivo
Importar / Exportar Campos de um banco de dados ODBC
Fechar a janela
Obs.: É importante salientar que, caso tenha sido usada uma expressão para a
definição da quantidade de detalhes para um arquivo de dados com registro Mestre e
Detalhes, o Format não processará essa expressão na fase de visualização dos dados
na tela apresentada acima e por esse motivo os dados não serão corretamente
apresentados.
O Format permite múltiplas definições dos Registros de Entrada que podem ser
visualizadas separadamente. Essa opção é útil para visualizar melhor a definição de
registros com layouts diferentes. Cada campo possui uma informação correspondendo
a “grupo”, campos do mesmo grupo pertencem a um mesmo layout do registro.
Clicando com o botão direito do mouse, é permitido criar um novo grupo, redefinir o
grupo de campos selecionados, visualizar apenas os campos de um determinado grupo
ou visualizar os campos de todos os grupos.
O botão "ir para registro xxx" na tela de definição dos Campos de Entrada e Campos
de Registro Detalhe permite acessar diretamente um registro especificado sem precisar
percorrer todos os registros seqüencialmente.
Para arquivos com campos de entrada variáveis em tamanho, a janela de Campos de
Entrada é a seguinte:
34
35. Campos de Entrada
Novo campo de entrada
Para criar um campo, basta selecionar como o mouse dentro do registro de dados a
seqüência de caracteres desejada e clicar no botão Novo. Neste momento aparecerá
uma janela que permitira definir o nome do campo. Cada nome deve ser único.
O nome necessita obrigatoriamente começar com um caractere alfabético (A-Z ou a-z)
e ser formado apenas por caracteres alfanuméricos (A-Z, a-z, ou 0-9). O Format não
diferencia letras maiúsculas e minúsculas em relação a nomes. O nome que aparece na
caixa de edição é o campo selecionado.
O tamanho máximo para o nome é de 12 caracteres.
Ao criar um novo campo de entrada, as posições dos campos seguintes, já existentes,
podem ser automaticamente deslocadas. Para isso, deve ser selecionada a opção
Deslocar Campos Seguintes.
Para campos de tamanho variável, existe um índice que indica a sua posição dentro do
registro. Colocando o cursor no campo e clicando a opção de campo Novo, o Format
apresenta a janela abaixo indicando, como Índice, o valor da sua posição relativa
dentro do registro.
35
36. Campos de Entrada
O tamanho do campo para campos com delimitador deverá ser escolhido pelo usuário,
indicando o seu máximo valor dentro da base de dados.
Posição do campo dentro registro de dados
Indica a posição do campo selecionado em relação ao registro de dados. A posição
inicial é 1. Se a posição indicar um valor maior que o tamanho do registro de dados, o
Format avisa ao usuário e permite que ele modifique o tamanho do registro através da
área sensível na linha de mensagens.
Tamanho do campo
Indica o tamanho, em caracteres, do campo selecionado.
Mais de um campo pode fazer referência a uma mesma parte do registro de dados,
normalmente com tamanhos diferentes para permitir acessos diferentes a um mesmo
dado na aplicação.
Alterar um campo existente
36
37. Campos de Entrada
Altera a definição do campo selecionado. Podem ser alterados a posição e o tamanho.
O nome do campo não pode ser alterado. Para isto é necessário excluir o campo e criá-
lo novamente com o novo nome.
Este diálogo também permite que os campos seguintes sejam deslocados, isto é,
quando o tamanho de um campo é alterado, o usuário tem a opção de deslocar a
posição dos campos seguintes.
Ordenação dos campos
Os campos de entrada podem ser ordenados por grupo, nome, posição ou tamanho, em
ordem crescente ou decrescente.
Campo como chave de recuperação
Indica que o campo selecionado será usado pelo Format como chave de recuperação
na impressão de registros selecionados.
Deslocar campos seguintes
Nos diálogos Novo, Alterar, ou Excluir, se esta opção estiver selecionada, o início dos
campos seguintes será automaticamente deslocada de acordo com o tamanho do
campo inserido, alterado ou excluído.
Importação e Exportação de Campos de Entrada
O Format permite a importação e exportação de Campos de Entrada. A descrição dos
campos de entrada deve estar contida em um arquivo com extensão ".FIF" e com o
seguinte formato : nome;posição;tamanho
Ex.:
nome;1;20
endereço;21;30
Quando o usuário desejar importar campos definidos num arquivo tipo FIF ou
exportar os já definidos, basta entrar na tela da Definição de Campos de Entrada e
através dos botões específicos localizados na parte superior da janela escolher a
opção.
37
38. Campos de Entrada
Esta facilidade do Format está disponível para todos os usuários no modo
"foreground" (interativo) que tenham senha para alterar uma aplicação e no caso da
senha ser de Programador Restrito, ao abrir a aplicação o Format executará a
importação de forma automática.
De forma semelhante, e para este último caso, ao salvar a aplicação, o Format
automaticamente exportará os Campos de Entrada que estão efetivamente sendo
usados na aplicação, para um arquivo com extensão .IFU .
Além da importação de Campos de Entrada descrita acima, o Format permite importar
os nomes dos Campos associados a uma tabela correspondente a um banco de dados
previamente escolhidos quando da configuração do Arquivo de Entrada. Veja figura a
seguir que apresenta um exemplo dos nomes dos campos da tabela.
38
39. Campos de Entrada
Nota:
Quando se usa o Format acessando um banco de dados através do driver ODBC
associado instalado no Windows e para o caso de importar dados de uma planilha
Excel, é importante observar que os valores associados a um campo, deverão ter
sempre a mesma categoria, isto é, se o valor de um campo for definido no primeiro
registro como numérico, nos demais registros ele deverá ser numérico, caso
contrário, o driver ODBC ignorará o conteúdo e retornará para o Format, um valor
vazio.
Com exemplo, podemos mencionar o caso de uma planilha que continha no primeiro
registro o valor "03", o qual era interpretado como cadeia de caracteres e mais a
frente este mesmo campo continha o valor "20", que era interpretado como numérico,
neste caso o driver não apresentava para o Format o valor "20".
Para evitar esse comportamento anômalo do driver, se recomenda:
- usar o caractere "plica" antes de cada campo para que o driver o trate como cadeia
de caracteres ou
- colocar um zero antes de cada campo para que o driver o trate como cadeia de
caracteres ou
- tirar o zero à esquerda dos campos, neste caso todos serão tratados como numéricos
ou
39
40. Campos de Entrada
- exportar a planilha como texto separado por TAB e fazer a aplicação no Format
usando registros de tamanho variável.
Com relação ao tamanho dos nomes, o Format aceita nomes com até 12 caracteres,
portanto os nomes das colunas com mais de 12 caracteres serão excluídos da lista na
importação e nem serão mostrados. Para solucionar esta restrição, cabe ao usuário
renomear os campos gerando uma nova tabela temporária.
Existem os conceitos de tamanho de campo e posição. Ao importar os campos da base
de dados para a criação dos Campos de Entrada, o Format usará como padrão para o
tamanho de cada Campo o valor definido na tabela associada ao banco de dados.
Cabe ao usuário manter ou alterar esses valores dentro da aplicação, podendo alterar
inclusive o tamanho total do registro.
Excluir um campo
Exclui o campo selecionado. Ao excluir um campo de entrada que não seja o último, o
usuário tem a opção de deslocar a posição dos campos seguintes.
Copiar Campo
Esta opção de edição permite copiar um ou mais campos de entrada usando as teclas
Shift ou Control como auxiliares (padrão do Windows) com as suas propriedades para
a área de trabalho do Windows.
Colar Campo
Esta opção de edição permite colar um ou mais campos de entrada com as suas
propriedades que estão na área de trabalho do Windows para dentro da aplicação.
Podem ser escolhidas as opções de:
Apagar nomes duplicados, caso na aplicação esses nomes tenham sido
previamente definidos. Se esta opção não for escolhida e ocorrerem nomes
duplicados, o Format acrescentará um número após os nomes duplicados de
forma que esses campos sejam unívocos.
Ampliar tamanho do registro
Deslocar campos seguintes
40
41. Configuração do Formulário
Configuração do Formulário
Este diálogo é utilizado para descrever as dimensões do papel, a rotação da página a
ser usada pela aplicação e o modo de impressão. Ele é acessado através da opção de
menu Layout | Formulário. A partir deste diálogo é possível também definir a
Configuração do Documento
Dimensões do Papel
As dimensões máximas do papel são variáveis, dependendo da impressora a ser usada.
Largura
Informa a largura do formulário utilizado na aplicação.
Altura
Informa a altura do formulário utilizado na aplicação.
Unidade
Escolha entre pixels, polegadas, centímetros e milímetros.
Nome do JDE
Válido apenas para impressoras Xerox que usem tamanhos personalizados para o
papel. Nesse caso, define o nome da entrada JDE que o usuário vai definir no SIRIUS
JSL (Apêndices B e C).
Rotação da Página
Indica a orientação da impressão. Para impressoras IPDS / AFP os valores possíveis
são: 0, 90, 180 e 270. Para impressoras Driver Windows as orientações possíveis são:
Retrato, Paisagem, Retrato Invertido e Paisagem Invertida. Para impressoras Xerox as
orientações possíveis são: Retrato e Paisagem.
Modo de Impressão
Os modos de impressão possíveis são Simplex, Duplex eixo horizontal, e Duplex eixo
vertical.
O modo Duplex eixo vertical permite a impressão de dados em ambos os lados do
papel no modo padrão de leitura de um livro:
41
42. Configuração do Formulário
O modo Duplex eixo horizontal permite a impressão de dados em ambos os lados do
papel no modo padrão de leitura de um relatório em formulário contínuo:
Para impressoras Xerox ambiente Metacode e modo de impressão duplex, leia os
comentários no anexo B.
42
43. Configuração do Documento
Configuração do Documento
O desenvolvimento de aplicações utilizando o Format é baseado no conceito de
Documento. À medida que o usuário descreve a configuração de um documento,
considera-se que este documento pode ocorrer diversas vezes em um formulário, com
ou sem numeração, podendo ou não formar talões. O usuário deve definir as
dimensões e a numeração dos documentos além do seu posicionamento no formulário.
Dimensões de Documentos
Este diálogo é utilizado para definir os tamanhos, margens e espaços entre
documentos. As mudanças podem ser verificadas na área de trabalho na medida em
que se modificam as dimensões do documento. Diversas unidades de medida são
disponíveis (Pixels, Polegadas, Centímetros e Milímetros). Este diálogo é acessado
através da opção de menu Layout | Documento | Dimensões ou a partir do diálogo de
Configuração do Formulário.
Tamanho
Permite definir a largura e a altura do documento utilizando para tais diversas
unidades de medida.
Margens
Superior
Indica o deslocamento do documento a partir do topo do formulário. Pode ser
utilizada para deslocar o documento para baixo. Apenas valores positivos são
permitidos.
Esquerda
Indica o deslocamento do documento a partir do lado esquerdo do formulário.
Pode ser utilizado para deslocar o documento para a direita. Apenas valores
positivos são permitidos.
Não utilizar as margens do Driver da impressora
No ambiente de impressão Driver Windows, os drivers instalados nesse ambiente e
usados no momento da impressão dos documentos, informam ao Format quais são as
43
44. Configuração do Documento
margens impostas pela impressora em uso.
Se o usuário não escolher esta opção, as margens (superior e esquerda) definidas para
o documento serão adicionadas às margens impostas pelo driver.
Se for escolhida esta opção, o Format descontará das margens definidas pelo usuário,
as margens impostas pelo driver.
Como o Format usado com a opção de "Não usar as margens da impressora", subtrai
das margens dos objetos definidas pelo usuário (overlays, documentos, etc.), as
margens da impressora definidas pelo driver (variável segundo o modelo da
impressora), pode acontecer que o resultado seja negativo. Neste caso objetos podem
desaparecer do documento ou aparecerem em posições imprevistas.
O primeiro caso depende do comportamento do driver.
O segundo caso é um comportamento da linguagem PCL quando enviamos valores
negativos como coordenadas.
Em termos da linguagem PCL esses valores negativos são interpretados como um
deslocamento relativo à posição corrente do cursor e não posicionamento absoluto.
A recomendação para que os documentos impressos tenham a mesma apresentação
que a desejada é escolher a opção "Não usar as margens da impressora" e definir
coordenadas X/Y maiores que os valores de margens definidos pelo driver em uso. A
partir da versão 8.07 o Format alerta o usuário para o eventual truncamento de objetos
ou posição errada dos mesmos informando qual é o valor da margem para o driver em
uso.
Espaços Entre Documentos
Utilizado quando mais de um documento será impresso na mesma página.
Horizontal
Indica a distância a partir da extremidade direita de um documento até a
extremidade esquerda do próximo na direção horizontal. Apenas valores
positivos são permitidos.
Vertical
Indica a distância a partir da extremidade de baixo de um documento até a
44
45. Configuração do Documento
extremidade de cima do próximo na direção vertical. Apenas valores positivos
são permitidos.
Posicionamento e Seqüenciamento dos Documentos
Este diálogo é utilizado para definir como será feita a impressão dos
documentos: pode ser feita a impressão de talões (chamada aqui de impressão
em profundidade), ou a impressão seqüencial de todos os documentos de um
registro (impressão em superfície). Este diálogo é acessado através da opção de
menu Layout | Documento | Posicionamento ou a partir do diálogo de
Configuração do Formulário.
Número de Diferentes Talões na Mesma Página
Indica o número de diferentes registros que vão ser processados na mesma
página. Se o valor fornecido for maior que 1 (impressão em profundidade), a
ordem do talão que está sendo impresso pode ser obtida através da variável do
sistema: _NumRegGr.
Se o valor fornecido for igual a 1 (impressão em superfície), _NumRegGr vai
ser sempre igual a 1.
Observação: O Format usa o termo "talão" como um sinônimo para registros. As
diferentes formas de seqüenciamento que o Format oferece para imprimir
documentos permitem atender às necessidades do pós-processamento dos
documentos.
Nota: O número máximo de documentos (páginas lógicas) numa página física é
de 30.
Documentos na Horizontal
Indica o número de documentos que serão impressos na extensão da largura do
formulário (direção horizontal).
A posição de cada documento na direção horizontal pode ser obtida através da
variável do sistema: _NumDocHoriz.
Documentos na Vertical
Indica o número de documentos que serão impressos na extensão da altura do
45
46. Configuração do Documento
formulário (direção vertical).
Por exemplo, se deseja imprimir 2 cartas para 2 clientes diferentes em cada
formulário, lado a lado, pode-se configurar da seguinte forma: 2 para número de
diferentes talões na mesma página, 2 para documentos na horizontal e 1 para
documentos na vertical.
Seqüência de Talões
Quando Número de diferentes talões na mesma página é 1, a seqüência de
talões indica a posição do primeiro documento do próximo talão.
Próximo à Direita
Indica que o primeiro documento de um talão será impresso à direita do último
documento do talão anterior.
Próximo na Vertical
Indica que o primeiro documento de um talão será sempre impresso no lado
esquerdo do formulário.
Próximo no Início da Pág.
Indica que o primeiro documento de um talão será sempre impresso no topo do
formulário (início da página).
46
47. Configuração do Documento
Próximo à Esquerda
Imprime os documentos da direita para a esquerda:
Quando o Número de diferentes talões na mesma página é um valor maior do
que 1, a seqüência de talões é tratada da seguinte forma:
Próximo à Direita
Selecione esta opção para escolher a seguinte configuração:
Exemplo com 4 talões por página
Próximo na Vertical
Selecione esta opção para escolher a seguinte configuração:
Exemplo com 4 talões por página
Próximo no Início da Página
Produz o mesmo resultado que Próximo na Vertical.
Próximo à Esquerda
Selecione esta opção para escolher a seguinte configuração:
47
48. Configuração do Documento
Exemplo com 4 talões por página
Observação: Em todos os casos em que o número de diferentes talões na mesma
página for maior do que 1, se a quantidade de documentos de um talão for menor
do que os demais, este talão será anulado a partir deste ponto, até completar todos
os talões que compõem a página.
Numeração do Documento
Este diálogo permite definir se os documentos impressos serão numerados e como
será essa numeração, e também, permite definir a quantidade de documentos a serem
impressos a partir de cada registro lido. Este diálogo é acessado através da opção de
menu Layout | Documento | Numeração ou a partir do diálogo de Configuração do
Formulário.
Quantidade
Indica o número mínimo de documentos a serem impressos por cada registro mestre
ou equivalente da base de dados.
Seu conteúdo pode ser atribuído utilizando uma expressão. Para construir
dinamicamente uma expressão, utilize o botão com o símbolo >> no lado direito da
caixa de edição para ativar o Editor de Expressão. Apenas valores maiores ou iguais a
1 são permitidos.
Durante o processo de impressão, a quantidade de documentos pode ser obtida através
da variável do sistema: _TotRep e o contador de repetições (número da cópia que está
sendo impressa) pode ser obtido através da variável do sistema: _ContRep .
Fixa
Se esta opção for selecionada, o valor definido no campo "Quantidade" será o número
de páginas impressas pelo Format.
Dinâmica
Se esta opção for selecionada sempre que houver estouro de página o Format
48
49. Configuração do Documento
acrescentará mais uma página até que não haja mais estouros.
Dinâmica Múltipla de:
Se esta opção for selecionada, o número de documentos impressos por registro será
um múltiplo do valor especificado e sempre que houver estouro de página o Format
acrescentará mais uma página até que não haja mais estouros.
Cabe ao usuário definir quais serão os documentos a serem impressos para as páginas
adicionais que completarão o valor especificado.
Número Inicial
Indica o número do primeiro documento. Seu conteúdo pode ser atribuído utilizando
uma expressão. Durante o processo de impressão, o número do documento pode ser
obtido através da variável do sistema: _NroDoc.
Incremento
Selecione esta opção para indicar que o número do documento (disponível através
variável do sistema _NroDoc) vai ser incrementado durante o processo de impressão.
Decremento
Selecione esta opção para indicar que o número do documento (disponível através da
variável do sistema _NroDoc) vai ser decrementado durante o processo de impressão.
Passo
Informa o valor que será incrementado ou decrementado ao número do documento
(variável do sistema _NroDoc) durante o processo de impressão.
Tamanho
Indica o número de dígitos do número do documento (variável do sistema _NroDoc).
Por exemplo, se for selecionado tamanho igual a 6, e o número inicial for 1, o
primeiro valor de _NroDoc será "000001".
Múltiplos Documentos
Esta opção permite que uma mesma aplicação possa compor documentos com as
mesmas dimensões e conteúdos diferentes, por exemplo, cartas com textos diferentes,
dados variáveis diferentes, etc. Quando se utilizam múltiplos documentos, uma
49
50. Configuração do Documento
condição precisa ser associada a cada documento para definir quando ele será
impresso. Os Campos de Saída, Códigos de Barras, Logotipos e Campos de Textos
devem ser definidos em todos os documentos nos quais eles devem aparecer.
A opção “Múltiplos Documentos” permite também que, em impressoras que
disponham de grampeamento, deslocamento de bandeja e outras funções de
acabamento como a seleção de bandejas, possam ser comandadas para tal fim quando
um determinado documento for ativado (Documento Separador), além da inserção de
capas de lote de documentos (Capa Inicial e Final).
Este diálogo é acessado através da opção de menu Layout | Documento | Múltiplos
Docs ou através do diálogo de Configuração do Formulário.
Para impressoras Xerox ambiente Metacode e modo de impressão duplex, leia os
comentários no anexo B.
Nome
Ao usar Múltiplos Documentos, um nome precisa ser especificado para cada
documento. O nome default para o primeiro documento é "principal", mas o
usuário pode escolher um nome diferente.
Condição
Ao usar Múltiplos Documentos, é necessário associar uma condição a cada
documento, para definir quando cada um será impresso. Nenhuma condição
deve ser definida quando apenas um documento é utilizado.
As condições dos vários documentos devem cobrir todas as possibilidades,
sendo que, somente um documento deve ser selecionado por vez.
Documento Principal
É necessário haver um, e somente um documento principal. O primeiro documento
definido é considerado o documento principal. É possível alterar a identidade do
documento principal, mas precisa haver sempre um não podendo ser excluído.
Documento Continuação
Se for utilizado algum Campo de Detalhes na formação de um documento, poderá ser
definido um documento de continuação caso o tamanho da área reservada para os
50
51. Configuração do Documento
Detalhes não seja suficiente para conter todos os Detalhes. O usuário deverá utilizar
cálculos lógicos na Numeração do Documento (ver capítulo sobre Numeração do
Documento).
De acordo com a formação e numeração dos documentos, poderá ser necessária a
inclusão de uma condição para este documento. Esta condição deverá ser descrita de
forma que não venha a ser atendida (Ex.: IF (_ContRep = 0)).
Exemplo de documento de Continuação:
Suponhamos que a base de dados é a seguinte:
1Jose 20
A01
A02
A03
A04
A05
A06
A07
A08
A09
A10
A11
A12
A13
A14
A15
A16
A17
A18
A19
A20
2María 10
B01
B02
51
52. Configuração do Documento
B03
B04
B05
B06
B07
B08
B09
B10
onde:
1Jose 20
Registro Mestre: onde 1 é o tipo de documento e 20 a quantidade de Detalhes
associados a esse registro Mestre
2María 10
Registro Mestre: onde 2 é o tipo de documento e 10 a quantidade de Detalhes
associados a esse registro Mestre
A01 até A20 e B01 até B10 são registros de Detalhes
A definição dos documentos será com base nos Campos de Entrada seguintes:
O Documento Principal será definido assim:
52
53. Configuração do Documento
O Documento de Continuação para o tipo 1 será como segue:
Nas expressões construídas para as Condições é permitido o uso de Campos de
Detalhes.
53
54. Configuração do Documento
Caso o documento vá ser usado não só como Continuação, mas também como
documento a ser ativado numa outra situação, deverá ser definida uma expressão
válida no espaço Condição.
Se o documento vai ser usado apenas como Continuação, bastará definir no espaço
Condição um valor irreal, por exemplo, IF (_ContRep = 0) e assinalar que ele é
um documento de Continuação.
Através do diálogo de Múltiplos Documentos é possível criar, excluir documentos ou
mudar suas características.
O documento corrente é o que será mostrado na área de trabalho.
Ao abrir uma aplicação com múltiplos documentos, o documento principal é
considerado o documento corrente. Ao sair do diálogo de Múltiplos Documentos, o
documento selecionado é considerado o documento corrente. A opção de menu
Opções | Selecionar Documento pode ser utilizada para selecionar o documento
corrente.
A Linha de Estado mostra o nome e a condição definida para o documento corrente.
Seleção de bandejas (Origem do papel)
Permite especificar, para impressoras que tenham mais de uma bandeja, aquela que
será utilizada.
Quando o ambiente de impressão é Driver Windows o usuário poderá escolher a
bandeja associada a um determinado documento baseado nas bandejas configuradas
para a impressora definida como padrão para o Windows. Como as identidades das
bandejas variam de impressora para impressora, o usuário deverá configurar como
padrão a impressora desejada.
Caso a impressora desejada não seja a padrão o usuário poderá usar a opção Valor
Definido pelo Driver. Neste caso o usuário deverá conhecer qual é o número que o
driver da impressora espera receber e colocar a diferença entre esse valor e o número
256, isto é, se o fabricante da impressora informa que o número para a bandeja 1 que o
driver PCL deve receber é 260, o usuário deverá colocar o número 4. Desta forma o
Format somará 4 ao valor 256 e envia para o driver da impressora desejada o valor
260 que será transformado pelo driver PCL no comando <escape>&l21H para a
bandeja 1.
54
55. Configuração do Documento
Para impressoras PostScript, Docuprint EPS, da Xerox foi implementada a seleção de
bandejas coloridas. O arquivo PostScript gerado pelo Format, antes de ser impresso,
deve ser convertido, usando o programa ColorTray.exe, desenvolvido pela Sirius. Este
programa recebe dois parâmetros de execução: o nome do arquivo de entrada (a ser
convertido) e o nome do arquivo de saída (que será enviado para a impressora) ou o
nome da pasta do arquivo de saída.
ColorTray <caminho_arq_entrada> <caminho_arq_saida>
ou
ColorTray <caminho_arq_entrada> <pasta_arq_saida>
Nesse último caso, o arquivo de saída será gerado na pasta especificada, com o mesmo nome
do arquivo de entrada, acrescido da extensão .PS.
Para impressoras Xerox Metacode o nome da bandeja onde o papel está deverá ser
definido pelo usuário de acordo com os nomes definidos no SIRIUS.JSL.
Documento Separador (Grampeamento e Deslocamento de bandeja)
Permite especificar, para impressoras que tenham a opção de grampeamento e
deslocamento de bandeja, qual será o documento que ao ser ativado pela aplicação,
provocará o envio de um comando para essa função.
Para que esta função seja efetivada, é preciso configurar nas Propriedades da
Impressora (Driver), a opção de grampeamento / deslocamento.
A janela abaixo mostra qual é a opção que permite associar um determinado
documento a esta finalidade.
55
56. Configuração do Documento
Impressão (somente para Xerox Metacode)
Seleciona o modo de impressão do documento corrente. Para impressoras Xerox
Metacode as opções são Simplex ou Duplex. Para impressoras Driver Windows as
opções são Simplex, Duplex Eixo Horizontal e Duplex Eixo Vertical.
Capa Inicial e Capa Final
O Format permite que o usuário construa uma aplicação inserindo uma folha no início
e outra no fim do lote de documentos formatados, como Capa Inicial e Capa Final
respectivamente. As páginas impressas não estão associadas a registros exclusivos
destinados a elas, isto é, não deverá haver na base de dados um registro para a Capa
Inicial nem para a Capa Final. O usuário poderá utilizar informações dos registros dos
documentos da base de dados para construir os dados da Capa Inicial e Final. As
páginas correspondentes às Capas Inicial e Final não são contabilizadas.
56
57. Campos de Saída
Campos de Saída
Campos de Saída são utilizados para definir dados fixos ou variáveis a serem
impressos nos documentos. Este diálogo é utilizado para descrever a configuração e o
conteúdo de cada Campo de Saída. Ele pode ser acessado através da opção de menu
Definição | Campos de Saída ou clicando duas vezes no retângulo de Campo de
Saída na área de trabalho.
Para modificar a posição de um Campo de Saída, arraste o retângulo ou altere os
campos Pos X e Pos Y no diálogo correspondente. Para modificar o tamanho de um
Campo de Saída, arraste as extremidades do retângulo ou altere o campo Tamanho no
diálogo correspondente.
Quando um Campo de Saída estiver selecionado, a cada <TAB> digitado, a seleção
irá para o próximo objeto do mesmo tipo no documento ou no detalhe.
Quando um Campo de Saída estiver selecionado e um <ENTER> ou <ESPAÇO> for
digitado será automaticamente aberto o diálogo de definição do objeto sem que seja
necessário um duplo clique.
57
58. Campos de Saída
Conteúdo
Expressão que define o valor que será atribuído ao Campo de Saída. Para construir
dinamicamente uma expressão utilize o botão com o símbolo >>, ao lado da caixa de
edição, para ativar o Editor de Expressão.
Mudança de fonte de caracteres dentro de um Campo de Saída
É possível alterar a fonte de caracteres dentro de um Campo de Saída utilizando
para tal, as definições de Fontes Condicionais e marcando no diálogo a opção
Usa Troca de Fonte. Para ativar uma determinada fonte condicional deverá ser
colocado o seguinte comando no Conteúdo:
<fn> onde n representa o número da fonte condicional.
Para retornar à fonte original do Campo de Saída, basta usar o comando </f>
Pos X
Indica o deslocamento da extremidade esquerda do campo, a partir do lado esquerdo
do documento. Apenas valores positivos são aceitos. O deslocamento mais o tamanho
(largura) do campo têm que ser menor que a largura do documento.
Pos Y
Indica o deslocamento da extremidade inferior do campo, a partir do topo do
documento. Apenas valores positivos são aceitos. O deslocamento menos a altura do
campo tem que ser maior que zero.
Tamanho
Indica o tamanho (largura) do campo. O tamanho mais Pos X não pode ser maior do
que a largura do documento.
Tamanho em Colunas
Selecione esta opção para ver o tamanho do campo em número de caracteres. Esta
opção está disponível apenas para fontes de caracteres com espacejamento fixo ou
fontes não proporcionais (caracteres com tamanhos iguais, por exemplo, a letra "I"
ocupa o mesmo espaço, em um texto, que a letra "W", um tipo de fonte fixa é a
Courier New), e não para fontes com espacejamento variável (fontes True Type, por
exemplo).
58