TREPORTS

Março
TODOS OS DIREITOS RESERVADOS 2019
AGENDA

 Introdução ao TReports

 RAC

 Instalador

 Estrutura e funcionalidades

 Mão na massa!

 Provedor Protheus
01
INTRODUÇÃO
TREPORTS: O QUE É?

?
?
?
?
? O que é o TReports ?
? ? ? ?

É uma solução independente de plataforma

e linha de produto para criação e geração
de relatórios.
Quais são as vantagens em
utilizar o TReports?
 Acesse seus
relatórios de
qualquer lugar!
O TReports é 100% web e responsivo,
logo é possível visualizar os relatórios
de qualquer dispositivo que suporte
HTML 5.
 Visualize os
relatórios do
seu jeito!
O TReports permite que o usuário
crie seus próprios relatórios de
forma customizada, trazendo uma
maior flexibilidade e evitando a
criação de relatórios fixos no
produto.
• Agendamento de geração de relatórios
• Agendamento com recorrência
configurável
• Alteração de parâmetros e filtros por
geração
• Escolha o formato de saída do seu
relatório (PDF, XLSX, DOCX, TXT, etc...)
 Explore as • Relacionamento entre entidades
• Matrizes (Pivot Table)
funcionalidades • Tabelas
Gráficos
do TReports! •
• Expressões
O TReports possui uma série de
• Sub-Relatórios
funcionalidades que aceleram e • Texto-Rico (Inserção de dados em textos
facilitam o desenvolvimento, além formatados)
de agregar ainda mais valor ao seus
relatórios e consequentemente ao • Códigos de barra
resultado do seu negócio. • QR Code
• Fotos, imagens
• Exportação e importação de template de
relatórios
 Melhore ainda
mais a experiência
do usuário!
• APIs REST para geração, agendamento e consulta de
relatórios
O TReports permite uma integração
completa com qualquer produto. • Página de exibição de relatório e manipulação de filtros
Basta seguir as documentações de para embarcar em aplicações terceiras
como construir esta integração e o
usuário continuará desfrutando de • Possibilidade de autenticação integrada ao produto
uma experiência única. terceiro

• Possiblidade de criação de provedor de dados de

aplicação integrada
02
RAC
RAC

RAC (Resource Access Control) é responsável pela autenticação e controle de

usuários e permissões de acesso da aplicação.

Todo e qualquer novo produto TOTVS deverá se autenticar com o RAC.

Desenvolvido e mantido pela equipe de Framework (TNF) da TOTVS POA.

Trabalha com o protocolo oAuth 2.0 e seus fluxos.

https://imasters.com.br/desenvolvimento/como-funciona-o-protocolo-oauth-2-0
RAC

Conceito Multi-Tenancy: arquitetura de software na qual uma única instância

de software é executada em um servidor e atende a vários tenants. Um tenant
é um grupo de usuários que compartilham um acesso comum com privilégios
específicos à instância do software.

Admin do RAC: é o usuário administrador do RAC, em uma arquitetura em

nuvem, o admin do RAC será o admin do servidor em Cloud que controla a
aplicação (login: admin / senha: 123qwe).

Admin do Tenant: é o usuário administrador do Tentant responsável pela

aplicação no cliente. É com este usuário que os acessos à aplicação serão
controlados, fazendo a criação de perfis e usuários (login: admin / senha:
totvs@123).
RAC

Como admin do RAC:

Cadastrar o Tenant.
Cadastrar Perfil e Usuários (admin do RAC).
Cadastrar Clientes oAuth.
Cadastrar Autenticação Externa.

Como admin do Tenant:

Cadastrar Organizações
Cadastrar Perfil e Usuários da aplicação (admin do Tentant e Aplicação).
RAC

Cliente oAuth
• é o cliente que possui um usuário (ClientId) e senha (ClientSecret) que cada Produto (no caso o TReports) possui para fazer a
integração com o RAC.

• Nome do produto: O produto informado no Cliente oAuth deve estar associado a um Tenant, para quando o Produto (no caso o
TReports) subir com o seu usuário e senha (ClientId e ClientSecret) as Features (Permissões) possam ser associadas ao Tenant com
este mesmo Produto.

• Tempo de expiração do Token: Tempo que a sessão do usuário logado ficará ativa no servidor até expirar (o produto TReports faz
o renew de acordo com esse tempo).

• Fluxo de autenticação: o TReports utiliza o Fluxo Hibrido do oAuth, mas os produtos que integrarem com o TReports usarão o
fluxo Resource Owner. http://tdn.totvs.com/pages/viewpage.action?pageId=417701686

• URL de Logout: Url que o usuário será enviado após fazer o Logout da aplicação.

• URL de redirecionamento: Url que o RAC deverá chamar logo após o usuário realizar Login na aplicação. (Esta URL também valida
se quem pediu o login é uma aplicação confiável).

• Chave de acesso: são as senhas (ClientSecret) do ClientId. Um ClientId pode ter mais de um ClientSecret.
RAC

Configuração do login externo

Deverá ser configurado através do menu “Autenticação Externa” do RAC.

Esta configuração é por Tentant, desta forma, edite o Tentant a configurar.

Obs: Esta configuração deve ser fornecida pela aplicação integradora.

Exemplo: Autenticação externa com o RM

Endereço de validação da credencial:

http://localhost:8051/rest/RMSUserRestService/ValidateCredentials

Endereço para obter informações do usuário:

http://locahost:8051/rest/RMSUserRestService/Users
03
INSTALADOR
INSTALADOR

 Instalação do TReports

- Requisitos de Hardware e Software

- Bancos de Dados
- Navegadores
http://tdn.totvs.com/display/public/LRM/Portabilidade+TReports

- Passo a passo da instalação

- Configuração do RAC
http://tdn.totvs.com/pages/viewpage.action?pageId=360451406
04
ESTRUTURA E
FUNCIONALIDADES
ARQUITETURA: TREPORTS, TRAC e ERP
CADASTROS E ESTRUTURA DE DADOS

• Provedor de dados http://tdn.totvs.com/display/LRM/Provedor+de+Dados

• Grupos de relatórios http://tdn.totvs.com/pages/viewpage.action?pageId=311632287
• Relatórios http://tdn.totvs.com/pages/viewpage.action?pageId=311632292
• Estrutura http://tdn.totvs.com/display/LRM/Estrutura
• Conexões http://tdn.totvs.com/pages/viewpage.action?pageId=311632305
• Parâmetros http://tdn.totvs.com/pages/viewpage.action?pageId=311632309
• Fonte de dados http://tdn.totvs.com/display/LRM/Fonte+de+Dados
• Entidades http://tdn.totvs.com/display/LRM/Entidades
• Relacionamentos http://tdn.totvs.com/display/LRM/Relacionamentos
• Filtros http://tdn.totvs.com/display/LRM/Filtro
• Designer https://treportsdemo.azurewebsites.net
• Gerar http://tdn.totvs.com/display/LRM/Gerar
• Exportar e Importar http://tdn.totvs.com/display/LRM/Exportar+e+Importar
• Relatórios agendados http://tdn.totvs.com/pages/viewpage.action?pageId=311632387
• Relatórios gerados http://tdn.totvs.com/pages/viewpage.action?pageId=311632394
• Configurações http://tdn.totvs.com/pages/viewpage.action?pageId=385866502
 ESTRUTURA: FLUXO PARA CRIAÇÃO DE UM RELATÓRIO

Parâmetros
Entidades Fontes de Dados Conexões Provedores de Dados
Relacionamentos Filtros

Banco de Dados

Nuvem

Design do Relatório
Campos a serem Tabelas Físicas
utilizados Sentenças SQL

Serviço REST Banco de Dados

Relatório Agendado Relatório Gerado Provedor Integrado

03
MÃO NA MASSA!
EXEMPLOS: COLOCANDO A MÃO NA MASSA!

Acessar o TReports
http://treportsdemo.eastus.cloudapp.azure.com/treports

Login
usuário: treinamento
senha: totvs
EXEMPLOS: RELATÓRIOS EM QUE IREMOS TRABALHAR

 Treina01 – Relatório Template

Objetivo:

Explorar o recurso de importação e exportação de relatórios, trazendo informações

comuns no cabeçalho e rodapé, padronizando os seus layouts.

Observação:

Quando o componente de sub-relatório for implementado (RoadMap deste ano), o

recurso de template pode ser utilizado através deste componente.
EXEMPLOS: RELATÓRIOS EM QUE IREMOS TRABALHAR

 Treina02 – Lista de Funcionários

Objetivo:

Criar uma listagem simples de dados ordenada pelo nome do funcionário, com fonte
de dados do tipo tabela e criação de estilos (zebra).

Entidade: Funcionários (PFUNC)

