WebServices com UniPaaS

Manoel Frederico da Silva / Product Manager & MAGIC Evangelist / Magic Software Brasil 

Neste post, veremos como consumir webServices em soluções UniPaaS.

O UniPaaS possui dois comandos para consumir (chamar) webServices via protocolo SOAP: Invoke WebSvc e Invoke WebSvc Lite. Haverá um capítulo da série “Eu vou Para o UniPaaS” que detalhará o comando “Invoke WebSvc”. Por isso, vamos nos ater agora ao “Invoke WebSvc Lite” apenas.

Inicialmente, é necessário possuir o WSDL do WebService. Pode ser em formato de arquivo, ou a própria URL dele.

Ao selecionar o comando Invoke WebSvc Lite, o assistente será exibido para que seja informado o WSDL do serviço web e selecionado qual método deste serviço deseja executar:

Uma vez que tenha sido escolhido o método (usa-se um comando Invoke WebSvc Lite separado para cada método desejado), um serviço do tipo SOAP LITE é registrado no UniPaaS, com o endereço do WebService:

Este modelo de vinculação permite que o endereço do serviço seja parametrizável externamente (via MAGIC.INI) sem necessidade de alteração no programa.

Este é o serviço UniPaaS que será associado ao comando:

As propriedades Soap Action, Style, Operation e NameSpace são preenchidas pelo assistente automaticamente e a rigor não devem ser alteradas. Estas outras propriedades tem as seguintes funções:

Return Value = Informar um campo UniPaaS para receber o valor de retorno da chamada ao WebService.

Successfully = Informar um campo lógico (boleano) do UniPaaS, que receberá TRUE se a chamada foi bem sucedida, ou FALSE caso contrário.

Fault = Informar um campo texto (string) do UniPaaS, que receberá a descrição do erro ocorrido, se a chamada falhar.

Caso o método chamado aceite argumentos (parâmetros) de entrada, deve-se fazer um ZOOM no item [arguments] e preencher as informações solicitadas:

NOTA: esta chamada será síncrona no contexto onde for executado.

O exemplo acima mostra o consumo de um WebService estilo RPC.

Quando o método escolhido for do estilo DOCUMENT:

Significa que o método terá no máximo um argumento, obrigatoriamente um XML, e retorno como resposta também um XML. Neste caso, o assistente UniPaaS cria na pasta “SoapClientModulesSOAPLITE” os esquemas (.xsd) que definem como são os xmls de argumento e de resposta:

Muitos são os casos em que é preciso (ou desejável) consumir um serviço web (WebService). Por exemplo, serviços web que permitem envio de SMS. Existem vários, em geral pagos, como este: http://www.human.com.br/tecnologia/sms

Mas existem também alguns gratuitos, como: http://www.naoligo.com.br/

O endereço deste WebService gratuito é:

Serviço: http://www.naoligo.com.br/ws/server.php

WSDL: http://www.naoligo.com.br/ws/server.php?wsdl

Acesse neste link um projeto exemplo (UniPaaS 1.9g ou UniPaaS JET) que permite enviar SMS através de serviço gratuito, usando o comando “Invoke WebSvc Lite”.

NOTA: Antes de abrir o projeto, é preciso registrar o serviço SOAP LITE (nome: Soap ServerSendSMS Service, endPoint: http://www.naoligo.com.br/ws/server.php) no UniPaaS Studio (menu: Options -> Settings -> Services), ou diretamente no arquivo MAGIC.INI:

[MAGIC_SERVICES]

Soap ServerSendSMS Service =  SOAP LITE,http://www.naoligo.com.br/ws/server.php,,

 

Diferenças Entre “Invoke WebSvc” e “Invoke WebSvc Lite”

Recursos disponíveis no “Invoke Web Svc” que não estão presentes no “Invoke Web Svc Lite”:

• Acesso a endereços HTTPS
• Certificados digitais do lado do cliente
• Anexos nas mensagens
• Padrão WS-I de transmissão segura