Aviso | ||
---|---|---|
| ||
A instalação depende da atualização dos pacotes descritosLocalizar e aplicar a última atualização da lib do Protheus, responsáveis pelos serviços rest e segurança: Atualizar o último pacote acumulado de atualizações dos serviços para o App MeuRH: Última versão dos arquivos cliente disponibilizados no portal do cliente: |
...
Abaixo seguem os detalhes e as instruções para a instalação do "Meu RH" na linha de produto TOTVS Protheus.
...
Informações relacionadas:
...
title | instalação e habilitação |
---|
...
id | deck principal |
---|
...
label | passo 1 |
---|
...
Após o download dos arquivos cliente da Central de Downloads no link: https://suporte.totvs.com/portal/p/10098/download?e=662850
Foi baixado o arquivo: 18-03-06-ARQUIVOS_PORTAL_MEURH_12.1.17.ZIP
Após baixar os arquivos e descompactar, será obtida a seguinte estrutura de arquivos:
Dentro desse arquivo compactado encontramos a pasta "PortalRHUnificado", contendo os WebFiles utilizados no app MeuRH, essa pasta pode ser descompactada e os arquivos remanejados para qualquer diretório dentro do seu ambiente Protheus, preferencial pode ser colocado dentro do ProtheusData na pasta "WEB".
O caminho criado será posteriormente utilizado dentro do seu appserver.ini.
...
Após o download dos arquivos cliente da Central de Downloads no link: https://suporte.totvs.com/portal/p/10098/download?e=662850
...
label | passo 2 |
---|
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 do seu ambiente.
1) Deve ser criado algumas seções para a configuração do serviço REST:
...
[HTTPV11]
Enable=1
Sockets=HTTPREST
[HTTPREST]
Port=9103
URIs=HTTPENV1
SECURITY=1
[HTTPENV1]
URL=/restT1
PrepareIn=T1
Instances=2,5
ENVIRONMENT=MeuEnv12117
CORSEnable=1
AllowOrigin=*
Public=fwjwt/refresh_token,auth
[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=MeuEnv12117
[ONSTART]
jobs=HTTPJOB
RefreshRate=120
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".
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
2) Em Seguida, criaremos a parte especifica para os serviços do aplicativo:
...
[127.0.0.1:8081/T1]
ENABLE=1
PATH=C:\TOTVS\Protheus\Protheus_Data\Web\PortalRHUnificado
ENVIRONMENT=MeuEnv12117
INSTANCENAME=MeuRHT1
DEFAULTPAGE=index.html
[RESTCONFIG]
restPort=9103
RefreshTokenTimeout=300
...
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.
Na sessão "RESTCONFIG" são criadas tags utilizadas para o projeto MeuRH Protheus:
...
label | passo 3 |
---|
Configurando o arquivo "properties.json"
Esse arquivo encontra-se no raiz da pasta de arquivos cliente do app MeuRH, o seu objetivo é permitir a configuração dos direcionamentos para o serviço REST. Segue abaixo como configurar as informações para um servidor Protheus:
...
Page Tree | ||
---|---|---|
|
Page Tree | ||
---|---|---|
|
Essa tag deve ser configurada com o endereço do REST criado no seu ambiente.
exemplo: "http://127.0.0.1:9103/restT1" ,onde:
Para realizar uma validação, pode-se abrir esse endereço no browser, onde deverá ser carregado a
api da Totvs referente aos serviços REST disponibilizado, caso não aconteça é necessário revisar as
configurações desse serviço no seu "appserver.ini"
...
Essa tag deve ser configurada com o endereço informado no seu "appserver.ini" que contém as
configurações de localização dos arquivos client.
Informações | ||
---|---|---|
| ||
Atente-se na atualização desse arquivo, atualizações realizadas incorretamente, podem ocasionar problemas no carregamento do aplicativo após o processo de autenticação. |
...
label | passo 4 |
---|
Acesso ao aplicativo MeuRH
Após as configurações do serviço e iniciar o seu servidor podemos realizar a verificação e login no aplicativo.
Para realizar o acesso pelo APP é necessário seguir os seguintes passos.
1 - Baixar o APP “Meu RH”
2 - Ao abrir o aplicativo pela primeira vez, será apresentada a tela para leitura do QRCode que é gerado de acordo com as configurações do ambiente em sua empresa. Nesse link encontrará informações necessárias para o QrCode: Geração QRCode acesso MeuRH - Linha RM (12.1.17)
cuidado com o case sensitive no momento de definição da URL de acesso, pois caso existam erros no preenchimento pode ocorrer no aplicativo realizar o login, mas em seguida ficar com uma tela em branco, interrompendo o processo de carregamento.
também poderá ser utilizada e executada a página "qrcodegenerator.htm" que se encontra disponível na raiz do pacote cliente do aplicativo, no mesmo lugar do arquivo "properties.json".
...
3 - Ao realizar o processo de login dentro do aplicativo MeuRH, é possível acompanhar as autenticações dentro do console do servidor, ou mesmo, em seu arquivo de log (exemplo: "console.log")
...