Home

TOTVS | Plataformas e tecnologias

Árvore de páginas

FAQ: 56512-Como funciona a integração via ADO?
Produto:Datasul
Ambiente:
Versão:2
Sintoma
56512-Como funciona a integração via ADO?
Causa
Como funciona a integração via ADO?
Solução

A integração via ADO (ActiveX Data Object) no Applink permite que o tráfego das informações entre a base do CRM e a base do sistema remoto seja feita por meio de conexão direta entre os mesmos, ao invés de ser feita por leitura e gravação de arquivos texto. Esta conexão é estabelecida por meio de uma fonte de dados ODBC que utiliza componentes ADO para efetuar o acesso e é feita autenticação com o login e senha do usuário do banco remoto.

Primeiramente, devemos configurar uma conexão ADO no Application Link, na tela Preferências Default -> Conexão ADO -> Botão Configurar.

Na caixa de diálogo, selecionar a opção Use Connection String e pressione o botão Build.

Na aba Provider, selecione a opção correspondente ao banco de dados remoto que se deseja conectar e pressione Avançar.

As parametrizações seguintes variam de banco para banco. O resultado será uma string de conexão remota com o banco. Pressione o botão Teste para efetuar um teste de conexão com o banco remoto que acabamos de parametrizar.

O próximo passo é cadastrar templates do tipo ADO para integração. O processo é simples, com poucas diferenças para os templates XML: ao cadastrar um template, selecione a opção ADO. Repare que no grid abaixo são exibidos dois novos campos, Tabela ADO e Campo ADO. Preencha essas informações respectivamente com o nome da tabela e da coluna cujos dados se deseja acessar. É importante frisar que os campos devem ser correspondentes em tamanho e tipo de dados.

Uma parametrização importante a ser verificada é o Filtro ADO. Ele serve para que se inclua a cláusula WHERE no comando SELECT que o Application Link irá efetuar no banco remoto para buscar as informações. Desta forma, podemos otimizar a busca fazendo com que somente dados que respeitem certas condições sejam lidos e gravados na tabela temporária. Ele também serve para estabelecermos ligações entre os campos-chave de tabelas (JOINS) caso tenhamos campos no mesmo template que acessem tabelas distintas. Repare na figura abaixo que serão retornados os dados de três tabelas distintas interligadas por campos-chave e que possuam o valor 1 no campo IND_CRM_SITUACAO.

Outro recurso importante é o Tratamento ADO (figura abaixo). Ele serve para indicar que o comando SQL será executado no banco remoto ao invés do banco CRM. É bastante útil, por exemplo, para sinalizarmos que um dado foi lido com sucesso ou não.

O Preview de Dados também funciona para templates ADO. Basta selecionar o template para que o Application Link efetue a busca dos dados e exiba no grid.

Para finalizar, a conexão ADO serve como alternativa para situações onde não é possível ou se perde em desempenho para o tráfego via sistema de arquivos, pois esta forma de integração dispensa a implementação de um local para armazenamento dos mesmos e não são necessários mecanismos de tradução de arquivos XML, como o plugin Velocity.