Esta página TDN centralizada e descreve os resultados explorados por meio do épico DAGROFRAME-4336, que fez parte da Meta de Pin People (Pesquisa "Fala, Gente Boa") para H2/2024 da Diretoria de Agro + Otimização Logística e da VP de Segmentos).

[DAGROFRAME-4336] 🎯Estudo e Análise de Viabilidade TOTVS iPaaS e TOTVS Agro Bioenergia (APIs Padrões) - JIRA
DAGROFRAME-4336 - Obtendo detalhes do item... STATUS

Conhecendo o TOTVS iPaaS (introdução/contextualização) | TOTVS Agro

O TOTVS iPaaS é uma ferramenta de integração de produtos, permitindo conectar produtos que utilizam diferentes formas de comunicação, de maneira simples e intuitiva utilizando drag-and-drop (arrastar e soltar) para que qualquer pessoa consiga elaborar diagramas. Atuando como intermediário, o TOTVS iPaaS permite realizar transformações nos dados de A para enviar a B, e vice-versa, além de criar diversos fluxos personalizados baseados em condições específicas dos dados trafegados. A solução também é capaz de integrar com qualquer aplicação, seja da TOTVS ou de terceiros.

Principais recursos e funcionalidades do TOTVS iPaaS | TOTVS Agro

Monitoramento → Monitor: É responsável por monitorar a quantidade de mensagens transacionadas, separando-as em processadas, em processamento, reprocessadas e com falhas. É possível reprocessar as mensagens de um ou vários diagramas na subdivisão "Mensagens". As informações podem ser filtradas por intervalo de tempo.

Monitoramento → Dashboard: Resume as informações de integração, como o consumo do plano contratado, a saúde do ambiente (percentual de mensagens processadas com sucesso em relação ao total transacionado), a quantidade de transações por diferentes períodos de tempo e os diagramas que levam mais tempo para executar, entre outras métricas.

Monitoramento → Alertas: Esta tela tem como objetivo automatizar a vigilância de problemas e dados de consumo nas integrações, permitindo a criação de alertas personalizados para monitorar o "Limite de mensagens" e a "Taxa de erro". A primeira opção notifica um número específico de pessoas definidas sobre o consumo de transações em relação ao plano contratado. A segunda opção alerta os responsáveis sobre exceções e erros nas integrações. Ambas opções permitem definir limites quantitativos ou percentuais para o envio dos alertas. Os contatos que receberão os alertas podem ser configurados com e-mails, Discord, Telegram, entre outros.

Integrações → Projetos e Pacotes → Templates: Criar diagramas a partir de templates pré-configurados. Além dos templates padrão, também é possível definir outros templates personalizados, facilitando e agilizando a criação de diagramas frequentemente utilizados.

Integrações → Projetos e Pacotes → Diagramas: O builder é a ferramenta de construção de diagramas, projetada no formato "arrasta e solta", permitindo a criação rápida e intuitiva de diagramas com diversas opções de configuração. Os diagramas podem ser salvos como rascunho ou publicados imediatamente após a finalização. No menu à esquerda, você pode acessar uma lista de aplicativos nativos e personalizados e os componentes essenciais para a construção dos diagramas. Também é possível editar configurações importantes, como o título e a descrição do diagrama, adicionar ou modificar variáveis, e ajustar a pré-visualização. O builder oferece ainda a possibilidade de consultar o histórico de ações e validar o diagrama, verificando automaticamente possíveis erros de fluxo ou configurações inadequadas antes da publicação. Além disso, o builder oferece funções adicionais no painel à esquerda, como a opção de alternar entre fundo claro e escuro para maior conforto, ajustar o zoom para facilitar a visualização de diagramas grandes, e a função "voltar ao início", que reposiciona o diagrama na posição original dentro do builder.

Ferramentas → Aplicativos → Nativos: Na guia "Nativos", estão listados todos os Aplicativos nativos homologados pela TOTVS, que já vêm disponíveis para uso ao adquirir o TOTVS iPaaS.

Ferramentas → Aplicativos → Personalizados: A guia "Personalizados" exibe exclusivamente os aplicativos criados pelos usuários. Estes aplicativos podem ser editados clicando no ícone de engrenagem. 
Para criar um novo aplicativo, basta localizar a opção "Cadastrar aplicativo" na aba "Aplicativos". Após criar um aplicativo, também é possível cadastrar os recursos que será utilizado, como Cadastrar ambiente, Cadastrar conta e Cadastrar serviço.

Ferramentas → Componentes: Lista os componentes de início, básicos e avançados por meio das guias de cada tipo de componentes. Além disso, é possível localizar componentes por meio da barra de busca.

Ferramentas → Componentes → Iniciais: Esta guia traz apenas os componentes que estão disponíveis para iniciar uma integração/diagrama. Sendo eles: SmartLink Hook, Timer, Webhook e Webhook síncrono.

