Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 6

changes.mady.by.user Rodrigo Silva Costa

Gravado em

comparado com

Nova versão 7

changes.mady.by.user Rodrigo Silva Costa

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Painel
titleColor#FFFFFF
titleBGColor#0897E9
titleDatasul x Smart View
  1. Conceito/Arquitetura Smart View
  2. Instalação do Smart View
  3. Configuração integração Smart View X Datasul
  4. Uso de relatório expedido para o Smart View
  5. Edição de um layout de relatório
  6. Criação de um objeto de negócio


Âncora
1.Conceito
1.Conceito

Aqui será descrito a arquitetura

Painel
borderColor#FF9900
titleColorwhite
titleBGColor#FF9900
title1. Conceito/Arquitetura Smart View


A arquitetura do Smart View integra ao Datasul por meio de comunicação mútua e compartilhamento de informações, onde o Smart View irá consumir os dados do ERP Datasul e fornecer para que o usuário monte, de acordo com as necessidades da área, os relatórios com estas informações.


draw.io Diagram
bordertrue
diagramNameDTSxSV
simpleViewerfalse
width
linksauto
tbstyletop
lboxtrue
diagramWidth451
revision1


Âncora
2.Instalação
2.Instalação
  ↑ Integração com o Smart View

Painel
borderColor#FF9900
titleColor#FFFFFF
titleBGColor#FF9900
title2. Instalação do Smart View

O SmartView Smart View precisa estar instalado em um servidor de sua preferência para a criação dos layouts, que posteriormente serão utilizados na geração dos relatórios, bem como integrações dos objetos de negócio, retorno de dados e validações de segurança com o ERP Datasul.


Painel
borderColor#363636
titleColorwhite
titleBGColor#363636
titleInstalação
Deck of Cards
idInstall
Card
defaulttrue
idwindows
labelWindows
  1. Faça download do Instalador do Smart View Agent clicando neste link;
  2. Extrair todo o conteúdo do arquivo zip e execute o arquivo 
    Estado
    subtletrue
    titleSmartView.AgentInstaller.exe
     ;

  3. Selecione o diretório de instalação e prossiga para a próxima etapa. Recomendamos que a instalação seja feita no diretório

    Estado
    subtletrue
    titleC:\TOTVS
    ;

  4. O instalador irá realizar a instalação na pasta
    Estado
    subtletrue
    titlesmart-view
    , criada automaticamente no diretório selecionado;
  5. Caso o diretório
    Estado
    subtletrue
    titlesmart-view
    já exista, o instalador perguntará se deseja sobrescrever a instalação anterior, caso não queira, um novo diretório deverá ser informado; 

  6. Após conclusão, o Smart View já se encontra disponível em seu ambiente e já pode ser configurado via navegador no endereço

    Estado
    subtletrue
    colourBlue
    titlehttp://localhost:7019
     (ver Configurações do Smart View).

    Informações
    titleDownloads

    Baixe aqui a versão para instalação Simplificada

Card
idlinux
labelLinux
Aviso

Para todas as operações será necessário que o usuário tenha privilégios de Administrador.

  1. Copie o arquivo zip de instalação para a pasta 

    Bloco de código
    languagetext
    themeRDark
    /usr/sbin/smart-view

    Obs.: Pode ser necessário utilizar o comando, chmod 

  2. Realize a extração do conteúdo do arquivo na raiz desta pasta

  3. Crie o arquivo do serviço na rota e com o nome abaixo:

    Bloco de código
    languagetext
    themeRDark
     /etc/systemd/system/smart-view-agent.service

  4. Abra o arquivo criado e adicione as configurações abaixo:

    Bloco de código
    languagetext
    themeRDark
    [Unit]
Description=smart-view-agent

[Service]
Type=notify
Environment="DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1"
WorkingDirectory=/usr/sbin/smart-view
ExecStart=/usr/sbin/smart-view/TReports.Agent --urls http://*:7019

[Install]
WantedBy=multi-user.target

  5. Atualize a lista de serviços do SO com o comando

    Bloco de código
    languagetext
    themeRDark
    sudo systemctl daemon-reload

  6. Inicie o serviço criado

    Bloco de código
    languagetext
    themeRDark
    sudo systemctl start smart-view-agent

  7. Execute o comando para conferir o status

    Bloco de código
    languagetext
    themeRDark
    sudo systemctl status smart-view-agent
  8. Pronto! O Smart View já se encontra disponível em seu ambiente e já pode ser configurado via navegador no endereço
    Estado
    subtletrue
    colourBlue
    titlehttp://localhost:7019
     (ver Configurações do Smart View).


    Informações
    titleDownload

    Baixe aqui esta versão para instalação

