title | instalação e habilitação1) | deck | | Card |
|---|
| label | Parte 1 - Wizard | Configurando 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. 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.
 Image Added
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
 Image Added
Abaixo temos exemplos de configurações de hosts existentes para o MeuRH, estes 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 será necessário informar a palavra "HTTP://" no nome, apenas a raiz base e o complemento do contexto + porta HTTP.  Image Added
Após finalizar essa configuração, encontraremos as seguintes tags no arquivo "appserver.ini": [localhost:9293/T1]
ENABLE=1
PATH=C:\P12BASES\P12127SISTDB\PROTHEUS_DATA_SIS\web\PortalMeuRH
DEFAULTPAGE=index.html [10.173.7.142:9293 |
|---|
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: - Caso necessário esse bloco poderá ser criado com o auxilio da ferramenta ApWebWizard do time de framework para a criação de ambientes:Utilizando ApWebWizard
- Uma dica interessante:
- É possível utilizar um servidor Protheus (AppServer) com os serviços rest, sem a necessidade de configurar os outros jobs e webservices do padrão soap referente ao portal tradicional Gestão do Capital Humano. O aplicativo MeuRH utiliza somente serviços REST em sua utilização, sendo assim, permite a flexibilidade da criação de servidores separados, podendo reinicializar um sem prejudicar o outro!
| [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:8081TOTVSProtheusProtheusDataWebPortalRHUnificadoENVIRONMENT=MeuEnv12117INSTANCENAME=MeuRHT1PortalMeuRh
DEFAULTPAGE=index.html [RESTCONFIG]
restPort= |
|---|
9103RefreshTokenTimeout300meurhLog=1 Nesse caso estamos criando uma sessão que será utilizada para o redirecionamento dos arquivos clientes do MeuRH 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 "127.0.0.1" 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 da rede corporativa.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: - A tag "restPort" é obrigatória e deve ser preenchida com a mesma porta utilizada na sessão "HTTPREST" dentro da chave PORT, exemplo: "PORT=9103".
- A tag "RefreshTokenTimeout" é responsável por definir o tempo em que um acesso/token de autenticação será válido, caso não seja informado essa tag, o seu valor default é 600 (correspondendo a 10 minutos).
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.
| Card |
|---|
| label | Parte 2 - Configurando manualmente |
|---|
| HostsRest=http://localhost:9191/restT1,localhost:9293,10.173.7.142:9293 |
|---|
| Nota |
|---|
| Ela é criada exclusivamente para utilização da arquitetura do App MeuRH: - A palavra 'restPort' é utilizada pelos serviços de backend por isso a obrigatoriedade do seu preenchimento, sendo assim, apesar do protheus em seu appserver permitir que se possa instanciar várias portas REST, em virtude da arquitetura do meurh esse contexto não é permitido.
- Em relação a palavra 'MeuRHLog' ela auxilia no processo de login e manutenção para identificar possíveis dificuldades no processo de configuração e divergências de login, posteriormente, também pode ser desligada utilizando o valor '0' para melhorar a performance de resposta do aplicativo.
- Em relação a palavra 'HostsRest', as configurações automáticas do Wizard carregam esta informação replicando os hosts que poderão ser acessados.
|
| Card |
|---|
| Configurando o arquivo properties.json Para finalizar a configuração, vamos atualizar as informações desse arquivo, baseado nas configurações realizadas anteriormente. O arquivo properties_exemplo.json encontra-se na |
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:no mesmo local do arquivo index.html. Após localizar o arquivo properties_exemplo.json, renomear para properties.json .  Image Added
As tags que atualizaremos
|
As tags utilizadas "" ""tag ""Essa tag deve ser configurada com o endereço do REST |
criado no seu ambiente.
exemplo: "1270019103127.0.0" ,onde:1 = Endereço/ip do seu servidor protheus9103 = A porta do REST (restPort) configurada no seu appserver.ini na tag [RESTCONFIG]restT1 = essa informação é localizada no seu appserver.ini no item URL, onde
é configurada o environment relacionado ao serviço REST
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"  Image Removed
tag "rootContext"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.- exemplo: "/MeuRH/" ,onde:
MeuRH = É o complemento da URL principal, onde está configurado a localização,
dentro do appserver.ini, por exemplo uma tag denominada: [127.0.0.1:8081/T1]
valor do sufixo da URL do rest, apenas quando configurar uma URL diferente para cada empresa.
Abaixo exemplo do arquivo "properties.json" padrão, que se encontra na raiz dos arquivos cliente da pasta web: {
"ERP": 3,
"PROPS":
{
"baseUrl": "http://10.173.7.142:9191/restT1",
"rootContext": "T1"
}
} |
|---|
| info| desse "", atualizações realizadas incorretamente, podem ocasionar problemas no carregamento do aplicativo após o processo de autenticação do usuário. |
|
|
|
