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.

Escrito por Wagner Chagas
Atualizado há mais de 2 meses

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?