Configurando serviço REST
Após o primeiro passo deve-se realizar a configuração no appserver.ini realizando a definição dos serviços REST.
Os itens abaixo, devem ser incluídos/atualizados no seu arquivo atual "appserver.ini" do seu ambiente.
- Primeiramente deve ser criado uma sessão para informar a URL de acesso para a empresa desejada:
[127.0.0.1:8081/T1]
ENABLE=1
PATH=C:\TOTVS\Protheus\Protheus_Data\Web\PortalRHUnificado
ENVIRONMENT=MeuEnv12117
INSTANCENAME=MeuRHT1
DEFAULTPAGE=index.html |
|---|
Nesse caso estamos criando uma sessão que será utilizada para o redirecionamento dos arquvios clientes do MeuRH e realizando a configuração do ambiente utilizado. Você poderá ter uma URL para cada empresa separada dentro da sua estrutura.
O endereço de exemplo "127.0.0.1" poderá ser um endereço para utilização apenas na sua rede local interna ou um endereço para acesso externo, assim permitindo que o aplicativo funcione quando os colaboradores de sua empresa estivem conectado fora da rede corporativa. A Porta de exemplo "8081" corresponde a sua tag "Port" configurada na sessão "HTTP" que já deverá existir no seu "appserver.ini", a mesma utilizada para os portais atuais da Totvs, como o portal do RH Gestão do Capital Humano.
- Em seguida, deve ser criado uma sessão para informar os dados de ambiente acesso para a empresa desejada:
[HTTPENV1]
URL=/restT1
PrepareIn=T1
Instances=2,5
ENVIRONMENT=MeuEnv12117
CORSEnable=1
AllowOrigin=*
Public=fwjwt/refresh_token,auth |
|---|
A sessão "HTTPENV1" serve para configurar as questões de ambiente e a URL Rest para cada empresa. Deve ser criado uma sessão para cada empresa, por exemplo "HTTPENV2", "HTTPENV3", permitindo que possa ser configurado outras tags, como o "PrepareIn", responsável em configurar o environment sempre que o Rest receber uma requisição e necessitar criar uma thread para executar a solicitação. É importante a criação da tag URL para que o aplicativo consiga chegar adequadamente ao servidor, pois ela será utilizada quando for realizado a geração do QrCode. Nesse caso foi formada por: "/rest" concatenado com a empresa "T1":
- Deve ser criado uma sessão abaixo para informar os dados de acesso para a empresa desejada:
[HTTPV11]
Enable=1
Sockets=HTTPREST [HTTPREST]
Port=9103
URIs=HTTPENV1
SECURITY=1 [HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=MeuEnv12117 [RESTCONFIG]
userId=UserRH
restPort=9103
RefreshTokenTimeout=300 |
|---|
As sessões criadas acima são padrões para a configuração do serviço REST, e podem ser localizadas nas informações colocadas no link do inicio da página. Caso tenha configurado ambientes para várias empresas basta incluir as configurações na tag "URIs", exemplo: URIs=HTTPENV1,HTTPENV2 A sessão "RESTCONFIG" é de extrema importância para o projeto MeuRH Protheus: - Na tag "userId" é preciso incluir um usuário do PROTHEUS, que não seja o ADMIN, cadastrado no módulo configurador, para autenticação e segurança dos serviços, no caso utilizamos um usuário exemplo chamado "UserRH".
- Atenção ao case sensitive na colocação do nome do usuário, pois no caso de erro no preenchimento o ambiente não será inicializado corretamente.
- Na tag "restPort" deve ser colocado a porta utilizada na sessão "HTTPREST" dentro da chave "PORT=9103".
| 
