Meu RH

Atalhos

Árvore de páginas

Configuração para funcionalidade de 'Esqueceu a senha' no Meu RH

Produto:

Meu RH

Ocorrência:

O serviço permite que o usuário do Meu RH consiga solicitar a redefinição de senha sem estar logado.

Passo a passo:

  1. A recuperação de senha deve estar ativa no produto. 
    1. DATASUL: Esta opção é habilitada por meio da propriedade enable.recover.password. Para mais informações sobre a propriedade, acesse Documentação "datasul_framework.properties"
    2. DATASUL FOR THF: É habilitada nas Propriedades do Sistema. Para mais informações sobre a propriedade, acesse Segurança.
  2. Verifique se os parâmetros de e-mail estão configurados e funcionais. O processo de redefinição de senha faz o uso do método de envio definido no produto. 
    1. DATASUL: Para mais informações sobre os parâmetros, acesse Parâmetros Email Foundation (BTB962ZB)
    2. DATASUL FOR THF: Para mais informações sobre os parâmetros, acesse E-mail. 
  3. O usuário deve ter seu e-mail cadastrado em Manutenção de Usuário (SEC000AA). Na inclusão ou edição de um usuário, poderá ser inserido o e-mail através da aba 'Geral', no campo 'E-Mail Local'.
  4. Necessário cadastrar a URL padrão do ambiente local que será utilizada na montagem do e-mail enviado para o usuário que solicitou a redefinição da senha. No e-mail enviado, conterá um link que irá redirecionar o usuário para uma tela na qual o mesmo poderá redefinir sua senha. Para isso:
    1. Abra o Datasul 12, clique em "Configurações" no canto superior direito e depois em "Executar Programa"
    2. Após abrir o DATASUL Interactive, pressione a combinação de teclas Ctrl+Alt+x e na caixa de diálogo que abrir digite _edit.r
    3. Com o editor de código aberto, cole o conteúdo da Listagem 1 abaixo substituindo os campos <URL do seu ambiente> e <porta> conforme seu ambiente local e pressione a tecla F2 no teclado. Este processo irá cadastrar a URL que será utilizada para redirecionar o usuário para uma tela a qual será possível redefinir a senha
    4. Com o editor de código aberto também é possível verificar a URL cadastrada no seu ambiente. Para isso, basta colar o código da Listagem 2 abaixo e pressionar a tecla F2 do teclado
  5. Necessário cadastrar o template HTML padrão que será utilizado na montagem do e-mail enviado para o usuário que solicitou a redefinição da senha.
    1. Abra o Datasul 12, clique em "Configurações" no canto superior direito e depois em "Executar Programa"
    2. Após abrir o DATASUL Interactive, pressione a combinação de teclas Ctrl+Alt+x e na caixa de diálogo que abrir digite _edit.r
    3. Com o editor de código aberto, cole o conteúdo da Listagem 3 abaixo e pressione a tecla F2 no teclado. Este processo irá cadastrar o template de e-mail que será utilizado para montar o conteúdo do e-mail enviado ao usuário
    4. Com o editor de código aberto também é possível verificar o template de e-mail cadastrado no seu ambiente. Para isso, basta colar o código da Listagem 4 abaixo e pressionar a tecla F2 do teclado. Será exibido uma mensagem na tela do seu computador confirmando os dados cadastrados no sistema
    5. Obs. Para este processo é necessário confirmar que o arquivo "passwordResetTemplate.r" localizado em seu ambiente na estrutura rh/meurh/api/v1/ esteja presente.
  6. Ao executar o serviço com sucesso, o usuário receberá um e-mail contendo um link com o código de acesso para redefinição de senha.
    1. O código é anulado após o seu uso na redefinição de senha
    2. O código é válido por 10 minutos, após este tempo será considerado como inválido
  7. Verificar se o artefato está presente em seu ambiente conforme servidor de aplicação utilizado:
    1. DATASUL: Verificar se o artefato  totvs-login-12.1.XX-SNAPSHOT.war se encontra dentro do diretório da instância do servidor de aplicação, conforme abaixo:
      1. instance-8x80/deploy/datasul-byyou-12.1.XX-SNAPSHOT.ear
    2. DATASUL FOR THF: Verificar se o artefato totvs-login.war se encontra dentro do diretório webapps do Tomcat, conforme abaixo:
      1. instance-8x80\apache-tomcat-9.0.XX\webapps
  8. Demais informações técnicas, consultar Serviço de redefinição de senha#05.Comomodificarotemplatedoe-mail.
  9. Caso seja necessário configurar Proxy Reverso, seguir as documentações:
    1. DATASUL: https://centraldeatendimento.totvs.com/hc/pt-br/articles/234966387-DS-TEC-Como-configurar-Proxy-Reverso-para-os-Portais-Datasul
    2. DATASUL FOR THF: https://centraldeatendimento.totvs.com/hc/pt-br/articles/360046255573-DS-THF-Configura%C3%A7%C3%A3o-de-Proxy-Reverso-para-o-Datasul-for-THF-utilizando-Apache
Observações
  1. Esta funcionalidade está presente no produto a partir da release 12.1.29
Listagem 1. Código para cadastrar URL
DEFINE VARIABLE hProgram AS HANDLE NO-UNDO.
RUN sec/passwordReset/domain/PasswordReset.p PERSISTENT SET hProgram.
RUN piCreateUrl IN hProgram (INPUT "app_meurh_url", 
                             INPUT "http://<URL do seu ambiente>:<porta>/dts/portal-hcm/PortalMeuRH/#/resetPassword").
Listagem 2. Verificar URL cadastrada
FIND FIRST param_extens_ems NO-LOCK
     WHERE param_extens_ems.cod_chave_param_ems = "passwordReset"
       AND param_extens_ems.cod_entid_param_ems = "url_guid"
       AND param_extens_ems.cod_param_ems = "app_meurh_url" NO-ERROR.
IF AVAIL param_extens_ems THEN DO:
    MESSAGE param_extens_ems.dsl_param_ems
       SKIP param_extens_ems.cod_param_ems
    VIEW-AS ALERT-BOX INFORMATION BUTTONS OK.
END.
Listagem 3. Código para template HTML
DEFINE VARIABLE hProgram AS HANDLE NO-UNDO.
RUN sec/passwordReset/domain/PasswordReset.p PERSISTENT SET hProgram.
RUN piCreateTemplate IN hProgram (INPUT "app_meurh", 
                                  INPUT "rh/meurh/api/v1/passwordResetTemplate.r").
Listagem 4. Verificar template HTML cadastrado
FIND FIRST param_extens_ems NO-LOCK
     WHERE param_extens_ems.cod_chave_param_ems = "passwordReset"
     AND   param_extens_ems.cod_entid_param_ems = "html_email_template"
     AND   param_extens_ems.cod_param_ems       = "app_meurh" NO-ERROR.
IF AVAIL param_extens_ems THEN DO:
   MESSAGE  param_extens_ems.dsl_param_ems
       SKIP param_extens_ems.cod_param_ems
       VIEW-AS ALERT-BOX INFORMATION BUTTONS OK.   
END.