TOTVS AGRO

Páginas filhas
  • Integração com TOTVS Agro Multicultivo

Versões comparadas

Versão antiga 22

changes.mady.by.user Elizabete Aparecida dos Santos

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Henrique Lopes Moino

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  1. Visão Geral
  2. Pré-requisitos para TOTVS Connector Client
    1. O que é TOTVS Connector
    2. O que é TOTVS Connector Client? 
    3. Requisitos Mínimos de Instalação
    4. Requisitos de Ambiente / Infraestrutura
  3. Pré-requisitos para TOTVS Agro Multicultivo
    1. Versão Mínima
    2. Requisitos de Ambiente / Infraestrutura
  4. Configuração TOTVS Agro Multicultivo
    1. Sincronismo MDM
    2. Totvs Connector Client
  5. Configuração Meu Fitossanitário
    1. Leitura QR Code
    2. Observação para clientes Meu Fitossanitário
  6. Como enviar (sincronizar) registros
  7. Tabelas que possuem sincronismo e Pré-requisitos 
    1. TOTVS Agro Multicultivo
      1. Configuração de Local de Produção
      2. Cultura / Ocupação
      3. Variedade / Híbridos
      4. Safra / Ano Agrícola
      5. Período de Produção
      6. Unidade Administrativa
      7. Fazenda
      8. SetorVariedade
      9. Talhão
    2. Meu Fitossanitário
      1. Variáveis
      2. Inspeções
      3. Armadilhas
  8. Observações Importantes
    1. Registros dependentes mandados fora de ordem
    2. Tempo de envio dos dados

...

É a parte responsável por ler os dados das aplicações On Premises. Ele é instalado em uma máquina que possa se conectar com o banco de dados do produto On Premise/Private Cloud.
Portanto, o TOTVS Connector Client irá se conectar com a base de dados do TOTVS Agro Multicultivo e enviará os registros, que sofrerem alterações, para o Meu Fitossanitário.

Após a instalação do TOTVS Connector Client é necessário que haja a inclusão dos seguintes schemas para o correto funcionamento do TOTVS Agro Fitossanitário e nesse exemplo abaixo de schemas está a relação para versão 12.1.2406 no TOTVS Agro Multicultivo:

    • ParametroLocal
    • Instancia
    • Cultura
    • Cultivar
    • AnoAgricola
    • PeriodoSafra
    • LocalProducao1
    • LocalProducao2
    • LocalProducao3
    • LocalProducao3Fisico
    • Variavel
    • Armadilha
    • Inspecao
    • Insumo
    • UnidadeMedida
    • GrupoInsumo
    • InspecaoResultadoCalculado

  • Requisitos Mínimos de Instalação

    • Sugestão do sistema operacional:

    Requisitos Mínimos de Instalação

    • Sugestão do sistema operacional: Debian ou Ubuntu ou CentOS GNU/Linux 10 (buster) ou distribuição Linux 64 bits (versões Server ou Desktop/GUI).
    • Memória RAM: 4GB.
    • Processador: Quad Core 1.8 GHZ ou superior.
    • Espaço em Disco: Espaço em disco de 40GB.
    • Ferramentas/Recursos principais: Docker (containers Linux) e Portainer (opcional, para monitoramento/gestão de ambientes baseados em Docker/containers).

...

Para utilizar a integração, é preciso relacionar os registros da tabela de Cultivo / Ocupação com a Cultura MDM. Portanto, é necessário configurar o Grupo de Configuração 50. Navegue até a tela Configurações Gerais pelo menu Administração > Configurações Gerais e busque pela configuração 50.


Image Modified


Atualize o campo "Utiliza MDM" para o valor "Sim". Essa configuração permitirá o uso do Cultivo / Ocupação MDM nos registros da tabela Cultura / Ocupação.


Image Modified


É necessário preencher o campo "APP ID", que é um token para utilizar os serviços (Web Services) do MDM. Para receber o seu token, entre em contato conosco para providenciarmos um para você. A imagem a seguir mostra o campo "APP ID" com um token fictício.


Image Modified


