TOTVS AGRO

Páginas filhas
  • Integração com a Solinftec - Telemetria de Máquina

Versões comparadas

Versão antiga 7

changes.mady.by.user Usuário desconhecido (tp.adenilson.marques)

Gravado em

comparado com

Nova versão 8

changes.mady.by.user Usuário desconhecido (tp.adenilson.marques)

Gravado em

Chave

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

...

03. DEMAIS FUNCIONALIDADES

  • Funcionário Padrão
  • Horário que será iniciado o processo para buscar os dados da Solinftec
    • Para definir o horário que o AgroData irá buscar as informações na Solinftec, entrar no banco de dados do AgroData, localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, para ID 10 com o NAME_PARAMETER='CRON_CLIENT_SCHEDULE', deverá definir uma expressão cron. Como default enviamos a seguinte expressão "0 0 22 * * ?", indicando que o processo será realizado todos os dias as 22:00 hs. Após finalizar o processo de baixar os apontamentos da Solinftec e o parâmetro "AUTOMATIC_TIMING" para o ID 11, estiver ativo o sistema ira começar a atualizar os apontamentos no Totvs Agro Multicultivo.
  • Ativar a utilização da telemetria dos apontamentos das solinftec.
    • Para ativar o modulo da Solinftec entrar no banco do AgroData, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor para o ID 15, com o NAME_PARAMETER='MODULO_SOLINFTEC'.
  • Quantidade de dias para busca dos apontamento na Solinftec
    • Este parâmetro define a quantidade de dias para baixar as telemetrias das máquinas, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor para o ID 19, com o NAME_PARAMETER='QUANTIDADE_DIAS_DATA_INICIAL', como valor padrão o parâmetro será  criado com 7 dias. Para definição deste parâmetro é importante levantar junto a Solinftec a quantidade de dias que ele pode liberar apontamentos. O apontamentos baixamos serão ignorados.
  • Remover a quantidade de dias dos apontamentos baixados
    • Este parâmetro define a quantidade de dias  para remover os apontamentos baixados e processados, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor para o ID 20, com o NAME_PARAMETER='REMOVER_REGISTROS_APOS_X_DIAS', como valor padrão o parâmetro será criado com 365 dias.
  • Apontar horas improdutivas
    • Este parâmetro define se serão consideramos as horas improdutivas enviadas pela telemetria, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor para o ID 21, com o NAME_PARAMETER='APONTAR_OPERACAO_IMPRODUTIVA', como valor padrão o parâmetro será criado com 'S'.
  • Grupos Operativos que serão ignorados na integração dos apontamentos.
    • Este parâmetro será utilizado para desconsiderar os grupos operativos de equipamentos na integração com o Totvs Agro Multicultivo, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor para o ID 23, com o NAME_PARAMETER='GRUPOS_EQUIPTO_NAO_APONTADOS', como valor padrão o parâmetro será vazio, caso necessite informar mais de um grupo operativo deverá ser criado separado com ';' ponto e virgua, exemplo 300;301.
  • Agrupar apontamentos com a mesma sequência
    • Este parâmetro será utilizado para agrupar os apontamentos com a mesma sequencia, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor para o ID 24, com o NAME_PARAMETER='AGRUPAR_SEQUENCIAL_OPERACOES_NAO_PRODUTIVAS', como valor padrão o parâmetro será 'S'. Nas experiências que tivemos nos clientes, quando o parâmetro estiver definido com 'S', gerou um grande quantidade de detalhe do apontamento.
  • Busca código do funcionário ERP
    • Este parâmetros será utilizado para definir como será considerado a busca do código do funcionário, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor para o ID 22, com o NAME_PARAMETER='BUSCA_FUNCIONARIO_TABELA_ERP', como valor padrão o parâmetro será 'N'. Quando o parâmetro estiver definido como 'S", a integração irá considerar o Código ERP do cadastro de funcionário, caso esteja como "N", será considerado o Código do cadastro de funcionário.
  • Considerar a jornada do apontamento
    • Este parâmetro será utilizados para definir como será considerado a jornada do operador, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir como será o valor,  para o ID 25, com o NAME_PARAMETER='UTILIZA_PARAMETRO_DT_HR_INI_REGNAJORNADA', como valor padrão o parâmetro será 'S'. Quando o parâmetro estiver definido como 'N", a jornada do operador será considerado as horas das operações disponibilizada pela telemetria, caso esteja como "S", será considerado a jornada do operador disponibilizada pela Solinftec.
  • Iniciar os detalhes do apontamento em 00:00 ou utilizar a hora real
    • Este parâmetro define a maneira que será iniciado a hora inicial no detalhe do apontamento, quando o parâmetro estiver definido como "S", será utilizado a hora real enviada pela telemetria da máquina, caso esteja definido como "N", a hora inicial no detalhe do apontamento será iniciado as "00:00".  Para isto localizar o ID 26, com NAME_PARAMETER='MOSTRAR_HORA_REAL_OPERADOR' na tabela PARAMETERS e no campo VALUE_PARAMETER definir a maneira que será iniciado a hora inicial. Valores validos (S/N). 
  • Tipo de Apontamentos Agrícola
    • Para a funcionamento correto da integração entre o AgroData e o Totvs Agro Multicultivo criar um tipo de apontamento para receber a telemetria da máquina. O Código e Descrição fica a critério do usuário, porém os seguintes campos deve esta marcados:
      • Tipo: Mecanizado
      • Cabeçalho - Comum
        • Turno
        • Observação
        • Centro de Custo
        • Operação
        • Equipamento
      • Cabeçalho - Mecanizado
        • Operador
        • Hora Inicial (Jornada do Operador)
        • Hora Final (Jornada do Operador)
        • Jornada do Operador
      • Detalhe - Local de Produção
        • Ano Agrícola
        • Período de Produção
        • Bloco
        • Gleba
        • Área
      • Detalhe - Mecanizado
        • Ordem de Serviço de Campo (Obrigatório = N)
        • Ano Agríocla
        • Período de Produção
        • Fazenda (Nível 1)
        • Setor (Nível 2)
        • Talhão (Nível 3)
        • Operação
        • Implemento
        • Hr/Km Inicial
        • Hr/Km Final
        • Hr/Km Total
    • Efetuar uma consulta no Totvs Agro Multicultivo (Administração → Execução de Consulta) na tabela AU_TIPO, localizar o modelo criado e copiar o valor do campo ID_AU_TIPO
    • Entrar no banco de dados do Agrodata, localizar a tabela PARAMETERS e efetua um UPDATE no campo VALUE_PARAMETRO com o ID_AU_ATIPO selecionado na opção para o ID 17 e o NAME_PARAMETER='ID_AU_TIPO_SOLINFITEC'.
  • Recuperar a Unidade Administrativa no Totvs Agro Multicultivo,
    • Recupera a Fazenda (Nível1) disponibilizado pela solinftec e efetua a busca pelo código na Totvs Agro Multicultivo, caso encontre o sistema irá considerar a unidade administrativa da fazenda e os apontamentos serão descarregados nesta unidade, caso não encontre a unidade administrativa o sistema ira desconsiderar esta linha e gerar mensagem que a unidade administrativa não foi localizada.
  • Para inserção na base de dados Totvs Agro Multicultivo o Totvs Agro Conecta recupera a fazenda disponibilizada pela solinftec e através da mesma localiza a unidade administrativa onde os apontamentos serão inseridos. Caso a Fazenda disponibilizada pela Solintec não seja encontrada no Totvs Agro Multicultivo este apontamento não será inserido no Totvs Agro Multicultivo ficando disponível para consulta apenas na base de dados do Totvs Agro Conecta.
  • Caso a Solinftec disponibilize na API  de telemetria a informação da ordem de serviço de campo, Totvs Agro Conecta ira considerar o Ano Agrícola, Período de Produção e Centro de Custo da ordem para inserção no Totvs Agro Multicltivo.
  • Caso a Solinftec não disponibiliza o sistema ira 

04. PARAMETRIZAÇÃO

...

Tabela: PARAMETERS

Configuração

Parâmetro

ConfiguraçãoConfiguração 

ID_AU_TIPO_SOLINFITECNeste parâmetro o usuário deverá indicar o ID   do   tipo de apontamento agrícola . É necessário a configuração de um tipo de apontamento agrícola para importação de dados, seu ID deve ser o valor deste parâmetrocriado para receber os apontamentos de telemetria da Solinftec. Para criar o tipo de apontamento seguir as instruções informadas em "demais funcionalidades".
FUNCIONARIO_PADRAO

Neste parâmetro o usuário deverá indicar o ID do funcionário padrão criado no Totvs Agro Multicultivo. Este funcionário deverá ter o mesmo código do funcionário padrão criado pela Solinftec. Para localizar o ID deste funcionário deverá efetuar uma pesquisa no banco de dados do Totvs Agro Multicultivo na tabela FUNCIONAR, para o código do funcionário criado. Caso não tenha criado o funcionário padrão no Totvs Agro Multicultivo o mesmo deverá ser criado.

UTILIZA_OSFlag para identificar se o TOTVS Agro Data utilizará o número da ordem de serviço para montar os apontamentos agrícolas. Valores válidos: S ou N, que significam sim e não respectivamente.FIXED_DELAY_GATEWAY_SCHEDULEPeriodicidade da rotina de sincronismo entre Operations Center → TOTVS Agro Data em segundosNeste parâmetro o usuário deverá indicar se utiliza Ordem de Serviço de campo. Valores válidos (S/N). Quando configurado e não possuir ordem de serviço disponibilizado pela telemetria da máquina o sistema irá procurar uma Ordem de Serviço de Campo criada para o Local de Produção (Fazenda/Setor/Talhão) e operação no Totvs Agro Multicultivo, caso encontre, será utilizado o Ano Agrícola, Período de Produção e Centro de Custo. caso não esteja configurado não irá procurar uma ordem de serviço de campo.
CRON_CLIENT_SCHEDULEExpressão Neste parâmetro o usuário deverá indicar a expressão cron que determina um horário fixo para a rotina de sincronismo TOTVS Agro Data → TOTVS Agro Multicultivosbaixar as telemetrias da máquina. Valor padrão "0 0 22 * * ?", que indica que a integração será realizadas as 22:00 e após baixar os dados da Solinftec e o parâmetro AUTOMATIC_TIMING estiver configurado os dados serão enviados para o Totvs Agro Multicultivo. Documentação sobre expressões crons: https://docs.oracle.com/cd/E12058_01/doc/doc.1014/e12030/cron_expressions.htm.
AUTOMATIC_TIMINGFlag para definir se o TOTVS Agro Data irá exportar os apontamentos agrícolas automaticamente para o TOTVS Agro Multicultivos, caso este parâmetro esteja configurado como não, a aplicação irá realizar somente o sincronismo Operations Center → TOTVS Agro Data, ficando a cargo do usuário acionar manualmente a sincronização TOTVS Agro Data → TOTVS Agro Multicultivos. Valores válidos: S ou N, que significam sim e não respectivamente.
START_DATE_DOWNLOADS

Data inicial dos dados que é desejado realizar o sincronismo. Exemplo: 01/01/2000 12:00:00, neste caso o TOTVS Agro Data irá buscar dados de operações que foram realizadas desde o dia 01 de janeiro de 2000, a partir das 12 horas. O formato da data deve ser: dd/MM/yyyy HH:mm:ss.

END_DATE_DOWNLOADSData final dos dados que é desejado realizar o sincronismo. Exemplo: 01/01/2000 12:00:00, neste caso o TOTVS Agro Data irá buscar dados de operações que foram realizadas até o dia 01 de janeiro de 2000, antes das 12 horas. O formato da data deve ser: dd/MM/yyyy HH:mm:ss.
Neste parâmetro o usuário deverá definir se os dados baixados da Solinftec será enviados para o Totvs Agro Multicultivo. Valor validos (S/N). Quando configurado indica que os apontamentos serão enviado para o Totvs Agro Multicultivos, caso contrário os dados ficarão apenas disponibilizados no Totvs Agro Data. 
MODULO_SOLINFTEC

Neste parâmetro o usuário deverá indicar que utiliza a telemetria da máquina da Solinftec. Valor validos (S?N). Quando configurado indica que utiliza a telemetria da máquina da Solinftec, caso contrário não utiliza a telemetria da máquina da Solinftec.

