...
Ou ainda, podemos cadastrar o domínio e selecionar a autenticação “custom” informando “apiKey“apiKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”xxxxxxxxxxxx”
...
Este código pode ser usado tanto em um dataset quanto em um processo. No nosso exemplo é uma atividade de serviço que manda dados do formulário para o TOTVS iPaaS.
...
Com este exemplo, você será capaz de chamar o fluig através do TOTVS iPaaS enviando dados fixos ou os dados de entrada de um webhook. O fluig possui API’s do tipo SOAP e REST e ambas podem ser utilizadas, porém, por questões de autenticação, para movimentar uma solicitação é aconselhável usar a API SOAP.
Apesar do TOTVS IPaaS iPaaS possuir conectores que permitem fazer apenas a configuração de variáveis, vamos mostrar como cadastrar ambos os tipos de serviço.
...
No cadastro de aplicativos, selecione o aplicativo que você criou do fluig para incluir os serviços. Para os serviços SOAP, você pode visualizar todos os serviços disponíveis acessando o endereço do seu fluig e adicionando /services. Por exemplo, caso o seu fluig seja acessível através do endereço https://empresa/ os serviços disponíveis estão listados em https://empresa/services. Para a movimentação de solicitações, vamos usar o SOAP de Workflow: https://empresa/webdesk/ECMWorkflowEngineService?wsdl.
...
Avance para “Recursos” e informe o endereço “wsdl” do serviço, no caso https://empresa/webdesk/ECMWorkflowEngineService?wsdl.
A importação leva alguns segundos que é o tempo necessário para que o TOTVS IpaaS valide o endereço e consiga trazer todos os dados desse serviço. Ao finalizar, você verá que todos os métodos do wsdl estão listados:
...
No cadastro de aplicativos, selecione o aplicativo que você criou do fluig para incluir os serviços. Para os serviços da API Pública, você pode visualizar todos os serviços disponíveis acessando o endereço do seu fluig e adicionando /api-rest. Por exemplo, caso o seu fluig seja acessível através do endereço https://empresa/ os serviços disponíveis estão listados em https://empresa/api-rest. Para a movimentação de solicitações, vamos usar a api de Process Managemento SOAP de Workflow: https://empresa/process-management/swagger-ui/
Para isso, na edição do aplicativo no TOTVS IPaaS, acesse Serviços e clique em cadastrar serviço. Preencha os dados selecionando o tipo de serviço como REST. Ao selecionar esta opção, irá pedir o Ambiente.
...
Você pode selecionar um ambiente pré-cadastrado, ou adicionar selecionando a opção Cadastrar ambiente. A autenticação pode ser feita tanto por token quanto por OAUTH1, que é a forma que iremos abordar. Para as APIs públicas do fluig, você não deve informar apenas a URL do fluig, é necessário utilizar o que é chamado de “Base URL” da api. Neste caso, a URL ficaria https://empresa/process-management/api.
Onde https://empresa/ é o endereço da empresa e process-management/api é a Base URL da api do fluig.
...
Nesta página também está o arquivo “swagger“swagger.json” json” que iremos usar para importar os recursos. No TOTVS IPaaSiPaaS, avance para a parte de recursos e clique no botão importar recurso e informe a URL do arquivo json mencionado.
A importação leva alguns segundos que é o tempo necessário para que o TOTVS IpaaS iPaaS valide o endereço e consiga trazer todos os dados desse serviço. Ao finalizar, você verá que todos os métodos da API estão listados:
...
Ao contrário do SOAP que recebe o usuário e a senha a cada método, a API Pùblica se conecta através da autenticação OAUTH. Para utilizar essa autenticação é necessário cadastrar um aplicativo no fluig e configurar um usuário integrador, conforme essa documentaçãohttps://tdn.totvs.com/display/public/fluig/Fluig+API#FluigAPI-Cadastraraplicativonofluigapp
Após o cadastro, acesse na tela do aplicativo a parte de Contas e clique em Cadastrar Conta.
...
Selecione o ambiente da API e a autenticação como OAUTH1 e informe os dados de consumer key, consumer secret, access token e token secret conforme o cadastro realizado no fluig.
...
Acesso no TOTVS iPaaS o menu Integrações e acesse a opção Projetos & Pacotes. Você pode utilizar projetos já existentes ou clicar em criar um projeto novo. No projeto, crie um novo diagrama e preencha o nome e a descrição.
...
Para o SOAP, selecione o serviço e o recurso (por exemplo, simpleStartProcess para iniciar uma solicitação) e não é necessário configurar uma conta. Na tela seguinte, a partir da leitura que foi realizada no momento do cadastro, já é exibida a tela com todos os dados aceitos pelo serviço. Em caso de dúvidas, você pode acessar a já referenciada documentação dos webservices do fluighttps://tdn.totvs.com/pages/releaseview.action?pageId=662867789
Para API Pública, selecione o serviço e recurso (por exemplo, Processes - /v2/processes/{{{processId}}}/start - Start request para iniciar uma solicitação) e selecione a conta que será usada para a autenticação.
Assim como no SOAP, na tela seguinte exibida todos os dados aceitos pelo serviço. Note que existem parâmetros InPath que são os itens da URL (neste caso, o {{{processId}}}) e os parâmetros InBody que são os dados do “corpo” da requisição. Em caso de dúvida sobre os parâmetros, você pode acessar também a documentação das API’s do fluig em https://api. fluig.com/latest/index.html.