Histórico da Página

1. Sistema operacional Microsoft Windows Server 2012 ou superior e;
2. 25MB de espaço em disco.

Para a instalação da solução, basta copiá-la para um diretório disponível no servidor alvo - como C:\TOTVS\SARA\Services\IntgraçãoBalanças, 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\IntgraçãoBalanças>TOTVSIntgBalanca.exe /install

É importante notar que a instalação pode ser parametrizada, fornecendo as configurações adequadas através de linha de comando, sendo:

Sendo assim, um exemplo de instalação parametrizada via linha de comando seria:

C:\TOTVS\SARA\Services\IntgraçãoBalanças>TOTVSIntgBalanca.exe -hSERVIDORBD\SQLSERVER2019 -dsara_db -p1433 -usa -PTotvs@123456 -r9876 /install

NOTAS

NOTA

Quando utilizando a versão legada do serviço, para que o novo serviço possa ser instalado, este deve ser parado e desativado no servidor afim de evitar a concorrência na conexão com as balanças integradas ou pelo consumo da porta de comunicação da API. Uma vez homologado o novo serviço, o serviço legado pode ser desinstalado por meio da linha de comando apropriada em um terminal com privilégios administrativos.

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 subchavessub-chaves:   API, Database e Log. Cada uma destas subchaves sub-chaves contém um subgrupo de configurações, os quais devem conter os seguintes valores:

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.

Ao instalar e iniciar o serviço de integração com balanças com comunicação via TCP/IP, este fornecerá um canal para acesso à sua documentação OpenAPI através da ferramenta Swagger inclusa no serviço. Conforme exemplo citado na seção de instalação, o serviço tendo sido instalado em um servidor cujo endereço IP seja 172.2625.22448.1 e a porta de comunicação seja 9876, o acesso à documentação se dá pela URL http://172.2625.22448.1:98779876/api/tlra/intgbalanca/v1/docs, exibindo-a conforme visto abaixo:

Image RemovedImage Added

Esta documentação permite que as respostas da API sejam testadas e validadas de forma rápida e simples. Contudo, os endpoints que contem com o parâmetro token, seja na URI - {token} - ou em seu corpo - nó token no objeto JSON passado na mensagem -, este não pode ser gerado senão pela equipe TOTVS durante o atendimento e os mesmos terão validade, máxima, de 30 minutos.excetuando o endpoint /access/currentdatetime, é necessário autenticar-se para executar os demais métodos. O processo é simples e pode ser feito por meio de um usuário válido dentro do ecossistema TLRA.

São endpoints expostos pela API:

• [GET] /access/balances: Obtém a lista de balanças integradas ao serviço.
• [GET] /access/canconnecttodatabase: Verifica se o servidor está apto a se conectar ao banco de dados.
• [GET] /access/connecttodatabase: Comanda a conexão do servidor com o banco de dados.
• [GET] /access/currentdatetime: Requisita ao servidor a data e hora atualizadas.
• [GET] /access/isconnectedtodatabase: Verifica se o servidor está conectado ao banco de dados.
• [GET] /access/reloadbalances: Recarrega as configurações das balanças cadastradas no sistema.
• [GET] /config/cumulativereading/{action}: Ativa/Desativa a leitura cumulativa do buffer de saída da balança. (activate/deactivate)
• [GET] /config/detailedlog/{action}: Ativa/Desativa os logs detalhados do servidor. (activate/deactivate)
• [GET] /config/eventlog/{action}: Ativa/Desativa os logs de eventos do servidor. (activate/deactivate)
• [GET] /config/readconfig: Lê a configuração corrente do servidor.
• [GET] /config/reloadconfig: Recarrega as configurações do serviço.
• [GET] /reading/readweight/{balanca}: Lê o peso medido na balança solicitada. (nome_da_balanca)