Descrição
Devido à necessidade de atender a diversos cenários de tipos e modelos de balanças, foi criado um novo programa de cadastro, configuração e leitura de pesos que permite a gravação do mesmo diretamente no banco de dados juntamente com validações e logs para aumentar a segurança.
Índice
Pré-Requisitos
Para utilização da nova rotina de captura de pesos, é necessária a configuração de uma conexão com o banco de dados Oracle ou Firebird para funcionamento do programa, e para ambos, também é necessário que 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 dos clientes de conexão serão descritos 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
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 caso exista, não há necessidade de instalação de uma nova versão 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, 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 Cliente Firebird
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)
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 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.
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.
Este programa é responsável por cadastrar e configurar as balanças de forma centralizada, permitindo o acompanhamento das leituras de peso de todas as balanças quando aberto de forma externa.
As balanças podem ser cadastradas e configuradas conforme a imagem acima. Cada balança deve possuir um ID e Descrição para identificação e ser configurada para Leitura Serial usando os campos Porta, Velocidade, Bits de Dados, Bits de Parada, Paridade e Controle de Fluxo que devem ser obtidos de acordo com a balança usada, e também pode ser configurada para Leitura por IP usando os campos IP e Porta IP para informar o endereço e porta de conexão para obtenção do peso.
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. |
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 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
Para utilizar a nova rotina de leitura de peso, deve-se configurar o atributo “Le Peso BD” nas configurações do módulo Agro conforme mostra a imagem a seguir.
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 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 |
|---|---|
1.1 | Keidson Paiva de Freitas |