Configurar Portais e Webservices

O Portal Protheus disponibiliza serviços na Web para agilizar e facilitar o compartilhamento de informações entre seus clientes, fornecedores, parceiros, usuários internos e externos; toda a comunicação entre os servidores Web e os servidores Corporativos é efetuada através de Web Services.

Para habilitar os WebServices é necessário que o Serviço HTTP esteja ativo. Este serviço permite que as informações sejam publicadas na WEB.
Assim, a configuração inicia-se habilitando o serviço HTTP e configurando a porta aos quais todos os outros serviços dependentes deste irão utilizar para a publicação das informações.

Observação: Os serviços devem ser configurados pelo WIZARD (SRVWIZARD), pois a cada módulo WEB instalado são descompactados arquivos importantes no diretório informado na configuração. Estes arquivos são de extensão exclusiva da Microsiga, os *.MZP, e que apenas com o Wizard será possível a correta instalação.

#include "protheus.ch"

#define URL_BASE_SOAP "http://localhost:8080/ws/"

//-------------------------------------------------------------------
/*{Protheus.doc} soapBearer
Consumo de serviço SOAP do Protheus com autenticação bearer

WSINDEX.apw?cOp=02&WSVCNAME=FWAUTHENTICATION

@author Daniel Mendes
@since 07/10/2020
@version 1.0
*/
//-------------------------------------------------------------------
user function soapBearer()
local oWsdl as object
local oXml as object
local cSoapResponse as char
local cError as char
local cWarning as char

oWsdl := TWsdlManager():New()

//Geração do token
oWsdl:ParseURL(URL_BASE_SOAP + "FWAUTHENTICATION.apw?WSDL")
oWsdl:SetOperation("TOKEN")

oWsdl:SetValue(0, "password")
oWsdl:SetValue(3, "admin")
oWsdl:SetValue(4, "1")

oWsdl:SendSoapMsg()

cError := ""
cWarning := ""

cSoapResponse := oWsdl:GetSoapResponse()
oXml := XmlParser(cSoapResponse, "_", @cError, @cWarning )

FreeObj(oWsdl)
oWsdl := nil

//Atualização do token
oWsdl := TWsdlManager():New()

//Verifica o endereço, se existe algum serviço disponível e se existe o serviço que quero utilizar
oWsdl:ParseURL(URL_BASE_SOAP + "FWAUTHENTICATION.apw?WSDL")
oWsdl:SetOperation("TOKEN")

oWsdl:SetValue(0, "refresh_token")
oWsdl:SetValue(5, oXml:_SOAP_ENVELOPE:_SOAP_BODY:_TOKENRESPONSE:_TOKENRESULT:_REFRESH_TOKEN:Text)

oWsdl:SendSoapMsg()

FWFreeVar(@oXml)

cError := ""
cWarning := ""

cSoapResponse := oWsdl:GetSoapResponse()
oXml := XmlParser(cSoapResponse, "_", @cError, @cWarning )

FreeObj(oWsdl)
oWsdl := nil

//Consome um serviço autenticado
oWsdl := TWsdlManager():New()

oWsdl:ParseURL(URL_BASE_SOAP + "FWDICTIONARY.apw?WSDL")
oWsdl:SetOperation("GETTABLELIST")

oWsdl:AddHttpHeader("Authorization", "Bearer " + oXml:_SOAP_ENVELOPE:_SOAP_BODY:_TOKENRESPONSE:_TOKENRESULT:_ACCESS_TOKEN:Text)

oWsdl:SetValue(0, "SED")

oWsdl:SendSoapMsg()

ConOut("GetSoapResponse:", oWsdl:GetSoapResponse())

FreeObj(oWsdl)
oWsdl := nil

return

Para configurar, siga o procedimento abaixo:

- Após baixar e descompactar o arquivo, abra o Smartclient, e no Programa Inicial, digite: SRVWIZARD

 
 

- Clique 2 vezes em Servidor Internet (HTTP/FTP) para expandir, clique em HTTP, e verifique se a caixinha Protocolo Habilitado está marcada, e confirme a Porta de Conexão (recomendamos que seja diferente de 80, que é a porta padrão do HTTP, e é utilizada por serviços do Windows).

- Após a confirmação, clique em Módulos Web e então clique em Novo Módulo

- Em Módulo Web, selecione WS - Microsiga Protheus Web Services
- Em Nome da Instância digite ws
- O Diretório Raiz das imagens será preenchido automaticamente
- Em Selecione o Environment, clique e selecione o ambiente do Protheus que será utilizado
- Marque a caixinha Habilitar processos na Inicialização do Servidor, e clique em Avançar

- Na tela Configuração de Hosts X Empresas/Filiais, em Hosts, digite o endereço, porta e pasta da instância do Webservice, conforme exemplo: localhost:8079/ws (não digite o "http"). Caso o servidor não seja local, digite o IP do servidor.
- Em Selecione a Empresa/Filial, selecione a Empresa que estará vinculada a este Webservice, então clique em Relacionar. A ligação entre o Host e a Empresa será listada em Relacionamentos
- Clique em Avançar

- Na tela Configuração de usuários, em Mínimo Usuários e Máximo Usuários, que é a quantidade de threads que será aberta em execução (Mínimo) e a quantidade de threads que será aberta em espera (Máximo), digite as quantidades desejadas e clique em Finalizar

- Será exibida uma janela de confirmação da criação do Módulo Web. Clique em Sim

- Ao final será exibido um aviso solicitando a reinicialização do Protheus para que a configuração entre em vigor. Clique em Fechar
- Após configurar o Webservice, é necessário configurar o Portal. Clique novamente em Módulos Web e clique em Novo Módulo
- Em Módulo Web selecione PP - Portal Protheus
- Em Nome da Instância digite pp
- O Diretório Raiz das imagens será preenchido automaticamente
- Em Selecione o Environment, clique e selecione o ambiente do Protheus que será utilizado
- Marque a caixinha Habilitar processos na Inicialização do Servidor
- Em URL do Protheus Web Services, preencha o endereço que foi criado na etapa anterior para o Webservice. No nosso exemplo: http://localhost:8079/ws
- Clique em Avançar

- Na tela Configuração de Hosts X Empresas/Filiais, em Hosts, digite o endereço, porta e pasta da instância do Portal, conforme exemplo: localhost:8079/pp (não digite o "http"). Caso o servidor não seja local, digite o IP do servidor.
- Em Selecione a Empresa/Filial, selecione a Empresa que estará vinculada a este Portal (geralmente será exibida apenas uma opção Todas as Empresas e Filiais), então clique em Relacionar. A ligação entre o Host e a Empresa será listada em Relacionamentos
- Clique em Avançar

- Na tela Configuração de usuários, em Mínimo Usuários e Máximo Usuários, que é a quantidade de threads que será aberta em execução (Mínimo) e a quantidade de threads que será aberta em espera (Máximo), digite as quantidades desejadas e clique em Finalizar

- Será exibida uma janela de confirmação da criação do Módulo Web. Clique em Sim

- Ao final será exibido um aviso solicitando a reinicialização do Protheus para que a configuração entre em vigor. Clique em Fechar

- Após essa configuração, finalize o Totvs Wizard e reinicie o Protheus para que as alterações passem a vigorar. O arquivo appserver.ini será alterado com essas configurações, e a parte da configuração HTTP, WebService e Portal deve ficar semelhante ao exemplo abaixo:

[HTTP] 
ENABLE=1 
PORT=8079
PATH=C:\TOTVS 12\Microsiga\help-online
Environment=P12

[localhost:8079/ws]
ENABLE=1
PATH=C:\TOTVS 12\Microsiga\protheus_data\web\ws
ENVIRONMENT=P12
INSTANCENAME=ws
RESPONSEJOB=JOB_WS_01010101
DEFAULTPAGE=wsindex.apw

[JOB_WS_01010101]
TYPE=WEBEX
ENVIRONMENT=P12
INSTANCES=1,1
SIGAWEB=WS
INSTANCENAME=ws
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=01,010101

[ONSTART]
JOBS=JOB_WS_01010101,JOB_PP

[localhost:8079/pp]
ENABLE=1
PATH=C:\TOTVS 12\Microsiga\protheus_data\web\pp
ENVIRONMENT=P12
INSTANCENAME=pp
RESPONSEJOB=JOB_PP

[JOB_PP]
TYPE=WEBEX
ENVIRONMENT=P12
INSTANCES=1,1
SIGAWEB=PP
INSTANCENAME=pp
ONSTART=STARTWEBEX
ONCONNECT=CONNECTWEBEX
ONEXIT=FINISHWEBEX
WEBSERVICELOCATION=http://localhost:8079/ws

- Após reiniciar o Application Server, para testar se o serviço dos Webservices iniciou corretamente, abra o endereço do WebService no navegador (Internet Explorer, que é o navegador homologado para Portais e Webservices), conforme exemplo: http://localhost:8079/ws

Configuração de segurança para um Webservice SOAP:

A chave abaixo deve ser incluída na seção do JOB de requisições:

Observação

O HTTP do SOAP verifica existência do campo Authorization no HEADER da requisição, porém a autorização é realizada pelo framework do produto que está utilizando o protocolo.
Somente é permitida autenticação do tipo Basic no webservice SOAP do Protheus. 

Para facilitar o desenvolvimento e testes pode-se configurar a chave Security com valor 0 (zero) para desabilitar a autenticação

 
Exemplo

[JOB_WS]
TYPE=WEBEX
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
SECURITY=1