Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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.

Image AddedImage Removed

Como resultado dessa configuração, encontraremos as seguintes tags no arquivo "appserver.ini":

[HTTP]
ENABLE=1
PORT=8081
PATH=C:\Protheus_12117_MeuRHP12117MNT\Protheus_Datadata\Web\PortalRHUnificadoPortalMeuRH
ENVIRONMENT=12.1.17P12117MNT


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.  

...

Image Removed

...

Na parte superior de Configuração de Sockets:

  • Marque a opção de "Habilitado".
  • Preencha o Nome, Porta e o item "Autenticação" deve estar marcado.

Na parte inferiro de Configuração de URIs, preencha:

  • Preencha o Nome → preferencialmente HTTPREST.
  • URL → obrigatório ter a expressão /rest.
  • Empresa/Filial para preparação de ambiente → caso utilize o mesmo rest para todas filial, coloque All,
  • Mínimo de Working Threads Ativas, Máximo de Working Threads Ativas, Mínimo de Working Threads Livres, Quantidade de Working Threads de Incremento (dependendo da quantidade de licenças de uso pode ser ajustado)
  • Habilitar Cors → deve estar marcado.
  • Allow Origin → preenchido com * (asterisco)
  • Endpoints publicos → deverá estar preenchido com as informações: fwjwt/refresh_token,auth 

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

Image Added

...

    • "Habilitar Cors" deve estar marcado, assim como "Allow Origin" preenchido com '*' (asterisco) para permitir que o server possa responder requisições de outros servidores.
    • "Endpoints publicos" deverá estar preenchido com as informações 'fwjwt/refresh_token,auth' , pois são os endpoints iniciais responsáveis pela autenticação e geração do token de acesso aos serviços.

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
titleDica interessante

É 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!

...

...

Image Removed


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:

    • Nome do Job
    • Ambiente
    • Função Advpl → informar
    • O nome para o JOB.
    • O ambiente relacionado para o serviço REST.
    • Informar o nome da função que inicializa o serviço, obrigatoriamente: "HTTP_START"
    • Marcar a opção "Habilitar job no start do servidor Protheus"

Image Removed

    • Protheus → marcar opção

Abaixo a imagem do Job criado, após a confirmação no botão finalizar!

Image RemovedImage Added


Como resultado dessa configuração, encontraremos as seguintes tags no arquivo "appserver.ini":

[HTTPV11]
Enable=1
Sockets=HTTPREST

[HTTPREST]
Port=8103
URIs=HTTPENV
SECURITY=1

[HTTPENV]
URL=/restT1rest
PrepareIn=T1All
Instances=1,2,5,1,1
ENVIRONMENT=12.1.17P12117MNT
CORSEnable=1
AllowOrigin=*
Public=fwjwt/refresh_token,auth

[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=12.1.17P12117MNT

[ONSTART]
jobs=HTTPJOB


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:

Image RemovedImage Added


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
Cor#00BFFF
TextoPróximo passo!
Linkhttphttps://tdn.totvs.com/display/NPR/0.2.4++Passo+4x/RMmmHQ


Demais passos da configuração:

...