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. 

Image Removed

• 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.

Image Added

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.

Image Removed

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

• Login.

Image Added

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 o 2C na Carol através do 2C, crie a conexão do 2C com o banco de dados do Protheus®, para isso acione o botão Add new database.

Image RemovedImage Added

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

Image Removed

• 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 "contabil".

                                    Image Added

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

                                    Image AddedSiga 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.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.

Image Added

Image AddedImage Removed

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".

Image Removed

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.

Image Removed

TOTVS Carol Painel Backoffice - Módulo Contábil.

Clique no menu Database Manager.

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

                                       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 O processo de mapeamento das views deverá ser realizado para cada uma delas.das views.

                                                                                                           Image Added 

Siga Para realizar esse mapeamento siga os seguintes passos:

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

Image Removed

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

1.  
2. Clique em Advanced Configuration

                                                                                   Image Added

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.

Image Added

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

                               Image Added

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

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.

Image Added

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

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

Image Removed

                                                                                                                    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 Added

Para mais informações sobre data model 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 ProtheusProtheus®, é 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 registrosPara o TOTVS Carol Painel Backoffice - 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 23 0 ? * * 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 CAROL_BALANCE, CARAOL_BALANCE_DAY, CAROL_DRE, CAROL_DRE_DAY e CAROL_LANC_CONTABIL como syncbytimestamp. Para  Marque as views como syncbyfullload. Para tanto:

• selecione a view
• desabilite a view clicando em Disable
• marque a opção "Sync using a value field"
• selecione o campo "DATA"
• by Full Load"
• Nas views CAROL_BALANCE_DAY, CAROL_DRE_DAY e CAROL_BALANCE_ACC marque a opção "Based on the sending date"Delete all CDS data before syncing the data"
• clique em Save e returninforme 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.

Image Removed

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.

Image Removed

                                                                Image Added