Orientações de configuração do Agrotis Gerencial

Este é o Agrotis Integrador, responsável por permitir a comunicação de equipamentos (balanças rodoviárias, determinadores de umidade, etc)
com os sistemas da Plataforma Agrotis, bem como o sistema Agrotis Gerencial.

Segue abaixo as orientações de configuração do Agrotis Integrador no módulo de Armazenagem de Grãos do sistema Agrotis Gerencial.

Importante

Estas orientações passam a valer a partir da versão 340.3 do sistema e seus módulos.

Orientações

A) Primeiramente é necessário testar a comunicação da máquina do usuário (balanceiro ou classificador) com o servidor, conforme os seguintes passos:

Importante

Se acesso do balanceiro for via TS, o teste deve ser realizado a partir do TS.

  1. Acessar a área de downloads do site >> Ferramentas Gerencial >> Comunicação Agrotis Integrador MQTTS - Aplicativo de teste e dll (ZIP)
  2. Baixar e descompactar o arquivo Agrotis.Integrador.MqttsClient.zip
  3. Executar o aplicativo TesteAgrotisMqttsClient.exe
  4. Preencher servidor/porta conforme abaixo e usuário e senha conforme orientado pelo responsável (usuário armazenagem.dev é utilizado para testes do desenvolvimento)
  5. Clicar no botão CONECTAR:

Se tudo OK, aparecerá a mensagem de sucesso acima.

  1. Em produção, atualmente, temos o servidor MQTT integrador.agrotis.io:3881, que será desligado assim que migrados todos os clientes para o novo servidor mqtts.agrotis.io:8883.
  2. Neste cenário de testes, peso e umidade só aparecem caso haja publicação nos tópicos armazenagem.dev/legado/peso ou armazenagem.dev/legado/umidade respectivamente.
    Para a proposta do aplicativo, basta que apareça "Cliente MQTTS conectado!"
    Vamos melhorando este aplicativo de testes sob demanda.

Caso não seja possível conectar, a seguinte mensagem é apresentada após no máximo 10 segundos:

Importante

O servidor mqtts-internal.agrotis.io só funciona a partir da rede interna da sede da Agrotis, qualquer teste fora dessa rede não funcionará com o -internal.
Portanto, não use -internal em clientes!


A não comunicação pode se dar pelos seguintes motivos:

  1. Não encontrou a biblioteca Agrotis.MqttsClient.dll (neste caso uma mensagem é apresentada no aplicativo, bastando garantir que executável e dll tenham sido baixados juntos e estejam na mesma pasta)
  2. Não há permissão/liberação na rede/firewall/antivírus da máquina em que está realizando esse teste, para que a comunicação com nosso servidor seja possível (cenário mais provável)
  3. Nosso servidor está fora do ar (cenário pouco provável, pois há toda uma infraestrutura preparada para não deixar o serviço indisponível)


B) Estando comunicando (aplicativo de testes apresentou a mensagem "Cliente MQTTS conectado!")
é possível passar para a configuração do sistema gerencial, módulo de Armazenagem, via preferências ou variáveis de empresa ou de usuário:


1. Via preferências (cliente possui apenas uma filial, com uma balança rodoviária e/ou um medidor de umidade):

Categoria "Armazenagem":

"[BALANÇA] Modelo da balança rodoviária" = "Agrotis Integrador"

"Modelo do medidor de umidade" = "Agrotis Integrador"


Categoria "Agrotis Integrador" (necessário reiniciar o sistema para visualizar esta categoria após configurar as preferências acima):

"Servidor Mensageiro (Broker) - Caminho" = mqtts.agrotis.io

"Servidor Mensageiro (Broker) - Porta" = 8883

"Servidor Mensageiro (Broker) - Usuário" = Solicitar usuário e senha a um de nossos consultores

"Servidor Mensageiro (Broker) - Senha" = Solicitar usuário e senha a um de nossos consultores

"Servidor Mensageiro (Broker) - Usar conexão segura (exige Agrotis.MqttsClient.dll)" = Sim

"Servidor Mensageiro (Broker) - Nível de Qualidade do Serviço (QoS)" = 0

"ID do Agrotis Integrador" = Verificar número de identificação na etiqueta na lateral ou embaixo do equipamento Agrotis Integrador

"ID do equipamento padrão para leitura de peso" = 1 ou conforme orientação do implantador

"ID do equipamento padrão para leitura de umidade" = 1 ou conforme orientação do implantador


2. Via variáveis de empresa (cliente possui duas ou mais filiais, cada uma com até uma balança rodoviária e/ou um medidor de umidade):

No cadastro de empresa, aba 'Variáveis', incluir as seguintes variáveis, confirmando todos os dados com um de nossos consultores:

INTEGRADOR_SERVIDOR=[mqtts.agrotis.io]
INTEGRADOR_PORTA=[8883]
INTEGRADOR_USUARIO=[solicitar usuário e senha a um de nossos consultores]
INTEGRADOR_SENHA=[solicitar usuário e senha a um de nossos consultores]
INTEGRADOR_MQTTS=[1]
INTEGRADOR_QOS=[0]

INTEGRADOR_ID=[Verificar número de identificação na etiqueta na lateral ou embaixo do equipamento Agrotis Integrador]
INTEGRADOR_ID_PESO=[1] ou conforme orientação do implantador
INTEGRADOR_ID_UMID=[1] ou conforme orientação do implantador

Importante

  1. Os dados acima são os vigentes até a última edição deste documento, confirme sempre com o implantador/consultor os dados mais atuais.
  2. Não é obrigatório utilizar todas as variáveis no cadastro de empresa, só o que for diferente do já preenchido nas preferências.
    Ex: se cada filial tem um Agrotis Integrador exclusivo, nas variáveis de empresa bastaria incluir INTEGRADOR_ID com o ID do respectivo integrador.


3. Via variáveis de usuário (cliente possui uma ou mais filiais, com dois ou mais equipamentos iguais numa mesma filial, ex: duas balanças e/ou dois medidores):

Necessário cadastrar um usuário para cada equipamento, ex: BALANCA1 e BALANCA2
Então deve-se utilizar as mesmas variáveis acima, só que agora no cadastro do usuário, aba 'Variáveis'.

Importante

  1. Não é obrigatório utilizar todas as variáveis no cadastro de usuário, só o que for diferente do já preenchido nas preferências e variáveis de empresa.
    Seguindo o exemplo, no usuário BALANCA1, teremos a variável INTEGRADOR_ID_PESO=[1] para indicar que este usuário terá acesso à primeira balança conectada ao Agrotis Integrador,
    já no usuário BALANCA2, teremos INTEGRADOR_ID_PESO=[2], para indicar que este, por sua vez, só terá acesso à segunda balança.


C) Estando configurado corretamente, é possível testar a leitura de peso e umidade pelo módulo de Armazenagem:

Menu Módulos >> Armazenagem >> Operações >> Romaneio de entrada/saída: permite leitura de peso via teclas de atalho F8 e F9  e umidade via tecla de atalho F5

Menu Módulos >> Armazenagem >> Operações >> Pesagem de mercadoria: permite apenas leitura de peso via tecla de atalho F8 ou clicando no hiperlink acima de cada campo de peso

Artigos relacionados

Para maiores informações sobre o hardware Agrotis Integrador é possível consultar os artigos relacionados abaixo: