Appostila 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 11
Educao Corporativa

Protheus Report

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, diferenciando-
se 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.

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).

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" para incluir uma seo para o
relatrio.
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 Operador Expresso
Cdigo Diferente de "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 Descrio
( ) utilizado para agrupar as operaes, estabelecendo a ordem em que devem ser executadas.
e 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.
ou 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.

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 "Adicionar Relacionamento" para definir o relacionamento entre as
tabelas.

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 "Excluir
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.

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

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 apresentado ao lado do campo "Expresso
Tabela Principal".

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 apresentado ao lado do campo "Expresso
Tabela Relacionada".

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.


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 - "Editar".

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,
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

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.


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 - "Executar relatrio" na barra de
ferramentas.
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

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

Ricardo Pereira Coelho

Avenida Segunda Avenida com a rua H-44 - Condomnio Cidade Empresarial

Você também pode gostar