Índice

Objetivo

O objetivo deste guia é demonstrar a criação de um dataset simples, para possibilitar a integração com sistemas terceiros sem qualquer tipo de codificação.

Pré-requisitos

Para que se tenha uma compreensão completa destas informações, alguns conhecimentos são considerados pré-requisitos, entre eles:

Visão geral sobre o Fluig
Visão geral sobre integração de sistemas

Criação de datasets simples

A criação de dataset simples está disponível no Painel de Controle do Fluig e consiste em duas etapas: o cadastro do serviço e a configuração do dataset.

Apenas os usuários administradores da plataforma têm acesso a essas configurações.

Cadastro do serviço

Para cadastrar o serviço é necessário conhecer o endereço e o método do Webservice que contém as informações que devem ser trazidas para o TOTVS Fluig Plataforma. É possível cadastrar serviços SOAP, REST ou JDBC, conforme a documentação: https://tdn.totvs.com/x/mqVtJg

Configuração do dataset simples

Após ter o serviço cadastrado, vamos criar o dataset simples, acesse a opção Painel de controle localize o agrupador Desenvolvimento e acione a opção datasets.

Selecione a opção novo dataset e após simples:

TOTVS Fluig > Dataset Simples > image2021-12-8_14-39-16.png

Preencher os campos para criação do dataset, os campos destacados com um asterisco (*) são de preenchimento obrigatório:

Campo	Descrição
Código*	Código do dataset, será utilizado para chamado do dataset em processos por exemplo.
Descrição*	Descrição do dataset para pode identificar a funcionalidade do mesmo.
Serviço*	Selecionar o serviço que será realizado a integração.
Operação	Aqui será selecionado a tabela ou método que será chamado do serviço.
Configurar	Pode ser configurada limite de resultado (JDBC) e configuração de autenticação (REST)
Parâmetro	Serão informados os parâmetros para buscar os dados conforme a operação selecionada.

TOTVS Fluig > Dataset Simples > image2021-12-8_14-57-30.png

TOTVS Fluig > Dataset Simples > image2021-12-8_14-59-18.png

O código-fonte gerado nessa interface pode ser utilizado em outros recursos, como eventos de processos ou scripts de tarefa de serviço assíncrono, por exemplo. Bastando neste caso que o desenvolvedor se responsabilize pela forma como o retorno do webservice é tratada. Além disso, o código-fonte dos datasets simples pode ser editado pelo Fluig Studio ou em modo avançado pela própria plataforma, o que automaticamente os transforma em datasets avançados.

Para visualizar mais detalhes sobre a criação dos datasets, acesse nossas documentações:

Edição em modo avançado

A interface de edição em modo avançado, disponível a partir da atualização 1.6.5 - Liquid, é acessada acionando a edição do dataset na listagem. Essa interface apresenta algumas vantagens em relação à edição pelo Fluig Studio, sendo algumas delas:

Histórico de versões publicadas, com detalhamento do responsável e possibilidade de restaurar versão antiga;
Possibilidade de manter as alterações em rascunho (salvar a edição sem publicá-la);
Monitoramento detalhado do serviço relacionado, com o log e a quantidade de requisições efetuadas.

Os datasets podem ser convertidos de simples para avançado, mas o contrário não pode ser feito: a partir do momento em que um dataset simples for editado em modo avançado, ele passa a ser um dataset avançado, e com isso, não poderá ser novamente editado em modo simples.

Esta documentação é válida a partir da atualização 1.6.5 - Liquid. Se você utiliza uma atualização anterior, ela pode conter informações diferentes das quais você vê na sua plataforma.