Pular para o conteúdo principal

Exemplo de como disponibilizar serviço Web

No endereço: http://localhost:8037/webrun/webservices,existem alguns serviços disponíveis pelo Webrun:

image565.jpg

Para este exemplo, utilizaremos a porta WFRWebService e o método callRulle para ilustra nosso exemplo.

Ao lado da porta WFRWebService, existe um link que abrirá o WSDL.

Web Services Definition Language (WSDL) é uma linguagem baseada em XML utilizada para descrever Web Service. Trata-se de um documento escrito em XML que além de descrever o serviço, especifica como acessá-lo e quais as operações ou métodos disponíveis.

Dentro do WSDL, existem métodos que estão relacionados com a porta WFRWebService. Iremos utilizar o método callRule:

image715.gif

Serão utilizados cinco parâmetros:

  • 1º Parâmetro: Sigla do sistema;

  • 2º Parâmetro: Usuário;

  • 3º Parâmetro: Senha;

  • 4º Parâmetro: Nome do fluxo (Obs.: Fluxo com destino servidor e marcada como externo);

  • 5º Parâmetro: Lista de parâmetros para o fluxo.

Exemplo 1

Para este exemplo, iremos construir dois fluxos: um que terá acesso externo, ou seja, disponibilizará um serviço que poderá ser consumido posteriormente; e outro que chamará o serviço web disponibilizado pelo primeiro fluxo.

Siga os passos:

Primeiro Fluxo:

  • Nome: Web Service

image566.jpg

  • Parâmetro de entrada:

image567.jpg

  • Expressão:

image568.jpg

  • Parâmetro de retorno:

image569.jpg

Este fluxo requer dois parâmetros de entrada: o primeiro será do tipo Letras e o segundo do tipo Número, que servirá para indicar a posição inicial. Para o parâmetro de retorno, define-se a quantidade de caracteres que se deseja obter do nome passado pelo primeiro parâmetro.

Segundo Fluxo:

  • Nome: Chamar Serviço Web

image570.jpg

  • Expressão:

Observação: Todo conteúdo passado para a lista tem que ser do tipo Letra. Quando se for utilizar o serviço interno, Webrun.

Utilizaremos a função Chamar serviço web, que recebe quatro parâmetros:

  • 1º Parâmetro: URL do Web Service (sempre com http:// antes). Para o exemplo, utilizaremos:

http://localhost:8036/webrun/services/WFRWebService?wsdl

  • 2º Parâmetro: Porta. Para o exemplo, utilizaremos:

WFRWebService

  • 3º Parâmetro: Nome do Método. Para o exemplo, utilizaremos:

callRule

  • 4º Parâmetro: Variante - uma lista de parâmetros para o método callRule:

...


<wsdl:part name="system" type="xsd:string" />

<wsdl:part name="user" type="xsd:string" />

<wsdl:part name="password" type="xsd:string" />

<wsdl:part name="ruleName" type="xsd:string" />

<wsdl:part name="params" type="impl:ArrayOfString" />

... Para o primeiro parâmetro, passaremos a sigla do sistema; para o segundo, passaremos a identificação do usuário; para o terceiro, informaremos a senha; para o quarto, indicaremos o nome do fluxo (fluxo do tipo servidor e marcado como externo) e o quinto parâmetro é uma lista de parâmetros para o fluxo do parâmetro anterior.

Observação: Todos os conteúdos passados para a lista, deverão ser do tipo letras, caso seja o método callRule que receba um ArrayOfString.

Exemplo 2

Neste exemplo, demonstraremos como disponibilizar serviço web, utilizando o método callRuleWithoutParams que é bastante similar ao Exemplo 1, mas sem a utilização de parâmetros para o fluxo que será disponibilizado. O método callRuleWithoutParams recebe quatro parâmetros:

image716.gif

  • 1º Parâmetro: Sigla do sistema;

  • 2º Parâmetro: Usuário;

  • 3º Parâmetro: Senha;

  • 4º Parâmetro: Nome do fluxo (deve ser do tipo servidor e marcado como externo).

Para este exemplo, serão criados dois fluxos: um que terá acesso externo, ou seja, disponibilizará um serviço que poderá ser consumido posteriormente; e outro que chamará o serviço web disponibilizado pelo primeiro fluxo.

Primeiro fluxo:

  • Nome: Obter Data

image717.gif

Observação: ao contrário do Exemplo 1, este fluxo não exige Parâmetro de Entrada.

  • Expressão:

image718.gif

  • Retorno:

image571.jpg

Segundo fluxo:

  • Nome: Chamar Serviço Web

image1007.gif

  • Expressão:

image720.gif

Observação: Todo conteúdo passado para a lista tem que ser do tipo Letra, quando se for utilizar o serviço interno, Webrun.

Utilizaremos a função Chamar serviço web, que recebe quatro parâmetros:

  • 1º Parâmetro: URL do Web Service (sempre com http:// antes). Para o exemplo utilizaremos:

http://localhost:8080/webrun/services/WFRWebService?wsdl

  • 2º Parâmetro: Porta. Para o exemplo, utilizaremos:

WFRWebService

  • 3º Parâmetro: Nome do Método. Para o exemplo, utilizaremos:

callRuleWithoutParams

  • 4º Parâmetro: Variante - uma lista de parâmetros para o método callRule, que recebe quatro parâmetros:

...

...

  • 1º Parâmetro: Sigla do sistema;

  • 2º Parâmetro: Usuário;

  • 3º Parâmetro: Senha;

  • 4º Parâmetro: Nome da regra (fluxo do tipo servidor e marcado como externo).