QUANTIDADE_DIAS_DATA_INICIALNeste parâmetro o usuário deverá indicar a quantidade de dias anterior da data inicial para importar a telemetria da máquina da Solinftec. Valor padrão 7. Exemplo: Supondo que estamos baixando apontamento para o dia 31/08, e estiver configurado 7 dias, o sistema irá buscar apontamento a partir do dia 25/08. Os apontamentos que foram baixados serão desconsiderados baixando apenas os novos apontamentos disponibilizados. 
REMOVER_REGISTROS_APOS_X_DIASNeste parâmetro o usuário deverá indicar a quantidade de dias anterior a data inicial para remover os apontamentos baixados da Solinftec. Valor padrão 365. Neste exemplo o sistema ira remover os apontamentos baixados da Solinftec anterior a 365 dias a partir da data atual. Ex. Se estiver baixando os apontamentos do dia 31/08/2021. serão removidos os apontamentos com data menor igual a 31/08/2020.
APONTAR_OPERACAO_IMPRODUTIVANeste parâmetro o usuário devera indicar se considera as operações improdutivas para integrar com o Totvs Agro Multcultivo. Valores validos (S/N). Caso configurado serão consideradas as horas das operações improdutivas para integrar com o Totvs Agro Multicultivo, caso contrário as horas das operações improdutivas serão desconsideradas.
BUSCA_FUNCIONARIO_TABELA_ERPNeste parâmetro o usuário deverá indicar se buscar o código do funcionário ERP no Totvs Agro Multoultico para compara com o código disponibilizado pela Solinftec. Valores validos (S/N). Caso configurado indica que Totvs Agro Data irá utilizar o Código ERP informado no cadastro de funcionário do Totvs Agro Multicultivo para comparar com o código disponibilizado pela Sonliftec, caso contrário o Totvs Agro Data, irá utilizar o código do funcinário do Totvs Agro Multiciltivo para comparar com o código disponibilizado pela Solinftec, Quando configurado que utiliza o código ERP do funcionário, deverá atentar se no ERP o código não se repete entre as filiais, pois se isto ocorrer o Totvs Agro Data não irá conseguir recuperar o funcionário.
GRUPOS_EQUIPTO_NAO_APONTADOSNeste parâmetro o usuário deverá indicar o grupo operativo dos equipamento serão desconsiderados na integração com a Solintec. Caso possua mais de uma grupo operativo o mesmo deverá ser informado separado por ";" ponto e virgula; Ex: 10;20. Quando informado grupo operativos todos os equipamento deste grupo será desconsiderados na integração com a solinftec.
AGRUPAR_SEQUENCIAL_OPERACOES_NAO_PRODUTIVASROUDING_ENGINE_HOURS

Parâmetro que determina se o registro do horímetro será arredondado. Valores válidos S ou N.

Exemplo: hora início 1515.5 e hora fim 1519.4, com o parâmetro no S as horas ficariam da seguinte forma, início 1516 e fim 1519. 


04. GLOSSÁRIO

Termo

Descrição

TOTVS Agro MulticultivosSolução TOTVS para o setor de agronegócio focado em vários tipos de cultivos, como soja, milho, etc...
Solinftec
Sincronismo Solinftec → TOTVS Agro Data
Sincronismo TOTVS Agro Data → TOTVS Agro MulticultivosRotina onde o TOTVS Agro Data trata os dados de sua base, e os transforma em apontamentos agrícolas para exportá-los ao TOTVS Agro Multicultivos.


...