TOTVS AGRO

Páginas filhas
  • Orientações e FAQ - TOTVS Agro API HUB

Versões comparadas

Versão antiga 7

changes.mady.by.user Andre da Rocha Souza

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Gabriel Giovani de Souza Machado

Gravado em

Chave

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

...

Expandir
titleErro ao subir o serviço do TOTVS Agro API Hub após alterar ta-api-hub.xml no Windows Server 2016
Nota
iconfalse

No Windows Server 2016, ocorre um erro ao tentar subir o serviço do TOTVS Agro API Hub após realizar alguma alteração no arquivo ta-api-hub.xml.

Este erro é sistêmico no Windows Server 2016, sendo necessário, como alternativa, reinstalar o serviço do TOTVS Agro API Hub.

Para realizar este processo, podemos seguir da seguinte forma:

  • Executar o arquivo unistall.bat

    • Caso ainda fique instalado o serviço, reinicie o Windows Server 2016

  • Após, execute o arquivo install-service-only.bat
    • Se não iniciar o serviço automaticamente, acesse a página de Serviços do Windows Server 2016 e inicie o serviço do TOTVS Agro API Hub manualmente.



Expandir
titleAlterar clientId e clientSecret (Chaves de acessos às APIs)
Nota
iconfalse
  1. Para alterar o clientId e clientSecret padrão, primeiro devemos gerar as novas credenciais através do ta-api-hub-encrypt.jar
    Image Added

  2. Com as credenciais geradas, devemos acrescentar ou modificar o argumento na tag <arguments> </arguments> no arquivo de configuração ta-api-hub.xml

    Bloco de código
    languagejava
    <arguments>
 -Dta-api-hub.credentials.client-id=ENC(VGnuE7ODZpa8Sj2OFC/bQt5NwBAZQntbLBCDF/myCkqmN0r5tduQhF9mdbGd5ez+)
 -Dta-api-hub.credentials.client-secret=ENC(yullLPu69+0RBWHWcNjwLFJPsdmPPXVr6HuFz6G+E5fResQ0gIGIRZZX3L+iWSiT)
</arguments>
  3. Pronto, agora para realizar um teste, basta codificar SEU_CLIENT_ID:SEU_CLIENT_SECRET (no exemplo: teste:teste:123) para Base64
  4. Agora basta chamar http://SEU_IP:SUA_PORTA/oauth2/token enviando no Headers
    1. Key: Authorization
    2. Value: BasicdGVzdGU6dGVzdGUxMjM=



Expandir
title[20/10/2025] TOTVS Agro API Hub com múltiplas conexões/produtos (Bioenergia, Indústria/PI e Indústria/MI)
Nota
iconfalse

Esta atualização adiciona suporte para múltiplas conexões de banco de dados de produtos externos no TOTVS Agro API Hub (mínimo 1, máximo 3) , permitindo integração simultânea com Bioenergia , Indústria PI e Indústria MI . A configuração da base de Bioenergia é obrigatória , enquanto Indústria PI e Indústria MI são opcionais. A seguir, será demonstrado como o XML de argumentos deve ser ajustado, mostrando o antes e depois da atualização para garantir a compatibilidade.


Como era antes:

Image Added

Como ficou:

Image Added


Para ajustar o XML de argumentos:

  1. Localize as propriedades antigas que começam com -Dta-api-hub.product... (destacadas com retângulo e setas vermelhas);

  2. Ajuste para o novo padrão: -Dta-api-hub.products.<produto>..., conforme mostrado na imagem de exemplo;
  3. Para cada produto que deseja ativar (bioenergia, industria-pi, industria-mi), repita o bloco de propriedades, atualizando <produto> pelo nome correspondente e preenchendo os dados necessários;
  4. Caso não utilize algum produto, ajuste a propriedade -Dta-api-hub.products.<produto>.enabled =false;
  5. A propriedade default-instance foi movida para o nível do ta-api-hub:
    1. Antes: -Dta-api-hub.product.default-instance;
    2. Agora: -Dta-api-hub.default-instance e -Dta-api-hub.default-company.
  6. Após configurar e salvar o ta-api-hub.xml , execute o uninstall.bat para remover o serviço antigo. Em seguida, execute install-service-only.bat para instalar o serviço com a nova configuração.


Observação: Esta explicação se aplica à instalação do ta-api-hub utilizando os arquivos .bat.