TOTVS RM

No NEXUS Flow o TOTVS RM é apenas mais um conector — você o usa lado a lado com APIs, banco e e-mail, dentro do mesmo fluxo. Todos os nós do RM usam uma credencial do RM.

RM — Consulta SQL

Executa uma sentença SQL cadastrada no seu RM e emite cada linha como um item. É a forma de ler dados do RM para o fluxo trabalhar. Você informa o código da sentença, a coligada, o sistema e os parâmetros.

Diferente do gatilho TOTVS RM (polling), que dispara o fluxo no intervalo, este nó consulta o RM no meio de um fluxo já iniciado.

Se a sentença devolve muitas linhas, marque Paginar resultados: informe o Parâmetro de página e o Parâmetro de limite que a sua sentença usa, o Tamanho da página e, se quiser, um teto em Máx. de páginas. O nó varre página a página até vir uma página vazia. A paginação precisa estar escrita na própria sentença do RM, usando esses dois parâmetros.

Em Quando não retornar linhas você escolhe o que acontece se a consulta vier vazia: Não emitir nada (para o ramo), o padrão, ou Passar o item de entrada adiante, quando a consulta é só um complemento e o fluxo deve continuar mesmo sem achar nada.

RM — DataServer (gravar)

Grava um registro no RM. O nó tem duas saídas — sucesso e erro — para você tratar cada caso: seguir o fluxo quando grava, e registrar/avisar quando falha.

RM — DataServer (ler)

Lê registros do RM. Escolha o Modo: Registro (por chave primária), para trazer um registro informando a chave (partes separadas por ;), ou View (por filtro), para trazer os registros que casam um filtro. O resultado vem no campo resultado do item, e o nó ramifica em sucesso e erro.

Como o conteúdo vem no formato que o DataServer devolve, use o Separar lista ou os placeholders para chegar aos campos que interessam.

RM — Processo

Executa um processo do RM. Como o DataServer, ramifica em sucesso e erro.

Quando o processo falha, o nó tenta anexar ao item de erro o log do Job do RM, para ajudar a entender o motivo. Isso depende de duas coisas: a mensagem de falha precisa informar o número do Job, e o seu RM precisa ter cadastrada a sentença indicada em Sentença de log (RM) (padrão LBHM.NEXUS.LOG), que lê o log dos jobs. Sem isso o item de erro traz apenas a mensagem do RM — desmarque Buscar log do Job em caso de erro se a sentença ainda não existir por aí.

RM — Gerar Relatório

Gera um relatório já cadastrado no seu RM e devolve o PDF anexado ao item, pronto para seguir para o nó de e-mail (no e-mail, aponte o mesmo nome em Anexos — propriedades binárias) ou para ser guardado.

Para não precisar montar filtros e parâmetros à mão, informe a coligada, o sistema e o código do relatório e use Trazer da última execução: o editor busca no RM a última geração daquele relatório e preenche o código, a coligada, os filtros, os parâmetros e o contexto. Revise e ajuste antes de gerar — é o que foi preenchido ali que vale na execução.

Você ainda define o Nome do arquivo de saída (padrão Report.pdf) e, para relatórios grandes, pode baixar em blocos. O nó ramifica em sucesso e erro.

RM — Valor Líquido

Calcula o valor líquido de um lançamento financeiro no RM, com juros e descontos, numa data. Informe a Coligada e o Lançamento; deixe Usar data atual marcado para calcular para hoje, ou desmarque e informe a data. O valor sai no campo valor do item, e o nó ramifica em sucesso e erro.

Padrão comum

Um fluxo típico com RM costuma ser:

Consulta SQL (ler)  →  lógica/decisão  →  DataServer/Processo (gravar)

Ou seja: ler dados do RM, decidir o que fazer com nós de lógica, e gravar de volta — com os caminhos de erro tratados explicitamente. Para reagir a dados que surgem no RM, comece pelo gatilho TOTVS RM (polling).