TOTVS CAROL - Carol Connect (2C) - Como criar uma conexão com um banco de dados do DATASUL?

Tempo aproximado para leitura: 00:05:00 min

Dúvida
TOTVS CAROL - Carol Connect (2C) - Como criar uma conexão com um banco de dados do DATASUL?

Ambiente
TOTVS CAROL - Carol Connect (2C) - Todas as versões. 

Solução
As orientações deste artigo abaixo, são referentes a ambientes DATASUL, siga as orientações expostas neste artigo para realizar a configuração do banco de dados corretamente.

O banco de dados Datasul já possui a tabela de fila (CAROL_3C_QUEUE (padrão) e carol-integr-queue (Totvs Health)), além das triggers (gatilhos) das tabelas que serão sincronizadas.

Por isso, nesta primeira etapa, devemos alterar dois parâmetros no arquivo application.yml, que é o arquivo que possui as configurações do Carol Connect (2C). 

Importante: Antes de realizar quaisquer alterações, no arquivo de configuração, é necessário parar o serviço do 2C, caso ele esteja em execução.

Windows: Abra a tela de serviços no Windows, e pare o serviço Carol2CService:

Linux: Use o comando systemctl list-unit-files --state=enabled para listar os serviços habilitados:

Para desabilitar o serviço, remova-o do carregamento inicial usando: sudo systemctl disable [service_name].

Após parar o serviço, abra o arquivo application.yml e altere os parâmetros ignoreQueueTable e ignoreTriggers para true.

Após realizar as alterações necessárias conforme mostrado acima, inicialize o serviço do 2C novamente.

IMPORTANTE: A sincronização dos dados do DATASUL não funciona de forma online, portanto, siga a documentação TOTVS CAROL - Carol Connect (2C) - Como integrar dados do DATASUL usando a estratégia SYNC BY FULLLOAD , para ajustar a estratégia do parâmetros SyncfullLoad.

Acesso o Carol Connect (2C) (normalmente o endereço é localhos:8880, caso seu ambiente fique em Cloud, solicite ao Cloud da TOTVS o endereço de acesso). Na tela inicial selecione a opção "+ Add a database". 

No primeiro passo escolha um nome para a conexão, aponte o Carol Connector de acordo com o ERP que neste exemplo é o Datasul e gere o token de conexão.

IMPORTANTE:  Caso na opção Carol Connector, você selecione uma opção que não seja a do seu ERP, não será possível editá-la posteriormente, será necessário deletar a conexão e refazer o passo acima.

TOTVS CAROL - Carol Connect (2C) - Como corrigir o apontamento do Connector após a sincronização

Na próxima tela, será necessário informar os dados de conexão do Banco de Dados, essas informações podem ser obtidas com o administrador do Banco de Dados. 

IMPORTANTE: No Parâmetro TOTVS Health - Line Datasul?, você deverá selecionar de acordo com sua linha Datasul. A linha saúde, já possui no banco de dados do cliente a tabela de fila do 2C que é a carol-integr-queue (Totvs Health), então colocando o parâmetro como true, o 2C não vai criar a tabela de fila.

Após conferir as informações do banco de dados e clicar em próximo, estando tudo certo com os dados informados, o 2C irá se conectar com o bando de dados. Será feita uma leitura geral da base, esse processo pode demorar um pouco dependendo do tamanho da base de dados.

Após terminada a leitura, temos duas opções:

• Enable matching entities: Habilitará todas as tabelas que já foram identificadas no Connector da Carol e também existentes no banco de dados. Caso selecione essa opção, as tabelas serão ativadas sem nenhum tipo de filtro/condição. Essa opção não é recomendada para quem possui banco de dados datasul, visto que a sincronização das tabelas ficará online, e o datasul não possui esse funcionamento.
• Select Entities: Permitirá selecionar individualmente quais tabelas que deseja habilitar, além de permitir adicionar filtro/condição para a subida de dados referente aos dados da tabela selecionada.
  
  

Saiba Mais
CLIQUE AQUI para acessar mais artigos e FAQs sobre a TOTVS Carol
CLIQUE AQUI para acessar a documentação técnica da TOTVS Carol no TDN
CLIQUE AQUI para acessar a documentação técnica da TOTVS Carol do LABS