...
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 completo acumulado dos serviços para o App MeuRH: Última versão dos arquivos cliente disponibilizados no portal do cliente: Versão atualizada do binário/server:
|
...
...
Page Tree | ||
---|---|---|
|
Page Tree | ||
---|---|---|
|
...
Abaixo seguem os detalhes e as instruções para a instalação do "Meu RH" na linha de produto TOTVS Protheus.
Requisitos:
Informações relacionadas:
...
title | instalação e habilitação |
---|
...
id | deck principal |
---|
...
label | passo 1 |
---|
Atualizando os arquivos Client MeuRH
Foi baixado o arquivo: 18-03-06-ARQUIVOS_PORTAL_MEURH_12.1.17.ZIP
...
...
Informações | ||
---|---|---|
| ||
É importantíssimo que esse usuário relacionado NÃO possua perfil de administrador, devendo ser um usuário comum de acesso ao smartclient. Isso é uma restrição de segurança das funções de framework para a geração dos tokens de acesso. Como sugestão, pode-se criar um usuário especifico para ser utilizado nessa funcionalidade! |
...
label | passo 2 |
---|
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 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 e o ambiente a ser utilizado.
É importante selecionar também "Protocolo habilitado" para permitir ao servidor responder as requisições que chegarem!
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 segunda imagem desse item 2, podemos configurar as informações sobre o certificado SSL, lembrando que para esse caso também deverá ser configurado um server HTTPs para que possa responder das solicitações REST em SSL. Continuando nessa segunda imagem, devemos informar outros parâmetros:
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!
Uma dica interessante:
...
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]
Enable=1
Sockets=HTTPREST
[HTTPREST]
Port=8103
URIs=HTTPENV
SECURITY=1
...
[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:
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".
...
label | passo 3 |
---|
Configurando o serviço do aplicativo MeuRH
1) Nessa etapa precisamos complementar o seu arquivo "appserver.ini" com as configurações relativas ao serviço MeuRH:
...
A Porta de exemplo "8081" corresponde a sua tag "Port" configurada na sessão "HTTP" que já deverá existir no seu "appserver.ini".
Realizamos essa configuração no passo anterior dessa página!.
Como complemento do endereço raiz (IP + Porta HTTP), precisaremos informar um contexto. A origem desse contexto é o sufixo da URL do serviço REST definido no wizard observe abaixo:
Nesse caso, o complemento do endereço rais será "/T1".
Essa informação do contexto é importante para que o aplicativo consiga realizar a montagem correta da URL do serviço REST para a realização das solicitações ao servidor!
...
[127.0.0.1:8081/T1]
ENABLE=1
PATH=C:\TOTVS\Protheus\Protheus_Data\Web\PortalRHUnificado
ENVIRONMENT=MeuEnv12117
INSTANCENAME=MeuRHT1
DEFAULTPAGE=index.html
...
Na sessão "RESTCONFIG" são criadas tags utilizadas para o projeto MeuRH Protheus:
A tag "meurhLog" controla a geração de mensagens no "console.log" sobre o processo de autenticação/login do aplicativo MeuRH, apoiando em possíveis manutenções e acompanhamentos do processo. Por padrão, as mensagens sempre estarão sendo demonstradas no console, mesmo que a tag não exista no arquivo de inicialização "appserver.ini". Caso deseje que as mensagens não sejam mais demonstradas no console, basta declarar a tag "meurhLog=0", dentro da sessão "[RESTCONFIG]", para seja desabilitado.
...
[RESTCONFIG]
restPort=8103
RefreshTokenTimeout=300
meurhLog=1
Configurando o arquivo "properties.json"
Para finalizar a configuração, vamos atualizar as informações desse arquivo, baseado nas configurações realizadas anteriormente.
...
Essa tag deve ser configurada com o endereço do REST criado no seu ambiente e testado anteriormente através do carregamento da página no browser.
exemplo: "http://127.0.0.1:8103/restT1" ,onde:
...
Essa tag deve ser configurada com o valor do complemento do endereço, informado em seu "appserver.ini", que contém as configurações de localização dos arquivos cliente do aplicativo:
...
...
Informações | ||
---|---|---|
| ||
Atente-se na atualização desse arquivo "properties.json", atualizações realizadas incorretamente, |
...
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 gerado nos passos anteriores. 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 (diferenciação entre letras minusculas e maiúsculas) no momento de definição da URL de acesso, pois caso existam erros no preenchimento podem ocorrer no aplicativo realizar o login. Como por exemplo, escrever erradamente "Restport" ou deixar de colocar o ponto de interrogação na URL.
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", ou algum outro portal web para a geração do seu QRCode, como por exemplo: https://www.the-qrcode-generator.com/ , sempre utilizando a opção gerar como "texto livre".
Podemos gerar o QRCode também pela página padrão liberada pela Totvs juntamente com os arquivos cliente:
Abaixo, segue exemplo de geração do QRCode via outro portal web:
...