Appostila Protheus Report

PROTHEUS 11
Educao Corporativa
Protheus Report
Ricardo Pereira Coelho

Avenida Segunda Avenida com a rua H-44 - Condomnio Cidade Empresarial Cidade Vera Cruz, Aparecida de Goinia
Telefone (62) 3097-9938 Website http://www.totvs.com/goias
Protheus Report O Protheus Report um aplicativo do Sistema Protheus que permite ao usurio a criao de relatrios personalizveis de forma prtica. Desta forma, a criao do relatrio realizada atravs de sees que sero impressas de uma determinada tabela. Para isso, necessrio definir em cada seo os campos que constaro no relatrio, e ainda relacion-lo com tabelas secundrias para trazer informaes adicionais. Alm de, permitir definir cores, estilos, tamanho, fontes, quebras, mscara das clulas para cada seo, criao de totalizadores por seo e/ou grupos de campos, frmulas e funes (Soma, Mdia, etc.), salvar as configuraes, criar grficos. Com essas funcionalidades, o usurio pode modificar os relatrios criados, desenvolvendo seus prprios leiautes. Alm disso, com base em um dado comum possvel agrupar as informaes no relatrio, facilitando a sua organizao e visualizao. O relatrio criado pode ser enviado impressora, ao disco, e-mail, html, Microsoft Excel ou ainda pode ser executado a partir do menu de um dos ambientes do sistemas. Dica Os relatrios personalizados so gravados com extenso .XRP, diferenciandose dos relatrios padres que recebe a extenso .##R e dos personalizveis que tem extenso .PRT. Para acessar o Protheus Report: Em qualquer mdulo do sistema atravs do menu Miscelnea, selecione a opo Protheus Report ou Totvs Report dependendo da verso. A primeira seo a principal e define as caractersticas gerais de todo o relatrio. Para a seo principal possvel definir: Seo Principal e as Sees Especficas

