Tempo aproximado para leitura: 00:03:00 min
Dúvida
Como configurar a URL para envio dos resultados da apuração do Ahgora para o Sistema RM?
Ambiente
TOTVS RH - TOTVS RH (Linha RM) - TOTVS Folha de Pagamento - A partir da versão 12.1.2402
Solução
Para que o Ahgora consiga enviar os resultados da apuração de ponto ao Sistema RM, é necessário realizar as seguintes configurações no ambiente:
1. Configuração do DefaultDB;
Para inclusão da tag DefaultDB acesse a máquina ou servidor que está executando o seu RM Host.
Vá ao diretório C:\totvs\CorporeRM\RM.Net e edite os arquivos RM.Host.exe.config e RM.Host.Service.exe.config. Inclua a tag <add key="DefaultDB" value="CorporeRM" /> em ambos os arquivos dentro da limitação appSettings.
O valor a ser atribuído a tag DefaultDB deve ser idêntica ao nome do alias que aponta para a base de dados utilizada. No nosso exemplo que citamos atribuímos o valor "CorporeRM" ao alias e respectivamente ao DefaultDB. Exemplo:
| RM.Host.exe.config | RM.Host.Service.exe.config |
| <?xml version="1.0"?> <configuration> <appSettings> <add key="JobServer3Camadas" value="false" /> <add key="Port" value="8050" /> <add key="ActionsPath" value="C:\totvs\CorporeRM\RM.Net;C:\totvs\CorporeRM\Corpore.Net\Bin" /> <add key="EnableCompression" value="true" /> <add key="DefaultDB" value="CorporeRM" /> </appSettings> <runtime> <NetFx40_LegacySecurityPolicy enabled="true" /> </runtime> <system.runtime.remoting> <customErrors mode="Off" /> </system.runtime.remoting> <startup> <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0" /> </startup> </configuration> |
<?xml version="1.0"?> <configuration> <appSettings> <add key="JobServer3Camadas" value="false" /> <add key="Port" value="8050" /> <add key="ActionsPath" value="C:\totvs\CorporeRM\RM.Net;C:\totvs\CorporeRM\Corpore.Net\Bin" /> <add key="EnableCompression" value="true" /> <add key="DefaultDB" value="CorporeRM" /> </appSettings> <runtime> <NetFx40_LegacySecurityPolicy enabled="true" /> </runtime> <system.runtime.remoting> <customErrors mode="Off" /> </system.runtime.remoting> <startup> <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0" /> </startup> </configuration> |
2. Criação de usuário para integração:
Crie um usuário no Sistema RM que será utilizado exclusivamente para a autenticação da integração com o Ahgora. As credenciais (usuário e senha) deverão ser informadas na parametrização da integração no portal do Ahgora, vinculando a comunicação entre o Ahgora e o Sistema RM.
Esse usuário deverá ser vinculado em um perfil que possui as permissões [01.06] - Ahgora e [13] Desconsiderar filtro de produto em webservice, para conceder acesse o menu Serviços Globais | Segurança | Perfis, selecione o sistema Folha de pagamento, edite o perfil vinculado, vá em acesso a menus e permita estes acessos.
3. Configuração da URL:
Para que o Ahgora consiga enviar os resultados das apurações ao Sistema RM, é necessário criar uma URL que disponibilize a API do Sistema RM para acesso externo;
A URL é composta pelos seguintes elementos:
- Servidor: endereço do servidor onde o Sistema RM está instalado.
- ApiPort: porta configurada no RM.Host.ServiceManager.exe.
- Endpoint: /api/rh/v1/ahgora/results
Exemplo: http://servidor:ApiPort/api/rh/v1/ahgora/results
Importante: Caso o ambiente utilize HTTPS, a URL poderá ser publicada utilizando esse protocolo. A definição entre HTTP e HTTPS dependerá da infraestrutura adotada pelo cliente.
3.1 Para identificar a ApiPort (WebApi) utilizada na composição da URL, acesse o aplicativo RM.Host.ServiceManager.exe pelo caminho C:\totvs\CorporeRM\RM.Net
Exemplo: http://localhost:8051/api/rh/v1/ahgora/results
Após a publicação da URL, recomenda-se validar se ela está acessível externamente antes de realizar a configuração no Ahgora. Para verificar se as configurações estão corretas, informe a URL abaixo no browser (Internet Explorer, Mozilla Firefox, etc): http://servidor:porta/wspageindex/
Observação: A TOTVS disponibiliza os endpoints utilizados pela integração e orienta quanto à sua composição. Entretanto, a publicação da URL, configurações de rede, certificados digitais, firewall e demais aspectos relacionados à infraestrutura são de responsabilidade da equipe técnica do cliente.
4. Requisitos para comunicação com o Ahgora:
Caso o ambiente possua restrição de acesso por IP (Firewall/Whitelist), será necessário liberar os seguintes endereços utilizados pelo Ahgora para envio das apurações:
Saiba mais
Como Expor os Web Services do RM através do Host
Cross Segmentos - Backoffice RM - Integração - WebServices - Como Habilitar Webservice via RM Host
0 Comentários