Agora, é preciso ativar o processo agendado "IntegracaoMdmAsyncScheduler", na qual é responsável por manter os seus dados do MDM atualizados. Para ativar, navegue até a tela Cadastros de Processos Agendados pelo menu Administração > Processos Agendados, e digite "mdm" para buscar o processo do MDM.


Image Modified


Atualize o campo "Ativo", selecionando a caixa de seleção do campo "Ativo", e salve o registro.


Image Modified


Pronto. O Sincronismo do MDM está configurado.

...

A integração do Meu Fitossanitário com o TOTVS Agro Multicultivo é feita através da leitura de um QRCode. Esse QRCode contém um identificador único da integração, permitindo o Meu Fitossanitário e TOTVS Agro Multicultivo se comunicarem. Para o Meu Fitossanitário realizar a leitura do QRCode, é necessário configurar geração dele no TOTVS Agro Multicultivo. Para isso, navegue até a tela Configurações Gerais pelo menu Administração > Configurações Gerais, e busque pela configuração 53.


Image Modified


No campo "Valor", será colocado a URL do TOTVS Connector Client que retornará o seu identificador de integração. O formato da URL deve ser a seguinte: "http://XX_XX_XX_XXX:YYYY/api/v1/clientMetadata", onde XX_XX_XX_XXX é o IP da máquina em que está instalado o TOTVS Connector Client e YYYY é a porta da rede em que a aplicação está utilizando. A imagem mostra o campo "Valor" com um IP e porta da rede fictícios.


Image Modified


Agora, vamos testar a geração do QRCode. Navegue até a tela Configuração para TOTVS Connector pelo menu Administração > Configuração para TOTVS Connector.  Se não houve problemas com a configuração, a tela deve gerar o QRCode corretamente, como a imagem a seguir.


Image Modified


Se a tela apresentar o erro da imagem a seguir, verifique se o IP e a porta foram inseridos corretamente na tela de Configurações Gerais, explicado anteriormente neste mesmo tópico. Também verifique a liberação da URL do TOTVS Connector Client, explicado no tópico 3 - Pré-requisitos para TOTVS Agro Multicultivo.


Image Modified


05. Configuração Meu Fitossanitário

...

A tela Configuração do Local de Produção (acessado através do menu Administração > Configuração do Local de Produção), possui parâmetros que são utilizados para configurar o Local de Produção, como "Utiliza Ano Agrícola" e "Utiliza Setor". Por padrão, esses parâmetros vêm desabilitados no Meu Fitossanitário. Caso você utilize algum desses parâmetros, é necessário enviar esse registro para o Meu Fitossanitário (explicado no tópico 07 - Como enviar os registros). 


Image Modified


Cultura / Ocupação

A tabela Cultura / Ocupação possui dependência com a configuração do Sincronismo MDM. Caso não tenha configurado o Sincronismo MDM no seu TOTVS Agro Multicultivo, leia o tópico 04 - Configuração TOTVS Agro Multicultivo. Como a Cultura / Ocupação do Meu Fitossanitário possui associação com a Cultura MDM, é preciso associar a Cultura / Ocupação do TOTVS Agro Multicultivo com a Cultura MDM correspondente. Importante: se a Cultura / Ocupação não estiver com a Cultura MDM associada, não acontecerá o envio do registro. Para associar a Cultura MDM, acesse a tela de cadastro da Cultura / Ocupação, através do menu Tabelas > Culturas > Cultura / Ocupação.


Image Modified


Selecione uma Cultura / Ocupação e clique em editar. No campo "Cultura MDM", clique na lupa para abrir a janela das Culturas MDM.


Image Modified


Após selecionar a Cultura MDM desejada, clique em salvar.


Image Modified


Pronto. A Cultura / Ocupação está associada à Cultura MDM.

...

A tabela Variedade/Híbridos possui dependência com a configuração do Sincronismo MDM. Caso não tenha configurado o Sincronismo MDM no seu TOTVS Agro Multicultivo, leia o tópico 04 - Configuração TOTVS Agro Multicultivo. Como a Variedade/Híbridos do Meu Fitossanitário possui associação com a Variedade MDM, é preciso associar a Variedade/Híbridos do TOTVS Agro Multicultivo com a Variedade MDM correspondente. Importante: se a Variedade/Híbridos não estiver com a Variedade MDM associada, não acontecerá o envio do registro. Para associar a Variedade MDM, acesse a tela de cadastro da Variedade/Híbridos, através do menu Tabelas > Culturas > Variedade/Híbridos.


