Páginas filhas
  • Smart View - Configuração do produto Protheus integrado ao Smart View

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações
titleLogs

É possível ver os logs da integração ligando a chave FwTraceLog=1 no INI do ambiente utilizado, para mais informações sobre a chave: Chaves para controle de logs

Índice

Índice
maxLevel2
excludeÍndice

Pré-requisitos

  • Já ter feito a instalação e integração com o TReportsSmart View, mais informações nos links:

           Instalação do TReportsSmart View: https://tdn.totvs.com/pages/releaseview.action?pageId=626636542

...

           Necessário utilizar o REST 2.0 - https://tdn.engpro.totvs.com.br/display/framework/Entendendo+as+novidades+do+REST

Documentações relacionadas

Configuração na interface do

...

Smart View

Expandir
titleInstalação simplificada

A partir da LIB Label 20241007 e com o Agent do Smart View atualizado (documentação: Instalação do Sistema) estará disponível a instalação facilitada, com ela em apenas 2 etapas você já conseguirá utilizar a integração com o Smart View, sem precisar de configurações adicionais, mais informações abaixo.

Endereço: http://{ip cadastrado}:7019/startup

...

Página inicial

Página inicial da interface de configuração do novo treportsImage Removed

Provedor de segurança automático

/storage-provider

Armazenamento de Dados

Image Added

Informações

O usuário utilizado no login deve ter permissões para criar bancos de dados e criar, alterar e deletar tabelas.

Após clicar em "Testar Conexão" deverá criar corretamente os dados necessários:

Image Added

Na etapa de Armazenamento de Dados será definido qual banco de dados será utilizado para o Smart View, é um banco que deve ser apartado do Protheus, sendo possível escolher entre os tipos SQLite, PostgreSQL e SQL Server e Oracle. Mais informações na documentação: Configurações do Sistema


Configurações da Integração

Informações
titleLIB Label

Recurso disponível a partir da LIB Label 20230515

Informações
titleConfiguração REST

Necessário ter a chave SECURITY do rest ligada na seção HTTPREST para a utilização da descoberta automática.

Mais informações sobre as configurações do REST: 01. Configuração

...

Para uso do rest com ssl é necessário que o certificado esteja instalado corretamente na máquina, conforme doc: Porta Multiprotocolo - Instalação de Certificado

Ao acessar o catalogo do rest, ele deverá estar seguro (para que a conexão seja feita corretamente pelo smart view):

Image Added

Rest com ssl: Exemplo com SSL

Image Added

Nome do provedor: sua preferência

Endereço de descoberta: http://[host]:[porta do rest]/[uri protheus]/.well-known/treports/security

...

Provedor de segurança manual

Imagem do provedor de segurança do TReportsImage Removed

Nome do Provedor: sua preferência

Endereço de criação do token: http://[host]:[porta do rest]/[uri protheus]/api/oauth2/v1/token

...

Após preencher os dados, clicar em "Conectar ao ERP" e preencher com usuário admin do Protheus e sua respectiva senha do ambiente do Rest cadastrado.

Com a instalação facilitada, nesse momento o endereço e porta do License já serão recuperados e preenchidos na configuração, você poderá validar clicando em "Configurações avançadas" > Servidor de Licença > Verificar disponibilidade

Image Added

Após a conclusão da configuração, o sistema realizará comunicações automáticas com o Protheus. Se a comunicação for bem-sucedida, o conector nativo será criado automaticamente no Smart View, e a URL correspondente será gerada no Protheus, eliminando a necessidade de realizar essa etapa que antes era manual (Smart View - Autenticação Token Protheus)

Image Added


Image Added

Caso de erro em alguma das etapas, verificar os logs do Agent, que fica no diretório de instalação na pasta Logs e se necessário faça as duas últimas etapas manualmente, criando o conector nativo (desmonstrado abaixo na configuração que foi depreciada) e criando a URL do Smart View no Protheus (Smart View - Autenticação Token Protheus).

Informações

Com a configuração concluída, todos os usuário do Protheus terão acesso ao Smart View

...

Endereço base da Api: http://[host]:[porta do rest]/[uri protheus]

Expandir
titleConfigurações de instalação (depreciada)

Endereço: http://{ip cadastrado}:7019/startup

Página inicial

Página inicial da interface de configuração do novo treportsImage Added

Provedor de segurança automático

Aviso

Configuração obrigatória do provedor com descoberta automática, a descoberta manual foi depreciada e algumas funcionalidades não estarão disponíveis.

Informações
titleConfiguração REST

Necessário ter a chave SECURITY do rest ligada na seção HTTPREST para a utilização da descoberta automática.

Mais informações sobre as configurações do REST: 01. Configuração

Image Added

Nome do provedor: sua preferência

Endereço de descoberta: http://[host]:[porta do rest]/[uri protheus]/

...

.well-known/treports/security

Após preencher os dados, clicar em 'Recuperar emissor' e preencher com usuário admin do Protheus e sua respectiva senha do ambiente do Rest cadastrado.

Recuperação de EmissorImage Added

Imagem do provedor de segurança do TReportsImage Removed

...


Informações

Com a configuração do Provedor de Segurança, todos os usuário do Protheus terão acesso ao Smart View

Servidor de Licença

Imagem do servidor de licença do TReportsImage Modified

Ip do Servidor: Informe o IP do servidor utilizado no License Server

Porta: Informe a porta cadastrada no seu License Server

CNPJ: Informe o CNPJ da sua empresa

Após preencher as informações, verificar a disponibilidade.

Imagem do servidor de licença do TReportsImage Modified

Provedor de Dados

Imagem do provedor de dados do TReportsImage Modified

Informações

O usuário utilizado no login deve ter permissões para criar bancos de dados e criar, alterar e deletar tabelas.

Na etapa de Provedor de Dados será definido qual banco de dados será utilizado para o

...

Smart View, sendo possível escolher entre os

...

tipos SQLite, PostgreSQL e SQL Server. Mais informações na documentação: Configurações do Sistema (Versões 3.5 e Anteriores)

Fim da configuração

Após configurar o Provedor de Dados, será apresentado a tela final de configuração, clique em "Abrir o TReports":

Imagem do fim da configuração do TReportsImage Modified

Login no TReports

Imagem do login do TReportsImage Removed


Provedor Nativo

Aviso
titleRecursos padrões

Para a utilização de recursos padrões, disponíveis a partir da release 12.1.2310 e objetos de negócios criados para o Protheus (fonte TLPP), é necessário fazer a configuração do Provedor Nativo.

Configure apenas 1 Provedor Nativo no Smart View

Lembrando que é necessário fazer a configuração do Token Protheus após todas as configurações do Smart View.

Conector NativoImage Added

Conector NativoImage Added

Nome do Provedor: sua preferência

Endereço do provedor: http://[host]:[porta do rest]/[uri protheus]/.well-known/treports/connector

Login no Smart View

Após as configurações o Smart View estará disponível na porta indicada na instalação (padrão 7017)

Imagem do login do TReportsImage Added

Para verificar as configurações do Conector Nativo, o acesso deverá ser feito pelo usuário Administrador configurado nas etapas anteriores.Logar no Treports com o usuário Admin e sua respectiva senha. 


Informações
titleProxima etapaProvedor SQL

Para iniciar o uso da ferramenta configure um conector. Link para mais informações Configurando Conectores.Obs.: Para a utilização da classe IntegratedProvider na criação de objetos de negócio é necessário configurar o provedor nativoinformações sobre o provedor SQL, verificar a documentação: Conectores.