| Í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.
...
01. Primeiramente, precisaremos criar um diagrama. Para isso, vá em Integrações, selecione um projeto já existente ou crie um novo e então clique em Criar diagrama.
...
Ou ainda, podemos cadastrar o domínio e selecionar a autenticação “custom” informando “apiKey: xxxxxxxx-xxxx-xxxx-xxxx-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.
...
| 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 TOTVS Fluig através do TOTVS iPaaS enviando dados fixos ou os dados de entrada de um webhook. O TOTVS 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.
...
01. No TOTVS IPaaS, acesse Aplicativos e em seguida 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 TOTVS 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 TOTVS Fluig e adicionando /services. Por exemplo, caso o seu TOTVS 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 TOTVS 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 TOTVS Fluig e adicionando /api-rest. Por exemplo, caso o seu TOTVS 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/
...
Logo após, clique em Concluir.
...
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 TOTVS Fluig e configurar um usuário integrador, conforme essa documentação.
...
Logo após, clique em Concluir.
...
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.
...