1-
Seo Principal
Propriedades
Configurando as propriedades: 1.1- Na rea Propriedades, clique na caixa "Ttulo" e informe um ttulo para identificao do relatrio. Ttulo Define o ttulo que ser apresentado no cabealho do relatrio. Altura da linha A altura padro para todas as linhas do relatrio. recomendvel que essa configurao seja definida considerando o tamanho da fonte utilizada. Para cada seo tambm poder-se definir altura das linhas. O sistema ir aplicar de forma diferenciada as alturas das linhas. Espaamento entre colunas Define o espaamento em pontos (caracter) entre as colunas Margem esquerda A margem esquerda em pontos (caracter) para todo o relatrio. Tambm ser possvel definir a margem esquerda de cada seo, criando endentaes na disposio dos dados. Nmero inicial da pgina O nmero da pgina do relatrio em que deve-se iniciar a impresso. Esse recurso til quando deseja-se reiniciar a impresso a partir de uma pgina do relatrio. Fonte A fonte e o tamanho de letra que ser utilizada em todo relatrio. So listadas todas as fontes disponveis no ambiente operacional, porm, o tamanho da fonte estlimitado a 16 pontos. Negrito A fonte utilizada no relatrio pode ser impressa mais grossa que o comum. Sublinhado A fonte utilizada no relatrio pode ser impressa sublinhada, marcada. 1.2- Quadro de Impresso Imprimir Define a apresentao ou inibio dos dados de: cabealho do relatrio, rodap e pginas inicial de configurao dos parmetros. Alm disso, possvel definir o formato de impresso, tais como: retrato ou paisagem. Ricardo Pereira Coelho
1.3- Parmetros do Relatrio Parmetros Permite incluir, editar, excluir, visualizar e preview das perguntas que sero apresentadas na janela de Parmetros, para serem utilizadas no filtro de dados do relatrio configurados no relacionamento da tabela principal da seo. Para isso, deve-se configurar a expresso de filtro da tabela. Exemplo: B1_COD>=MV_PAR01 and B1_COD<=MV_PAR02.
Selecione a opo "Incluir" e, em seguida, clique no boto "Configurao" onde ser apresentada a janela "Novo Grupo de Perguntas". Determine um nome para o grupo de perguntas do seu relatrio, normalmente utilizasse as iniciais do nome do relatrio ou tabela principal com sequencias numrica. Ex: SB1001 Para relao de produtos cadastrados. Clique no campo "Pergunta" e digite a pergunta. Preencha os demais campos conforme a descrio a seguir: Pergunta Espanhol/Ingls Informe a pergunta em espanhol e ingls. Tipo Selecione o tipo da resposta pergunta, se: 1=Caracter, 2=Nmerico ou 3=Data Tamanho Informe o tamanho do campo para resposta pergunta. Decimal Informe o nmero de casas decimais para a resposta nmerica, se necessrio. Formato Informe a mscara para preenchimento deste parmetro. Help Digite um texto explicativo sobre a funo da pergunta. Objeto Selecione como a pergunta ser apresentada na janela, se: 1 = Edit (Formato que permite editar o contedo). 2 = Text (Permite apresentar, como contedo, um texto padro; apenas para visualizao, no poder ser alterado). Ricardo Pereira Coelho
3 = Combo (Formato que apresenta uma lista de opes para seleo dos dados). 4 = Range (Permite definir intervalos de dados seqenciais). 5 = File (Permite selecionar um arquivo do servidor ou da estao local). 6 = Expression (Permite definir uma expresso de filtro). 7 = Check (Permite selecionar at cinco itens). Consulta Padro (Edit) Para habilitar uma consulta (F3) ao campo, selecione a tabela para pesquisa. Contedo (Text) Permite informar o contedo padro para o campo, se o objeto for "1=Edit" ou "2=Text". Pr-seleo (Combo) Se o objeto for "3 = Combo" (lista de opes), pode-se definir qual a opo ser posicionada automaticamente para seleo. Informe de "1" a "5" para identificar as opes, respectivamente. Item 1 a 5 (Combo) Informe, nestes campos, as opes que sero apresentadas para seleo, quando o objeto for "3 = Combo". Pode-se definir at 5 opes para seleo, que devem ser definidas em sequncia (no pode existir lacuna entre as opes). 1.4- Finalizao Para finalizar, clique no boto "Ok". O sistema retornar pasta propriedade.
2-
Sees Especficas
Propriedades
2.1- Clique no boto "Adicionar Seo" relatrio. para incluir uma seo para o
Ser apresentada a janela "Propriedades" da seo especfica.
2.2-
Configurando as propriedades:

Na rea Propriedades, clique na caixa "Ttulo" e informe um ttulo para identificao da seo. Configure as seguintes especificaes: Imprimir Permite definir se os dados dos itens da seo devem ser impressos. Caso a seo seja inibida, somente seus totais de valores sero apresentados, como em um relatrio sinttico. Ttulo da seo Define se ser ou no impresso o ttulo da seo. Clulas em linha Definem se as clulas (campos) sero apresentadas em formato colunar ou em linhas. Se marcada a opo linhas, em "Colunas (clulas em linha)", possvel definir quantas clulas por linha devem ser impressas. Cabealho das clulas Define se os cabealhos das clulas (nome dos campos) devem ser exibidos. No topo da pgina Configura a apresentao do cabealho acima de cada clula (topo da pgina). Aps as quebras Repete o cabealho sempre que houver quebra de pgina. Altura e espaamento entre linhas A altura da linha e o espaamento entre linhas podem ser ajustados. recomendvel que essa configurao seja definida considerando o tamanho de fonte utilizado. Margem esquerda O espao em pontos para margem esquerda da seo. Para a impresso ser considerada a margem do relatrio mais a margem da seo. Quebra linha na impresso de colunas Quando o relatrio possui muitas colunas, dependendo do tamanho da fonte utilizada, pode ocasionar o truncamento de informaes. Assim, com essa opo marcada, se no couberem todas as colunas na mesma linha, o sistema continuar a impresso dos dados na linha seguinte.