Image Modified

...


Selecione uma Variedade/Híbridos e clique em editar. No campo "Variedade MDM", clique na lupa para abrir a janela das Variedade MDM.


                                                                                                Image Modified


       Após selecionar a Variedade MDM desejada, clique em salvar.


Image Modified


     

 Pronto. A Variedade/Híbridos está associada à Variedade MDM.


Safra / Ano Agrícola

Os registros da tabela Safra / Ano Agrícola não possuem dependências para ser enviada. Basta incluir ou atualizar um registro existente, que será enviado para o Meu Fitossanitário. Para acessar a tabela Safra / Ano Agrícola, navegue até o menu Tabelas > Calendário > Safra / Ano Agrícola.


Image Modified

Período de Produção

O registros da tabela Período de Produção possuem dependências dos registros da tabela Safra / Ano Agrícola. Ou seja, para o Meu Fitossanitário receber o Período de Produção, é preciso que a Safra / Ano Agrícola do Período de Produção, já tenha sido enviada anteriormente. Para acessar a tabela Período de Produção, navegue até o menu Tabelas > Calendário > Período de Produção.

...

Os registros da tabela Unidade Administrativa não possuem dependências. Basta incluir ou atualizar um registro existente, que será enviado para o Meu Fitossanitário. Para acessar a tabela Unidade Administrativa, navegue até o menu Administração > Unidade Administrativa.


Image Modified


Fazenda

Os registros da tabela Fazenda possuem dependências com os registros da tabela Unidade Administrativa. Ou seja, para o Meu Fitossanitário receber a Fazenda, é preciso que a Unidade Administrativa da Fazenda, já tenha sido enviada anteriormente. Para acessar a tabela Fazenda, navegue até o menu Tabelas > Locais de Produção > Fazenda.


Image Modified


Setor

Os registros da tabela Setor possuem dependências com os registros da tabela Fazenda. Ou seja, para o Meu Fitossanitário receber o Setor, é preciso que a Fazenda do Setor, já tenha sido enviada anteriormente. Para acessar a tabela Setor, navegue até o menu Tabelas > Locais de Produção > Setor.


Image Modified


Talhão

Os registros da tabela Talhão possuem dependências com os registros das tabelas Setor e Período de Produção . Ou seja, para o Meu Fitossanitário receber o Talhão, é preciso que o Setor e o Período de Produção do Talhão, já tenham sido enviados anteriormente. Além disso, é preciso que o registro do Talhão possua um mapa cadastrado. Caso contrário, o registro do Talhão não será enviado para o Meu Fitossanitário. Para acessar a tabela Talhão, navegue até o menu Tabelas > Locais de Produção > Talhão.


Image Modified


Para verificar se o Talhão possui um mapa cadastrado, selecione um Talhão na tela Cadastro de Talhão e clique em "Editar". Selecione a aba "Mapa" e selecione a opção "Visualizar Mapa". Se o Talhão estiver com mapa cadastrado, a tela apresentará o mapa cadastrado.


Image Modified



Caso não houver mapa cadastrado, a tela apresentará uma mensagem que não possui mapa cadastrado.


Image Modified

  • Meu Fitossanitário

IMPORTANTE!

(1) NÃO se Recomenda-se o uso de recurso de "Cópia de Talhão" do TOTVS Agro Multicultivo para um mesmo polígono em 2 fazendas diferentes, pois pode impactar a experiência de uso do usuário final devido a sobreposição de polígonos (não impeditivo ao uso do aplicativo);

(2) Caso seja alterada a entidade "Fazenda" associada a um Talhão pré-existente na rotina de "Edição de Talhão" do TOTVS Agro Multicultivo, o histórico de inspeções do Talhão sofrerá as seguintes consequências práticas:

