Carol Connect (2C) - Como criar uma conexão com um banco de dados
A conexão criada na Carol Connect (2C) é utilizada para envio dos dados de seu ambiente local ou cloud para Plataforma Carol onde eles podem ser utilizados para APPs como o Clock In, entre outros.
Para criar essa conexão acesse a Carol Connect (2C). O seu endereço padrão é localhost:8880, porém pode ter IPs e portas diferentes dependendo da sua configuração de rede.
Preencha sua Organização e e-mail e senha do usuário dela na Plataforma Carol. No exemplo minha organização é a masteringcarol.
Na página de Database Manager clique sobre + Add database.
Depois selecione o tipo de base de dados que deseja criar a conexão, neste exemplo é o SQL SERVER.
No Connection Name pode ser qualquer descrição, ele é um simples apelido para essa conexão dentro do 2C.
No Carol Environment você deve selecionar para qual ambiente da Plataforma você quer enviar os dados, há situações que pode ter mais de um ambiente, por exemplo Homologação e Produção.
No Carol Connector, você deve informar o nome do Connector existente dentro da Plataforma Carol, ele é onde ficam vinculadas as configurações da Plataforma.
Se você associar o Connector errado o dado pode chegar na Plataforma Carol, mas não será processado corretamente e, se for o caso, no 2C será necessário refazer essa configuração do zero.
No exemplo específico do APP do Clock In, ao instalar o APP na Plataforma já será criado o Connector padrão de acordo com sua linha de produto (RM, Protheus, Datasul, etc). No exemplo abaixo eu tenho o Connector totvsprotheus da Plataforma onde eu já tenho uma staging table vinculada ao Data Model Employee que vai enviar os trabalhadores para o Clock In.
No Carol Authentication já deve puxar o usuário que utilizou para acessar e configurar o 2C, mas é importante que ele seja um Environment Admin na Plataforma Carol. Se necessário pode dar um Reset connector token para atualizar essa informação.
Na próxima tela serão apresentados os campos para informar as configurações de conexão com o Banco de Dados do qual quer enviar os dados para plataforma. Essa configuração muda de acordo com o tipo de Banco de dados (Oracle, SQL, etc). O ideal é que seja feito junto com o seu DBA e use o mesmo usuário utilizado na configuração de conexão do ERP (Protheus, RM, etc).
IMPORTANTE: Você deve avaliar com sua infra interna ou cloud as permissões para o usuário responsável pelo serviço do 2C acessar o servidor onde encontra-se o Banco de Dados e/ou diretórios.
Para Banco de Dados Oracle, dependendo do usuário configurado você pode ajustar no arquivo app.config.yml o parâmetro oracleUseOwnerAsQueueSchema: para true ou false
Se na próxima tela não aparece matching entities você deve revisar todos os passos acima, pois pode ser que informou o CONNECTOR errado, que não tem PERMISSÃO para acessar o diretório e/ou não tem a STAGING TABLE na Plataforma Carol.
A partir do momento que der ENABLE na tela acima o 2C deve enviar a primeira carga e será considerado como padrão o sincronismo online, porém, muita ATENÇÃO, dependendo das permissões do usuário do Banco de Dados ou se for um diretório NÃO funcionará o sincronismo online, então ajuste sua estratégia de sincronização para BATCH com timestamp ou full load.