Ajustar clulas Se for utilizado um tamanho grande de fonte, pode ser necessrio ajustar o tamanho das colunas para que seja possvel balancear o espao utilizado e prevenir que os dados no sejam truncados. O Protheus proporcionaliza automaticamente todos os tamanhos das colunas, aproximando as informaes conforme a quantidade de posies dos campos. Mesmo assim, pode ocorrer o truncamento dos ttulos e dos dados da coluna caso no haja espao suficiente. Tambm possvel realizar o ajuste individual de clulas, veja no tpico "Clulas". Quebrar pgina antes Marque essa opo para imprimir cada seo em uma nova pgina. Cor Pode-se definir cores em RBG para o fundo e para a fonte da seo. No primeiro boto, define-se a cor de fundo e no segundo boto, a cor da fonte.
Para seleo, selecione a cor desejada do lado esquerdo da janela ou gira o tringulo na direo da cor desejada e arraste o ponto interno at o tom desejado. Ou digita-se as quantidades de Vermelho, Verde e Azul para compor a cor.
Borda possvel imprimir linhas para separar as informaes das sees, utilizando o recurso de bordas. No primeiro boto, define-se a borda para a clula e no segundo boto, define-se a borda para o cabealho da clula.

Para separao das sees, pode-se aplicar borda superior, inferior e lateral, basta clicar em cada lado.
1. Na parte inferior da janela, clique na pasta "Relacionamento".
3-
Relacionamento
Esta opo permite definir em quais tabelas o Sistema deve buscar as informaes que constaro no relatrio. Exemplo: SA1 - Cadastro de Clientes, SA2 - Cadastro de Fornecedores, SC2 - Ordens de Produo, etc. Nesta pasta, possvel selecionar a tabela principal que ser utilizada como base para apresentar as informaes da seo, como tambm filtrar esses dados.
3.1-
Criando um relacionamento
No campo "Tabela" informe o nome/alias da tabela principal. O sistema apresenta na janela as possibilidades de configurao do filtro de dados para impresso do relatrio. No campo "Relacionamento com Seo Anterior", clique no boto "Adicionar Relacionamento" para incluir ou alterar um relacionamento com a seo anterior. Quando se desejar que o relacionamento seja diferente do padro do ambiente. A partir das caixas de listagens de cortina "Campos", "Operadores" e "Expresso", o usurio pode compor o filtro para restringir as informaes a serem consultadas.

Exemplo: Para apresentar todos os produtos em que o cdigo diferente de 0001, deve-se definir a seguinte operao:
Campo Cdigo Operador Diferente de Expresso "0001"
Aps a seleo dos elementos da operao, clique no boto Adiciona. Os elementos escolhidos so apresentados na rea de Filtro. Para informar mais de uma operao utilize os botes de formao de operaes lgicas:
Botes () e Descrio utilizado para agrupar as operaes, estabelecendo a ordem em que devem ser executadas. o sistema permite a informao de mais uma expresso para composio do filtro. Quando se utiliza o operador E, somente so exibidos os registros que atendam a duas ou mais condies especificadas. o sistema permite a informao de mais uma expresso para composio do filtro. Quando se utiliza o operador OU, so exibidos os registros que atendem a qualquer uma das condies especificadas.
ou
Exemplos: Produtos que possuem Unidade igual a "UN" (Unidade) (igual a UN) Assim o sistema ir montando a expresso na rea "Expresso". Se ocorrerem erros na montagem da sua expresso, voc pode iniciar novamente com o boto "Limpa Filtro". Clique no boto "Expresso" caso queira definir uma condio para consulta utilizando uma expresso em linguagem AdvPl. Exemplo: SUBSTR(B1_COD,3,3)="001" O sistema apresenta a tela para digitao da expresso.

