| Índice | ||||||
|---|---|---|---|---|---|---|
|
...
O objetivo do TOTVS iPaaS é ser uma plataforma Low Code, feita para facilitar a construção e manutenção de integrações, para perfis de usuários com baixo aprofundamento técnico e também para usuários com grande experiência em desenvolvimento.
...
Caso não conheça o TOTVS iPaaS, clique aqui e saiba mais.
***imagem***
...
Com este exemplo, você será capaz de chamar o TOTVS iPaaS enviando dados fixos ou de campos do formulário.
...
Com um diagrama configurado no TOTVS iPaaS com o componente de início do tipo webhook, você deve copiar a url. O fluig é compatível com os dois tipos de autenticação: via token e via URL.
...
Ou ainda, podemos cadastrar o domínio e selecionar a autenticação “custom” informando “apiKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
imagem domínio
...
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.
...
| Bloco de código |
|---|
var serviceName = 'connector-cadastro-centro-custos-rm';
//Caso não tenha informado a API KEY no cadastro de serviço, preencha na linha abaixo
var apiKey = ''; //'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
//Neste objeto são os dados que são enviados para o TOTVS iPaaS. Neste exemplo, apenas um campo de formulário está sendo enviado.
//Note: em Strings retornadas pelos nossos métodos (hAPI, getValue) deve ser adicionado a concatenação com uma String vazia (+ '').
//Caso não seja feito isso, o comando JSON.stringify retornará um erro.
var data = {
'processId': hAPI.getCardValue("processId") + ''
}
// a partir daqui o código deve ser mantido
var clientService = fluigAPI.getAuthorizeClientService();
var vo = {
companyId : getValue("WKCompany") + '',
serviceCode : serviceName, // código usado no cadastro do serviço
endpoint : '',
method : 'post',
timeoutService: '3000', // timeout do serviço em ms, neste caso, 3 segundos.
params : data ,
options : {
encoding : 'UTF-8',
mediaType: 'application/json'
},
headers: {
"Content-Type": 'application/json;charset=UTF-8'
}
};
if (apiKey) {
vo.headers.apiKey = apiKey;
}
try {
// O objeto data montado para realizar a requisição precisa ser convertido para um texto para ser enviado
var result = clientService.invoke(JSON.stringify(vo));
if (result.getHttpStatusResult() >= 200 && result.getHttpStatusResult() < 300) {
// o Connector funciona de maneira assíncrona então vai retornar um 202 (Accepted).
log.info("connector retornou ok");
} else if (result.getHttpStatusResult() == 401) {
log.info("Ocorreu um erro ao comunicar com o TOTVS iPaaS. Confira a URL do serviço e a API KEY utilizada");
throw "Error 401";
} else if (result.getHttpStatusResult() == 0 && result.getDescription() != null && result.getDescription().startsWith("ERROR CALLING SERVICE")) {
log.info("Ocorreu um erro ao chamar o serviço. Confira se o serviço foi criado com o nome: " + data.serviceCode)
throw "Error 404"
} else {
log.info("Ocorreu algum erro desconhecido")
log.dir(result);
throw "Error UNK";
}
} catch (e) {
throw "Ocorreu um erro. Entre em contato com a administração do fluig (" + e + ")";
}
|
...
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 possuir conectores que permitem fazer apenas a configuração de variáveis, vamos mostrar como cadastrar ambos os tipos de serviço.
...
No TOTVS IPaaS, acesse Aplicativos e Cadastrar aplicativo:
...
Ao concluir o cadastro, você será redirecionado novamente para a tela de listagem de aplicativos.
...
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.
...
Para a lista completa dos serviços e dos recursos de cada serviço pode ser consultada em https://tdn.totvs.com/pages/releaseview.action?pageId=662867789
...
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/
...
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 da API estão listados:
imagem ipaas
...
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ção https://tdn.totvs.com/display/public/fluig/Fluig+API#FluigAPI-Cadastraraplicativonofluigapp
...
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.
imagem ipaas
...
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.
...