(a) Perda de referência de histórico de inspeções do talhão associado a Fazenda "original" no App Meu Fitossanitário Visões, devido a impossibilidade de associação entre entidades (i) "Talhão" e (ii) "Fazenda" original por parte do sistema;

(b) Manutenção da possibilidade de consulta de histórico de Talhão de Fazenda antiga através do uso de Indicadores do PIMS MC;

(c) Armazenamento de histórico de dados de inspeção no Banco de Dados do TOTVS Agro Fitossanitário.


  • Meu Fitossanitário

Todos os registros das tabelas do Meu Fitossanitário Todos os registros das tabelas do Meu Fitossanitário são enviados, automaticamente, quando realiza o sincronismo dos dados pelo aplicativo Meu Fitossanitário. As dependências das tabelas do Meu Fitossanitário, são os cadastros dos registros das tabelas do TOTVS Agro Multicultivo, citadas anteriormente. Uma vez enviado esses registros para o Meu Fitossanitário, não há nenhuma outra dependência para enviar os dados do Meu Fitossanitário para o TOTVS Agro Multicultivo. 

...

  • CF_VARIAVEL: possui informações do cadastro de variáveis.
  • CF_VARIAVEL_OPCAO: possui informações das opções cadastradas para as variáveis do tipo Lista. . 
  • CF_VARIAVEL_RESULTADO: possui informações que definem se a variável é a principal ou não do talhão e seu valor (Disponível a partir da versão 12.1.2406 do TOTVS Agro Multicultivo).

Para saber mais sobre o cadastro de Variáveis no Meu Fitossanitário, acesse a documentação Variáveis.

...

As tabelas do TOTVS Agro Multicultivo que correspondem à tabela de Inspeção são: correspondem à tabela de Inspeção são: 

  • CF_INSPECAO: possui informações da inspeção, como data de abertura e nome do inspetor.
  • CF_PONTO: possui informações sobre cada ponto de determinada inspeção, como a data que o ponto foi inserido, a sua posição (latitude e longitude), se foi inserido de forma manual e se está excluído.

  • CF_APTO_VARIAVEL: possui informações sobre o apontamento das variáveis de inspeção. Essas variáveis podem ser variáveis da planta (ponto) ou da praga.

  • CF_APTO_PRAGA: possui informações sobre a praga, como nome, nome científico e o tipo da praga (doença, inseto ou erva daninha).

  • CF_INSPECAO_RESULTADO: possuiinformações dos resultados calculados  das variáveis inspecionadas com seus valores e os valores das legendas das variáveis (Alerta, Controle e Dano) (Disponível a partir da versão 12.1.2406 do TOTVS Agro Multicultivo).
  • CF_INSPECAO_RESULTADO_CALCULO:  possui informações dos status (legenda) de cada talhão e suas respectivas datas dos apontamentos.  (Disponível a partir da versão 12.1.2406 do TOTVS Agro Multicultivo
  • CF_INSPECAO: possui informações da inspeção, como data de abertura e nome do inspetor.
  • CF_PONTO: possui informações sobre cada ponto de determinada inspeção, como a data que o ponto foi inserido, a sua posição (latitude e longitude), se foi inserido de forma manual e se está excluído.

  • CF_APTO_VARIAVEL: possui informações sobre o apontamento das variáveis de inspeção. Essas variáveis podem ser variáveis da planta (ponto) ou da praga.

  • CF_APTO_PRAGA: possui informações sobre a praga, como nome, nome científico e o tipo da praga (doença, inseto ou erva daninha).

Armadilha

As tabelas do TOTVS Agro Multicultivo que correspondem à tabela de Armadilha são: 

  • CF_ARMADILHA: possui informações sobre as armadilhas cadastradas. 
  • CF_APTO_ARMADILHA: possui informações sobre o apontamento das armadilhas, como a data do apontamento, o nome do inspetor, o nome e o nome científico da praga e o valor apontado.
  • CF_ARMADILHA_UPNIVEL1: possui informações sobre o apontamento das armadilhas nas Fazendas (Disponível a partir da versão 12.1.2406 do TOTVS Agro Multicultivo).


08.  Observações Importantes

...