Passar para o conteúdo principal

Como substituir o endpoint da integração RM On-Premises pela URL do RM Cloud no Tóch

Objetivo Este artigo descreve, de forma clara e objetiva, o procedimento para substituir o endpoint (URL) do RM On-Premises pela nova URL do RM Cloud dentro do Tóch, utilizando integrações já existentes em fluxos ativos.

Wagner Chagas avatar
Escrito por Wagner Chagas
Atualizado há mais de uma semana

Público-alvo

Este procedimento é destinado a usuários do Tóch que possuem fluxos com integração ao RM TOTVS, especificamente aqueles que utilizam campos do tipo Conexão com Integração para consumo de dados do RM (On-Premises ou Cloud).

Não é recomendado para usuários que não possuam integrações ativas com o RM em seus fluxos.


Antes de começar

Antes de qualquer alteração, é fundamental garantir que o ponto de integração esteja corretamente identificado e funcionando.

Em poucas palavras:

  1. Escolha um fluxo que possua um campo do tipo Conexão com Integração;
    ​

  2. Confirme que, com a URL antiga (endpoint do RM On-Premises) configurada, o fluxo retorna corretamente os dados do RM;
    ​

  3. Somente após validar esse cenário inicial, prossiga com a alteração.

Passo a passo para substituição do endpoint

1. Identificar o campo de integração no fluxo

No fluxo selecionado:

  • Localize o campo do tipo "Conexão com Integração";

  • Anote exatamente o nome da integração vinculada a esse campo.

Exemplo fictício: "TOCH.29 - Tabela Opções"

Essa informação será utilizada no próximo passo.
​

2. Acessar o menu de Integrações

  1. No menu lateral esquerdo do Tóch, clique em Integrações;
    ​

  2. Na lista apresentada, localize a integração identificada anteriormente (ex.: TOCH.29 - Tabela Opções);

  3. Clique em Editar (ícone de lápis).


3. Substituir a URL do endpoint

Dentro da tela de edição da integração:

  1. Faça scroll até localizar o campo "Link";

  2. Substitua a URL antiga do RM On-Premises pela nova URL do RM Cloud:

URL antiga (RM On-Premises):

http://XXX.XXX.XX.XX:8051/

Nova URL (RM Cloud):
​

https://suainstanciaxxxxxx.rm.cloudtotvs.com.br:8051/

  1. Após a substituição, clique no botão "Atualizar Integração", localizado no canto inferior direito da tela.
    ​


    ​

Validação pós-alteração

Com a integração atualizada:

  1. Execute um teste no fluxo onde a integração é utilizada;

  2. Verifique se o retorno dos dados é exatamente o mesmo observado antes da alteração;

  3. Confirme que não há erros, lentidão ou inconsistências no comportamento do fluxo.

Essa etapa é essencial para garantir que o endpoint do RM Cloud está respondendo corretamente.


Rollback (retorno à URL antiga)

Após a validação e confirmação de que tudo está funcionando conforme esperado:

  • Realize o rollback da alteração, apontando novamente a integração para a URL antiga do RM On-Premises:

http://XXX.XXX.XX.XX:8051/

Esse retorno é importante para:

  • Evitar impactos não planejados;

  • Garantir que a alteração seja utilizada apenas para testes e validações controladas.

Alertas importantes

  • Atenção: Este procedimento deve ser utilizado exclusivamente para testes e validações controladas.

  • Não recomendado em produção: Evite realizar essa alteração diretamente em ambientes produtivos sem planejamento e acompanhamento.

  • Impacto em fluxos: Qualquer erro na URL pode causar falha imediata nos fluxos que utilizam a integração.


Considerações finais

  • Sempre valide o fluxo antes e depois da alteração;

  • Documente os resultados do teste para referência futura;

  • Em caso de dúvidas ou comportamento inesperado, acione o time responsável pelo Tóch ou RM (TOTVS).

Respondeu à sua pergunta?