Tempo aproximado para leitura: 00:05:36 min

Dúvida
Como é o funcionamento da integração de balança com o Logix?

Ambiente
TOTVS Logística - TOTVS WMS (Linha Logix) - Geral - A partir da versão 12

Solução
A leitura de peso de balança no Logix funciona da seguinte forma:

Existem 2 programas de cadastros no Sistema que precisam fazer parte do menu.

• LOG00099 - Modelos de balanças para pesagem

• LOG00100 - Modelos de balanças por equipamento

Estes 2 cadastros são pré-requisitos para que seja possível o uso das funcionalidades de leitura de peso no Logix.

Na aplicação LOG00099 existe uma opção chamada simulação, que tem como objetivo permitir ao usuário efetuar testes da leitura de dados da balança. Ao acionar o botão, será feita uma tentativa de leitura de dados da balança a partir da maquina atual em uso, com base no modelo da balança que está exibido em tela. Considerando isso, é necessário pesquisar antes o modelo da balança que deseja realizar teste de leitura.

Funções a serem utilizadas na programação dos códigos fontes do Logix para realizar a leitura da pesagem utilizando linguagem 4GL:

• BALANCA_lePeso()
• BALANCA_getLiquido()
• BALANCA_getBruto()
• BALANCA_getTara()
• BALANCA_getStatus()

A leitura gera um arquivo de retorno no formato texto que é gravado em disco. O formato da linha de texto deste arquivo de retorno de leitura de peso é cadastrado no LOG00099 e precisa usar formato e alguns termos fixos pra indicar os dados retornados, sendo:

• [LIQUIDO]
• [BRUTO]
• [TARA]
• [STATUS]

Exemplo de formato: [STATUS];[LIQUIDO];[BRUTO];[TARA];
Neste caso os dados são gerados numa linha separados por ; - ponto e vírgula.

Podem ser definidos mais campos, mas os campos indicados acima já estão previstos por padrão entre as funções. Caso tenha novo campo no formato, basta informá-lo entre colchetes.

Para recuperar o valor de um dos campos que não sejam um dos campos citados acima como padrões, pode-se recuperar o valor após a leitura com a seguinte função: Exemplo: campo = [UNIDADE]
LET valor = balanca_getValue(“UNIDADE”).

Esta função irá checar o nome da máquina atual, HOSTNAME e ver se tem algum modelo de balança já registrado no LOG00100 para este equipamento. Se não encontrar, não permitirá realizar leitura de dados da balança até registrar um modelo de balança para o equipamento atual.

Exemplo de código pra mostrar o peso líquido:
IF balanca_lepeso() THEN
LET mr_tela.peso = balanca_getLiquido()
END IF

Foi implementada opção de chave de DEBUG para o processo de leitura de dados da balança, que irá gerar mensagens do processo de leitura dos dados no arquivo TOTVSCONSOLE.LOG. Para gerar isso é preciso ativar uma chave de debug no arquivo TOTVSPROFILE.PRO e executar novamente o SMARTCLIENT para que carregue a chave de debug:logix.balanca.debug=TRUE

Os pré-requisitos para uso da funcionalidade de pesagem a partir de balanças pelo Logix são:

• A partir da máquina local onde já deve existir a balança conectada e o driver da balança instalado, deve ser instalado um aplicativo executável disponibilizado pelo fornecedor da balança.
  Este aplicativo deve permitir execução via linha de comando - DOS / prompt de comando Windows e gerar um arquivo de saída no formato texto contendo as informações de pesagem em uma única linha, conforme já citado anteriormente o formato.
• As configurações de porta, velocidade, driver, modelo requeridos como parâmetros para o aplicativo devem ser analisados e levantados por algum responsável da área de TI - Tecnologia da Informação, conforme o manual do aplicativo cita os valores válidos de cada parâmetro requerido.
  Isso deve ser feito com base no modelo da balança que estiver instalado. Alguns modelos requerem instalação de um HARDKEY para permitir a leitura de informações de peso, mas isto também está descrito no manual do aplicativo disponibilizado pelo fabricante.

A implementação atual no Logix foi feita com base em 2 aplicativos, sendo:

• LEBALDOS.EXE Aplicativo disponibilizado no site do fabricante de balanças FILIZOLA, que gera o arquivo texto PESO.TXT em disco contendo informações da pesagem;
• LEPESO.EXE Aplicativo disponibilizado no site do fabricante de balanças TOLEDO, que gera o arquivo texto PESO.TXT em disco contendo informações da pesagem.

Ambos os aplicativos geram um arquivo com conteúdo num formato que deve ser cadastrado via LOG00099 no Logix e cada um dos aplicativos pode ter um código de status diferente para indicar status de SUCESSO de leitura do peso que também deve ser informado no cadastro LOG00099.

Desta forma facilita que vários outros modelos de balanças possam ser integrados ao Logix , pois cada balança pode ter outro aplicativo para realizar leitura de informações da balança. Os pré-requisitos são:

• Aplicativo que possa ser executado via linha de comando.
• Aplicativo deve gerar um arquivo de saída no formato texto contendo 1 linha com as informações de pesagem separadas por algum delimitador, bem como um código de status de leitura, informando qual o código de status de leitura com sucesso ou falha.
• O nome do arquivo de saída gerado pelo aplicativo é cadastrado no LOG00099.