Ferramentas → Componentes → Básicos: Esta guia traz os componentes de uso básico. Sendo eles: Converter, Generator, Global error, JDBC, Jolt, Resposta síncrona, JavaScript (disponível para o plano Enterprise), SmartLink Sender, Splitter, Throw Exception e XSLT.

Ferramentas → Componentes → Básicos → Converter: Este componente realiza a conversão de dados entre diferentes formatos, como XML para JSON e vice-versa, garantindo a compatibilidade de informações em fluxos complexos de integração. Ele aceita uma entrada em um formato específico e a transforma para outro conforme a necessidade do fluxo. O vídeo abaixo exemplifica o uso do componente Converter em um cenário prático:

Ferramentas → Componentes → Básicos → Generator:  Este componente é utilizado para gerar dados estruturados de forma automática, como objetos JSON ou elementos XML, criando estruturas padrão que podem ser utilizadas em fluxos de integração. A saída é um dado estruturado, como JSON ou XML, que pode ser usado em etapas subsequentes para processamento ou montagem de mensagens. O vídeo abaixo exemplifica o uso do componente Generator em um cenário prático:

Ferramentas → Componentes → Básicos → Global Error: Este componente cria um sub-fluxo dedicado para gerenciar e tratar erros em um nível global dentro de cada diagrama de integração. Ele permite a captura e o manuseio centralizado de exceções em qualquer parte do processo, garantindo que falhas inesperadas sejam tratadas de forma robusta e consistente. O componente é versátil e pode lidar com diferentes tipos de dados que causaram a exceção, como XML, JSON, entre outros. O vídeo abaixo exemplifica o uso do componente Global Error em um cenário prático:

Ferramentas → Componentes → Básicos → Jolt: Este componente permite a transformação de dados exclusivamente em formato JSON, aplicando regras definidas pelo usuário para modificar, reordenar ou enriquecer a estrutura de entrada. A entrada e a saída são sempre em JSON, tornando-o ideal para fluxos que manipulam dados desse tipo. O vídeo abaixo exemplifica o uso do componente Jolt em um cenário prático:

Ferramentas → Componentes → Básicos → Splitter: Este componente divide uma entrada de dados, como um documento XML ou um array JSON, em partes menores para permitir o processamento individual. Por exemplo, ele pode separar um array JSON em elementos únicos ou fragmentar um XML em nós específicos. A saída são partes separadas do dado original, prontas para processamento sequencial. O vídeo abaixo exemplifica o uso do componente Splitter em um cenário prático:

Ferramentas → Componentes → Básicos → Throw Exception: Este componente é utilizado para lançar exceções personalizadas em fluxos de integração, permitindo o tratamento específico de erros. Ele pode receber qualquer tipo de dado de entrada, mas serve para interromper o fluxo com uma mensagem de erro clara, ajudando na depuração e controle de exceções. O vídeo abaixo exemplifica o uso do componente Throw Exception em um cenário prático:

Ferramentas → Componentes → Avançados: Esta guia traz os componentes de uso avançado no TOTVS iPaaS. Sendo eles: FTP e SFTP.

Ferramentas → Variáveis → Projetos: Funcionam de maneira similar às variáveis globais, mas com o escopo limitado a um único projeto. Assim, as variáveis de projeto só são visíveis para diagramas dentro desse projeto específico.

Ferramentas → Variáveis → Globais: Visam facilitar o desenvolvimento de diagramas, reduzindo a duplicação de dados. Dados comuns podem ser cadastrados como palavras-chave e usados em múltiplos diagramas de um ou mais projetos. Caso haja necessidade de alteração, essa mudança refletirá em todos os diagramas que utilizam a variável.

Cenário Prático | TOTVS Agro

Para ilustrar cenários práticos, foi desenvolvido um protótipo de produto chamado "Agro Digital", que simula um recurso externo a ser consumido. Essa ferramenta se comunicará com o TOTVS Agro API Hub, com o objetivo de integrá-las como exemplo de aplicação. A seguir, são apresentados três cenários iniciais:

Cenário 1 (clique para acessar)

Cenário 2 (clique para acessar)

Cenário 3 (clique para acessar)

Cenário 4 (clique para acessar)

Semáforo iPaaS e TOTVS Agro Bioenergia & TOTVS Agro API Hub (considerações) | TOTVS Agro

Para esclarecer um compilado de informações e considerações, no formato de semáforo acesse a página a seguir:

Considerações (clique para acessar)

Modelos de Planos do iPaaS | TOTVS Agro

Os dados apresentados abaixo foram consultados no Webinar de Apresentação da Solução TOTVS iPaaS

Framework e Engenharia TOTVS Agro

🎯Estudo e Análise de Viabilidade TOTVS iPaaS e TOTVS Agro Bioenergia (APIs Padrões)