Árvore de páginas

Versões comparadas

Chave

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

...

Você pode usar via URL quando tiver a necessidade de alterar essas chaves futuramente ou via autenticação quando quiser limitar um pouco mais o acesso ao serviço ou quando não quiser que a pessoa que cadastre o serviço tenha acesso a essa chave.

imagem webhokImage Added


No TOTVS Fluig, acesse o Painel de Controle e no grupo Desenvolvimento acesse a opção Serviços.

imagem painel de controleImage Added


Clique no botão Novo Serviço.

imagem serviçosImage Added

Selecione o tipo de serviço REST e preencha os campos código e descrição conforme o tipo de integração. Lembre-se que você deve ter um cadastro de serviço para cada diagrama, então use um nome que seja significativo.

imagem novo serviçoImage Added

Há a possibilidade de fazer, como citado, o cadastro usando a autenticação via token. Neste caso, podemos cadastrar somente o domínio sem autenticação:

imagem domínioImage Added

Ou ainda, podemos cadastrar o domínio e selecionar a autenticação “custom” custominformando “apiKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”

imagem domínioImage Added

Chamando o serviço

...

Cadastrando um aplicativo para comunicação com o fluig

...

No TOTVS IPaaS, acesse Aplicativos e em seguida Cadastrar aplicativo:

imagem totvs connectorImage Added


Preencha os dados:

imagem totvs connectorImage Added


Ao concluir o cadastro, você será redirecionado novamente para a tela de listagem de aplicativos. 

...

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 SOAP.

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 SOAP.

imagem ipaas

Image Added


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:

imagem ipaasImage Added


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

...

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. 

imagem ipaasImage Added

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. 

Após preenchido as informações clique em Cadastrar.  

Image Addedimagem ipaas

Cada serviço do fluig tem um Base URL próprio, e pode ser consultado na página da própria API:

imagem api fluigImage Added

Nesta página também está o arquivo “swagger.json” que iremos usar para importar os recursos. No TOTVS IPaaS, 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 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:

Image Added

Logo após, clique em Concluir.imagem ipaas

Adicionando uma conta OAUTH a API

...

Após o cadastro, acesse na tela do aplicativo a parte de Contas e clique em Cadastrar Conta.

imagem ipaasImage Added

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.

Image Added

Logo após, clique em Concluir.imagem ipaas

Criando um projeto e realizando a integração com o fluig

...