Esta página descreve um compilado de informações e considerações, no formato de semáforo (🟢verde = resolvido, 🟠amarelo/laranja = atenção e 🔴vermelho = limitação/restrição), com o objetivo de facilitar o entendimento acerca de detalhes do Estudo e Análise de Viabilidade da adoção de TOTVS iPaaS no contexto de APIs Padrões do produto TOTVS Agro Bioenergia, por meio do TOTVS Agro API Hub.

Dúvidas | TOTVS Agro

1) Existe a possibilidade de utilizar o content-type do body que seja diferente de "application/json"? Sim, é só passar o content-type no cabeçalho, neste exemplo foi passado a variável "var.project.ta_api_hub_content_type" no cabeçalho (inHeader) contendo "x-www-form-urlencoded", ou seja, será convertido de JSON para este formato internamente.

Limitações | TOTVS Agro

1) Atualmente, o sistema não permite a definição de variáveis globais ou de projeto de forma dinâmica. Para resolver essa limitação, o time do iPaaS está desenvolvendo um componente que permitirá a atualização automática dessas variáveis, com previsão de lançamento para 2025. Por enquanto, uma solução alternativa seria utilizar variáveis para gerenciar esses diagramas manualmente. Um exemplo prático é o armazenamento do lastUpdate mais recente do respectivo dia em uma variável do iPaaS, que precisaria ser atualizado manualmente conforme a necessidade. Embora essa funcionalidade ainda não esteja disponível nativamente, alguns clientes optam por implementar soluções externas para suprir essa necessidade.

Para exemplificar o controle manual utilizando variáveis do iPaaS, temos, na primeira imagem, o uso do parâmetro lastUpdate vazio para selecionar todos os itens que sofreram alguma alteração. Já na segunda imagem, fornecemos a última data de modificação do respectivo dia, permitindo filtrar a busca e identificar apenas os itens alterados posteriormente a essa data. Nesse caso, o valor utilizado como filtro deve ser armazenado manualmente em uma variável do iPaaS, que deve ser atualizada conforme necessário. A ideia é que, no final de cada dia, seja capturada a maior data de atualização do respectivo dia de maneira manual. Após isso, é necessário atualizar a variável do iPaaS manualmente com essa data coletada. Assim, quando o diagrama for executado novamente podendo ser no final do expediente, por exemplo, serão capturados apenas os registros posteriores à data definida. Cada caso é um caso, neste cenário, essa abordagem foi adotada para contornar uma limitação que em breve será corrigida.

Foi identificado, através das requisições realizadas pelo navegador, uma possível forma de alterar variáveis no TOTVS iPaaS sem utilizar a interface gráfica. Esse processo envolve enviar um cabeçalho de autorização contendo o token da sessão (válido por 2 dias), além de incluir no corpo da requisição as informações necessárias, como o ID do projeto, a chave da variável e o novo valor da variável (destacado em vermelho).

Seria viável criar um recurso que se conectasse a esse endpoint, permitindo a atualização automática da variável diretamente no diagrama, conforme os critérios definidos. No entanto, há um obstáculo: o token de autenticação expira após 2 dias e precisa ser renovado manualmente. Caso seja possível automatizar o envio dos dados para a autenticação e receber o novo token, seria possível automatizar completamente esse processo, tornando essa solução totalmente válida, como observado nas imagens abaixo:

--------------------------------------------------------------------------------------------------------------------------------------

2) Atualmente, não é possível armazenar partes de uma resposta (body e header) de um recurso ou requisição em uma variável dinâmica que permita seu uso de forma automatizada em outras requisições. Segundo a equipe do iPaaS, o desenvolvimento de um componente para atender a essa necessidade está previsto para ser entregue em 2025. 

--------------------------------------------------------------------------------------------------------------------------------------

3) O componente JavaScript foi criado recentemente, porém, não pode ser utilizado em qualquer tipo de conta.

--------------------------------------------------------------------------------------------------------------------------------------

4) Há limitações na importação de aplicativos, serviços e recursos. Não é possível importar aplicativos, ambientes e serviços entre contas diferentes. No caso de serviços, é necessário cadastrá-los manualmente ou utilizar uma implementação de OpenAPI como Swagger.

--------------------------------------------------------------------------------------------------------------------------------------

5) Função size não aceita corpo vazio, logo se for passado o inBody {} ela não consegue mensurar que o array está com 0 itens, é necessário apontar um array em específico, como por exemplo inBody.items.