...
Informando uma pasta do servidor com o caminho para os serviços Web, a porta do HTTP e , o ambiente a ser utilizado .
É importante selecionar também e a opção de "Protocolo habilitado" para permitir ao servidor responder as requisições que chegarem!marcada.
Como resultado dessa configuração, encontraremos as seguintes tags no arquivo "appserver.ini":
[HTTP] |
---|
2) Nessa fase vamos habilitar o serviço REST no server Protheus:
Escolha a opção REST do menu, em seguida o item HTTPV11, e clique no botão "editar configurações".Conforme imagem abaixo, devemos configurar o socket com a porta do REST.
É importante selecionar o item "habilitado" para permitir ao servidor responder as requisições que chegarem!
Também é importante, marcar o item "Autenticação", para que os acessos sejam validados, visto que por padrão todos os serviços REST da TOTVS são públicos.
Na parte inferior da imagem, devemos informar as configurações para a montagem da URL que estará disponível com a relação dos serviços a serem consumidos.
Sendo possível configurar uma URL diferente para cada empresa, nesse momento devemos sempre utilizar a palavra "/rest" seguido com o ID da sua empresa. Por exemplo, na montagem desse exemplo, a minha empresa é "T1", ou seja, meus dicionários são "SX2T10", "SX3T10", etc.
Informações |
---|
A utilização obrigatória da palavra "rest" na URL do REST é uma necessidade do app MeuRH, pois é utilizado internamente quando utilizado via aplicativo baixado da apple store ou google play instalado nos celulares. |
...
...
Na parte superior de Configuração de Sockets:
Na parte inferiro de Configuração de URIs, preencha:
Na parte inferior da imagem, devemos informar as configurações para a montagem da URL, sendo possível configurar uma URL diferente para cada empresa, acesse o exemplo: Configuração para mais de um grupo de empresa
...
Após clicar no botão de confirmação, deverá ser possível visualizar a terceira imagem final da sequencia desse item 2 de configuração!
Informações | ||
---|---|---|
| ||
É possível recomendado utilizar um servidor Protheus (AppServer) apenas com os serviços REST, sem a necessidade de configurar os outros jobs e webservices do padrão soap referente ao portal tradicional Gestão do Capital Humano. O aplicativo MeuRH utiliza somente serviços REST em sua utilização, sendo assim, permite a flexibilidade da criação de servidores separados, podendo, caso necessário, reinicializar um server sem prejudicar o outro! |
...
...
3) Nessa fase vamos criar um processo comum que criará um job para inicializar o serviço do REST criado anteriormente:
Como na imagem abaixo, devemos informar:
Abaixo a imagem do Job criado, após a confirmação no botão finalizar!
Como resultado dessa configuração, encontraremos as seguintes tags no arquivo "appserver.ini":
[HTTPV11] [HTTPREST] [HTTPENV] [ONSTART] |
---|
4) Após essas configurações do serviço REST, podemos iniciar o server, e identificar na imagem abaixo a inicialização dos serviços:
5) Para validar se o seu serviço REST está sendo carregado adequadamente, verifique se é possível realizar o carregamento dos serviços via browser:
...
Button | ||||||
---|---|---|---|---|---|---|
|
...