PUBLICAÇÃO WEB SERVICE REST DOS MOTIVOS DO TIPO DE OCORRÊNCIA DE TRANSPORTE

Características do Requisito

Descrição

Para os clientes usuários que possuem algum aplicativo customizado, e que precisa precisam de informações dos motivos do Tipo de ocorrência do produto Gestão de Frete Embarcador Embarcador (SIGAGFE), foi  foi disponibilizado o método Web Service REST.

Para utilização, é necessário a atualização do produto e a configuração do Web Service REST, conforme descrito nos prepré-requisitos.

Método Publicado

Fonte	GFEA030
Nome do Serviço	GFEA030

Exemplo de

Utilização

Para realizar testes, pode ser utilizado qualquer programa de sua preferencia preferência, que teste API Web Service REST.

Como , como exemplos de programas, podemos citar o SoapUI ou a extensão Postman do Navegador Chrome. Ambos são excelentes aplicativos.

Utilizando o Postman

Abaixo uma tela utilizando a extensão Postman, executando a consulta de dados, utilizando dois parâmetros no método GET. Neste exemplo listou são listados os dados da tabela das tabelas GU4 e GU5 filtrado , filtrados por um tipo de ocorrência.

Utilizando o Progress Datasul

Código de exemplo

/* Variaveis da consulta ao webservice */
DEFINE VARIABLE http     AS COM-HANDLE.
DEFINE VARIABLE strURL   AS CHARACTER.
DEFINE VARIABLE strRET   AS CHARACTER.
DEFINE VARIABLE iNumEntries AS INTEGER NO-UNDO.
DEFINE VARIABLE iLoop AS INTEGER NO-UNDO.
assign  strURL  =   "http://localhost:8020/rest/fwmodel/GFEA030?FIRSTLEVEL=FALSE&FILTER=GU5_CDTIPO=" + "'99'" + "&FIELDVIRTUAL =TRUE".
/* Le a informação do Retorno */
CREATE "MSXML2.XMLHTTP.3.0" http NO-ERROR.
http:OPEN("GET", strURL, FALSE).
http:setRequestHeader("Translate", "f").
http:setRequestHeader("Depth", "0").
http:SEND() NO-ERROR.
/* Armazena o retorno */
strRET = http:responseText.
MESSAGE strRET
    VIEW-AS ALERT-BOX INFO BUTTONS OK.
/* Se tiver erro, retorna o erro */
if strRET begins "Houve erro" then do:
   /* Trata */
end.
else do:
   /* Trata o retorno */
end.

Resultado esperado.

Pré-requisitos para Utilização

• Atualização do Microsiga Protheus com versão igual ou superior a 12.1.17.
• Configuração do AppServer para disponibilizar as rotinas publicadas com o Web Service REST.
  • No link http://tdn.totvs.com.br/pages/viewpage.action?pageId=185747842 é possível encontrar todas as configurações necessárias.
• Documentação do Web Service REST
  • No link http://tdn.totvs.com.br/pages/viewpage.action?pageId=271671548 possui  é possível encontrar toda a documentação da API RESTFull do Protheus e como utilizá-la.