Passo 4: Configurando appserver e properties

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.

Na parte superior preencha:

• Porta REST → informe a porta rest da seção HTTPREST.
• Endereço completo do servidor REST → informe o endereço que utiliza para acessar o REST no browser, inclusive com http://.
• MeuRH Console Log Habilitado → caso deseje controlar a geração de mensagens no console.log.

Na parte inferior de Hosts do MeuRH, preencha:

• Nome do host → poderá ser um endereço local em sua rede corporativa, 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 + porta HTTP.
• Host habilitado → marque essa opção.
• Caminhos dos arquivos cliente (PATH) → diretório onde foram extraídos os aquivos baixados no primeiro passo.
• Página principal do host → index.html

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 + porta HTTP.

Configurando o arquivo properties.json

Nessa etapa precisamos complementar o seu arquivo appserver.ini com as configurações relativas ao serviço MeuRH, criando uma [seção] auxiliar que será utilizada para o redirecionamento dos arquivos client.

O endereço poderá ser para utilização na rede local ou 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, com essa esse endereço não é possível acessar de outro dispositivo, como exemplo vamos utilizar 11.222.33.44.

A porta de exemplo "8081" corresponde a sua chave Port configurada na seção HTTP que já deverá existir no seu appserver.ini.

Sendo assim, ficaria dessa forma:

Agora criaremos mais essa seção abaixo no arquivo appserver.ini, a seção RESTCONFIG onde são criadas chaves utilizadas para o Meu RH:

• restPort → deve ser preenchida com a mesma porta utilizada na seção HTTPREST dentro da chave Port no nosso caso o nosso REST foi iniciado na porta 8103.
• 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. 

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

Tag rootContext

Essa tag deve ser configurada com o valor do sufixo da URL do rest, apenas quando configurar uma URL diferente para cada empresa, acesse o exemplo: Configuração para mais de um grupo de empresa, no exemplo será vazio.

Abaixo exemplo do arquivo "properties.json" padrão, que se encontra na raiz dos arquivos cliente da pasta web: