Árvore de páginas

Versões comparadas

Chave

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

...

O builder é o nosso nosso construtor de diagramas. No modelo arrasta e solta é possível construir diagramas de forma rápida e simples e nele . 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 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, como o Splitter e o Global error e 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 do diagramade diagramas extensos, voltar ao início que recentraliza um diagrama no componente de início facilitando a visualização de diagramas muito extensos. E reposiciona o diagrama na posição inicial em relação ao builder, a opção de aplicar fundo branco ou quadriculado , onde dessa forma o usuário consegue escolher qual o fundo é 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. 


Image RemovedImage Added


Criar diagrama

...

Existem duas formas de Para criar um diagrama no TOTVS Connector Plataforma. Quando o usuário já tem um projeto e deseja criar um novo diagrama dentro deste projeto e quando o usuário ainda não possui um possui um projeto. Abaixo vamos explicar as duas formas existentes.

Com projeto

Para criar um diagrama possuindo um projeto, siga os passos abaixo:

01. No projeto desejado clique em Visualizar. O projeto será aberto.

02. Clique em Criar diagrama. O builder será aberto para a construção do diagrama.

03. Inicie incluindo um nome para o diagrama em Diagrama sem título.

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áveis04 Após isso, escolha o componente de início que deseja. Atualmente temos o Timer e Webhook.

Painel
borderColor#f2f2f2
bgColor#f2f2f2

Consulte as documentações acima para mais detalhes sobre componentes de início.

05. Escolhe os aplicativos que deseja utilizar para a construção do diagrama. Para isso consulte a documentação de Aplicativos.

06. Caso seja necessário utilizar componentes de subfluxo no diagrama consulte a documentação de Spltter e Global error.

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.07. É possível salvar o diagrama em modo rascunho para publicá-lo mais tarde, para isso clique em Salvar rascunho

Painel
borderColor#f2f2f2
bgColor#f2f2f2

O diagrama salvo será apresentado dentro do projeto escolhido. Portanto, ao salvar o diagrama pode-se fechar o buider. 

08. Para publicar o diagrama clique em Publicar diagrama.

Sem projeto

Para criar um diagrama, primeiro é necessário criar um projeto e a partir dele criar um diagrama. Para isso, siga os passos abaixo:

01. Passe o mouse sobre Integrações e depois clique em Projetos&Pacotes.

02. Clique em Novo projeto.

03. Defina um novo para o novo projeto e clique em Confirmar.

04. Após isso, o projeto será aberto. Clique em Criar diagrama.

05. Aqui os passos se igualam ao item Com projeto, siga os passos acima.

Configurações gerais do diagrama

Dentro do builder existe as configurações gerais do diagrama. Explicaremos mais sobre as configurações nos passos abaixo: 

01. Clique no ícone Image Removed localizado no lado direito superior da tela.

02. As configurações gerais serão apresentadas em duas guias distintas, sendo Informações e Variáveis.

Informações

Essa guia exibe as seguinte informações: Título do diagrama e Descrição do diagrama.

01. Caso deseje pode-se alterar o título do diagrama no campo de mesmo nome e a descrição do diagrama no campo de mesmo nome respectivamente.

02. Após as alterações clique em Salvar.

Variáveis

Essa guia exibe as informações sobre variáveis já cadastradas separadas pelas guias Todas, Projetos e Globais, além de apresentar a opção de cadastrar novas variáveis.

Cadastrar variável

01. Com a guia Variáveis aberta, clique em Cadastrar variável.

02. Selecione o tipo da variável entre Global e Projetos.

03. Insira a chave da variável, ou seja, um nome para localizá-la com facilidade.

04. Insira o valor da variável, ou seja, seu conteúdo.

05. Clique em Salvar.

Editar variável

01. Com a guia de Variáveis aberta, localize a variável que deseja editar.

02. Clique no ícone Image Removed para editar a variável.

03. Será possível editar apenas o campo Valor da variável. Também é possível ocultar seu valor através do ícone Image Removed, dessa forma seu valor ficará ocultado na listagem de variáveis.

04. Clique em Salvar.

Excluir variável

01. Com a guia de Variáveis aberta, localize a variável que deseja excluir.

02. Clique no ícone Image Removed para excluir a variável.

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. 

Painel
borderColor#f2f2f2
bgColor#f2f2f2

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.03. Uma mensagem para confirmar a ação será apresentada informando que a variável não poderá ser utilizada novamente. Para excluir clique em Excluir.

Painel
borderColor#f2f2f2
bgColor#f2f2f2
  • Note que algumas lixeiras ficarão identificadas com a cor cinza claro como na imagem abaixo.

Image Removed

  • Isso quer dizer que esta variável está em uso em algum diagrama e por isso não pode ser excluída. 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. Como na imagem abaixo.

Image Removed

Pesquisar variáveis

01. Na barra de busca insira o valor ou a chave da variável. Os resultados são apresentados conforme a digitação.

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.02. Ao lado da barra de busca existe um filtro onde é possível filtrar as variáveis por: Mais recentes, chave ou valor. Por padrão, o filtro vem preenchido com a opção Mais recentes.


Paralelismo

...

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


Image RemovedImage Added


Painelnote
borderColor#f2f2f2
bgColor#f2f2f2

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

Painelnote
borderColor#f2f2f2
bgColor#f2f2f2

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 unicoúnico:


Image RemovedImage Added


Paineltip
borderColor#f2f2f2
bgColor#f2f2f2

Importante: 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 Image Added para facilitar em casos onde o diagrama é extenso. Além disso, as ações de aumento Image Added e diminuição Image Added do zomm também estão disponíveis. 

Painel
borderColor#f2f2f2
bgColor#f2f2f2

Essas mesmas ações são apresentadas nos componentes que abrem um subfluxo como o Splitter e o Global Error.