Histórico da Página

Após a inicialização do serviço Carol2CService acesse no seu navegador o endereço http://localhost:8880.

Na página do 2C informe os dados de conexão da Carol que lhes foram fornecidos. 

No campo de Organization informe o domínio do ambiente da Carol.

O nome do domínio se encontra na URL em que se realiza acesso na plataforma da Carol, por exemplo, para a URL "totvs.carol.ai" a organização será "totvs".

No campo Environment informe o ambiente da Carol disponível para sua organização, ele pode ser visualizado no complemento da URL ao acessar a plataforma Carol.

Informe também as credenciais de acesso nos campos Username e Password e clique no botão Ok.

Será realizada a conexão do 2C com a Carol. 

Para mais informações sobre a conexão no 2C acesse: https://docs.carol.ai/docs/carol-connect-2c

Após conectar o 2C na Carol, crie a conexão do 2C com o banco de dados do Protheus®, para isso acione o botão Add new database.

Selecione o tipo de banco de dados utilizado no Protheus®. Nesse exemplo é utilizado o SQL Server®.

Informe um nome para a conexão no campo Connection Name e selecione o nome do conector na Carol. 

Siga o exemplo abaixo para preencher os demais campos e passe os dados de conexão com seu banco do Protheus®.

Clique no botão "Save configuration" para gravar e validar a conexão.

Para mais informações sobre a conexão do 2C com o banco de dados, acesse: https://docs.carol.ai/docs/carol-connect-2c

Após a realização de conexão na Carol e no banco de dados do Protheus® é necessário indicar quais dados serão levados à plataforma da Carol para utilização no Painel Contábil.

Atualmente o Painel Contábil faz uso de 11 views criadas na execução do BCInstaller.

Para configuração da views acione o botão "Configure entities".

Aguarde enquanto os objetos do banco de dados são carregados, dependendo do tamanho da base isso pode levar alguns minutos.

Digite CAROL_ na caixa de pesquisa para trazer somente as views relacionadas ao Painel Contábil.

O processo de mapeamento das views deverá ser realizado para cada uma delas.

Para realizar esse mapeamento siga os seguintes passos:

1. Clique na view. Serão listados os campos que a compõe.

2. Informe quais desses campos formam sua chave na Carol adicionando-os na coluna de Selected columns. 

3. Após o mapeamento dos campos da primary key habilite a sincronização dos dados da view, clique no botão Enable.

Ao habilitar a sincronização os dados serão carregados na plataforma da Carol.

Siga a ordem abaixo para mapear e habilitar a carga dos dados, atente-se aos campos que compõem a primary key de cada uma das views.

Após o mapeamento de todas as chaves e de habilitar todas as views, acesse o menu Database Manager e confirme se a integração está habilitada, se não estiver habilite clicando em Play.

Para visualizar se a carga dos dados está sendo realizada, acesse a plataforma da Carol, no menu Explore.

Nessa tela é apresentada a relação das stages e a quantidade de registros que foram enviados.

Para mais informações sobre stages e conceitos da Carol, acesse: https://docs.carol.ai/docs/getting-started

A primeira carga de dados é realizada levando todos os dados selecionados nas views.

Considerando que novos registros serão criados no Protheus, é necessário o envio das novas informações à Carol.

Sendo assim, para que haja a sincronização automática dos dados é necessário configurar uma estratégia de sincronização no 2C.

Após a realização da primeira carga completa, não se faz necessário sincronizar todos os dados selecionados das views novamente, o que geraria um processamento desnecessário de informações que já se encontram na plataforma da Carol.

Dessa forma, é possível configurar uma estratégia de sincronização no 2C para considerar os registros a partir de determinada data. 

Para o Painel Contábil serão usados dois tipos de sincronização, o syncbyfullload para cadastros, pois não tem campo de data neles, e o syncbytimestamp onde se indica um campo de data para considerar os registros.

Para realizar essa configuração, siga os seguintes passos para definir o agendamento e critério de sincronização:

1. Pare o serviço do windows Carol2CConnect.
2. Abra o arquivo app.config.yml.

Na seção jobs, indique a opção cron com o período desejado para a sincronização dos dados.

Nesse exemplo é aplicado para a sincronização do tipo syncbyfullload a expressão "0 0 23 ? * 1#1 *", sendo assim a carga para views configuradas nesse tipo será realizada no primeiro domingo de cada mês.

Para o tipo syncbytimestamp será usada a expressão "0 0 0 ? * SUN *", sendo assim a carga para views configuradas nesse tipo será realizada aos Domingos à meia-noite.

3. Salve a alteração do arquivo.

4. Reinicie o serviço Carol2CConnect.

5. Configure para cada view no 2C o tipo de sincronização da seguinte forma:

Marque as views CAROL_BALANCE, CARAOL_BALANCE_DAY, CAROL_DRE, CAROL_DRE_DAY e CAROL_LANC_CONTABIL como syncbytimestamp. Para tanto:

• selecione a view
• desabilite a view clicando em Disable
• marque a opção "Sync using a value field"
• selecione o campo "DATA"
• marque a opção "Based on the sending date"
• informe a quantidade de dias para considerar o envio do registro. (Nesse exemplo, serão enviados os registros dos últimos 30 dias à partir da última data de sincronização).
• habilite a view clicando em Enable
• Repare que ao marcar a opção syncbytimestamp é exibida a data da próxima carga definida na configuração da sincronização.

Marque as demais views que representam cadastros como syncbyfullload. Para tanto:

• selecione a view
• desabilite a view clicando em Disable
• marque a opção "Sync using Full Load"
• habilite a view clicando em Enable
• Repare que ao marcar a opção syncbytimestamp é exibida a data da próxima carga definida na configuração da sincronização.