Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Conteúdo
Índice minLevel 2
01. Objetivo
Esta documentação tem a finalidade de servir como uma guia no momento da integração com o TOTVS Privacidade de Dados. Para mais informações sobre a ferramenta, acesse TOTVS Privacidade de Dados.
Para tanto, abaixo seguem as instruções para que a integração seja realizada corretamente.
02. Informações
Leia Documentos de Referência do TOTVS Privacidade de Dados.
O produto Datasul faz o uso do Smart Link, que é um mecanismo de troca de mensagens entre aplicações TOTVSApps e aplicações OnPremises On Premises (ou remotas).
- Foi utilizada a biblioteca Smart Link Client Java, que por meio deste foi implementado o processador de mensagens.
- O processador de mensagens é uma aplicação java
Obtenha informações (client, secret, name e id)
do seu tenant para poder realizar as configurações necessárias nos prximos próximos passos.
03. Instalação
Copiar arquivo compactado
O arquivo está localizado no diretório do Foundation srcfnd/interfac/smart-link/dts-smart-link-clientsmartlink-service.zip
Extrair os arquivos do arquivo compactado
Expandir | ||
---|---|---|
| ||
Extrair os arquivos em um deretório diretório de sua escolha, sugerimos o uso do nome do seu tenant para complementar e facilitar a organização dos aterfatos. Exemplo:
|
Instalador de serviço para Windows
| ||||||||||||||||||||
Expandir | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
Editar o arquivo "C:\TOTVS\dts-
Instalação do serviço:
|
Desinstalador de serviço para Windows
|
Instalador de serviço para Windows
Expandir | |||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||
Editar o arquivo
Instalação | |||||||||||||||||||||||||||
Expandir | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||
Editar o arquivo
Desinstalação do serviço:
|
Instalador Desinstalador de serviço para LinuxWindows
Expandir | ||
---|---|---|
|
Editar o arquivo
|
title | Procedimento |
---|
04. Configuração
Desinstalação do serviço:
|
Instalador de serviço para Linux
Expandir | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
Para a instalação do serviço no Linux certifique-se de que os passos a seguir foram realizados:
Instalando o serviço:
|
Desinstalador de serviço para Linux
Expandir | ||
---|---|---|
| ||
|
04. Configuração
Arquivo de configuração
Arquivo de configuração application.yml
.
Utilizando a pasta de exemplo dos passos anteriores, podemos encontrar o arquivo em: "/client/application.yml"
Configurações do arquivo application.yml
Aviso |
---|
Leia com atenção o detalhamento das configurações abaixo: |
# SERVER
A porta de acesso da aplicação pode ser alterado na propriedade:
Bloco de código | ||||
---|---|---|---|---|
| ||||
# -------------------------------------------------
# SERVER
# -------------------------------------------------
server:
port: 8777 |
# SPRING
Por padrão estamos utilizando 10MB para poder trafegar metadado no formato JSON.
Bloco de código | ||||
---|---|---|---|---|
| ||||
# -------------------------------------------------
# SPRING
# -------------------------------------------------
spring:
codec:
max-in-memory-size: 10MB |
# LOG
O nome do arquivo de log pode ser alterado na propriedade:
Bloco de código | ||||
---|---|---|---|---|
| ||||
# -------------------------------------------------
# LOG
# -------------------------------------------------
logging:
file:
name: log/smart-link-client.log |
# SPRING ACTUATOR
Bloco de código | ||||
---|---|---|---|---|
| ||||
# -------------------------------------------------
# SPRING ACTUATOR
# -------------------------------------------------
management:
endpoints:
web:
exposure:
include: "*"
base-path: "/doc-hc" |
# SMART LINK CLIENT
Bloco de código | ||||
---|---|---|---|---|
| ||||
# -------------------------------------------------
# SMART LINK CLIENT
# -------------------------------------------------
totvs:
link:
auth:
url: INFORMAR_URL_RAC
client: INFORMAR-CLIENT
secret: INFORMAR-SECRET
client:
subscriptions:
- SGDPDataCommand
- SGDPMaskCommand
- SGDPLogsCommand
server:
host: INFORMAR_HOST
port: 443
secure: true
tenant:
name: INFORMAR-NOME-TENANT
id: INFORMAR-ID-TENANT
application:
url: 'INFORMAR_URL_DATASUL'
username: 'INFORMAR_USUÁRIO'
password: 'INFORMAR_SENHA'
messages:
- type: SGDPDataResponse
- type: SGDPMaskResponse
- type: SGDPLogsResponse
- type: SGDPUpdateTenantMetadata
audiences:
- type: SGDP
subscriptions:
- subscription: SGDPDataCommand
route: api/sec/v1/sgdp/commands
dataSources:
- companyId: 'INFORMAR_CÓDIGO_EMPRESA'
rpw: 'INFORMAR_EMPRESA:INFORMAR_RPW'
- subscription: SGDPMaskCommand
route: api/sec/v1/sgdp/commands
dataSources:
- companyId: 'INFORMAR_CÓDIGO_EMPRESA'
rpw: 'INFORMAR_EMPRESA:INFORMAR_RPW'
- subscription: SGDPLogsCommand
route: api/sec/v1/sgdp/commands
dataSources |
Arquvio de configuração
O arquivo de configuração application.yml
está localizado na pasta lib.
Utilizando a pasta de exemplo dos passos anteriores, podemos encontrar o arquivo em: C:/TOTVS/dts-smart-link-client-totvs-fwk/lib/application.yml
Configurações do arquivo application.yml
Aviso |
---|
Leia com atenção o detalhamento das configurações abaixo: |
# SERVER
A porta de acesso da aplicação pode ser alterado na prorpriedade:
Bloco de código | ||
---|---|---|
| ||
# -------------------------------------------------
# SERVER
# -------------------------------------------------
server:
port: 8777 |
# SPRING
Por padrão estamos utilizando 10MB para poder trafegar metadado no formato JSON.
Bloco de código | ||
---|---|---|
| ||
# -------------------------------------------------
# SPRING
# -------------------------------------------------
spring:
codec:
max-in-memory-size: 10MB |
# LOG
O nome do arquivo de log pode ser alterado na propriedade:
Bloco de código | ||
---|---|---|
| ||
# -------------------------------------------------
# LOG
# -------------------------------------------------
logging:
file:
name: log/dts-smart-link-client.log |
# SMART LINK CLIENT
Bloco de código | ||
---|---|---|
| ||
# -------------------------------------------------
# SMART LINK CLIENT
# -------------------------------------------------
totvs:
link:
auth:
url: INFORMAR_URL_RAC
client: INFORMAR-CLIENT
secret: INFORMAR-SECRET
client:
subscriptions:
- SGDPDataCommand
- SGDPMaskCommand
server:
host: INFORMAR_HOST
port: 443
secure: true
tenant:
name: INORMAR-NOME-TENANT
id: INORMAR-ID-TENANT
datasul:
url: 'INFORMAR_URL_DATASUL'
username: 'INFORMAR_USUÁRIO_DATASUL'
password: 'INFORMAR_SENHA_USUÁRIO'
#linkClientUrl: 'INFORMAR_URL_SMART_LINK_CLIENT'
companies:
- 'INFORMAR_CÓDIGO_EMPRESA'
tpdDisabled: false
jboss: false |
Aviso |
---|
Leia com atenção o detalhamento das configurações abaixo: |
Expandir | ||||||
---|---|---|---|---|---|---|
| ||||||
O Smart Link Client Java é uma bibloteca que facilita o desenvolvimento de um LINK Client para a plataforma Java, sendo necessária a implementação de uma aplicação que implemente um processador de mensagens (LINK Client Java Application mais abaixo). No Smart Link Client Java utiliza o protocolo GRPC, sendo necessária a seguinte configuração:
Deve ser informada também uma lista de subscrições, onde somente mensagens com determinados "types" são efetivamente enviadas para o Smart Link Client. No Smart Link Client Java é necessária a seguinte configuração: Bloco de código | | |||||
| ||||||
Expandir | ||||||
| ||||||
rpw: 'INFORMAR_EMPRESA:INFORMAR_RPW' |
Aviso |
---|
Leia com atenção o detalhamento das configurações abaixo: |
Expandir | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
O Smart Link Client Java é uma biblioteca que facilita o desenvolvimento de um LINK Client para a plataforma Java, sendo necessária a implementação de uma aplicação que implemente um processador de mensagens (LINK Client Java Application mais abaixo). No Smart Link Client Java utiliza o protocolo GRPC, sendo O produto Datasul suporta apenas o single tenant, é necessária a seguinte configuração:
|
Expandir | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
O produto Datasul suporta apenas o single tenant, é necessária a seguinte configuração:
| |||||||||
Expandir | |||||||||
| |||||||||
Informar os valores do seu Tenant:
|
Expandir | |||||||
---|---|---|---|---|---|---|---|
| |||||||
Informar os valores do seu Tenant:
|
Expandir | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||
A comunicação acontece nos dois sentidos (TOTVS Privacidade de Dados > Datasul) e (Datasul > TOTVS Privacidade de Dados) por meio das configurações abaixo: | |||||||||||||||||||||||||||||||||||||||||
Expandir | |||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||
A comunicação acontece nos dois sentidos (TOTVS Privacidade de Dados > Datasul) e (Datasul > TOTVS Privacidade de Dados) por meio das configurações abaixo:
INFORMAR_URL_DATASUL : Subistituir pelo valor do seu ambiente Datasul.
INFORMAR_USUÁRIO_DATASUL : Subistituir pelo valor de um usuário existente no Datasul. INFORMAR_SENHA_USUÁRIO : Subistituir pelo valor da senha do usuário.INFORMAR_CÓDIGO_EMPRESA : Subistituir pelo valor do código da empresa Bloco de código |
INFORMAR_USUÁRIO : Substituir pelo valor de um usuário existente no Datasul. INFORMAR_SENHA : Substituir pelo valor da senha do usuário.
|
05. Iniciar o serviço instalado
Após ter realizados concluir as etapas anteriores, basta iniciar o serviço instalado e verificar se tudo ocorreu no log se a aplicação foi iniciada com sucesso por meio do log.
Started Starting Application
Bloco de código | ||
---|---|---|
| ||
INFO 352815788 --- [main] com.totvs.link.client.Application : Started Application in 8.771 seconds (JVM running for 9.392) |
Ao iniciar o serviço serão feitas algumas requisições, sendo elas:
Expandir | |||||
---|---|---|---|---|---|
| |||||
|
Expandir | ||
---|---|---|
| ||
Bloco de código | | |
|
Para facilitar a visualização de log foi adicionada a infomação [SMART-LINK-CLIENT] no LOG para as classes java implementadas.
Bloco de código | ||
---|---|---|
| ||
INFO 3528 --- [main] c.totvs.link.client.ApplicationStartup : [SMART-LINK-CLIENT][ApplicationStartup.readyEvent] INFO 3528 --- [main] c.totvs.link.client.ApplicationStartup : [SMART-LINK-CLIENT][ApplicationStartup.showConfiguration] Configuration (totvs.datasulproduct) INFO 3528 --- [main] c.totvs.link.client.ApplicationStartup : [SMART-LINK-CLIENT][ApplicationStartup.showConfiguration] Configuration jboss: false INFO 3528 --- [main] c.totvs.link.client.ApplicationStartup : [SMART-LINK-CLIENT][ApplicationStartup.showConfiguration] Configuration tpdDisabled: falsename: Datasul INFO 3528 --- [main] c.totvs.link.client.ApplicationStartup : [SMART-LINK-CLIENT][ApplicationStartup.showConfiguration] Configuration username: ---- INFO 3528 --- [main] c.totvs.link.client.ApplicationStartup : [SMART-LINK-CLIENT][ApplicationStartup.showConfiguration] Configuration url: http://----:8380/ INFO 3528 --- [main] c.totvs.link.client.ApplicationStartup : [SMART-LINK-CLIENT][ApplicationStartup.showConfiguration] Configuration password: ********* INFO 3528 --- [main] c.totvs.link.client.ApplicationStartup : [SMART-LINK-CLIENT][ApplicationStartup.showConfiguration] Configuration companies: [10] INFO 3528 --- [main] c.t.l.c.d.DatasulSyncDefaultMetadataProductSyncDefaultMetadata : [SMART-LINK-CLIENT][DatasulSyncDefaultMetadataProductSyncDefaultMetadata.sync] INFO 3528 --- [main] c.t.l.client.datasulproduct.DatasulSendMessageProductSendMessage : [SMART-LINK-CLIENT][DatasulSendMessageProductSendMessage.send][REQUEST][GET] to http://----:8380/api/sec/v1/sgdp/metadata/default INFO 3528 --- [main] c.t.l.client.datasulproduct.DatasulSendMessageProductSendMessage : [SMART-LINK-CLIENT][DatasulSendMessageProductSendMessage.send][RESPONSE][GET][200] from http://----:8380/api/sec/v1/sgdp/metadata/default INFO 3528 --- [main] c.t.l.c.d.DatasulSyncDefaultMetadataProductSyncDefaultMetadata : [SMART-LINK-CLIENT][DatasulSyncDefaultMetadataProductSyncDefaultMetadata.sync] Sending message to Smart Link Server - type: SGDPUpdateApplicationMetadata - metadado: {"header":{"type":"SGDPUpdateApplicationMetadata"},"content":{"models":{},"codes":{},"package":"Datasul","productId":"Datasul","readOnly":true,"smartLink":"singleTenant","localLogs":false,"applicationId":"Datasul"}} INFO 3528 --- [main] c.t.l.c.d.DatasulSyncDefaultMetadataProductSyncDefaultMetadata : [SMART-LINK-CLIENT][DatasulSyncDefaultMetadataProductSyncDefaultMetadata.sync] Sent to Smart Link Server INFO 3528 --- [main] c.t.l.c.datasulproduct.DatasulUpdatePropertiesProductUpdateProperties : [SMART-LINK-CLIENT][DatasulUpdatePropertiesProductUpdateProperties.update] INFO 3528 --- [main] c.t.l.c.datasulproduct.DatasulUpdatePropertiesProductUpdateProperties : [SMART-LINK-CLIENT][DatasulUpdatePropertiesProductUpdateProperties.update] {"subscriptionscompanies":["SGDPDataCommand,SGDPMaskCommand10"],"companiessubscriptions":["10" SGDPDataCommand","SGDPMaskCommand"],"linkClientUrl":"http://----:8777","tpdDisabled":false} INFO 3528 --- [main] c.t.l.client.datasulproduct.DatasulSendMessageProductSendMessage : [SMART-LINK-CLIENT][DatasulSendMessageProductSendMessage.send][REQUEST][POST] to http://----:8380/api/btb/v1/properties/integrations/totvslinkclient INFO 3528 --- [main] c.t.l.client.datasulproduct.DatasulSendMessageProductSendMessage : [SMART-LINK-CLIENT][DatasulSendMessageProductSendMessage.send][RESPONSE][POST][200] from http://----:8380/api/btb/v1/properties/integrations/totvslinkclient INFO 3528 --- [main] c.t.l.c.datasulproduct.DatasulUpdatePropertiesProductUpdateProperties : [SMART-LINK-CLIENT][DatasulUpdatePropertiesProductUpdateProperties.update] OK |