...
Para utilização da nova rotina de captura de pesos, é necessária a configuração de uma conexão ODBC de conexão com o banco de dados Oracle e ou Firebird para funcionamento do programa, e no caso do Oracle para ambos, também é necessário que o Oracle Client o Cliente de conexão com o banco de dados esteja previamente instalado e configurado para que o programa possa se conectar. Os passos para instalação do Oracle Client não dos clientes de conexão serão descritos aqui, apenas o ODBC. Deve-se apenas observar que o Oracle Client e o ODBC Package devem ser compatíveis com a versão do Banco Oracle para o correto funcionamento. Tanto a instalação do Oracle Client quando dos Drivers ODBC mais abaixo porém, é importante observar que a instalação deve ser feita na máquina em que serão executadas as aplicações cliente da Viasoft (Agro3c, FinAgro3c, etc).
...
Passo a passo
Instalação e
...
configuração (Até o Lote 732_2303.1014, a partir do Lote 732_2303.1015 não será mais necessária)
Instalação do Oracle Instant Client Basic
O Instant Client Basic que já atende as necessidades do leitor de peso porém, deve ser observado se já existe outra versão instalada e nesse caso exista, não há necessidade de instalação de uma nova versão caso e mesma já tenha o driver ODBC embutido (isso pode ser verificado no painel de controle do ODBC verificando se existe o Driver “Oracle in OracleClient”).desde que esta atenda à versão do banco Oracle sendo utilizado
Para instalar o Oracle Client Basic deve-se seguir o guia abaixo:
Efetue o download do pacote “Instant Client Basic”
...
apropriado de acordo com a versão do Oracle instalada, utilizando o link a seguir
...
(32 bits).
https://www.oracle.com/br/database/technologies/instant-client/microsoft-windows-32-downloads.html
Descompacte o pacote baixado para uma pasta única como por exemplo C:\OracleClient, observando que os arquivos e DLLs devem estar na raiz da pasta criada.
Adicione o diretório à variável de ambiente PATH.
Para o oracle 12.1 ou superiores, o Instant Client Basic requer o pacote Visual Studio Runtime Redistributable, que deve ser baixado e instalado de acordo com a versão do Oracle usando os links a seguir, observando a arquitetura do Oracle Client (32 bits).
Oracle 18 ou superior - Visual Studio 2017 Redistributable.
Oracle 12.2 - Visual Studio 2013 redistributable.
Oracle 12.1 - Visual Studio 2010 redistributable.
Oracle 11.2 - Visual Studio 2005 redistributable.
Após a instalação acima, deve-se abrir o ODBC Data Sources (32-bit) no windows e criar uma nova conexão usando o Driver instalado conforme mostra a imagem a seguir.
...
Após isso devem ser preenchidos os parâmetros da conexão do Oracle conforme a imagem a seguir, colocando o IP, Porta e SID/Serviço do banco Oracle, juntamente com o usuário utilizado para login no banco. Pode-se então testar a conexão, usando o botão “Test Connection”.
...
basta configurar a conexão no programa da balança. Deve-se observar que em alguns casos, a conexão por SID pode não funcionar e nesse caso, será necessário configurar um serviço através do tnsnames.ora na pasta de instalação do Oracle Client.
Instalação e configuração do
...
Para instalação do ODBC para Firebird deve-se efetuar o download do Driver ODBC a partir do link:
https://sourceforge.net/projects/firebird/files/firebird-ODBC-driver/2.0.5-Release/Firebird_ODBC_2.0.5.156_Win32.exe/download para o driver 32-bits
https://sourceforge.net/projects/firebird/files/firebird-ODBC-driver/2.0.5-Release/Firebird_ODBC_2.0.5.156_x64.exe/download para o driver 64-bits
Após o download deve-se executar o instalador e seguir as instruções até o final. Após isso deve-se abrir o ODBC Data Sources (32-bit) no windows e criar uma nova conexão usando o Driver instalado conforme mostra a imagem a seguir.
...
Depois, deve-se preencher os parâmetros conforme a imagem abaixo, trocando o IP e caminho do banco e a localização da DLL do fbclient conforme a instalação do sistema.
...
Cliente Firebird (Até o Lote 732_2303.1014 a partir do Lote 732_2303.1015 não será mais necessária)
Para instalação e configuração do cliente Firebird, basta que a DLL fbclient.dll esteja acessível no PATH do sistema operacional, não sendo necessária nenhuma configuração adicional
Utilização da nova rotina de leitura de peso do Agrotitan
Para utilização da nova rotina de leitura de pesos, é necessário configurar as balanças utilizando o programa de cadastro mostrado abaixo. Os aplicativos citados abaixo estão disponíveis na pasta Viasoft\Client\Tools. Por padrão, o sistema já irá alimentar o novo cadastro de balanças com base nas balanças já configuradas para os usuários, então será necessário apenas ajustar os parâmetros específicos de formato, posição e tamanho do peso para garantir a correta leitura do mesmo.
Cadastro e configuração (balancas.exe) até o Lote L732_2303.1014
Durante a primeira inicialização do programa balancas.exe, o mesmo irá solicitar os dados de conexão conforme pode ser visto abaixo. No campo DSN, deve ser informado o nome da fonte de dados ODBC criada e na sequência o usuário e
Host - Neste campo deve ser informado o endereço IP e porta de conexão caso não esteja sendo usada a porta padrão de conexão, sendo que o mesmo não é necessário para conexões ODBC.
Tipo - Deve ser selecionado o tipo do banco de dados utilizado.
Usuário - Deve ser informado o ID do usuário para conexão no banco.
Senha - Deve ser informada a senha de conexão com o banco
...
.
Banco - Deve ser informado o SID ou o Service Name para Oracle e o caminho completo do banco FDB para Firebird.
...
Cadastro e configuração (balancas.exe) a partir do Lote L732_2303.1015
Durante a primeira inicialização do programa balancas.exe, o mesmo irá solicitar os dados de conexão conforme pode ser visto abaixo.
Host - Neste campo deve ser informado o endereço IP do Servidor onde roda o ViasoftServerAgroXE.
Porta - Deve ser informada a Porta TCP/IP REST do ViasoftServerAgroXE.
Usuário - Deve ser informado o ID do usuário padrão de conexão com a API do ViasoftServerAgroXE (Já é carregado automaticamente na inicialização).
Senha - Deve ser informada a senha padrão de conexão com a API do ViasoftServerAgroXE (Já é carregada automaticamente na inicialização).
...
Ao informar esses dados, será criado um arquivo chamado balancas.ini na mesma pasta do aplicativo, que armazenará essas informações (a senha de forma criptografada). O programa captura.exe utiliza esses mesmos dados de conexão para seu funcionamento.
...
Para ambos os tipos de balança, existem diversos parâmetros que podem ser configurados para garantir a correta leitura e estabilização do peso. Esses parâmetros são descritos abaixo:
Campo | Descrição |
|---|---|
Início Linha |
...
Campo que define um caractere ou texto que identifica o início do peso quando a balança enviar esta informação. Pode ser vazio. | |
Fim Linha |
...
Campo que define um caractere ou texto que identifica o término da linha quando a balança enviar esta informação. Pode ser vazio |
...
. |
Pos. Ini |
...
Campo que indica a posição inicial do peso a partir dos dados obtidos já aplicando os caracteres de início e fim de linha. Pode ser Zero. | |
Pos. Fim |
...
Campo que indica a posição final do peso a partir dos dados obtidos já aplicando os caracteres de início e fim de linha. Pode ser Zero. | |
Fator |
...
Campo que define um fator de conversão, pelo qual o peso será dividido. Ex. Peso vem em quilos mas deseja-se em toneladas. Pode ser Zero. | |
Variação |
...
Campo que define uma variação mínima de peso para mais ou para menos em relação ao último peso lido. Permite uma maior segurança, evitando o registro do mesmo peso duas vezes de forma sequencial. Quando o caminhão sai da balança, o peso é zerado e gravado na balança, então a próxima leitura deverá superar a variação para que o peso seja aceito. Pode ser Zero. | |
Tamanho Max |
...
Campo que define o tamanho máximo do peso. Deve-se utilizar este campo ou a posição inicial e final do peso. Quando usado esse campo, o peso será lido da esquerda para direita se informado um caractere de início ou da direita para a esquerda se informado um caractere de fim ou nenhum dos dois for informado. Pode ser Zero. | |
Intervalo |
...
Campo que define o intervalo entre as capturas de dados da porta. Deve-se informar aqui um valor que coincida com o intervalo de envio de dados da balança para evitar o acúmulo de dados na porta. É obrigatório. | |
Leitura Constante |
...
Campo que define se a leitura da balança será feita de forma constante ou abrindo e fechando a conexão com a porta serial a cada leitura de peso. A leitura constante permite a obtenção de pesos mais rapidamente, porém, em balanças com conexão muito instável pode não conseguir capturar o peso. | |
Qtd. Peso Estável |
...
Campo que define a quantidade de vezes que o mesmo peso deve ser lido da balança para ser considerado estável. Esse campo deve ser usado para evitar que os pesos recebidos na porta antes da estabilização da balança sejam registrados. Pode ser Zero. |
| Info |
|---|
Obs: Todos os parâmetros informados acima valem para leitura serial ou por IP também. |
As balanças devem ser associadas a um usuário e caso uma balança seja utilizada por mais de um usuário deve ser criado um cadastro para cada um deles. Para associar deve ser usado o campo Usuário do cadastro.
A partir da tela de configuração de balanças também é possível testar e validar a conexão com a balança desde que a porta Porta Serial ou IP da Balança esteja acessível na máquina em que o programa está sendo executado. Para isso basta clicar no botão “Ativar Balança” que então irá abrir o programa captura.exe para realizar a leitura conforme pode ser visto a seguir. Essa tela também pode ser usada como um monitoramento, acompanhando as pesagens que estão ocorrendo em cada balança em tempo real.
Leitura de Peso (captura.exe)
O programa de captura é o responsável por efetivamente se conectar e retornar os dados da porta serial ou do endereço IP configurados. Ele irá respeitar as configurações definidas no cadastro da balança e irá fazer um máximo de 20 tentativas para obter um peso estável e caso não consiga, irá habilitar o botão para “Tentar novamente” conforme pode ser visto abaixo. Existe também um botão para exibir os detalhes da saída de comunicação com a balança, sendo útil para determinar as causas de possíveis falhas na leitura de peso.
...
Configuração do Agrotitan
...
Depois disso, nas telas de leitura de peso, ao clicar no botão de leitura do peso já será disparado o novo processo. Com a tela de leitura de peso aberta, será possível abrir a configuração das balanças conforme a tela exibida no item 2.1 em Cadastro e configuração (balancas.exe) deste manual utilizando a tecla de atalho Ctrl+Alt+B porém, é preciso observar que o programa de configuração só funciona com a tela de leitura de peso aberta (seja a nova leitura de peso ou a antiga).
...
Versão
Versão da Documentação | Autor/Revisor | Data |
|---|---|---|
1. |
1 | Keidson Paiva de Freitas | |
1.2 | Luiz Alberto Parnoff | |
1.3 | Luiz Alberto Parnoff | 11/12/2023 |