...

Objetivo

Objetivo da rotina, como se integra com as demais rotinas do sistema, considerações gerais do programa permitindo ao cliente obter uma visão de como e quando deve ser utilizadaPara os usuários que possuem algum aplicativo customizado, e que precisam de informações do cadastro de motivo de ocorrência do produto Gestão de Frete Embarcador (SIGAGFE), foi disponibilizado o método Web Service REST.

Serviços Disponíveis 

Âncora
principaiscampos principaiscampos

Conteúdos Relaciona

Informe os links de acessos para o conteúdo de outros documentos e/ou endereços (Fluig ou vídeos no YouTube) que estão relacionados com a rotina mencionada nesta página.

Conteúdos Relacionados

...

Exemplos de Utilização

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

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

Utilizando Postman

Abaixo uma tela utilizando a extensão Postman, executando a consulta de dados, utilizando dois parâmetros no método GET. Neste exemplo são listados os dados da tabela GU6.

Image Added

Image Added

Utilizando 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/GFEA031?COUNT=3'.
/* 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:setRequestHeader("tenantId", "T1,D MG 01 ").
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.

Image Added

.

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=185748193 é 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 é possível encontrar toda a documentação da API RESTFull do Protheus e como utilizá-la..