Quando finalizada, clique no boto "Adiciona" para que a expresso seja transportada para a rea de "Filtro", ou "Cancela" para retornar tela de gerao de filtros. Clique no boto "Ok" para encerrar o relacionamento. Caso deseje incluir dados de outras tabelas na mesma seo, clique no boto tabelas. "Adicionar Relacionamento" para definir o relacionamento entre as
Aps selecionar a tabela principal, o Sistema permite criar novos relacionamentos; ou seja, possvel combinar dados de vrios arquivos no mesmo relatrio, como por exemplo, uma relao de produtos e seus tipos de entradas e sadas (TES). Para estabelecer uma relao, necessrio que os arquivos possuam pelo menos um campo em comum. No exemplo anterior, o arquivo de Produtos (SB1), possui o campo "B1_TE", onde gravado o cdigo do tipo de entrada do produto; j o arquivo Tipos de Entradas e Sadas (SF4), possui o campo "F4_CODIGO", onde gravado o cdigo do Tipo de Entrada e Sada para sua identificao. Se desejar excluir um relacionamento, clique no boto Relacionamento". Boto "Adicionar relacionamento" 1. Na janela "Adicionar Relacionamento" na qual apresentada. Torna-se necessrio selecionar o relacionamento criado. 2. No campo "Pesquisar Tabela", digite o nome da tabela relacionada. "Excluir

Observe que a informao de "Expresso Tabela Relacionada" foi alterada com o nome do campo escolhido da tabela secundria e comum tabela principal. 3. Clique, ento, no boto "Criar" para confirmar o relacionamento. Ser apresentada a janela para escolher a tabela e montar as expresses do relacionamento.
4. Clique no boto "Consultar Campos", apresentado ao lado do campo "Expresso Tabela Principal", para selecionar um ou mais campos da tabela principal que sero utilizados para o relacionamento. Ser apresentada a janela "Consultar Campo" com a relao dos campos da tabela principal.

5. Clique sobre o campo chave para o relacionamento e, em seguida, clique no boto "Ok". Observe que o campo selecionado foi apresentado no campo "Expresso Tabela Principal".
Em alguns casos, necessrio criar relacionamentos com mais de um campo para que a informao esteja realmente individualizada ou separada. Por exemplo: Tratando-se de um relatrio com a tabela principal baseada no Ricardo Pereira Coelho
Cadastro de Clientes, pode ser interessante criar o relacionamento com os campos "Cdigo do Cliente" e "Loja" (A1_COD+A1_LOJA), isto garante que o relatrio ir apresentar os dados separados para cada loja do cliente. 6. Para adicionar um campo chave de relacionamento da tabela principal, clique novamente no boto Tabela Principal". apresentado ao lado do campo "Expresso
Ser reapresentada a janela "Consultar Campo" com a relao dos campos da tabela principal. 7. Clique sobre o outro campo chave que ir compor o relacionamento e, em seguida, clique no boto "OK". Observe no campo "Expresso Tabela Principal" foi includo o sinal de "+" e o campo selecionado. Caso seja necessrio adicionar mais campos para separar as informaes, repita estes procedimentos at incluir todos os campos necessrios para composio da chave de relacionamento. 8. Aps definir todos os campos chaves da tabela principal, deve-se selecionar a tabela secundria. Para tanto, no campo "Pesquisa Tabela", digite o nome da tabela que ser relacionada.
9. Em seguida, clique no boto Tabela Relacionada".
apresentado ao lado do campo "Expresso

Ser apresentada a janela "Consultar Campo" com a relao dos campos da tabela relacionada. 10. Clique sobre o campo e, em seguida, no boto "Ok". 11. Da mesma forma que na tabela principal, repita esta operao para adicionar todos os campos que devem compor a chave de relacionamento.
2. Para finalizar o relacionamento entre estas tabelas, clique no boto "Finalizar". A janela "Adicionar Relacionamento" reapresentado. 3. Clique no boto "Confirmar". O sistema retornar janela de Relacionamento.
Clulas
Cada seo apresenta um conjunto de clulas. As clulas so as colunas dos campos apresentados pelas sees do relatrio. Para adicionar ou inibir colunas, e definir seus atributos, basta clicar sobre a barra "Clula" apresentada na parte inferior da janela. No lado esquerdo, so relacionados os campos das tabelas de dados utilizadas no relatrio. No lado direito "Clulas" so relacionados os campos selecionados para apresentao na seo que est sendo definida.

Configurando as clulas:
1. Na rea esquerda, clique no boto apresentado ao lado do nome da tabela que ter seus campos escolhidos. Sero listados os campos da tabela. 2. Clique sobre o nome do campo que deve ser apresentado no relatrio e, em seguida, no boto "Adicionar". O nome do campo adicionado na rea direita. 3. Para adicionar todos os campos em uma nica operao, clique no boto "Adiciona Todos". O sistema adiciona todos os campos da tabela na rea direita. 4. Se necessrio remover algum campo da lista, utilize os botes "Remover e "Remover Todos" para remover um ou todos os campos, respectivamente. 5. Observe no lado direito da janela a definio da propriedade da clula. Ttulo: sugerido o ttulo do campo, mas, pode ser alterado. Tamanho: Quantidade de posio reservadas para exibio dos dados da clula. sugerido o tamanho do campo. Ricardo Pereira Coelho
Mscara: Formato para apresentao dos dados em sintaxe AdvPL. sugerida a mscara padro do campo. Alinhamento e Alinhamento de Ttulo Alinhamento dos dados das clulas e do ttulo. Com o alinhamento automtico, o Protheus analisa o tipo de campo e alinha esquerda se caractere, memo, data ou lgico e direita se numrico, desde que esteja configurado no Dicionrio de Dados. Totalizar Seo Define o tipo do acumulador criado (no totaliza, contador, ltimo valor, totalizar, valor mdio, valor mnimo e valor mximo) para a clula que ser impressa na quebra de uma seo ou do agrupamento. Auto ajustar Da mesma forma que o ajuste da seo, possvel definir individualmente o ajuste automtico da largura da clula. Quebra linha (para texto longo) Se o campo for do tipo caracter ou memo, ser efetuada a quebra automtica de linha para exibio de todo o texto. Considerar o tamanho do cabealho Caso o tamanho do dado a ser impresso for menor que o cabealho, ser considerado o tamanho do cabealho. Se essa caixa no for habilitada, at mesmo o ttulo da clula poder ser cortado para que seja possvel ajustar a visualizao dos dados. Considerar no agrupamento Esta clula ir fazer parte do grupo de quebra. Esta configurao permite apresentar de forma agrupada os registros com informaes comuns, facilitando a anlise, organizao do relatrio. Por exemplo: um relatrio de solicitaes de compras agrupadas por fornecedores. Nesse caso, tambm importante que a ordem do relatrio esteja definida por fornecedores.

Cor e Borda Da mesma forma que a configurao da seo, pode-se especificar bordas, cor de fundo e fonte especificamente para uma clula. Boto "Condicional" Permite criar, editar e excluir condies para impresso dos dados com cores diferenciadas.

Exemplo: Saldo atual do produto > 0 (Cor de fundo branco e cor da fonte preta) Saldo atual do produto <= 0 (Cor de fundo branco e cor da fonte vermelha) Definindo frmula/expresso: A criao de frmulas permite realizar clculos com as clulas selecionadas para o relatrio. possvel criar estruturas complexas de frmulas, utilizando comandos AdvPL. A elaborao de frmulas devem ser realizada de forma criteriosa, pois, pode comprometer a performance do processamento do relatrio, Para cada linha impressa da clula, o Protheus precisa calcular a frmula novamente. 1. Clique no boto "Formula" e, em seguida, no boto "Adicionar". Ser apresentada a janela a seguir, onde no lado direito da janela, so relacionadas s clulas do relatrio.

