Índice:
Objetivo:
O objetivo desse documento é esclarecer o uso de conexão destino usando a Carol.
Introdução:
TOTVS Carol é a plataforma de dados e inteligência artificial da TOTVS. Leia mais sobre a Carol.
Nas versões mais recentes do RM é possível enviar dados para a Carol, através da ferramenta de Conceito (ETL).
Os provedores de banco de dados são APIs que promovem conexão direta a uma base de dados, sem necessidade de existir um ERP. O provedor de banco de dados fará conexão direta com um banco específico ou a diversos bancos de forma genérica, sendo assim, é de responsabilidade do usuário escolher o que melhor atenderá sua demanda.
O principal campo para preenchimento dos dados de um provedor é a Connection String. É a partir deste que os outros campos serão preenchidos e, caso alguma alteração ocorra nos outros campos, a mudança será refletida na connection string.
Conexão:
Após inserir a Connection String e pressionar Enter, a tela irá se expandir, contendo novos campos junto das informações preenchidas na string. Os novos campos exibidos na tela poderão ser alterados, refletindo na connection string.
São suportadas todos os tipos de Conexões de Origem disponíveis no Conceito. E Para a conexão de destino é necessário configurar uma conexão Carol.
É importante ter uma conta válida no sistema da Carol.
Conexão:
Veja abaixo um exemplo de como criar uma conexão com a Carol.
Neste exemplo, o objetivo é enviar toda a tabela de Funcionários (PFUNC) para a Carol. Para isso, usamos uma conexão de origem de Banco de Dados, selecionando a tabela PFUNC e todos seus campos. Veja mais sobre esse tipo de conexão: Conexão de Origem/Destino Utilizando Banco de Dados.
Passos para criar a conexão de destino com a Carol
Provedores:
| Deck of Cards |
|---|
|
| Card |
|---|
| Connection String: Driver={SQL SERVER};server=<servername>;database=<dbname>  Image Removed
| Informações |
|---|
Nessa conexão, também é possível informar as tags User ID e Password |
|
| Card |
|---|
| Connection String: Provider=SQLOLEDB;Data Source=<servername>;Password=<password>;User ID=<userid>;Initial Catalog=<dbname>  Image Removed
| Informações |
|---|
Para o uso de segurança integrada na conexão, informe a tag Integrated Security=SSPI e remova as tags Password e User ID. |
Para conexão a um Provedor OleDb, estão disponibilizadas as seguintes opções, no campo "Provider":  Image Removed
|
| Card |
|---|
| label | OracleClient Data Provider |
|---|
| | Aviso |
|---|
Para uso da conexão, é necessário instalar Oracle Client acima da versão 8.1.7. |
Connection String: Data Source="(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=<host>)(PORT=<port>))(CONNECT_DATA=(SERVICE_NAME=<servicename>)))";User ID=<userid>;Password=<password>  Image Removed
| Informações |
|---|
Apenas é aceito privilégio/atribuição "SYS", que é o padrão Oracle. SYSDBA não é suportado. |
|
| Card |
|---|
| label | SqlClient Data Provider |
|---|
| Connection String: Server=<servername>;Database=<dbname>;User Id=<userid>;Password=<password>;  Image Removed
|
|
| Dica |
|---|
| As informações a seguir deverão ser recuperadas do ambiente Carol. O Token pode ser obtido conforme link a seguir: Autenticação na Carol.  Image Added
No exemplo acima não foi usado o token, mas um usuário e senha para autenticação. Os dados preenchidos foram obtidos diretamente da Carol, no connector:  Image Added
|
| Card |
|---|
| label | Conexão Carol - Mensagem |
|---|
| Na aba Mensagem será configurado o schema da tabela do connector da Carol, onde os dados serão enviados.  Image Added
- Se o a tabela já existir no connector, basta clicar no botão 'Buscar Schema', que o schema da stagging será retornado:
 Image Added
- Se ele não existir, será retornada uma mensagem ao realizar o passo anterior: "Tabela não encontrada na staging!".
Para criar a tabela na staging, clique em 'Criar Schema'. O sistema listará todos os campos da conexão de Origem:  Image Added
Selecione a(s) PK(s), remova os campos indesejados e clique em Criar Schema. Nesse momento, aguarde a confirmação que a tabela foi criada corretamente no connector da Carol. |
| Card |
|---|
| Por último, configure as ligações entre a tabela destino e origem. Arraste primeiro a tabela de destino, depois a de Origem. Em seguida, clique no ícone 3, em destaque na imagem abaixo, para que as associações de campos sejam feitas automaticamente baseando-se no nome.  Image Added
|
Utilize o botão "Testar" para testar sua conexão. |
