Instalação

...

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

Configurações

...

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: 

• Configuração do REST do Protheus
•  Instalar e configurar o Portal Gestão do Capital Humano
• Configuração de servidores HTTPs/SSL
• Configuração de broker no servidor de aplicação
• Configuração de balanceamento de carga com broker

...

...

...

...

• Após o download dos arquivos cliente da Central de Downloads no link: https://suporte.totvs.com/portal/p/10098/download?e=662850   

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 (tabela RD0), como demonstrado no campo da imagem abaixo. Todavia, é importante realizar um relacionamento complementar para a utilização do aplicativo móvel MeuRH.

...

Image Removed

• Exemplo abaixo do cadastro de usuários do protheus (SIGATCF/Miscelanea/Usuários) utilizado no relacionado com o usuário do portal. .

Image Removed

...

Configurando o serviço REST via APWebWizard

O APWebWizard é responsável por fazer as atualizações no seu arquivo "appserver.ini" de acordo com sua necessidade para a criação dos serviços.
Para iniciarmos, conforme imagem abaixo, realize a chamada via smartclient para o seu ambiente desejado:

Image Removed

1) Inicialmente, caso ainda não possua um serviço HTTP, precisaremos cria-lo, como no exemplo da imagem abaixo:

Informando uma pasta do servidor com o caminho para os serviços Web, a porta do HTTP e o ambiente a ser utilizado.
É importante selecionar também "Protocolo habilitado" para permitir ao servidor responder as requisições que chegarem!

Image Removed

2) Nessa fase vamos habilitar o serviço REST no server Protheus:

Escolha a opção REST do menu, em seguida o item HTTPV11, e clique no botão "editar configurações".
Conforme imagem abaixo, devemos configurar o socket com a porta do REST.

É importante selecionar o item "habilitado" para permitir ao servidor responder as requisições que chegarem!
Também é importante, marcar o item "Autenticação", para que os acessos sejam validados, visto que por padrão todos os serviços REST da TOTVS são públicos.

Na parte inferior da imagem, devemos informar as configurações para a montagem da URL que estará disponível com a relação dos serviços a serem consumidos.
Sendo possível configurar uma URL diferente para cada empresa, nesse caso sugerimos utilizar o nome da URL com o complemento da empresa para apoiar na identificação. No exemplo da imagem, como nossa empresa de teste é T1, o novo da URL seria "/restT1"

Na segunda imagem desse item 2, podemos configurar as informações sobre o certificado SSL, lembrando que para esse caso também deverá ser configurado um server HTTPs para que possa responder das solicitações REST em SSL. Continuando nessa segunda imagem, devemos informar outros parâmetros:

• • "Habilitar Cors" deve estar marcado, assim como "Allow Origin" preenchido com '*' (asterisco) para permitir que o server possa responder requisições de outros servidores.
  • "Endpoints publicos" deverá estar preenchido com as informações 'fwjwt/refresh_token,auth' , pois são os endpoints iniciais responsáveis pela autenticação e geração do token de acesso aos serviços.

Após a confirmação dessas configurações, deverá estar visualizando a terceira imagem final da sequencia desse item 2 de configuração!

...

Image Removed

Image Removed

Image Removed

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:

...

[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

[RESTCONFIG]
restPort=9103
RefreshTokenTimeout=300
meurhLog=1

...

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 "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.

...

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]

...

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”

• • • Google Play: https://play.google.com/store/apps/details?id=com.totvs.hr.mobile&hl=pt_BR
    • Apple Store: https://itunes.apple.com/br/app/totvs-meu-rh/id1263940937

 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 (diferenciação entre letras minusculas e maiúsculas) no momento de definição da URL de acesso, pois caso existam erros no preenchimento podem ocorrer no aplicativo realizar o login. Como por exemplo, escrever erradamente "Restport" ou deixar de colocar o ponto de interrogação na URL.

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")

• • Essas mensagens poderão auxiliar caso esteja tendo problemas no processo de autenticação.
  • Caso as mensagens não estejam aparecendo no servidor, 3 situações necessitam serem revistas:
    • confirmar se o patch referente ao MeuRH, informado na inicio desse documento, encontra-se aplicado em seu RPO.
    • confirmar as informações utilizada para a geração do QRCode, caso não esteja aparecendo nenhuma informação no console do servidor, a sua requisição de login nem chegou ao server para validação, pois deverá estar apontando para um endereço errado.
    • caso esteja tentando realizar o login, fora da sua rede corporativa, é importante confirmar com o seu time de infraestrutura se o endereço configurado no QRCode está habilitado para receber conexões remotos da internet e não apenas configurado para acesso interno.

https://suporte.totvs.com/portal/p/10098/download?e=715593