2. Clique no boto "Ok" para confirmar. O sistema retorna janela Clulas. 3. Para editar, selecione uma frmula e clique no boto Definindo os Acumuladores Os acumuladores permitem criar clulas com total, mdia, mnimo e mximo baseado em outras clulas numricas e tambm criar clulas de contagem de ocorrncias baseado em qualquer dado. 1. Clique no boto "Acumulador" e, sem seguida, - "Editar".
no boto "Adicionar". A partir de um acumulador tambm so criados grficos para apresentao ao final do relatrio. Ser apresentada a janela Acumulador dvida em 3 reas:

Acumulador Ttulo Define o tipo de acumulador que ser criado: se totalizador, valor mnimo, mximo, mdia ou contador de ocorrncias. Agrupar por Os acumuladores so criados baseados em uma clula agrupadora, por exemplo: para criar um acumulador que totalize as comisses faturadas pela venda de cada cliente, necessrio que os valores estejam agrupados por cliente. Nessa caso, basta dar um duplo clique sobre o nome da clula Cliente, na relao de celulas direita, para inclui-la no campo "Agrupar por". possvel agrupar o acumulador por mais de uma clula. Frmula dado que ser acumulado. Por exemplo: Comisso. Nesse caso, basta dar um duplo clique sobre o nome da clula Comisso, na relao de celulas direita, para inclui-la no campo "Frmula". Pode-se utilizar expresses em AdvPL para composio do acumulador. Imprimir no final do relatrio Ricardo Pereira Coelho
Os acumuladores podem ser impressos separadamente ao final do relatrio como uma estatstica dos dados apresentados. Formulando Grfico A partir do acumulador podem-se criar diferentes tipos de grficos (barra, linha, pizza etc). Os grficos so gravados em arquivo .BMP, com o mesmo nome do arquivo do relatrio. Se existirem vrios acumuladores com grficos, os arquivos .BMP sero gravados em sequncia (matr1501.bmp, matr1502.bmp, etc) no diretrio de spool. Se excludo o arquivo .BMP, o grfico deixar de ser exibido.
Nome Define um nome para o grfico. Nome da sria Define o nome para a srie do grfico. Imprimir no final do relatrio O grfico ser apresentado ao final do relatrio. Ricardo Pereira Coelho
Clula Ttulo Define um ttulo para a clula. Tamanho Define o tamanho da clula para a sria do grfico. Mscara Define o formato do dado que ser impresso. Imprimir Um acumulador pode ser utilizado apenas para criao de grfico, assim, se no houver interesse em apresent-lo no relatrio, basta desmarcar esta opo.

Executando um relatrio pronto O sistema permite imprimir um relatrio pronto, mesmo no estando aberto; ou seja, em configurao. 1. Na janela principal, clique no boto ferramentas. - "Executar relatrio" na barra de
Ser apresentada a janela Selecione o arquivo.
2. Selecione o diretrio e o arquivo desejado e clique no boto "Abrir". O sistema apresentar janela Imprimir - XXXX, com as possibilidades de configurao da impresso. 3. Configure os dados necessrio e clique no boto "Imprimir". O sistema apresentar o relatrio.


Appostila Protheus Report

Enviado por

Direitos autorais:

Formatos disponíveis

Appostila Protheus Report

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Appostila Protheus Report

Enviado por

Direitos autorais:

Formatos disponíveis

PROTHEUS 11

Ricardo Pereira Coelho

Ricardo Pereira Coelho

Ser apresentada a janela "Propriedades" da seo especfica.

Ricardo Pereira Coelho

Ricardo Pereira Coelho

Ricardo Pereira Coelho

1. Na parte inferior da janela, clique na pasta "Relacionamento".

Ricardo Pereira Coelho

Ricardo Pereira Coelho

Ricardo Pereira Coelho

Ricardo Pereira Coelho

9. Em seguida, clique no boto Tabela Relacionada".

apresentado ao lado do campo "Expresso

Ricardo Pereira Coelho

Ricardo Pereira Coelho

Ricardo Pereira Coelho

Ricardo Pereira Coelho

Ricardo Pereira Coelho

Ricardo Pereira Coelho

Ricardo Pereira Coelho

Ser apresentada a janela Selecione o arquivo.

Ricardo Pereira Coelho

Você também pode gostar