Como integrar Rubeus com TOTVS

🗒 Introdução

A aplicação de Integração TOTVS foi desenvolvida com o objetivo de melhorar a integração de informações relacionadas ao módulo Educacional, Financeiro e Processo Seletivo do TOTVS RM por meio de sentenças SQL desenvolvidas e cadastradas no TOTVS. Através dela, há mais facilidade para enviar dados ao mesmo tempo em que é possível agendar periodicamente a execução de sentenças.

🔗 Acesse todos os conteúdos relacionados a esse assunto, clicando AQUI!

Agora vamos entender um pouco sobre o funcionamento de cada componente e a sua função. Mas, antes de mais nada, você precisa saber que há algumas guias importantes, são elas: Sentenças, TBCs, Campos e Log.

1. Sentenças

Cadastramos as Sentenças SQL que foram criadas no TOTVS, para serem executadas, seja manualmente ou agendadas periodicamente.

Tela de cadastro de sentença

Configurações TOTVS

1.1) Sentença SQL

Nesse campo é informado o Código da Sentença cadastrada no TOTVS RM.

1.2) Sistema

É o código do sistema, onde a sentença foi cadastrada. Por exemplo, se for uma sentença no Educacional é o “S”, caso seja no Financeiro é o “F” e se for no sistema Global é o “G”.

1.3) Código da Coligada

É o Código da Coligada onde a sentença foi cadastrada.

1.4) Parâmetros TOTVS

Este campo se torna obrigatório caso a sentença tenha parâmetros a serem passados, mas, caso não tenha, ele é opcional.

1.5) Vincular TBC

Campo onde é selecionado o TBC, previamente cadastrado no app, para a execução da sentença.

Configurações Rubeus

1.6) Canal Rubeus integrado ao TOTVS

Canal da Plataforma Rubeus onde será integrado o TOTVS. O mesmo ficará como "origem" nos dados enviados à plataforma.

1.7) Ações do Rubeus

• Define para qual entidade do Rubeus os dados serão direcionados. Exemplo: Selecionado a opção "Contato", os dados irão para a entidade Contato no Rubeus.
• Atualmente, temos as seguintes entidades:
  
  
  • Unidade
    
  • Curso
    
  • Oferta
    
  • Local de Oferta
    
  • Contato
    Ao adicionar uma ação de “Contato”, será exibido o campo “Base legal”, onde é necessário escolher uma de nossas bases legais para tratamento de dados de contatos.
    
    
  • Evento
    Ao adicionar uma ação de “Evento”, será exibido o campo “Tipo de evento integrado”, onde podemos selecionar qual evento será disparado na Plataforma Rubeus, o mesmo será usado nas automações.
    
    Obs: Para enviar um evento, é preciso primeiro cadastrar o tipo na plataforma e vinculá-lo a um fluxo de automação. Saiba como criar um fluxo de automação.
    
    
  • Processo Seletivo

Informações adicionais:

As entidades possuem contextos distintos, portanto só podem ser enviadas com entidades do mesmo contexto.

Atualmente são:

• Unidade e Local de oferta.
• Curso, Oferta e Processo seletivo.
• Contato e Evento.

Configurações da sentença

1.8) Descrição da sentença

Recomendamos adicionar uma descrição a sentença, como por exemplo, uma sentença que envia as ofertas para o Rubeus. Ao adicionar uma descrição na mesma, ela ficará com um ícone de exclamação no dashboard de sentenças.

Descrição da sentença

1.9) Rodar sentença em lotes

Para que a sentença seja executada em lotes, precisamos de dois parâmetros (:INICIO e :FIM) na consulta, esses parâmetros tem como objetivo limitar os resultados que irão retornar na consulta. 

Ex: Se a consulta retorna 30.000 registros, na primeira execução “:INICIO” vai trazer o valor 1 e “:FIM”  o valor 5000, após o processamento os valores serão 5001 e 10000 respectivamente, até que sejam processados os 30.000 registros.

Obs: Ao cadastrarmos a sentença no integrador, caso o campo “Rodar sentença em lotes” esteja ativado, não é necessário adicionar os parâmetros “:INICIO” e “:FIM” no campo “Parâmetros TOTVS”.

Importante:

A consulta deve ter um contador de linhas e, esse contador deve ser utilizado como filtro na sentença SQL, ex:

WITH PESSOA AS

(

SELECT

ROW_NUMBER() OVER(ORDER BY PPESSOA.CODIGO DESC) AS Row,

NOME,

CODIGO

FROM

PPESSOA

)

SELECT

ROW,

NOME as 'contato.nome',

CODIGO as 'contato.codigo'

FROM

PESSOA

WHERE

ROW BETWEEN :INICIO AND :FIM

 

1.10) Horário de execução

Define o horário estimado para a primeira execução da consulta.

1.11) Intervalo entre execuções

Definição de tempo entre as execuções da sentença.

Obs: os horários de execução são distribuídos de forma a otimizar a carga no servidor.

Importante:

Para que a sentença seja executada automaticamente, seguindo os intervalos entre execuções programados, é necessário que o campo “Execução automática” esteja ativado.

🕕 Horários disponíveis em que as consultas serão executadas, são:

3h, 6h, 12h, 1 dia e 1 semana.

1.12) Categoria da sentença

Aqui vinculamos, caso haja, uma categoria para a sentença. Para cadastrar uma categoria, que é o lugar onde você irá categorizar as sentenças, é bem simples, veja:

CRUD de categorias

Pop-up de cadastro e edição de categoria

🛑 Bom saber!

O app de Integração TOTVS recebeu atualizações da LGPD. Para conhecê-las detalhadamente, clique AQUI!