Campos: CHAPA, DATAADMISSAO, NOME, SALARIO

Observação:

As fontes de dados do tipo tabela permitem a criação de filtros no relatório.

EXEMPLOS: RELATÓRIOS EM QUE IREMOS TRABALHAR

 Treina03 – Funcionários e seus Dependentes

Objetivo:

Criar um relatório mestre/detalhe com dados de funcionários e dependentes, fonte

de dados do tipo tabela, relacionamentos, filtros e visibilidade de grupos que não
possuir informação.

Entidade: Funcionários (PFUNC)

Campos: CODCOLIGADA, CHAPA, DATAADMISSAO, NOME, SALARIO

Entidade: Dependentes (PFDEPEND)

Campos: CODCOLIGADA, CHAPA, NRODEPEND, NOME, DTNASCIMENTO, SEXO
Campo relacional: GRAUPARENTESCO (PCODPARENT.DESCRICAO)

Observação:

As fontes de dados do tipo tabela permitem a criação de filtros no relatório.

EXEMPLOS: RELATÓRIOS EM QUE IREMOS TRABALHAR

 Treina04 – Funcionários por Seção

Objetivo:

Criar um relatório mestre/detalhe com dados de funcionários por seção, fonte de

dados do tipo Sentença SQL, parâmetros, agrupamento de banda e totalizadores.

Entidade: SecaoFunc (SQL)

Campos: PFUNC.CODCOLIGADA, PFUNC.CODSECAO, PFUNC.CHAPA,
PFUNC.DATAADMISSAO, PFUNC.NOME, PFUNC.SALARIO, PSECAO.DESCRICAO

Observação:

As fontes de dados do tipo SQL permitem a criação de parâmetros no relatório.

Neste exemplo, o relacionamento é criado na própria fonte de dados.
EXEMPLOS: RELATÓRIOS EM QUE IREMOS TRABALHAR

 Treina05 – Relatório em três níveis

Objetivo:

Explorar as bandas de detalhe com a ligação das entidades de relacionamento e

mostrar quando o relacionamento possui mais de uma opção de ligação.

Entidade: Clientes/Fornecedores (FCFO)

Entidade: Movimentações (TMOV)
Entidade: Itens das Movimentações (TITMMOV)

Observação:

Deve-se ter atenção as ligações, ou seja, os sub-detalhes serão ligados as entidades

de relacionamento e não às entidades originais.
EXEMPLOS: RELATÓRIOS EM QUE IREMOS TRABALHAR

 Treina06 – Currículo Funcionário

Objetivo:

Criar um relatório de currículo com foto e dados pessoais, fonte de dados do tipo
tabela, utilização dos campos relacionados e campos SQL da entidade e componente
Texto Rico com carregamento RTF.

Entidade: Funcionários (PFUNC)

Campos: CODCOLIGADA, CHAPA, NOME, SALARIO, CODPESSOA
Campo relacional: IMAGEM (PFUNC -> PPESSOA -> GIMAGEM)
Campo SQL: DadosPessoa (PPESSOA)

Observação:

O componente Texto Rico não estará disponível na versão 12.1.24, pois a DEVEX
ainda não realizou a migração do mesmo para o .NET Core.
EXEMPLOS: RELATÓRIOS EM QUE IREMOS TRABALHAR

 Treina07 – Gráfico de Barra

Objetivo:

Explorar o gráfico de barras mostrando o total de salários por seção.

Observação:

Acrescentaremos o gráfico no rodapé do relatório Treina04.

Utilize o recurso de exportação e importação para criar o novo relatório de gráfico.

EXEMPLOS: RELATÓRIOS EM QUE IREMOS TRABALHAR

 Treina08 – Gráfico de Linha

Objetivo:

Explorar o gráfico de linhas mostrando o histórico salarial do funcionário.

Entidade: Funcionários (PFUNC)

Campos: CODCOLIGADA, CHAPA, NOME, SALARIO

Entidade: Histórico Salarial (PFHSTSAL)

Campos: CODCOLIGADA, CHAPA, DTMUDANCA, MOTIVO, SALARIO
Campo Relacional: MOTIVO (PMOTMUDSAL.DESCRICAO)
06
PROVEDOR
PROTHEUS
OBRIGADO
Gustavo Matos
TOTVS BH – Squad BI e TOOLS

gustavo.matos@totvs.com.br

totvs.com company/totvs
@totvs fluig.com