Instalação
Importante
A instalação depende da atualização de um patch do Frame Protheus (última atualização 23/02/2018).
Então, deve-se baixar e aplicar o patch mais recente do frame de acordo com seu ambiente no link abaixo:
Importante também atualizar o último pacote acumulado de atualizações dos serviços para o app MeuRH;
Geral
Abaixo seguem 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
- Acesso à internet
Informações relacionadas:
instalação e utilização
Atualizando os arquivos Client MeuRH
Acesse a Central de Downloads no link: https://suporte.totvs.com/portal/p/10098/download?e=662850
Baixe 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:
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.
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 "appserver.ini" do seu ambiente.
- Primeiramente deve ser criado uma sessão para informar a URL de acesso para a empresa desejada:
[127.0.0.1:8081/T1] |
|---|
Nesse caso estamos criando uma sessão que será utilizada para o redirecionamento dos arquvios 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.
- Em seguida, deve ser criado uma sessão para informar os dados de ambiente acesso para a empresa desejada:
[HTTPENV1] |
|---|
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":
- Deve ser criado uma sessão abaixo para informar os dados de acesso para a empresa desejada:
[HTTPV11] [HTTPREST] [HTTPJOB] [RESTCONFIG] |
|---|
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
A sessão "RESTCONFIG" é de extrema importância para o projeto MeuRH Protheus:
- Na tag "userId" é preciso incluir um usuário do PROTHEUS, que não seja o ADMIN, cadastrado no módulo configurador, para autenticação e segurança dos serviços, no caso utilizamos um usuário exemplo chamado "UserRH".
- Atenção ao case sensitive na colocação do nome do usuário, pois no caso de erro no preenchimento o ambiente não será inicializado corretamente.
- Na tag "restPort" deve ser colocado a porta utilizada na sessão "HTTPREST" dentro da chave "PORT=9103".
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:
As tags utilizadas dentro de arquivo são: "baseUrl" e "rootContext"
| tag "baseUrl" |
|---|
|
Essa tag deve ser configurada com o endereço do REST criado no seu ambiente.
Para realizar uma validação, pode-se abrir esse endereço no browser, onde deverá ser carregado a
|
| tag "rootContext" |
|---|
Essa tag deve ser configurada com o endereço informado no seu "appserver.ini" que contém as
|
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”
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.
No nosso exemplo acima, poderia colar o seguinte texto:
"MeuRH - MeuEnv12117|MeuRH empresa T1|http://127.0.0.1:8081/T1/?restPort=9103"
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas