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". Clique em Continue.

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

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 se conectar na Carol através do 2C, crie a conexão com o banco de dados do Protheus®, para isso acione o botão Add 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. 
• No campo Environment informe o ambiente da Carol disponível para sua organização.
• No campo Carol Connector selecione a opção "painelcontabilcontabil".

Image Removed                                    Image Added

• Caso o campo Connector Token esteja em branco, acione o botão "Generate Connector Token" e confirme.

Image Removed                                    Image Added

Clique no botão "Next: Configure". 

Informe os dados para conexão no banco de dados do Protheus® e clique em Next: Add Database. Exemplo na imagem a seguir.

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 TOTVS Carol Painel ContábilBackoffice - Módulo Contábil.

Clique no menu Database Manager.

Localize a conexão criada e acione a opção Configure.Image Removed

                                       Image Added

Agora deverão ser configuradas as views criadas pelo BCInstaller no Protheus® para que os dados possam ser levados à plataforma da Carol.

Obs: Esse processo de configuração deverá ser realizado para cada uma das views.

                                                                                                           Image Modified 

Siga os seguintes passos:

1. Clique na view. 
2. Clique em Advanced Configuration

                                                                                   Image Modified

3. Acione o botão Set primary key. Informe quais campos formam a chave de identificação dos registros clicando na opção Add primary key.

Após selecionar os campos da chave clique em Save e return.

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

                               Image Modified

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.

Image Removed                                                                  Image Added

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

Cada uma das views configuradas será representada por um data model na Carol.

Nessa tela é apresentada a relação dos data models e a quantidade de registros que foram enviados para eles.

                                                                                                                    Image Added

Crie o agendamento da limpeza e reprocessamento da Stagings, CAROL_BALANCE_ACC, CAROL_BALANCE_DAY e CAROL_DRE da seguinte forma:

• Na tela de Connectors clique na seta ao lado do botão Pause all e selecione a opção Clean target & Reprocess Records:

Image Added

• Ao iniciar o processamento será exibido no canto superior a notificação de execução da tarefa solicitada, clique no sino e em seguida na tarefa:

Image Added

• Será exibido os detalhes da tarefa, no final do frame a opção de criar um Create schedule da tarefa:

Image Added

• Configure o schedule para rodar diariamente as 3h da manhã:

Image AddedImage Removed

Para mais informações sobre data model 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 TOTVS Carol 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 registrosBackoffice - Módulo Contábil será utilizada a sincronização syncbyfullload.

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.

                                                                   Image Added

Nesse exemplo é aplicado para a sincronização do tipo syncbyfullload a expressão "0 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.

Image Removed

todos os dias às 00h00.

Outra alteração necessária no arquivo app.config.yml é o parâmetro "clearEntitiesNotFoundOnDatabase: false", após essa alteração, salvar o arquivo.

                                                                      Image Added

Image Added

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 CARAOL_BALANCE_DAY, CAROL_DRE_DAY e CAROL_LANC_CONTABIL como syncbytimestamp. Para como syncbyfullload. Para tanto:

• selecione a view
• desabilite a view clicando em Disable
• na seção Sync strategy clique em ConfigureImage Removed
• selecione Batch e Sync by value.
• marque a opção "Based on the sending date".
• selecione o campo Data.
• informe a quantidade de dias para considerar o envio do registro no campo Days to resend. (Nesse exemplo, serão enviados os registros dos últimos 100 dias à partir da última data de sincronização).
• clique em Save e return.
• habilite a view clicando em Enable.

Image Removed

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

• Sync by Full Load"
• Nas views CAROL_BALANCE_DAY, CAROL_DRE_DAY e CAROL_BALANCE_ACC marque a opção "Delete all CDS data before syncing the data
• selecione a view
• desabilite a view clicando em Disable
• marque a opção "Sync by Full Load"
• clique em Save e return.
• habilite a view clicando em Enable

                                                                Image Modified