Академический Документы
Профессиональный Документы
Культура Документы
Esta documentao destinada aos responsveis pela implantao do Sistema Totus nas empresas e aos usurios do sistema que necessitam criar relatrios personalizados.
1.1.
Para criar uma pasta, clique no Menu Arquivo, em Novo / Pasta e d um nome pasta criada.
1.2.
Criando um Relatrio
Vamos criar um relatrio de Produtos por Grupo como exemplo. Para criar o relatrio, clique com o boto direito sobre a pasta onde o relatrio deve ser criado e escolha a opo Novo Relatrio. A tela abaixo ser aberta:
Esta a tela onde se desenha o layout do relatrio com todas as informaes que iro ser impressas no mesmo. Porm, antes de desenh-lo, necessrio selecionar os dados que sero impressos. Para isso, selecione a aba Dados e clique no menu Arquivo e em Novo. Com a tela abaixo aberta, selecione o Assistente de Consulta e d um Ok.
Selecione as tabelas MAT_ITEM e MAT_GRP_EST para acompanhamento do exemplo. A primeira tabela ser inclusa normalmente. A partir da segunda tabela, o Gerador ir solicitar que sejam confirmados os vnculos de relacionamentos entre as tabelas selecionadas. Para existir um relacionamento entre duas tabelas, necessrio que exista uma ou mais colunas com informaes semelhantes em ambas s tabelas. No caso das tabelas que selecionamos, a coluna semelhante a COD_GRP_EST, como mostra a tela abaixo:
IMPORTANTE: ao abrir a tela de relacionamentos, o Gerador coloca nos Campos Relacionados todos os campos com nomes iguais entre as tabelas, porm nem sempre esses campos so relacionados, portanto remova-os e deixe somente os campos com os relacionamentos corretos. Clique em Ok para voltar tela de seleo das Tabelas. No nosso caso no temos mais tabelas a inserir, ento clique no boto Prximo. A tela para seleo dos campos ser aberta. Caso queira inserir todos os campos na consulta do relatrio, escolha a opo Todos os Campos. Para continuarmos, escolha a opo Escolher os Campos conforme mostra a tela abaixo e selecione os seguintes campos: MAT_ITEM.COD_EST MAT_ITEM.DESC_EST MAT_ITEM.COD_GRP_EST MAT_ITEM.COD_UND MAT_GRP_EST.DESCRICAO
Clique no boto Prximo para passarmos para outra etapa. A prxima tela a abrir, como mostra a figura abaixo, permite a insero de campos calculados no relatrio. Como no relatrio que estamos criando no h necessidade, veremos este assunto mais adiante. Escolha a opo Nenhum Clculo e clique em Prximo para continuarmos.
Na prxima tela a ser exibida podemos criar grupos de informaes para o relatrio, porm veremos estes passos de uma outra forma mais simplificada logo adiante. Clique no boto Prximo para visualizarmos a prxima etapa. A tela seguinte a ser aberta permite inserir critrios para a seleo, ou filtros, dos dados no relatrio. Para isso, selecione a opo Definir Critrios de Localizao e clique com o boto direito do mouse sobre a tela de edio, selecionando a opo Inserir Critrio como na tela abaixo:
Ao clicar neste menu, abrir uma tela onde deve ser informado o critrio que se deseja para o relatrio. Vamos incluir um critrio para que seja impresso apenas o item de Almoxarifado. Para tanto, selecione o campo MAT_ITEM.ALMOX que deve ter valor = S, conforme mostra a figura abaixo:
Clicando em Ok, a tela ficar como na figura abaixo. Caso queira inserir mais critrios, repita o mesmo processo. O nmero de critrios ilimitado.
Clique em Prximo para visualizarmos a prxima etapa que definir a ordenao dos dados no relatrio. Selecione a opo Configurar Classificao. Como queremos que os dados sejam exibidos de acordo com os seus grupos, primeiramente, ordene os grupos, selecionando o campo MAT_ITEM.COD_GRP_EST, para que o mesmo dado de grupo no aparea vrias vezes no relatrio. Depois ordene pelo campo MAT_ITEM.DESC_EST para ordenar os produtos por ordem alfabtica de descrio. Selecione os campos mencionados acima conforme exemplo da tela a seguir:
Com a tela abaixo aberta, clique na aba Desenho para iniciarmos a confeco do relatrio.
Use o boto Adicionar para inserir o grupo na caixa de itens. Se voc desejar que o relatrio inicie uma nova pgina para cada grupo, marque a opo Iniciar Nova Pgina. Clique em Ok para Retornar para a aba de Desenho. Note que no corpo do relatrio foi acrescentada mais uma barra de diviso, sendo uma para o cabealho do relatrio e outra para o cabealho do grupo. Veja a figura abaixo:
Desta forma, posicione o ponteiro do mouse sobre o meio das duas barras que esto unidas e quando o ponteiro do mouse mudar, clique e arraste a barra cabealho do Grupo para baixo de forma a abrir espao para a insero dos campos. Veja o exemplo abaixo:
Cabealho do relatrio
Cabealho do grupo
1 - Label: Campo para insero de textos fixos no relatrio. o campo mais usado para construo de cabealhos, ttulo de colunas, etc. 2 - Memo: Permite a edio de textos em vrias linhas no mesmo campo. 3 - Tech Text: Idntico ao campo Memo, somente com a peculiaridade de poder ser vinculado a documentos ou textos externos em padro RTF ao relatrio. 4 - Varivel do Sistema: Utilizado para inserir campos de data, contador de pginas, etc. 5 - Varivel: A utilizao deste campo requer conhecimentos avanados de Linguagem de Programao Pascal. O mesmo recebe variveis geradas via cdigo para o relatrio. 6 - Imagem: Permite incluir uma imagem externa no relatrio. 7 - Polgono: Insere formas geomtricas como losangos, retngulos, crculos, etc no relatrio. Pode ser utilizado para a confeco de grade para o Relatrio. Obs.: esta opo para uso avanado. 8 - Linha: Insere linhas horizontais e verticais no relatrio. o recurso mais simples e mais usado para a diviso do relatrio. 9 - Cdigo de Barras Fixo: Recebe valores fixos editados da mesma forma que o label. Barra de Componentes de Dados
________________________________________________________________________________________________________________________ TOTUS_Manual_Gerador_Relatorios.doc | Pgina 9 de 30
1 - DbEdit: Insere um campo do Banco de Dados no relatrio. 2 - DbMemo: Insere um campo Memo do Banco de Dados. 3 - DbRichText: Insere um campo Text do Banco de Dados. 4 - Campo Calculado: Insere um campo calculado criado pelo relatrio. 5 - Imagem: Insere um campo imagem do Banco de Dados. 6 - Cdigo de Barras: Imprime o campo do Banco de Dados em formato de cdigo de Barras.
Voc tambm pode formatar os campos inseridos no relatrio clicando com o boto direito do mouse sobre o campo. O Gerador ir abrir um Menu com vrias opes de formatao, dependendo do tipo do componente inserido. O mesmo processo para formatar os grupos de dados no relatrio como Cabealho, Cabealho do Grupo, etc. Para inserir os campos de dados no relatrio, voc utilizar a Barra de Componentes de Dados. Vamos agora inserir um DbEdit para cada campo que iremos colocar no relatrio. Aps a insero dos DbEdits,
________________________________________________________________________________________________________________________ TOTUS_Manual_Gerador_Relatorios.doc | Pgina 10 de 30
vamos vincul-los aos campos do Banco de Dados (consulta que fizemos primeiramente) como mostra a figura abaixo. Vamos utilizar o cabealho do grupo para imprimir os grupos e Detalhe para imprimir os produtos do grupo.
Perceba que na figura acima foram relacionados todos os DbEdits com seus respectivos campos no Banco de Dados. Clique na aba Visualizar Impresso que ser mostrado na tela como ficou a impresso do relatrio com o layout definido acima. Segue abaixo o exemplo:
Volte para a aba Desenho e insira Labels no relatrio para fazer a identificao de cada coluna e do relatrio. Veja a sugesto na figura abaixo:
________________________________________________________________________________________________________________________ TOTUS_Manual_Gerador_Relatorios.doc | Pgina 11 de 30
Com este layout, ao visualizar a impresso, o relatrio ficou como na figura abaixo:
Para inserir um campo de Varivel do Sistema no relatrio, use o componente Varivel do Sistema e formate-o para a informao que deseja mostrar.
Procure pelo campo COD_GRP_EST e d um duplo clique para que ele seja inserido em Critrio. Marque a coluna Localizao e a coluna Mostrar Tudo como na figura abaixo. A coluna Localizao deve ser marcada para que no momento da emisso do relatrio pelo usurio, possa aparecer uma janela onde ele deve escolher o grupo que deseja imprimir e a coluna Mostrar Tudo deve ser marcada para que caso o usurio no queira escolher um grupo, ficar uma opo de mostrar os produtos de todos os grupos.
________________________________________________________________________________________________________________________ TOTUS_Manual_Gerador_Relatorios.doc | Pgina 13 de 30
Existem agora dois critrios para o relatrio, o primeiro um critrio fixo, ou seja, o usurio no ter acesso para modificar o seu valor e o segundo um critrio varivel, onde o usurio poder informar o valor que deseja filtrar. Na aba Visualizar Impresso, note que agora existe o cone exibida na figura abaixo: . Clique para abrir a janela de localizar
Informe o cdigo do grupo que deseja filtrar os produtos e clique em Ok. Isso far com que sejam exibidos no relatrio somente os produtos pertencentes ao grupo 018. Caso o usurio queira ver todos os Grupos, basta marcar a opo Mostrar todos os valores do Campo cod_grp_est.
D um duplo clique em qualquer um dos campos para simplesmente inserir uma linha em Clculos. Altere a coluna funo para Expresso e na coluna Expresso informe, entre parnteses, o clculo que deve ser
mostrado. Para alterar o nome do campo a ser criado, clique em Apelido do campo e coloque o nome que desejar conforme figura abaixo:
Clique no boto OK e perceba que o campo criado aparece agora na lista de campos e pode ser usado no relatrio. Volte para a aba Desenho e vamos, ento, inseri-lo no layout. Para isso, use o componente DbText e vincule ao campo criado. Veja o exemplo abaixo:
Para formatar um campo, basta clicar com o boto direito do mouse sobre ele e escolher a opo Formato de Apresentao. Ser aberta uma tela, como mostra a figura a seguir, onde deve ser escolhida a formatao adequada. Vamos formatar o campo VLR_PRODUTO criado anteriormente.
Clicando sobre o componente Link que se encontra na janela da consulta, o Gerador ir abrir a tela abaixo. Deixe marcada a segunda opo como mostra a figura:
________________________________________________________________________________________________________________________ TOTUS_Manual_Gerador_Relatorios.doc | Pgina 17 de 30
Prximo passo, vamos inserir um sub-relatrio na posio onde sero impressas as unidades. Clique na ferramenta de sub-relatrio circulada e insira na posio conforme mostra a figura abaixo:
Perceba que o Gerador criou uma segunda aba na parte inferior da tela. Clique nela e o Gerador abrir uma outra folha de dados semelhante Principal.
________________________________________________________________________________________________________________________ TOTUS_Manual_Gerador_Relatorios.doc | Pgina 18 de 30
Relacione esta folha de dados com a consulta que acabamos de criar, clicando no menu Relatrios / Dados. Escolha a consulta MAT_ITEM_UNIDADES e clique em Ok. Em seguida inclua os campos no grupo Detalhe conforme mostra a figura abaixo:
Clique em visualizar a impresso e o relatrio ser impresso conforme mostra a figura abaixo:
Para usurios avanados com maiores conhecimentos de linguagem de banco de dados, o Gerador de Relatrios dispe de um recurso que possibilita uma maior flexibilidade na gerao dos dados necessrios ao relatrio. Esse recurso permite que, por exemplo, se visualize o relatrio e se dispare uma ao que tenha ou no relao com os dados sendo mostrados pelo relatrio. Isso possvel porque o relatrio possui um nome de stored procedure (procedimento armazenado em banco de dados) que ir receber alguns campos constantes na tela de autofiltro do relatrio.
Na tela a seguir mostrada a aba de tabelas, sendo que neste exemplo os dados mostrados no relatrio so provenientes da tabela que criada/preenchida pela procedure sr_lfe:
________________________________________________________________________________________________________________________ TOTUS_Manual_Gerador_Relatorios.doc | Pgina 20 de 30
Um ponto a ser verificado neste caso que a tabela j deve existir no banco de dados, ou seja, voc j verificou os campos necessrios para o relatrio e j executou a rotina para criao da tabela no banco de dados, pois caso contrrio no tem como inclu-la no relatrio. Os campos de filtro (que aparecem quando se chama o relatrio) sero enviados para a procedure (neste caso sr_lfe) e devem estar previstos na mesma (todos devem estar como obrigatrios - Mandatory), seguem telas:
Perceba abaixo que os dois primeiros campos e o ltimo campo de argumentos da procedure devem sempre estar constando e sero os mesmos em todas procedures deste tipo, e entre eles estaro os
________________________________________________________________________________________________________________________ TOTUS_Manual_Gerador_Relatorios.doc | Pgina 21 de 30
campos que o relatrio passar, neste caso @data_recebimento e @data_recebto. Perceba tambm que o relatrio sempre passar os dados no formato texto (char, varchar) independentemente se o campo for do tipo data, numrico ou texto e deve ser este o tipo das variveis na definio da procedure. Deve-se ter um tratamento especial no caso de datas. O disparo da procedure somente ser feito quando o relatrio for chamado pelo Totus, no sendo chamado pela visualizao do relatrio pelo ambiente do Gerador de Relatrios.
Para que o valor digitado neste campo no momento da abertura do relatrio, seja impresso ento deve ser inserido um campo do tipo Label no corpo do relatrio:
Depois de inserido este campo pode incluir uma expresso na aba Calc ( direita da aba Design, acima). Com a aba Calc selecionada, deve-se clicar no menu View e deixar a visualizao configurada conforme abaixo:
Com isso, deve ser selecionado o objeto e selecionado o evento Onprint, e dentro deste evento inserir uma linha de cdigo que instrua para pegar o valor digitado no campo de busca para dentro do objeto, no caso Label7. Verifique na figura abaixo a localizao dos locais a serem selecionados e do cdigo a ser inserido:
Uma ateno nas observaes acima deve ser dada no caso do nome da consulta de dados, que no caso ficou como ven_pedido. Esse nome voc pode conferir qual o correto para o relatrio que est fazendo clicando na aba Data (primeira da esquerda para a direita), veja na rea da figura abaixo selecionada em azul:
Caso queira alterar esse nome basta clicar no boto selecionado em vermelho e digitar o nome desejado, atentando para o fato que o nome j dado na expresso da aba Calc no ser automaticamente alterado e neste caso dever ser alterado manualmente.
Como resultado, mostramos o valor digitado na tela de filtro de busca do relatrio e a sua impresso no campo Label7 com a visualizao do relatrio:
Gerando Arquivos Texto Exportveis Com o relatrio visualizado na tela, no importando se o mesmo foi executado a partir do Totus ou do Gerador de Relatrios, clique no boto referente funo de imprimir e observe a figura a seguir:
Note na rea demarcada que deve ser selecionada a opo Imprimir para Arquivo. No campo Onde deve ser informado o local a gravar o arquivo e o nome do mesmo com a extenso (.txt,.xls). No campo 'Tipo' existem duas opes: 1) Arquivo Texto: Neste caso o arquivo fica gravado com os dados prontos para serem utilizados em uma importao por outro programa, por exemplo, Excel. Verifique na figura abaixo, como fica um arquivo gerado com esta opo:
Note que os campos esto separados por tabulao (isto definido na configurao da gerao do arquivo pelo Gerador de Relatrios). E neste caso o arquivo poderia estar sendo salvo com extenso .xls pois assim ele seria aberto diretamente pelo Excel em colunas j separadas, aparecendo desta forma:
2) Arquivo Texto para Emulao do Relatrio: Neste caso o arquivo fica gerado tal qual est no relatrio visualizado, com as limitaes de ajuste de posicionamento dos campos nas linhas. Por se tratar de um arquivo de modo texto, por exemplo, no aparecem as linhas horizontais desenhadas que aparecem na visualizao do relatrio. Verifique na figura abaixo, como fica um arquivo gerado com esta opo:
Selecione a pasta onde se salvou o arquivo e clique em abrir. A janela abaixo ser mostrada.
Caso o arquivo tenha sido configurado como Delimitado por Tabulao, o Excel detecta automaticamente as tabulaes do arquivo e pode-se clicar diretamente no boto concluir e a importao ser concluda corretamente. Caso se use outro delimitador ou a configurao Tamanho Fixo, clique na aba avanar para exibir a prxima tela:
Selecione o delimitador escolhido para o arquivo e clique em concluir. No caso de ter usado configurao Tamanho Fixo, clique na tela Visualizao de dados nos locais onde se quer dividir as colunas para a gerao da planilha. Veja janela abaixo: Antes da separao:
Definidas as colunas, basta clicar no boto concluir para se gerar a planilha. A partir deste ponto, basta alterar os dados na planilha normalmente.