O builder é o nosso nosso construtor de diagramas. No modelo arrasta e solta é possível construir diagramas de forma rápida e simples. Nele existem várias possibilidades de criação de diagramas, de configurações, sendo possível apenas salvá-lo para uma publicação futura ou também publicá-lo no momento da finalização do diagrama.
Ao lado esquerdo da tela encontra-se é possível visualizar e acessar informações do projeto através do ícone
. Também encontra todos os aplicativos nativos e personalizados disponíveis para a criação dos diagramas, podendo ser utilizado o filtro para pesquisa e rápida localização dos aplicativos. Também é possível visualizar todos os componentes, acessar as variáveis já cadastradas ou cadastrar novas variáveis.Além disso, na barra de ferramentas do builder temos as opções de aumentar ou diminuir o zoom para facilitar a visualização de diagramas extensos, voltar ao início que reposiciona o diagrama na posição inicial em relação ao builder, a opção de aplicar fundo branco ou quadriculado onde dessa forma é possível escolher a forma mais confortável para construir o diagrama. E o diagnóstico de erros, que analise se existe algum erro de fluxo na criaçã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 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, causando mau funcionando dos diagramas que a utilizam. 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 no 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 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 será 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 configurações 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 processo. Assim, ao arrastar para o builder um componente ou aplicativo, é 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 em casos onde o diagrama é extenso. Além disso, as ações de aumento e diminuição do zomm também estão disponíveis.Essas mesmas ações são apresentadas nos componentes que abrem um subfluxo como o Splitter e o Global Error.