Nessa etapa do passo a passo os clientes que encontram-se na release 12.1.25, poderão utilizar a configuração via ApWebWizard, para as releases anteriores deverão realizar a configuração complementar manualmente.
A partir da release 12.1.25 o complemento da configuração para o app MeuRH poderá ser realizado também de dentro do APWebWizard, assim como foi realizada a configuração do serviço REST anteriormente. Ao acessar o Wizard você deverá identificar uma nova opção na árvore do menu chamada "App MeuRH".
Dentro dessa configuração já existem uma série de validações referentes aos serviços HTTP e REST que já devem estar previamente configurados, onde seu objetivo é eliminar possíveis divergências de informações durante o processo de configuração.
Iniciando a configuração será validado o endereço da URL do REST que será atualizada automaticamente no arquivo “properties.json” ao final da configuração, desde que a pasta dos arquivos cliente já exista no server, antes que essas configurações de host do MeuRH sejam finalizadas!
Abaixo informe os hosts existentes para o MeuRH, que serão responsáveis em realizar os acessos diretamente via browser e também farão parte da construção do QRCode para realizar os acessos via aplicativo.
o "nome do host" poderá ser um endereço local em sua rede corporativa, ou mesmo, um endereço IP externo de acesso, nesse caso não pode ser informado a palavra "http" no nome, apenas a raiz base e o complemento do contexto.
Nessa etapa também são realizadas uma série validações para evitar problemas futuros nos acessos.
Ao realizar a confirmação das configuração dos hosts para o App MeuRH , o arquivo "appserver.ini" será atualizado e o wizard tentará realizar a criação do novo arquivo “properties.json” para cada PATH informado, renomeando o arquivo já existente na pasta como backup.
Ao retornar será possível identificar visualmente na lista todos os hosts cadastrados para serem utilizados no App MeuRH.
Nessa etapa precisamos complementar o seu arquivo "appserver.ini" com as configurações relativas ao serviço MeuRH:
Nesse caso estamos criando uma '[sessão]' auxiliar do MeuRH que será utilizada para o redirecionamento dos arquivos client 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 "11.222.33.44" 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 de sua rede corporativa.
Lembre-se de não utilizar localhost ou 127.0.0.1 pois estes indicam "este computador", ou seja, quando você configura com localhost não é possível acessar de nenhum outro computador ou smartphone.
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:
- A URL do serviço REST configurado foi "/restT1", dividiremos essa URL em 2 partes:
- O prefixo "/rest"
- O sufixo "T1"
Nesse caso, o complemento do endereço raiz 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!
[11.222.33.44:8081/T1] |
|---|
Agora criaremos mais essa sessão abaixo no seu arquivo "appserver.ini", a sessão "RESTCONFIG" onde são criadas tags utilizadas para o app MeuRH Protheus:
-
- A tag "restPort" é obrigatória e deve ser preenchida com a mesma porta utilizada na sessão "HTTPREST" dentro da chave PORT, no nosso caso o nosso REST foi iniciado na porta 8103.
- 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] |
|---|
Configurando o arquivo "properties.json"
Para finalizar a configuração, vamos atualizar as informações desse arquivo, baseado nas configurações realizadas anteriormente.
Esse arquivo encontra-se no raiz da pasta de arquivos cliente do app MeuRH, no mesmo local do arquivo "index.html".
Essa pasta é declarada na chave "PATH", no exemplo acima sobre a declaração do aplicativo.
As tags que atualizaremos dentro de arquivo são: "baseUrl" e "rootContext":
Tag "baseUrl"
Essa tag deve ser configurada com o endereço do REST, onde no exemplo: "http://11.222.33.44:8103/restT1"
- 11.222.33.44 = Endereço/IP do seu servidor protheus
- 8103 = A porta do REST (restPort) configurada no seu appserver.ini na seção [RESTCONFIG]
- /restT1 = essa informação foi declarada no item URL de REST, em seu "appserver.ini"
Tag "rootContext"
Essa tag deve ser configurada com o valor do sufixo da URL do rest:
-
- Seguindo o exemplo "http://11.222.33.44:8103/restT1" o contexto será /T1/.
Abaixo exemplo do arquivo "properties.json" padrão, que se encontra na raiz dos arquivos cliente da pasta web:
{
"ERP": 3,
"PROPS":
{
"baseUrl": "http://11.222.33.44:8103/restT1",
"rootContext": "/T1/"
}
}
Atente-se na atualização do arquivo "properties.json", quando realizadas incorretamente, causam problemas no carregamento do aplicativo.
A baseUrl padrão e o rootContext devem estar configurados de acordo com seu ambiente.
- Passo 1: Atualizando os arquivos cliente do MeuRH
- Passo 2: Associando o usuário do Portal Gestão do Capital Humano
- Passo 3: Configurando o serviço REST via APWebWizard
- Passo 5: Acessando o App MeuRH
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas