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 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.
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. Caso haja alguma dúvida em relação a como criar um bloco do tipo servidor clique aqui. Nesse exemplo, utilizaremos um bloco para exibir uma notificação contendo a palavra "Olá".
Figura 1 - Bloco(servidor) utilizado no exemplo
Figura 1.2 - Opção de configurar bloco(servidor)
- Após criar o bloco servidor, clique no ícone mostrado na figura 1.2 para abrir as configurações do bloco.
Figura 1.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 1.4).
Figura 1.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 1.2).
Figura 2 - Configurações de segurança do bloco(servidor)
- Clique nos "..." indicados na figura 2 para abrir as configurações de segurança.
Figura 2.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 opção "Todos"(Permite que qualquer um possa inserir dados no serviço) e após isso clique em "Ok". Novamente, clique em "Ok" e por fim clique no botão "Salvar" para confirmar as alterações.