Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin
Aviso

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.

Painel
Deck of Cards
iddeck principal
Card
labelConfigurando pelo ApWebWizard


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


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.


Card
labelConfigurando manualmente


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]
ENABLE=1
PATH=C:\TOTVS\Protheus\Protheus_Data\Web\PortalRHUnificado
DEFAULTPAGE=index.html


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]
restPort=8103
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.

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:


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.


Button
Cor#00BFFF
TextoPróximo passo!
Linkhttp://tdn.totvs.com/display/NPR/0.2.5++Passo+5