O SOAP (Simple Object Access Protocol) é um protocolo utilizado em trocas de informação entre sistemas, ou seja um formato padronizado para o envio de estruturas entre diferentes serviços. Esse padrão permite a comunicação entre plataformas totalmente diferentes, como por exemplo, C++, Java e Ruby sem muito trabalho. No Cronapp é possível utilizar esse serviço de forma low-code nos blocos de programação fazendo com que o bloco criado possa ser utilizado em outra aplicação de forma simples, além de agilizar ainda mais o desenvolvimento dos projetos.
Pré-requisitos
Antes de começar é necessário ter certeza de que se possui um ambiente preparado para a realização do exemplo. Abaixo estão os principais requisitos necessários.
Requisitos:
- Projeto do tipo web ou web-mobile criado. Caso haja dúvidas em relação a como criar esse tipo de projeto acesse o link (Criar novo projeto).
Visão Geral
Aqui veremos como ativar o serviço de SOAP nos blocos de programação, dessa forma disponibilizando o bloco para que possa ser utilizado em outra aplicação. No fim desse tutorial, será possível utilizar o bloco criado em outra aplicação cronapp e exibir o resultado retornado pelo bloco.
Figura 1 - Bloco(servidor) utilizado no exemplo
Passos
Ativando SOAP no bloco de programação
Para ativar esse serviço num bloco será necessário, primeiramente, criar um bloco do tipo servidor(Só é possível ativar essa funcionalidade em blocos servidor) . Caso haja alguma dúvida em relação a como criar um bloco do tipo servidor clique aqui. Nesse exemplo, utilizaremos um bloco para retornar o resultado de uma soma entre 2 números.
Figura 2 - Bloco(servidor) utilizado no exemplo
Figura 2.1 - Opção de configurar bloco(servidor)
- Após criar o bloco servidor, clique no ícone mostrado na figura 2.2 para abrir as configurações do bloco.
Figura 2.3 - Configurações do bloco(servidor)
- Em seguida, marque a opção "Disponibilizar como SOAP" para ativar o serviço no bloco e depois clique em "Salvar".
- Ao rodar o projeto, já é possível acessar o bloco disponível no serviço, para isso acesse o link https://<url da aplicação>/services/ para abrir a lista de serviços soap disponíveis (figura 2.4).
Figura 2.4 - Lista de serviços SOAP disponíveis
Opções de segurança
Assim como um WebService REST, as permissões de segurança afetam diretamente o serviço. Um WebService SOAP é trafegado via POST, logo a permissão "Permite Inserir" é a que deve ser usada para ele.
- Acesse novamente as configurações do bloco (figura 2.2).
Figura 3 - Configurações de segurança do bloco(servidor)
- Clique nos "..." indicados na figura 3 para abrir as configurações de segurança.
Figura 3.1 - Configurações de segurança do bloco(servidor)
- No passo 1, selecione os "..." da opção "Permitir Inserir". Isso abrirá a janela em que definiremos o tipo de permissão utilizada no evento inserir do serviço.
- No passo 2, selecione a permissão desejada para o seu bloco e após isso clique em "Ok". Novamente, clique em "Ok" e por fim clique no botão "Salvar" para confirmar as alterações.
Figura 3.2 - Bloco consumido em outra aplicação cronapp via SOAP
Aqui é possível verificar o bloco gerado nesse exemplo, disponível em outra aplicação cronapp por meio do serviço SOAP(Figura 3.2). Para aprender mais sobre o consumo de webservices soap dentro do cronapp, clique aqui.