Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Deck of Cards
idEtapas
Card
labelConexão Carol

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

Dica

Caso não seja possível utilizar o 2C na porta 8880, pare o Carol2CService no Serviços do Windows e altere o número da porta no arquivo app.config.yml.

Esse arquivo está localizado na pasta de instalação do serviço.

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

Card
labelConexão Banco Protheus

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

                                   


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

                                   

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

Card
labelMapeamento Views

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 Backoffice - Módulo Contábil.

Clique no menu Database Manager.

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

                                       


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.

                                                                                                            

Siga os seguintes passos:

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

                                                                                   


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.

Dica

A relação dos campos que compõem a chave primária de cada uma das views se encontra logo abaixo.


4. Após o mapeamento dos campos 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.

Aviso

O mapeamento das views deve seguir uma determinada ordem para facilitar a sincronização dos dados.


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.


Expandir
titleCAROL_EMPRESA

Em Available columns, selecione os seguintes campos para a formação da primary key:

Informações
iconfalse

COD_EMPRESA
TOTVS_LINHA_PRODUTO
INSTANCIA

Expandir
titleCAROL_FILIAL

Em Available columns, selecione os seguintes campos para a formação da primary key:

Informações
iconfalse

COD_EMPRESA
COD_FILIAL
TOTVS_LINHA_PRODUTO
INSTANCIA

Expandir
titleCAROL_MOEDACTB

Em Available columns, selecione os seguintes campos para a formação da primary key:

Informações
iconfalse

FILIAL
TOTVS_LINHA_PRODUTO
COD_MOEDA
EMPRESA
INSTANCIA
TABELA

Expandir
titleCAROL_TPSALDO

Em Available columns, selecione os seguintes campos para a formação da primary key:

Informações
iconfalse

FILIAL
TOTVS_LINHA_PRODUTO
COD_TPSALDO
EMPRESA
INSTANCIA
TABELA

Expandir
titleCAROL_VISAOGERENCIAL

Em Available columns, selecione os seguintes campos para a formação da primary key:

Informações
iconfalse

FILIAL
TOTVS_LINHA_PRODUTO
EMPRESA
INSTANCIA
LINHA_COMPOSICAO
TABELA
COD_VISAO
ORDEM_EXIBICAO

Expandir
titleCAROL_CONTACONTABIL

Em Available columns, selecione os seguintes campos para a formação da primary key:

Informações
iconfalse

FILIAL
TOTVS_LINHA_PRODUTO
COD_CONTA_CONTABIL
EMPRESA
INSTANCIA
TABELA

Expandir
titleCAROL_BALANCE_DAY

Em Available columns, selecione os seguintes campos para a formação da primary key:

Informações
iconfalse

TABELA_SALDOS
EMPRESA
TIPO_SALDO
FLAG_LP
TOTVS_LINHA_PRODUTO
DATA
COD_MOEDA
COD_CONTA
DATA_APURACAO
FILIAL_PLANO_CONTAS
FILIAL_SALDO
INSTANCIA
TABELA_PLANO_CONTAS

Expandir
titleCAROL_DRE_DAY

Em Available columns, selecione os seguintes campos para a formação da primary key:

Informações
iconfalse

TABELA_SALDOS
EMPRESA
TIPO_SALDO
FLAG_LP
TOTVS_LINHA_PRODUTO
DATA
COD_MOEDA
COD_CONTA
DATA_APURACAO
FILIAL_PLANO_CONTAS
FILIAL_SALDO
INSTANCIA
TABELA_PLANO_CONTAS

Expandir
titleCAROL_LANC_CONTABIL

Em Available columns, selecione os seguintes campos para a formação da primary key:

Informações
iconfalse

DOCUMENTO
SUBLOTE
TABELA_LANCAMENTO
EMPRESA
SEQ_LANC
TIPO_SALDO
TOTVS_LINHA_PRODUTO
DATA
COD_MOEDA
LOTE
FILIAL_LANC
LINHA
SEQ_HISTORICO
INSTANCIA
TIPO_LANC

Expandir
titleCAROL_BALANCE_ACC

Em Available columns, selecione os seguintes campos para a formação da primary key:

Informações
iconfalse

TABELA_SALDOS
EMPRESA
TIPO_SALDO
FLAG_LP
TOTVS_LINHA_PRODUTO
COD_MOEDA
COD_CONTA
DATA_APURACAO
FILIAL_PLANO_CONTAS
FILIAL_SALDO
INSTANCIA
TABELA_PLANO_CONTAS

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.



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.


                                                                                           



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


Dica

Ao final da sincronização, verifique se os dados foram sincronizados corretamente.

Na tela Explore, selecione um registro aleatório nos data models de Balanço Diário e DRE Diário e verifique se os campos Descrição Empresa, Descrição Filial, Descrição Tipo de Saldo e Descrição Moeda estão preenchidos, caso contrário será necessário a reprocessar as informações.

Caso seja necessário realizar o reprocessamento execute os seguintes passos:

Acesse na plataforma Carol, o menu Connectors e selecione o conector do Contábil.

                                                                                                                         


Selecione a stage carol_balance, e acione a opção para reprocessamento de todos os registros da stage selecionada.

Realize o mesmo procedimento para a stage carol_balance_day se necessário.

Aviso

Após a configuração e carga dos dados é necessário configurar os serviços de IA da Carol.

É imprescindível que esses serviços sejam executados pelo menos uma vez antes do acesso à aplicação do Contábil.

Para visualizar o processo de execução e agendamento dos serviços de IA acesse: Configuração dos Serviços de Inteligência Artificial

Necessário também configurar políticas de retenção e consolidação dos dados, acesse: Retenção e Consolidação de Dados

Card
labelAgendamento de Carga

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.

Dica

Para mais informações sobre estratégias de sincronização acesse: https://docs.carol.ai/docs/carol-connect-2c 

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


Nesse exemplo é aplicado para a sincronização do tipo syncbyfullload a expressão "0 0 0 ? * * *", sendo assim a carga para views configuradas nesse tipo será realizada todos os dias às 00h00.


                                                                             


Dica

Podemos usar sites para formar a expressão cron, como por exemplo, https://www.freeformatter.com/cron-expression-generator-quartz.html 

3. Salve a alteração do arquivo.

4. Reinicie o serviço Carol2CConnect.

 Marque as views como syncbyfullload. Para tanto:

  • 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


                                                               


Aviso

Após a configuração e carga dos dados é necessário configurar os serviços de IA da Carol.

É imprescindível que esses serviços sejam executados pelo menos uma vez antes do acesso à aplicação do Painel Backoffice - Módulo Contábil.

Para visualizar o processo de execução e agendamento dos serviços de IA acesse: Configuração dos Serviços de Inteligência Artificial

Necessário também configurar políticas de retenção e consolidação dos dados, acesse: Retenção e Consolidação de Dados

...