Nota

Maiores detalhes podem ser encontrados em: Smart View - Instalação do Sistema

Âncora
3.Integração
3.Integração
  ↑ Integração com o Smart View

Painel
borderColor#FF9900
titleColorwhite
titleBGColor#FF9900
title3. Configurando a integração Datasul x Smart View

É necessário realizar as três etapas a seguir para configurar a integração Datasul x SmartView Smart View.


Painel
borderColor#363636
titleColorwhite
titleBGColor#363636
titleConfigurações
Deck of Cards
idConf
tabLocationleft
Card
defaulttrue
idsv
labelSmart View

1 - Tela inicial

         Após efetuada a instalação, é necessário efetuar as configurações do Smart View. Para isto, basta entrar no endereço: http://[SERVIDOR]:7019/startup


1.1 - Provedor de Segurança

O provedor de segurança efetuará comunicações com o ERP Datasul para que a segurança de acesso seja de responsabilidade do próprio ERP.

Sendo assim, é possível efetuar o login no servidor do Smart View com o mesmo usuário e senha do ERP Datasul, bem como facilitação no compartilhamento de layouts.


  

CampoDescrição
Nome do provedorInformação exibida no login do Smart View.
Endereço de criação do token

Endereço do ERP Datasul responsável por efetuar a geração do token.

http://[SERVIDOR]:[PORTA]/totvs-login-oauth2/oauth2/token

Endereço Jwks

Endereço do ERP Datasul onde estarão as chaves públicas de decodificação do token.

http://[SERVIDOR]:[PORTA]/totvs-login-oauth2/oauth2/jwks

Endereço base Api

Endereço base para a comunicação das Api(s) entre o SmartView Smart View e o ERP Datasul.

http://[SERVIDOR]:[PORTA]/datasul-rest/

Emissor

Nome do usuário administrador

Nome do emissor

Usuário responsável por ser o administrador do Smart View, somente com ele é permitido efetuar configurações dos provedores, sendo necessário informar o usuário e senha (do ERP Datasul).

Caso as informações estejam válidas, uma mensagem de sucesso é exibida em tela e os campos do Emissor são preenchidos automaticamente.

1.2 - Servidor de licença

Informar os dados do servidor de licença para que o consumo seja realizado corretamente.

CampoDescrição
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.

1.3 - Provedor de Dados

Base de dados local que conterá informações pertinentes ao Smart View.


1.4 - Fim da configuração

Após configurar o Provedor de Dados, será apresentado a tela final de configuração.

Ao efetuar um clique em Abrir o Smart View, será aberto a tela para o desenvolvimento de layouts.


Próximo passo ➝

Card
idconectores
labelConectores

Âncora
conectores
conectores

2 - Login no Smart View

Efetue o login no Smart View com o mesmo usuário e senha definidos na etapa do Emissor.

2.1 - Conectores

Clique no botão Conectores para efetuar a parametrização dos endpoints necessários para a comunicação entre o SmartView Smart View e o ERP Datasul quando o relatório for gerado. 

2.2 - Tipo de conector

Escolha a opção Provedor Nativo.

2.3 - Provedor Nativo

CampoDescrição
NomeInforme um nome ao conector, o mesmo será utilizado na etapa dos layouts.
Endereço

O ERP Datasul disponibiliza um endereço para que seja retornado os dados e objetos de negócio para a construção do relatório.

http://[SERVIDOR]:[PORTA]/api/trep/v1/provider/.well-known/treports/connector/


Próximo passo ➝

Card
iddts
labelDatasul

Âncora
dts
dts

3 - Login Datasul

Efetue o login no ERP Datasul com um usuário que possua permissão de acesso a tela de propriedades.


3.1 - Propriedades Smart View

Habilite a integração e informe um usuário administrador e a URL onde o SmartView Smart View foi instalado (porta padrão 7017).

SmartView.png

PropriedadeDescrição
Habilitar IntegraçãoHabilita a integração com o Smart View
Usuário Administrador

