Versões comparadas

Chave

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

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
Jira
serverJIRA
serverId0c783de1-186e-383b-975c-a1acd7d76cb5
keyDAGROFRAME-4336


...

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.

...

Monitoramento → Monitor: Esta tela é É 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: Esta tela resume 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.

...

Integrações → Projetos e Pacotes → Templates: No TOTVS iPaaS, você pode criar Criar diagramas a partir de templates pré-configurados. Além dos templates padrão, também é possível definir outros templates  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 do TOTVS iPaaS, 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 builde builder.


Ferramentas → Aplicativos → Nativos: Na guia "Nativos", estão listados todos os aplicativos Aplicativos nativos homologados pela TOTVS, que já vêm disponíveis para uso ao adquirir o TOTVS iPaaS. Você pode conferir cada um deles neste link: Aplicativos nativos.

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 ele utilizará, como Ambientes, Contas e Serviços. Para o passo a passo de cada tipo de cadastro de recurso, acesse os links a seguir: será utilizado, como Cadastrar ambiente,   Cadastrar conta Cadastrar serviço.

...

Ferramentas → Componentes: A página de componentes do TOTVS iPaaS lista Lista os componentes de início, básicos e avançados por meio das guias de cada tipo de componente componentes. Além disso, é possível localizar componentes por meio da barra de busca. Para mais detalhes e especificações de cada componente, consulte este link: Componentes.

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 no TOTVS iPaaS. 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 → GeneratorConverter: Este componente gera formato realiza a conversão de dados do tipo entre diferentes formatos, como XML para JSON e XMLvice-versa, permitindo a criação de chaves e valores ou tags, este contéudo pode ser tratado com um outro formato de dados de entrada, podendo utilizar parte da entrada para moldar um novo formato de dados, para exemplificar, assista o vídeo abaixogarantindo 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:

Multimedia
namerender converter.mp4
width40%
height40%

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:

Multimedia
namerender generator.mp4
width40%
height40%

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:

Multimedia
nameRender Global Error.mp4
width40%
height40%

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:

Multimedia
nameRender Jolt.mp4
width40%
height40%

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:

Multimedia
namerender splitter.mp4
width40%
height40%

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:

Multimedia
namerender
generator
throw exception.mp4
width40%
height40%


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

...

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)


Aviso
titleObservação

Será importante analisar todos os cenários, pois cada um contém informações complementares, novos exemplos a serem explorados e a resolução de algumas limitações.


...

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.

Screenshot_1.pngImage Removed

Screenshot_2.pngImage Removed


Image Added


Image Added


Aviso
titleObservação

Valores

...

e planos sujeitos a atualização, consulte o responsável.


...

Framework e Engenharia TOTVS Agro

...