Protheus x Smart View Parte 3 — Criando um relatório
Chegamos a terceira parte dos artigos sobre a Integração Protheus x Smart View.
Para quem ainda não deu uma olhada nos artigos anteriores, deixo aqui os links:
- Protheus x Smart View Parte 1 — Como iniciar a integração
- Protheus x Smart View Parte 2 — Criando um Objeto de Negócio
Nesta parte do artigo, irei mostrar como criar um relatório e passar pela etapa com mais recursos, que é o design do relatório. Embora não seja possível abordar todos os recursos disponíveis no Smart View nesta etapa, vou mostrar aqueles que podem ser úteis e aplicados em outros modelos de relatórios. Vamos começar!
Passos para iniciar a criação do relatório
O legal é que nesse ponto começamos a visualizar o que foi feito no fonte do Objeto de Negócio, como o nome da área, o nome ‘amigável’ do objeto e sua descrição.
Na próxima etapa temos uma pré-visualização dos dados retornados do nosso Objeto de Negócio:
Nessa etapa é possível adicionar filtros/parâmetros no seu relatório.
Design do relatório
Chegamos à parte de desenhar o layout do relatório. Vou explicar cada detalhe para que todos possam entender como o layout de exemplo foi criado.
No final do artigo, fornecerei o link para o repositório com o layout pronto para importação, para que todos possam explorá-lo, entender melhor e fazer as alterações desejadas. Vamos lá!
Entendendo as bandas (bands) do design
Inicialmente o relatório contém 3 bandas, sendo elas:
- TopMargin1 (Margem superior)
- Detail1 (Detalhes do relatório)
- BottomMargin1 (Margem inferior)
No exemplo que vamos construir precisaremos adicionar mais 2:
- GroupHeader1 (Cabeçalho de grupo)
- GroupFooter (Rodapé de grupo)
Para isso, seguir os passos:
As bandas de Group foram adicionadas para que possamos fazer um agrupamento de dados, conforme formos avançando isso ficará claro.
A largura das bandas definem o tamanho que ela ocupará na página. Para que uma banda ocupe um tamanho menor do relatório, o tamanho deve ser ajustado.
Criando o cabeçalho (que ficará no TopMargin1)
Formatação de cada elemento
A partir daqui serão utilizados alguns elementos repetidos, como as labels, para não ficar muito repetitivo não detalharei tanto eles.
Lembrando que essa formatação não é uma regra, fica ao seu critério deixar os tamanhos maiores ou menores, mudar a cor da fonte etc.
Lembre-se de sempre ir apertando o botão de salvar na tela de design, para não perder as suas alterações.
Antes de mostrar os componentes da banda GroupHeader1 iremos definir um agrupamento para a mesma
Aqui estamos definindo que essa banda será agrupada pelo campo Fornecedor, ou seja, todos os dados com o mesmo Fornecedor ficarão juntos.
Com a quebra de página definida como ‘Antes da Seção’ a cada troca de Fornecedor será feita a quebra.
Adicionando os elementos do GroupHeader1
A qualquer momento podemos selecionar o botão Preview para ter uma ideia de como esta ficando o relatório:
Detail do relatório
A banda de detalhe define os dados que serão impressos no relatório, ali estamos imprimindo informações do Produto.
Adicionando os elementos do GroupFooter1
Essa última banda é mais simples, tem apenas um separador e um totalizador, que indicará a quantidade de Produtos por Fornecedor, ou seja, a cada agrupamento feito.
Neste exemplo não utilizaremos o BottomMargin1, basta dar 2 cliques em cima da banda que ela ficará recolhida e com a cor cinza, é possível fazer isso em qualquer banda e não irá apagar os elementos contidos nela.
Compartilhamento do Relatórios
Após a tela de design nos deparamos com a tela de compartilhamento.
Como funciona? Neste momento apenas o usuário que criou o relatório consegue visualizar o mesmo, para que outros usuários consigam visualizar/editar o recurso criado, é necessário adicioná-los ao compartilhamento, é possível compartilhar com usuários ou grupos. Confira a documentação completa clicando aqui!!
Resultado final
Assim ficou o relatório criado:
Veja este layout completo aqui: ArtefatosTReportsxProtheus
Documentações: