Passo 3: Configurando REST

Configurando o serviço REST via APWebWizard  

O APWebWizard é responsável por fazer as atualizações no seu arquivo "appserver.ini" de acordo com sua necessidade para a criação dos mais diversos serviços. Para iniciarmos, conforme imagem abaixo, realize a chamada via smartclient para o seu ambiente desejado:

1) Inicialmente, caso ainda não possua um serviço HTTP, precisaremos cria-lo, como no exemplo da imagem abaixo:

Informando uma pasta do servidor com o caminho para os serviços Web, a porta do HTTP, o ambiente a ser utilizado e a opção de "Protocolo habilitado" marcada.

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

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".

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

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 da função que inicializa o serviço, obrigatoriamente: HTTP_START
  • Habilitar job no start do servidor Protheus → marcar opção

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":

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:

Observe que utilizamos a porta 8103 do REST criada anteriormente, assim o nome da URL definida "/restT1".

Próximo passo!

Demais passos da configuração:

• Passo 1: Atualizando os arquivos cliente do MeuRH
• Passo 2: Associando o usuário do Portal Gestão do Capital Humano 
• Passo 4: Configurando o complemento do App MeuRH
• Passo 5: Acessando o App MeuRH