Árvore de páginas




O builder é o construtor de diagramas do TOTVS iPaaS. No modelo arrasta e solta é possível construir diversos diagramas com diversas opções de configurações de forma rápida e simples, sendo possível apenas salvá-lo para uma publicação futura ou publicá-lo no momento da finalização da construção e configuração do diagrama.

Ao lado esquerdo temos o menu, onde é possível consultar todos os aplicativos nativos ou personalizados, que são aplicativos criados pelos usuários para atender suas necessidades, e componentes para a construção do diagrama. 

Também é possível acessar e editar algumas configurações do diagrama como: título, descrição, editar e cadastrar novas variáveis e editar a pré-visualização do diagrama. Além de poder acessar o histórico de ações e validar o diagrama, que analisa se existe algum erro de fluxo ou configuração de aplicativos e componentes ao publicar o diagrama. Outro ponto é o atalho para o projeto no qual o diagrama que está sendo construído através do ícone .

Na ações localizadas ao lado esquerdo do builder temos a opção de aplicar o fundo escuro ou claro oferecendo maior conforto ao construir um diagrama, aumentar ou diminuir o zoom para facilitar a visualização de diagramas extensos e voltar ao início que reposiciona o diagrama na posição inicial em relação ao builder.

Para iniciar a construção do diagrama é necessário escolher qual componente de início será utilizado escolhendo entre: SmartLink Hook, Timer, Webhook e Webhook síncrono.

Recomendamos a leitura de algumas documentações que auxiliarão no contexto e facilitarão a construção do diagrama.



Criar diagrama


Para criar um diagrama no TOTVS iPaaS é necessário antes ter um projeto criado. Para isso siga as instruções na documentação de Integrações. Após o projeto criado, é possível criar o diagrama também descrito na documentação de diagramas no tópico Criar diagrama dentro de projeto.

Nesta documentação abordaremos as possibilidades de uso e configurações do builder.


Configurações


Dentro do builder existem as configurações gerais do diagrama.


01. Ao final do menu lateral, clique em Configurações .

02. Três guias são apresentadas: Informações, Variáveis e Pré-visualização.

Informações


Nesta guia é possível alterar o nome e descrição do diagrama através dos campos Título do diagrama e Descrição do diagrama.

Variáveis


Essa guia exibe as variáveis já cadastradas separadas por categorias: Todas, Projetos e Globais, além de apresentar a opção Cadastrar variável. Para cadastrar uma nova variável siga as instruções na documentação Variáveis.

Algumas variáveis apresentam o ícone de lixeira desabilitado. Isso acontece por que essas variáveis estão em uso em algum diagrama e por isso não podem ser excluídas. Para saber mais detalhes de onde a variável esta sendo utilizada clique no ícone da lixeira e depois em Saiba onde esta variável está sendo utilizada.

Pré-visualização


Essa guia apresentada as informações definidas para a pré-visualização do card do diagrama. Nela também é possível fazer alterações caso desejado.

Pré-visualização do diagrama: Este tópico é opcional e quando deseja-se personalizar a pré-visualização do diagrama é possível escolher até 4 ícone utilizados no diagrama para serem exibidos no card do diagrama, facilitando sua identificação. 

  • Selecione até 4 ícones: possível escolher até 4 ícones para a pré-visualização personalizada do diagrama.
  • Área da pré-visualização: Ao escolher os ícones é exibida uma pré-visualização de como ficará o card do diagrama.

Definir pré-visualização automaticamente: quando ativado será definido automaticamente como ficará o card do diagrama com base nos aplicativos utilizados. 

03. Após realizar todas as alterações desejadas através das configurações gerais do diagrama, clique em Salvar.


Histórico


Para acessar o histórico siga os passos abaixo:


01. Ao final do menu lateral, clique em Histórico.

02. O histórico será apresentado mostrando todas as ações tomadas pelos usuários, versão do diagrama, além de data e hora da modificação.

03. Clicando na ação desejada é possível visualizar o diagrama e caso necessário, é possível restaurar a versão clicando em Restaurar essa versão.

04. Uma mensagem será apresentada junto a um campo de descrição para informar o que foi alterado. Clique em Restaurar para confirmar a ação. 

Ao acessar o histórico é possível utilizar o filtro disponível para buscar determinadas ações. Por exemplo, é possível pesquisar por Usuários, Status, Versões e Meses.


Validar diagrama


Esse recurso permite verificar se há existência de erros na configuração do diagrama.


01. Ao final do menu lateral, clique em Validar diagrama .

02. Será executado a validação do diagrama para encontrar se existe alguma configuração errônea ou faltante.

03. Ao final, o diagnóstico será apresentado no rodapé do builder.

Os aplicativos e componentes identificados pela validação ficarão identificados para que as ações necessárias sejam tomadas. Além disso, uma tag informando a quantidade de erros encontrados é apresentada no lado direito superior do builder.


Condição


O recurso de condições tem o intuito de fazer com que o diagrama atenda certas condições impostas para que ele siga a integração realizada. Essas configurações são feitas a partir das linhas que ligam os componentes aos aplicativos. Para mais informações sobre como configurar condição nos diagramas, siga as instruções na documentação Condição.


Paralelismo


Com o TOTVS iPaaS, é possível criar fluxos paralelos nas integrações, reduzindo o tamanho dos diagramas e facilitando a leitura do processo. Assim, ao arrastar um componente ou aplicativo para o builder, é possível criar uma bifurcação com dois fluxos distintos a serem executados concomitantemente, refletindo todo o cenário de negócio na integração.



Em caso de erros em qualquer um dos fluxos, a integração terá o status de Não Processada.

A ordem de execução dos fluxos poderá variar durante o processamento da integração, ou seja, o fluxo paralelo TOTVS Collab → Google Suite poderá ser executado antes que o fluxo paralelo Forms → Fluig.


É possível ainda convergir dois fluxos paralelos em um único:



Seguindo o exemplo acima, o aplicativo "RD Station" não aguardará pelo termino de ambos fluxos paralelos para ser executado, ao final do processamento de cada fluxo paralelo ocasionará em uma chamada individual do aplicativo RD Station. Logo, a junção de dois ou mais fluxos paralelos resultará em duas ou mais execuções do aplicativo convergente.


Mais ações do builder


Estão disponíveis no builder ações como recentralizar para facilitar a visualização em casos onde o diagrama é extenso. Aumento e diminuição do zomm e aplicação de fundo claro ou escuro através do ícone

As ações recentralizar e aumentar e diminuir zoom também são apresentadas nos componentes que abrem um subfluxo como o Splitter e o Global Error.