01. DADOS GERAIS
| Produto: | | Solucoes_totvs |
|---|
| Solucao | TOTVS Logística Recintos Aduaneiros |
|---|
|
| Solucoes_totvs_parceirosexptotvs |
|---|
|
|
|---|
| Linha de Produto: | | Linhas_totvs |
|---|
| Segmento | Distribuição |
|---|
| Region | Construção Projetos |
|---|
| Linha | Linha Logix |
|---|
|
|
|---|
| Segmento: | |
|---|
| Módulo: | Serviço de Integração TPD - Recintos Aduaneiros |
|---|
| Função: | Serviço de Integração TPD - Recintos Aduaneiros |
|---|
| Ticket: |
|
|---|
| Requisito/Story/Issue (informe o requisito relacionado) : | - DLOGPORTOS-16395
- DLOGPORTOS-16389
|
|---|
02. SITUAÇÃO/REQUISITO
Para atendimento à solicitação para resolução de problemas relacionados à conexão com balanças rodoviárias, com comunicação efetuada através dos protocolos TCP/IP, em que duas ou mais estações, utilizando o módulo Portaria, tentam conectar-se simultaneamente à mesma balança, causando erro de conexão, foi elaborada a solução de integração para conexão entre as estações e as balanças configuradas.
A conexão, por dar-se através de sockets TCP/IP, causa erro de conexão por tratar-se de canal exclusivo de comunicação, não aceitando que dois ou mais canais sejam abertos simultaneamente. Mesmo que não haja a necessidade de duas ou mais estações acessarem a mesma balança simultaneamente, o problema pode ocorrer no momento em que o operador execute o processo de alteração da balança a ser acessada, uma vez que isso pode efetuar uma tentativa de conexão com uma balança já conectada a uma estação.
03. SOLUÇÃO
A solução, uma aplicação no modelo de serviço para o sistema Microsoft Windows, deve ser instalada em um servidor na infraestrutura local de rede, uma vez que, para garantir a estabilidade da comunicação desta com as balanças, a latência de rede deve ser a menor possível. Sendo assim, esta solução não está homologada para operação em nuvem, sendo vetada integralmente sua utilização em tal modelo.
...
| Totvs custom tabs box |
|---|
| tabs | Pré-requisitos,Instalação,Configuração,Inicialização |
|---|
| ids | prerequisitos,instalacao,configuracao,inicializacao |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | prerequisitos |
|---|
| - Sistema operacional Microsoft Windows Server 2012 ou superior e;
- 25MB de espaço em disco.
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | instalacao |
|---|
| Para a instalação da solução, basta copiá-la para um diretório disponível no servidor alvo - como C:\TOTVS\SARA\Services\IntgBalancaSvc, por exemplo - e comandar sua instalação através do comando abaixo, devendo ser executado por um usuário com privilégios administrativos:
C:\TOTVS\SARA\Services\IntgBalancaSvc>IntgBalacaSvc.exe /install |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | configuracao |
|---|
| Após o término da instalação do serviço de integração - com a mensagem de sucesso sendo exibida pelo sistema operacional - é necessário realizar as configurações referentes ao serviço. Para isso, é necessário executar, com privilégios administrativos, o editor de registro do sistema Microsoft Windows, acessando a chave a seguir:
Computador\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\TOTVSIntgBalanca Esta chave apresenta todas as configurações do serviço junto ao servidor e deve conter três subchaves: API, Database e Log. Cada uma destas subchaves contém um subgrupo de configurações, os quais devem conter os seguintes valores:
| Subchave | Configuração | Função específica | Valor padrão | Padrão do valor a ser inserido |
|---|
| API | Audience | Valor de validação das restrições de uso da API de integração disponibilizada pelo serviço. | Integração Balanças | Nenhum | | API | DSContext | Valor de configuração da rota de acesso à API de integração disponibilizada pelo serviço. | api/ | ^[a-z0-9_]+\/$ | | API | Issuer | Valor de validação das restrições de uso da API de integração disponibilizada pelo serviço. | SARA | Nenhum | | API | Port | Porta TCP pela qual o serviço fará a exposição de sua API. | 4321 | 1~65535 | | API | RESTContext | Valor de configuração da rota de acesso à API de integração disponibilizada pelo serviço. | sara/ | ^[a-z0-9_]+\/$ | | Database | CharSet | Conjunto de caracteres utilizado pelo servidor Microsoft SQL Server. | SQL_Latin1_General_CP1_CI_AS | Nenhum | | Database | Database | Nome do banco de dados usado pelo ecossistema TOTVS Recintos Aduaneiros. | sara_db | Nenhum | | Database | DriverID | Identificação do tipo de banco de dados a ser utilizado. | MSSQL | Nenhum | | Database | Hostname | Indicação de localização do servidor Microsoft SQL Server. | localhost | NomeDoServidor\NomeDaInstância | | Database | Password | Senha do usuário usado na integração para acesso ao banco de dados. | Totvs@123 | Nenhum | | Database | Port | Porta padrão de comunicação do servidor Microsoft SQL Server. | 1433 | 1~65535 | | Database | Username | Nome do usuário usado na integração para acesso ao banco de dados. | sa | Nenhum | | Log | LogFile | Caminho completo para o arquivo de log da aplicação. | C:\Temp\TOTVS\IntgBalanca\IntgBalanca_%s.log | ^[A-Z]{1}:\\([\w]+\\)+(IntgBalanca_%s\.log)$ |
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | inicializacao |
|---|
| Após efetuada a configuração dos parâmetros de operação do serviço, basta acessar o gestor de serviços do servidor e comandar sua inicialização. 
|
|
Para uma perfeita integração com o sistema TOTVS Recintos Aduaneiros, este deve estar em sua versão 12.1.2301 ou superior, uma vez que esta versão está preparada para a integração com o sistema de integração com balanças rodoviárias TCP/IP. Em versões anteriores a esta, a tentativa de integração ocasionará falhas no processo de integração que podem paralisar o serviço de integração e, na pior das hipóteses, paralisar o servidor onde ele esteja abrigado.
...