Código do usuário (ERP Datasul) que será responsável pela administração dos recursos na integração entre o SmartView Smart View e o ERP Datasul.

Exemplo: Importação de layouts.

URL Smart View

URL base do servidor onde foi instalado o Smart View

Observação: Por padrão, este servidor é instalado na porta 7017

TESTE

Campos para validação da integração com o Smart View

(não são persistidos no banco de dados)

Usuário (opcional)Código do usuário (ERP Datasul) que possui acesso ao layout 
Senha (opcional)Senha do usuário (ERP Datasul)
Nome Exibição Layout (opcional)

Nome de Exibição do Layout cadastrado no Smart View

(Observação): Apesar da ferramenta permitir a duplicidade da informação, este nome deve ser único

Tipo Arquivo (opcional)

Extensão do tipo de arquivo a ser gerado

(Caso não seja selecionado, o padrão é o formato .pdf)

Teste Integração Layout (opcional)Efetua a geração e download do relatório integrado com o Smart View, no tipo de arquivo desejado



Âncora
4.Relatório
4.Relatório
  ↑ Integração com o Smart View

Painel
borderColor#FF9900
titleColorwhite
titleBGColor#FF9900
title4. Uso de relatório expedido para o Smart View
Informações

Somente o Usuário Administrador do Smart View, configurado em Propriedades → Integrações TOTVS possui a permissão para efetuar a importação, compartilhamento e exclusão dos layouts.

Caso o usuário não seja administrador, somente as funcionalidades de pesquisa são liberadas.


Lista de Layouts


Funcionalidade

Descrição

Configuração

Abre uma tela para informar a senha do usuário logado, necessário para efetuar a comunicação com o servidor do SmartViewSmart View.


Importar

Efetua a abertura da tela para importar os layouts previamente exportados no SmartViewSmart View.

Para mais informações quanto a exportação, consulte o link: Exportação/Importação de Relatórios

Busca Avançada

Abre uma janela Pop Up para informar os dados do filtro:

Ação (...)

Ao clicar no botão ... é exibida as ações:

Ação

Descrição

Compartilhar

Abre uma janela Pop Up para selecionar os grupos que poderão visualizar o layout

Mais informações consulte o link: Compartilhamento do Layout.

Remover

Efetua a remoção do layout entre o ERP Datasul e o SmartViewSmart View


Importação de Layout



Campos

Descrição

Layout Padrão

Indica que todos os layouts importados no arquivo são padrões.

Caso necessário, é permitido alterar o valor para Não.

Selecionar arquivoAo clicar neste botão, é aberta a seleção do arquivo que conterá os layouts
Importar

Efetua a importação do layout para o portal do SmartViewSmart View.


Informações
titleInformação

A ação de importação. além de importar os layouts, possui algumas caracteristicas:

  • Como a importação do
SmartView
  • Smart View possui a "...Durante a importação todos os recursos encontrados serão importados como sendo novos recursos considerando a versão do resolver no qual foram exportados..." , o UID do
SmartView
  • Smart View pode ser alterado, porém a referência do nome layout deve permanecer o mesmo;
  • Caso o layout já tenha sido importado nesta tela e o mesmo possuir compartilhamentos, estes vínculos são atualizados automaticamente para o
SmartView
  • Smart View após sua importação;
  • A referencia do layout entre o ERP Datasul e o
SmartView
  • Smart View será sempre com base no último layout importado;
  • O layout anterior será automaticamente removido (caso exista) após a importação (somente caso os layouts foram previamente importados pelo ERP Datasul).


Compartilhamento do Layout


Campo

Descrição

Grupos

Grupos do ERP Datasul para o compartilhamento do layout.


Dica
titleDica

Somente o usuário que efetuou a importação do layout possuirá sempre o acesso ao mesmo.

Utilize as regras de relacionamento entre o usuário x grupo de segurança (ERP Datasul) para conceder ou limitar o acesso a um determinado layout (e consequentemente o relatório)

Âncora
5.Layout
5.Layout
  ↑ Integração com o Smart View

Painel
borderColor#FF9900
titleColorwhite
titleBGColor#FF9900
title5. Edição de um layout de relatório


Âncora
6.Objeto
6.Objeto
  ↑ Integração com o Smart View

Painel
borderColor#FF9900
titleColorwhite
titleBGColor#FF9900
title6. Criação de um objeto de negócio