Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Image Added

Instalação

...

Image Removed

Aviso
titleImportante

A instalação depende da atualização dos pacotes descritos

Localizar 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:

e Configuração Protheus

Pré-Requisitos

  • Protheus Release 12.1.17 ou superior
    • Lib com data igual ou superior a 31/01/2019
    • Binário com data igual ou superior a 14/01/2019
    • RHNP05.PRW com data igual ou superior a 01/03/2019
  • Possuir arquivos atualizados do portal
  • Para o correto funcionamento do MeuRH é necessário que a base esteja atualizada, pois diversas funções da tecnologia e framework Protheus são utilizadas: Clique aqui

...

  • Para utilizar o aplicativo MeuRH é necessário possuir o mesmo padrão de licenciamento do Portal RH, caso ainda não possua esse tipo de licenciamento, entre em contato com o seu ESN (Executivo de Soluções de Negócio) para aquisição e maiores informações

...

  • .

Como instalar

Page Tree
root0.2.1 Instalação

Configurações

Page Tree
root0.2.2 Informações Complementares

...

Abaixo seguem os detalhes e as instruções para a instalação do "Meu RH" na linha de produto TOTVS Protheus.

 Requisitos: 

  • Protheus Release 12.1.17 ou superior;
  • Possuir usuários configurados para acesso ao portal;
  • Para acesso via aplicativo "Meu RH”:    
    • Android 5.0 ou superior 
    • iOS 9.0 ou superior

 Informações relacionadas: 

 

...

titleinstalação e habilitação

...

iddeck principal

...

labelpasso 1

...

Foi baixado o arquivo: 18-03-06-ARQUIVOS_PORTAL_MEURH_12.1.17.ZIP

 

  • Após baixar os arquivos e descompactar, será obtida a seguinte estrutura de arquivos: 

Image Removed 

  • Dentro desse arquivo compactado encontramos a pasta "PortalRHUnificado", contendo os WebFiles utilizados no app MeuRH, essa pasta pode ser descompactada e os arquivos remanejados para qualquer diretório dentro do seu ambiente Protheus, preferencial pode ser colocado dentro do ProtheusData na pasta "WEB".
  • O caminho criado será posteriormente utilizado dentro do seu appserver.ini.

...

  • Durante o processo de configuração do Portal Padrão do RH GCH (Gestão do Capital Humano) foi necessário realizar a associação de um usuário do portal ao cadastro do participante, como demonstrado no campo da imagem abaixo. Todavia, é importante realizar uma verificação complementar para a utilização do aplicativo móvel MeuRH.

...

  • No cadastro do "Usuário do portal" que foi associado ao cadastro do participante, existe um campo denominado "Usuário int.".
    Caso ainda não tenha sido feito nenhum relacionamento/preenchimento desse campo com o cadastro de usuário(responsável em realizar o login no smartclient), será necessário atualizar esse cadastro e criar esse relacionamento com um usuário.
    É fundamental a execução desse processo de relacionamento, pois o aplicativo MeuRH utiliza esse usuário do Protheus para a geração do token de autenticação e permissão de acesso aos serviços rest.

Image Removed

  • Imagem abaixo do cadastro de usuários do protheus.

Image Removed

...

labelpasso 2

Configurando serviço REST

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 no padrão soap do portal tradicional. A 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:8081/T1]
ENABLE=1
PATH=C:\TOTVS\Protheus\Protheus_Data\Web\PortalRHUnificado
ENVIRONMENT=MeuEnv12117
INSTANCENAME=MeuRHT1
DEFAULTPAGE=index.html

...

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:

...

labelpasso 3

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:

...

Essa tag deve ser configurada com o endereço do REST criado no seu ambiente.
exemplo: "http://127.0.0.1:9103/restT1" ,onde:

  • 127.0.0.1 = Endereço/ip do seu servidor protheus
  • 9103 = 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"

...

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]
Informações
titleImportante

Atente-se na atualização desse arquivo, atualizações realizadas incorretamente, podem ocasionar problemas no carregamento do aplicativo após o processo de autenticação.

...

labelpasso 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”

 Image Removed

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 em sua empresa. 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 no momento de definição da URL de acesso, pois caso existam erros no preenchimento pode ocorrer no aplicativo realizar o login, mas em seguida ficar com uma tela em branco, interrompendo o processo de carregamento.

também 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".

...

  Image Removed 

3 - Ao realizar o processo de login dentro do aplicativo MeuRH, é possível acompanhar as autenticações dentro do console do servidor, ou mesmo, em seu arquivo de log (exemplo: "console.log")

...